POSTenterprise-general-taxpayer-query
企业纳税人信息查询
查询企业的通用纳税人详细信息，包括注册、经营状态及税务登记情况，帮助用户全面了解目标企业的税务画像和运营合规性。
接入文件
功能介绍
本接口提供企业通用纳税人的详细信息查询服务。用户可通过企业名称或统一社会信用代码作为查询条件，获取目标企业的全面税务数据。返回内容涵盖企业的基本注册信息、当前经营状态、详细经营范围、税务登记状态、纳税人资质类型以及相关的税务信用评级等关键数据。此服务旨在帮助用户深入了解企业的税务画像和运营合规性。
应用场景
- 企业资信评估: 金融机构在进行贷款审批、商业合作或投资决策前，可利用此接口核实企业的纳税资质和经营状况，有效评估潜在风险。
- 供应商/客户背景调查: 企业在选择合作方（供应商、客户等）时，能够快速了解其税务合规性及历史信用，确保交易安全与稳定。
- 风险监控: 持续监控关联企业的税务状态变化，及时发现潜在的税务风险或经营异常。
- 市场分析与研究: 收集特定行业或区域内企业的纳税数据，进行宏观经济分析、市场趋势洞察或竞争对手研究。
接入示例程式碼
提供 Shell、Python、Go、Java、PHP 等常見接入示例，便於直接接到現有專案裡。
請求示例
{}響應示例
{
"code": 200,
"data": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"logo": {
"type": "string",
"example": "",
"description": "公司logo"
},
"name": {
"type": "string",
"example": "杭州安那其科技有限公司",
"description": "公司名"
},
"alias": {
"type": "string",
"example": "",
"description": "公司简称"
},
"endDate": {
"type": "string",
"example": "9999-12-31 00:00:00",
"description": "认定有效期截止"
},
"startDate": {
"type": "string",
"example": "2021-02-01 00:00:00",
"description": "认定有效期起始时间"
},
"taxpayerQualificationType": {
"type": "string",
"example": "增值税一般纳税人",
"description": "纳税人资格类型"
},
"taxpayerIdentificationNumber": {
"type": "string",
"example": "91330110MA2CC1X505",
"description": "纳税人识别号"
}
}
},
"example": [
{
"logo": "",
"name": "杭州安那其科技有限公司",
"alias": "",
"endDate": "9999-12-31 00:00:00",
"startDate": "2021-02-01 00:00:00",
"taxpayerQualificationType": "增值税一般纳税人",
"taxpayerIdentificationNumber": "91330110MA2CC1X505"
}
]
},
"total": {
"type": "string",
"example": "1",
"description": "总数"
}
},
"message": "success"
}響應欄位
以下欄位根據示例 JSON 自動提取，僅作接入參考。
| 欄位路徑 | 型別 | 示例值 |
|---|---|---|
| code | number | 200 |
| data | object | {...} |
| data.items | object | {...} |
| data.items.type | string | array |
| data.total | object | {...} |
| data.total.type | string | string |
| data.total.example | string | 1 |
| data.total.description |