开放平台API

已申报批次基本信息获取接口

POST

/post/rest/tssb/dii

此接口支持通过关键字（申报年月，业务类型，流水号等字段）获取企业自身的退税申报批次数据包含：申报年月，申报批次，退税金额，消费税金额，审核状态，操作时间。

请求参数

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

optStartDate

string

最新操作结束日期

可选

例：yyyy-MM-dd

downType

string

业务类型

必需

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

page

integer

当前第几页

必需

默认从1开始

pageSize

integer

每页条数

必需

默认20

示例

{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9E1B011E914FCA94C",
        "appSec": "J9a5RICPd0lSlIjvyrEHM6c2VuY="
    },
    "globalInfo": {
        "appId": "TSSB",
        "version": "V1.0",
        "interfaceCode": "TAXREFUND.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzYlltIjoiMjAyMCIsImRvd25UeXBlIjoiV01RWSIsInBhZ2UiOjEsInBhZ2VTaXplIjoxMCwib3B0U3RhcnREYXRlIjoiIiwib3B0RW5kRGF0ZSI6IiJ9"
}

//data 解密请求参数
{
    "sbYm": "2020",
    "downType": "WMQY",
    "page": 1,
    "pageSize": 10,
    "optStartDate": "",
    "optEndDate": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://117.78.0.163/51GP/post/rest/tssb/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9E1B011E914FCA94C",
        "appSec": "J9a5RICPd0lSlIjvyrEHM6c2VuY="
    },
    "globalInfo": {
        "appId": "TSSB",
        "version": "V1.0",
        "interfaceCode": "TAXREFUND.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzYlltIjoiMjAyMCIsImRvd25UeXBlIjoiV01RWSIsInBhZ2UiOjEsInBhZ2VTaXplIjoxMCwib3B0U3RhcnREYXRlIjoiIiwib3B0RW5kRGF0ZSI6IiJ9"
}

//data 解密请求参数
{
    "sbYm": "2020",
    "downType": "WMQY",
    "page": 1,
    "pageSize": 10,
    "optStartDate": "",
    "optEndDate": ""
}'

返回响应

🟢200成功

application/json

Body

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回状态信息

必需

例：处理成功

data

object

返回退税数据

必需

data

array [object {6}]

必需

msgKey

string

退税数据返回状态

必需

true：成功
false：失败

totalRows

integer

当前返回总条数

必需

示例

{
  "returnStateInfo": {
    "returnCode": "string",
    "returnMessage": "string"
  },
  "data": {
    "data": [
      {
        "zsShFlag": "string",
        "optDate": "string",
        "sbPc": "string",
        "xfsTsAmt": "string",
        "zzsTsAmt": "string",
        "sbny": "string"
      }
    ],
    "msgKey": "string",
    "totalRows": 0
  }
}

修改于 2024-02-28 04:11:12

退税申报批次数据获取接口

企业信息获取接口