开放平台API

退税申报批次-汇总数据申请下载接口

POST

/post/rest/taxrefund/dii

此接口支持通过关键字（申报年月，业务类型，流水号等字段）
发起下载企业自身的退税申报批次数据的请求，然后由系统自动采集退税数据。
接口编码：TAXREFUND.DOWN

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

根据密钥ID和KEY生成的签名串

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：TSSB

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：TAXREFUND.DOWN

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

由获取条件参数通过用Base64加密生成的字符串

sbYm

string

申报年月

必需

例：yyyy或yyyyMM

seqNo

string

请求唯一序号

可选

32位字符串

downType

string

业务类型

必需

WMQY：外贸企业
SCQY：生产企业

示例

{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE90E02339C2F905E25",
        "appSec": "ik7FKe7MmendB94XFgxe8jcrHJI="
    },
    "globalInfo": {
        "appId": "TSSB",
        "version": "V1.0",
        "interfaceCode": "TAXREFUND.DOWN",
        "enterpriseCode": "NFKA.ZSC",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzYlltIjoiMjAyMyIsInNlcU5vIjoiNTE1QjJDNkREQThGNDdCRkJGQ0U1RDQ1NUYxQTdERjgiLCJkb3duVHlwZSI6IldNUVkifQ=="
}
//data 解密请求参数

{
    "sbYm": "2023",
    "seqNo": "515B2C6DDA8F47BFBFCE5D455F1A7DF8",
    "downType": "WMQY"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://117.78.0.163/51GP/post/rest/taxrefund/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE90E02339C2F905E25",
        "appSec": "ik7FKe7MmendB94XFgxe8jcrHJI="
    },
    "globalInfo": {
        "appId": "TSSB",
        "version": "V1.0",
        "interfaceCode": "TAXREFUND.DOWN",
        "enterpriseCode": "NFKA.ZSC",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzYlltIjoiMjAyMyIsInNlcU5vIjoiNTE1QjJDNkREQThGNDdCRkJGQ0U1RDQ1NUYxQTdERjgiLCJkb3duVHlwZSI6IldNUVkifQ=="
}
//data 解密请求参数

{
    "sbYm": "2023",
    "seqNo": "515B2C6DDA8F47BFBFCE5D455F1A7DF8",
    "downType": "WMQY"
}'

返回响应

🟢200成功

application/json

Body

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功

示例

{
  "returnStateInfo": {
    "returnCode": "0000",
    "returnMessage": "处理成功"
  }
}

修改于 2024-11-22 06:09:34

记账凭证回推接口-XINVOICE.DBACK

退税申报批次-汇总数据查询（下载完成后调用）