税单 (交易接口)


触发税单取数任务

说明:触发税单取数任务。支持按报关单号或按时间范围两种方式。

取数规则:

  • 传入 entryId 时:按报关单号调取,忽略 startTime / endTime
  • 未传 entryId 时:按时间范围调取
  • 未支付的税单:以税单生成时间genDate)落在时间范围内为条件
  • 已支付的税单:以银行扣款时间taxDate)落在时间范围内为条件
  • 如果不传时间,默认使用当天时间范围

请求

  • 接口路径:v1/customs-taxation/client-task
  • 请求方法:POST
  • 请求头内容:
    • Content-Type: application/json

按报关单号请求 Body 示例:

{
    "entryId": "XXXXXXXXXXXXXXXXXX"
}

按时间范围请求 Body 示例:

{
    "startTime": 1717171200000,
    "endTime": 1719763199000
}
属性 类型 是否必填 说明
entryId String 非必填 报关单号。传入时按报关单号调取,忽略 startTime / endTime
startTime long 非必填 时间范围开始时间(Epoch毫秒)。仅在未传 entryId 时生效;未传时默认当天开始时间;未支付税单按生成时间过滤,已支付税单按银行扣款时间过滤
endTime long 非必填 时间范围结束时间(Epoch毫秒)。仅在未传 entryId 时生效;未传时默认当天结束时间;未支付税单按生成时间过滤,已支付税单按银行扣款时间过滤

响应

  • HTTP状态: 200 代表调用成功

响应正文:

{
    "success": true,
    "message": "任务已触发",
    "result": null,
    "error": null
}
属性 类型 说明
success Boolean 是否成功触发 true成功 false 失败
message String 失败返回错误消息
result N/A 保留
error N/A 保留