税单 (交易接口)
触发税单取数任务
说明:触发税单取数任务。支持按报关单号或按时间范围两种方式。
取数规则:
- 传入
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 | 保留 |