开放平台API
  1. 企业数据
开放平台API
  • 海关数据
    • 出口报关单获取接口
      POST
    • 进口报关单获取接口
      POST
    • 进口税单获取接口
      POST
    • 保证金获取接口
      POST
    • 海关编码获取接口
      POST
    • 退税商品编码获取接口
      POST
    • 下载任务状态查询
      POST
  • 进项数据
    • 进项发票获取接口
      POST
    • 进项发票查验接口
      POST
    • 进项异常发票获取接口
      POST
    • 进项票据OCR识别接口
      POST
  • 销项数据
    • 销项发票申请接口
      POST
    • 销项发票获取接口
      POST
    • 销项发票红冲接口
      POST
    • 销项发票作废接口
      POST
    • 记账凭证回推接口-XINVOICE.DBACK
      POST
  • 退税数据
    • 生产企业
    • 外贸企业
      • 退税申报批次-汇总数据申请下载接口
      • 退税申报批次-汇总数据查询(下载完成后调用)
      • 自检状态查询
    • 退税申报批次申请下载接口
    • 退税申报批次数据获取接口
    • 已申报批次基本信息获取接口
  • 企业数据
    • 企业信息获取接口
      POST
    • 是否一般纳税人查询接口
      POST
    • 税局违法企业获取接口
      POST
    • 企业财税数据获取接口
      POST
    • 企业开通申请接口
      POST
    • 企业开通申请结果获取接口
      POST
    • 企业备案信息申请下载接口
      POST
    • 企业备案信息结果获取接口
      POST
    • 企业开通申请接口WEB版
      POST
    • 渠道关联企业-续期接口WEB版
      POST
  • 开票服务
    • 登录电票平台接口
    • 获取是否需要人脸识别接口
    • 获取人脸识别二维码接口
  • 其他数据服务
    • 汇率查询
  1. 企业数据

是否一般纳税人查询接口

POST
/post/rest/enterprise/dii
此接口支持通过关键字(企业名称或企业税号)获取企业自身的类型是“一般纳税人”还是“小规模纳税人”。

请求参数

Header 参数
Content-Type
string 
可选
示例值:
application/json
Body 参数application/json
authorize
object 
安全凭证
必需
appSecId
string 
密钥ID
必需
平台随机生成
appSec
string 
签名串
必需
根据密钥ID和KEY生成的签名串
globalInfo
object 
接口信息
必需
appId
string 
接口ID
必需
例:QYXX
version
string 
接口版本号
必需
例:V1.0
interfaceCode
string 
接口编码
必需
例:ENTERPRISE.TAXPAYER.GET
enterpriseCode
string 
企业编码
必需
dataExchangeId
string 
接口数据加密
必需
例:默认值dataExchangeId
data
object 
获取条件参数
必需
由获取条件参数通过用Base64加密生成的字符串
name
string 
企业名称
可选
与企业税号必填一项
nsrdjNo
string 
企业税号
可选
与企业名称必填一项
示例
{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE995C39FFC3DFE17FB",
        "appSec": "aJBbsUYV6G1oCkjstTSBiHRLQ6A="
    },
    "globalInfo": {
        "appId": "QYXX",
        "version": "V1.0",
        "interfaceCode": "ENTERPRISE.TAXPAYER.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJuc3Jkak5vIjogIjkxMTEwMTA4MTAwMDA2MDU1SiIsIm5hbWUiOiIifQ=="
}

//data 解密请求参数

{
    "nsrdjNo": "91110108100006055J",
    "name": ""
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://117.78.0.163/51GP/post/rest/enterprise/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE995C39FFC3DFE17FB",
        "appSec": "aJBbsUYV6G1oCkjstTSBiHRLQ6A="
    },
    "globalInfo": {
        "appId": "QYXX",
        "version": "V1.0",
        "interfaceCode": "ENTERPRISE.TAXPAYER.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJuc3Jkak5vIjogIjkxMTEwMTA4MTAwMDA2MDU1SiIsIm5hbWUiOiIifQ=="
}

//data 解密请求参数

{
    "nsrdjNo": "91110108100006055J",
    "name": ""
}'

返回响应

🟢200成功
application/json
Body
data
object 
返回参数
必需
由返回的参数通过用Base64加密生成的字符串
totalRows
integer 
数据的总条数
必需
data
array [object {9}] 
企业信息
必需
currentRows
integer 
当前第几页
必需
returnStateInfo
object 
接口状态信息
必需
returnCode
string 
返回状态编码
必需
例:0000
returnMessage
string 
返回信息
必需
例:处理成功
示例
{
    "data": "eyJkYXRhIjpbeyJhbGlhcyI6IuaVmeiCsuWbvuS5piIsImVuZERhdGUiOiIgIiwiaWQiOiIyNjEzODAzNCIsIm5hbWUiOiLkuK3lm73mlZnogrLlm77kuabov5vlh7rlj6PmnInpmZDlhazlj7giLCJzZWFyY2hVcGRhdGVUaW1lIjoiMjAyMy0xMC0wOCAwMDowMDowMCIsInN0YXJ0RGF0ZSI6IjE5OTMtMTItMDEiLCJ0YXhOdW1iZXIiOiI5MTExMDEwODEwMDAwNjA1NUoiLCJ0YXhwYXllclR5cGUiOiLkuIDoiKznurPnqI7kuroiLCJ1dWlkIjoiNDAyODgxNWM4YjBkZGNmODAxOGIwZGU0Y2ZlMTAwMDEifV0sImN1cnJlbnRSb3dzIjoxLCJ0b3RhbFJvd3MiOjF9",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}


//data加密前的数据
{
    "data": [
        {
            "alias": "教育图书",
            "endDate": " ",
            "id": "26138034",
            "name": "中国教育图书进出口有限公司",
            "searchUpdateTime": "2023-10-08 00:00:00",
            "startDate": "1993-12-01",
            "taxNumber": "91110108100006055J",
            "taxpayerType": "一般纳税人",
            "uuid": "4028815c8b0ddcf8018b0de4cfe10001"
        }
    ],
    "currentRows": 1,
    "totalRows": 1
}
修改于 2023-12-14 10:04:49
上一页
企业信息获取接口
下一页
税局违法企业获取接口
Built with