税单 (查询接口)

• 按时间范围查询税单

按时间范围查询税单

按时间范围查询企业的进口税单（关税、增值税及其它税种）。

查询可传入一个时间范围；如果不传时间，默认查询当天数据。平台内部会按支付状态分别用不同的时间字段过滤，再将两部分结果合并返回：

• 未支付的税单：以税单生成时间（genDate）落在时间范围内为条件
• 已支付的税单：以银行扣款时间（taxDate）落在时间范围内为条件

最终返回为以上两部分的合并结果，可通过每条记录的 transStatus 字段区分支付状态。

请求

• 接口路径：v1/customs-taxation/query
• 请求方法：POST
• 成功返回状态码200
• 请求头内容：
  • Content-Type: application/json

请求Body内容：

{
    "startTime": 1717171200000,
    "endTime": 1719763199000,
    "entryId": "",
    "cardOrgCode": ""
}

响应

响应正文：

每一张税单（关税/增值税/其它税种）为一条记录，按报关单可对应多条税单记录。 返回结果同时包含「生成时间在范围内的未支付税单」与「银行扣款时间在范围内的已支付税单」，可通过 transStatus 区分。

[
    {
        "id": "1018425",
        "entryId": "534520231450120479",
        "billNo": "BILL20230001",
        "contrNo": "HT20230001",
        "customMaster": "5345",
        "taxType": "TARIFF",
        "taxName": "关税",
        "taxNo": "53452023T0001",
        "seqNo": "202300000085475001",
        "amt": 1200.50,
        "dutyValue": 100000.00,
        "transStatus": "S",
        "payType": "1",
        "payPlat": "SW",
        "paybkCode": "BK001",
        "paybkName": "中国银行",
        "createUser": "operator01",
        "extendField1": "0",
        "resourceId": "resource-id-check",
        "layoutResourceId": "resource-id-layout",
        "genDate": 1717050000000,
        "limitDate": 1718409600000,
        "taxDate": 1717459200000,
        "items": [
            {
                "goodsNo": 1,
                "codeTs": "8708999990",
                "goodsName": "汽车零件",
                "goodsQty": 10,
                "goodsUnitName": "千克",
                "dutyModeName": "照章征税",
                "tradeCurr": "USD",
                "dutyValue": 100000.00,
                "exchangeRate": 7.1200,
                "rate": 0.1200,
                "qtyRate": null,
                "rateType": "从价",
                "amt": 1200.50,
                "issueDate": 1717050000000
            }
        ]
    },
    {
        "id": "1019870",
        "entryId": "534520231450120512",
        "billNo": "BILL20230002",
        "contrNo": "HT20230002",
        "customMaster": "5345",
        "taxType": "VAT",
        "taxName": "增值税",
        "taxNo": "53452023V0002",
        "seqNo": "202300000085475099",
        "amt": 13000.00,
        "dutyValue": 100000.00,
        "transStatus": "0",
        "payType": null,
        "payPlat": null,
        "paybkCode": null,
        "paybkName": null,
        "createUser": null,
        "extendField1": null,
        "resourceId": "resource-id-check",
        "layoutResourceId": "resource-id-layout",
        "genDate": 1717250000000,
        "limitDate": 1718409600000,
        "taxDate": null,
        "items": [
            {
                "goodsNo": 1,
                "codeTs": "8708999990",
                "goodsName": "汽车零件",
                "goodsQty": 10,
                "goodsUnitName": "千克",
                "dutyModeName": "照章征税",
                "tradeCurr": "USD",
                "dutyValue": 100000.00,
                "exchangeRate": 7.1200,
                "rate": 0.1300,
                "qtyRate": null,
                "rateType": "从价",
                "amt": 13000.00,
                "issueDate": 1717250000000
            }
        ]
    }
]

税单字段：

税单表体字段（items 元素）：