保证金获取接口 - 开放平台API

此接口支持获取外贸企业自身的税费保证金数据（含：保证金的报关单号，保金/函文号，申报关区，担保单位名称，申办单位名称，保证金金额，期限，支付状态，商品税号，商品名称等信息），帮助外贸企业实时拿到保证金数据，提升工作效率，同时规避税务的风险。

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

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

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：CKBGD

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：MANIFEST.MGET

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

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

guaId

string

保金/函文号

可选

bgdNo

string

报关单号

可选

endDate

string

填发结束日期

可选

格式：yyyy-MM-dd

optStartDate

string

最新操作结束日期

可选

格式：yyyy-MM-dd

pageSize

integer

页数

必需

默认10条

page

integer

当前第几页

必需

默认从1开始

startDate

string

填发开始日期

可选

格式：yyyy-MM-dd

示例

{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9E1B011E914FCA94C",
        "appSec": "Ylnac2ZS/aJEhRG3f9iKUANhWTg="
    },
    "globalInfo": {
        "appId": "BZJ",
        "version": "V1.0",
        "interfaceCode": "DEPOSIT.GET",
        "enterpriseCode": "ZSC",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MSwicGFnZVNpemUiOjIsImd1YUlkIjoiIiwiYmdkTm8iOiIiLCJvcHRTdGFydERhdGUiOiIiLCJvcHRFbmREYXRlIjoiIn0="
}

//data加密前的数据
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 2,
    "guaId": "",
    "bgdNo": "",
    "optStartDate":"",
    "optEndDate":""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

返回参数

必需

由返回的参数通过用Base64加密生成的字符串

result

array [object {53}]

保证金列表数据

必需

totalRows

integer

数据的总条数

必需

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功

示例

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

//data加密前的数据
{
    "result": [
        {
            "addTimeStr": "2019-12-27 15:48:16",
            "affirmFlag": "",
            "affirmMsgSeq": "",
            "affirmTime": "",
            "agentCode": "4401280139",
            "agentName": "广州益嘉物流有限公司",
            "codeTS": "1520000000",
            "cusSeq": "",
            "dataSrcUnitCode": "SW11000020170725",
            "dealTimeStr": "2019-12-27 17:12:24",
            "declPort": "5212",
            "declPortName": "新沙海关",
            "entryId": "521220191129013647",
            "gName": "粗甘油",
            "genDateStr": "2019-12-27 15:48:15",
            "grtInfoSeqNo": "000000000002174499",
            "guaId": "J52122019100000407",
            "guarEr": "中国国投国际贸易有限公司",
            "id": "fd82ac3b65da425898fa5b373b66abd6",
            "loanInfoId": "",
            "opType": "002",
            "opTypeName": "",
            "optDate": null,
            "optId": "",
            "ownerCode": "1101919076",
            "ownerName": "中国国投国际贸易有限公司",
            "payAcct": "",
            "payOpbkName": "",
            "payStatus": "S",
            "payStatusName": "支付成功",
            "payType": "01",
            "periodStr": "2020-06-27",
            "protocolNo": "5200201801006322",
            "qyId": "f17cd438fb384f3ab6e91172c760d920",
            "reAccount": "307617.31",
            "regrDateStr": "2019-12-27",
            "rn": 1,
            "sdType": null,
            "seqGrtId": "360336403",
            "statusMemo": "支付成功",
            "taxPayCode": "91110000100002361J",
            "taxPayName": "中国国投国际贸易有限公司",
            "taxPntPayCode": "1101919076",
            "taxPntPayName": "中国国投国际贸易有限公司",
            "taxStatus": "S",
            "taxStatusName": "支付成功",
            "taxType": "T",
            "taxTypeName": "保证金",
            "tradeCode": "1101919076",
            "tradeName": "中国国投国际贸易有限公司",
            "updateTime": "2019-12-27",
            "updateUser": "8600000097986",
            "zzjgId": "04c0cfc9546b473fac868dfc6c2d1c03"
        },
        {
            "addTimeStr": "2019-12-27 15:47:23",
            "affirmFlag": "",
            "affirmMsgSeq": "",
            "affirmTime": "",
            "agentCode": "4401280139",
            "agentName": "广州益嘉物流有限公司",
            "codeTS": "1520000000",
            "cusSeq": "",
            "dataSrcUnitCode": "SW11000020170725",
            "dealTimeStr": "2019-12-27 17:13:39",
            "declPort": "5212",
            "declPortName": "新沙海关",
            "entryId": "521220191129013648",
            "gName": "粗甘油",
            "genDateStr": "2019-12-27 15:47:24",
            "grtInfoSeqNo": "000000000002174495",
            "guaId": "J52122019100000406",
            "guarEr": "中国国投国际贸易有限公司",
            "id": "bf24eee4651541a1b15a17b437077272",
            "loanInfoId": "",
            "opType": "002",
            "opTypeName": "",
            "optDate": null,
            "optId": "",
            "ownerCode": "1101919076",
            "ownerName": "中国国投国际贸易有限公司",
            "payAcct": "",
            "payOpbkName": "",
            "payStatus": "S",
            "payStatusName": "支付成功",
            "payType": "01",
            "periodStr": "2020-06-27",
            "protocolNo": "5200201801006322",
            "qyId": "f17cd438fb384f3ab6e91172c760d920",
            "reAccount": "321315.8",
            "regrDateStr": "2019-12-27",
            "rn": 2,
            "sdType": null,
            "seqGrtId": "360337181",
            "statusMemo": "支付成功",
            "taxPayCode": "91110000100002361J",
            "taxPayName": "中国国投国际贸易有限公司",
            "taxPntPayCode": "1101919076",
            "taxPntPayName": "中国国投国际贸易有限公司",
            "taxStatus": "S",
            "taxStatusName": "支付成功",
            "taxType": "T",
            "taxTypeName": "保证金",
            "tradeCode": "1101919076",
            "tradeName": "中国国投国际贸易有限公司",
            "updateTime": "2019-12-27",
            "updateUser": "8600000097986",
            "zzjgId": "04c0cfc9546b473fac868dfc6c2d1c03"
        }
    ],
    "totalRows": 1
}