/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"requestExample": "curl --location 'https://openapi.lingxing.com/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress?app_key=value×tamp=value&sign=value' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer <access_token>' \\\n--data '{\n \"task_no\": \"c6709f6a-1539-4606-80f0-eb14d062c0b5\"\n}'",
"responseExample": {
"code": 1,
"msg": "操作成功",
"request_id": "",
"data": {
"task_no": "c6709f6a-1539-4606-80f0-eb14d062c0b5",
"total_count": 1,
"completed_count": 1,
"progress": 100,
"finished": true,
"items": [
{
"log_id": "10001",
"apply_status": 4,
"apply_quantity": 2,
"actual_quantity": 2,
"asin": "B0923L1BJ8",
"seller_sku": "DEMO-SKU",
"error_msg": "",
"tcodes": [
"DEMO-TCODE-001",
"DEMO-TCODE-002"
]
}
]
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | task_no | 申请接口返回的任务编号 | string | — | Required | 申请接口返回的任务编号;新任务为 UUID 字符串,查询端只校验非空和最大长度。 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 业务状态码 | integer | — | Required | 业务状态码 |
| 2 | msg | 提示消息 | string | 操作成功 | Optional | 提示消息 |
| 3 | request_id | 请求追踪ID | string | — | Optional | 请求追踪ID;为空时省略。 |
| 4 | data | 响应数据 | object | — | Required | 响应数据 |
| 4.1 | task_no | 查询的任务编号 | string | c6709f6a-1539-4606-80f0-eb14d062c0b5 | Required | 查询的任务编号。 |
| 4.2 | total_count | 任务下未删除申请记录的条数 | integer | 3 | Required | 任务下未删除申请记录的条数。 |
| 4.3 | completed_count | 已结束申请条数 | integer | 3 | Required | 已结束申请条数,包括失败以及代码已落库的成功/数量不匹配申请。 |
| 4.4 | progress | progress | integer | 100 | Required | completed_count × 100 / total_count,取整数百分比。 |
| 4.5 | finished | 当前查询中所有申请均已结束 | boolean | true | Required | 当前查询中所有申请均已结束;不代表全部成功。 |
| 4.6 | items | 按申请记录ID升序返回 | array<object> | — | Required | 按申请记录ID升序返回。 |
| 4.6.1 | log_id | 申请记录ID | string | 10001 | Required | 申请记录ID,以字符串返回,避免大整数精度丢失。 |
| 4.6.2 | apply_status | apply_status | integer | 4 | Required | 1待处理、2处理中、3失败、4数量匹配成功、5数量不匹配。 |
| 4.6.3 | apply_quantity | 该条记录的申请数量 | integer | 2 | Required | 该条记录的申请数量。 |
| 4.6.4 | actual_quantity | 状态4/5为实际落库数量 | integer | 2 | Required | 状态4/5为实际落库数量,包含之后软删除的代码,因此可能大于 tcodes 长度;其他状态取申请记录中的返回数量。 |
| 4.6.5 | asin | asin | string | B0923L1BJ8 | Required | ASIN |
| 4.6.6 | seller_sku | seller_sku | string | DEMO-SKU | Required | MSKU |
| 4.6.7 | error_msg | 申请记录中的错误信息 | string | — | Required | 申请记录中的错误信息;无错误时为空字符串。 |
| 4.6.8 | tcodes | 仅返回属于该申请且未删除的已保存代码 | array<any> | ["DEMO-TCODE-001","DEMO-TCODE-002"] | Required | 仅返回属于该申请且未删除的已保存代码,按代码记录ID升序。状态4/5可在落库未全部完成时返回部分代码,应结合 finished 判断;其他状态为空数组。 |
The 查询 T - Code 申请结果 API (/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.