查询发票勾选结果
接口描述
查询发票勾选任务的处理结果。调用发票勾选同步超时转异步后(响应 isAsync=true),携带返回的任务号调用本接口获取任务终态。
请求地址
Header 参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
Timestamp | String | 必选 | 公共参数。 |
SecretId | String | 必选 | 公共参数。 |
Signature | String | 必选 | 公共参数。 |
Algorithm | String | 可选 | 公共参数。 |
Content-Type | String | 必选 | 取值:application/json |
Body 请求参数
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
taxpayerNumber | String | 必选 | 纳税人识别号 |
taskId | String | 必选 | 勾选任务号,业务接口转异步响应 data.taskId |
返回参数
公共返回结构
| 参数名称 | 类型 | 说明 |
|---|---|---|
code | Integer | 200 表示请求成功 |
message | String | 错误提示信息,附任务状态中文描述 |
startTime | long | 开始时间 |
endTime | long | 结束时间 |
callId | long | 调用记录标识 |
data | Object | 返回数据 |
isAsync | Boolean | 固定 false(同步返回),任务状态由 data.zt 表达 |
data 内容说明
任务处理结果,关键字段:
| 参数名称 | 类型 | 说明 |
|---|---|---|
zt | String | 任务状态:1-处理中 2-失败 3-成功 |
- | - | 任务完成后的勾选结果字段(含单票结果 cljg 与 message),以实际返回为准 |
任务状态判定
zt=3 任务完成且成功,data 即勾选结果;zt=2 任务失败,单票失败信息看单票 cljg / message;zt=1 处理中,稍后再次查询。