进口税单获取接口 - 开放平台API

此接口支持获取外贸企业自身的进口税单（又称：海关缴款书）数据（含：税单的税单号，缴款单位，合同号，运输工具，填发日期，缴款期限，支付状态，税种（A-关税，L-增值税，U-滞纳金，Y-消费税）、商品等信息），帮助外贸企业实时拿到税单数据，提升工作效率，同时规避税务的风险。

//data加密前的参数
{
"startDate": "",
"endDate": "",
"page": 1,
"pageSize": 10,
"taxId": "",
"daysSFlag": "",
"optStartDate": "2020-01-01",
"optEndDate": "2023-02-17"
}

请求参数

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加密生成的字符串

taxId

string

税单号

可选

税单号不为空，那么按税单查询其它条件可为空否则按条件查询

daysSFlag

string

支付状态

可选

默认为空
11：未支付
12：支付中
13：已支付

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": "x84BC6CQSYUpmhE4SaGrKtIb1co="
    },
    "globalInfo": {
        "appId": "JKSD",
        "version": "V1.0",
        "interfaceCode": "INTAX.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJzdGFydERhdGUiOiIiLCJlbmREYXRlIjoiIiwicGFnZSI6MSwicGFnZVNpemUiOjEwLCJ0YXhJZCI6IiIsImRheXNTRmxhZyI6IiIsIm9wdFN0YXJ0RGF0ZSI6IjIwMjAtMDEtMDEiLCJvcHRFbmREYXRlIjoiMjAyMy0wMi0xNyJ9"
}

//data加密前的参数
{
    "startDate": "",
    "endDate": "",
    "page": 1,
    "pageSize": 10,
    "taxId": "",
    "daysSFlag": "",
    "optStartDate": "2020-01-01",
    "optEndDate": "2023-02-17"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

返回参数

必需

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

totalRows

integer

数据的总条数

必需

result

array [object {75}]

税单列表数据

必需

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功

示例

{
    "data": "eyJyZXN1bHQiOlt7ImFjY291bnQiOiIwMjAwMzE2ODE5M...",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}
//data加密前的数据
{
    "data": {
        "result": [
            {
                "account": "0200316819100041035",
                "agentCode": "1113980001",
                "agentName": "北京陆捷达报关有限公司",
                "bank": "中国工商银行王府井金街支行",
                "billNo": "99911605484_JIT11992",
                "budgetClass": " ",
                "capital": "壹万陆仟柒佰柒拾肆元柒角玖分",
                "checkFlag": " ",
                "contrNo": "4100174197 4100178419 4100181249",
                "customsId": "2233",
                "customsName": "浦东机场",
                "cutMode": "101",
                "cutModeName": "一般征税",
                "daysSFlag": "13",
                "declPort": "0101",
                "declPortName": "京机场关",
                "detailList": [
                    {
                        "cjbz": "502",
                        "clsl": "0",
                        "cmcode": "8504409999",
                        "cmname": "电源输出控制单元",
                        "dutyMode": "1",
                        "dutyModeName": "照章征税",
                        "dutyValue": "34609",
                        "entryId": "010120211000123299",
                        "hNo": "1",
                        "qnt": "2",
                        "rateType": "0",
                        "tax": "5475.49",
                        "taxHeadSeqNo": "000000000510101363",
                        "taxId": "010120211000123299-L02",
                        "taxRate": ".13",
                        "unit": "007",
                        "unitName": " ",
                        "valoremRate": 0.13,
                        "whzsl": "6.4391"
                    },
                    {
                        "cjbz": "502",
                        "clsl": "0",
                        "cmcode": "8481100090",
                        "cmname": "泄压阀",
                        "dutyMode": "1",
                        "dutyModeName": "照章征税",
                        "dutyValue": "56755",
                        "entryId": "010120211000123299",
                        "hNo": "2",
                        "qnt": "28",
                        "rateType": "0",
                        "tax": "8484.87",
                        "taxHeadSeqNo": "000000000510101363",
                        "taxId": "010120211000123299-L02",
                        "taxRate": ".13",
                        "unit": "006",
                        "unitName": " ",
                        "valoremRate": 0.13,
                        "whzsl": "6.4391"
                    },
                    {
                        "cjbz": "502",
                        "clsl": "0",
                        "cmcode": "8307100000",
                        "cmname": "氦气管路",
                        "dutyMode": "1",
                        "dutyModeName": "照章征税",
                        "dutyValue": "18347",
                        "entryId": "010120211000123299",
                        "hNo": "3",
                        "qnt": "4",
                        "rateType": "0",
                        "tax": "2814.43",
                        "taxHeadSeqNo": "000000000510101363",
                        "taxId": "010120211000123299-L02",
                        "taxRate": ".13",
                        "unit": "035",
                        "unitName": " ",
                        "valoremRate": 0.13,
                        "whzsl": "6.4391"
                    }
                ],
                "dutyEr": " ",
                "entryId": "010120211000123299",
                "extendField1": "COLLPAY",
                "genDateStr": "2021-03-04 10:24:33",
                "goodsName": "泄压阀",
                "iEDate": "2021-03-01 00:00:00",
                "iEFlag": "I",
                "iEFlagName": "进口",
                "id": "fead99dff3d84f25ad6d5df6f1428e7b",
                "incomeBankCode": " ",
                "incomeBankName": " ",
                "incomeName": "中央金库",
                "incomeSys": "税务系统",
                "interestDays": " ",
                "jckrq": null,
                "mzxz": " ",
                "newPayerCode2": "1113210076",
                "newPayerName2": "北京北方华创微电子装备有限公司",
                "newSendTimeStr": " ",
                "newStatus": "0",
                "newTradeMode": null,
                "notes": " ",
                "ownerCode": "1113210076",
                "ownerName": "北京北方华创微电子装备有限公司",
                "pDate": "2021-03-10",
                "pLimit": " ",
                "payStatus": "S",
                "payerBank": "中国工商银行总行",
                "payerCode": "1113210076",
                "payerName": "北京北方华创微电子装备有限公司",
                "printDateStr": " ",
                "procDesc": "银行扣税成功，海关核注成功",
                "protocolNo": "0100201801010701",
                "realTax": "16774.79",
                "rechkEr": " ",
                "rn": 1,
                "seqNo": "000000000510101363",
                "sfhdwdm": "1113210076",
                "sfhdwmc": "北京北方华创微电子装备有限公司",
                "subjectName": " ",
                "swTaxId": "510297173",
                "sz": "L",
                "szName": "进口增值税",
                "taxHeadSeqNo": "000000000510101363",
                "taxId": "010120211000123299-L02",
                "taxPntPayCode": "1113210076",
                "taxPntPayName": "北京北方华创微电子装备有限公司",
                "taxTotal": "16774.79",
                "taxvouNo": "02",
                "taxyRgNo": " ",
                "tbsbz": " ",
                "tradeCode": "1113210076",
                "tradeMode": "0110",
                "tradeModeName": "一般贸易",
                "trafName": " ",
                "type": "3",
                "updateTimeStr": "2021-03-10 09:28:59",
                "zbznbz": " "
            }
        ],
        "totalRows": 1
    },
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}