/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"
]
}
]
}
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | task_no | 申请接口返回的任务编号 | string | — | 必填 | 申请接口返回的任务编号;新任务为 UUID 字符串,查询端只校验非空和最大长度。 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 业务状态码 | integer | — | 必填 | 业务状态码 |
| 2 | msg | 提示消息 | string | 操作成功 | 可选 | 提示消息 |
| 3 | request_id | 请求追踪ID | string | — | 可选 | 请求追踪ID;为空时省略。 |
| 4 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 4.1 | task_no | 查询的任务编号 | string | c6709f6a-1539-4606-80f0-eb14d062c0b5 | 必填 | 查询的任务编号。 |
| 4.2 | total_count | 任务下未删除申请记录的条数 | integer | 3 | 必填 | 任务下未删除申请记录的条数。 |
| 4.3 | completed_count | 已结束申请条数 | integer | 3 | 必填 | 已结束申请条数,包括失败以及代码已落库的成功/数量不匹配申请。 |
| 4.4 | progress | progress | integer | 100 | 必填 | completed_count × 100 / total_count,取整数百分比。 |
| 4.5 | finished | 当前查询中所有申请均已结束 | boolean | true | 必填 | 当前查询中所有申请均已结束;不代表全部成功。 |
| 4.6 | items | 按申请记录ID升序返回 | array<object> | — | 必填 | 按申请记录ID升序返回。 |
| 4.6.1 | log_id | 申请记录ID | string | 10001 | 必填 | 申请记录ID,以字符串返回,避免大整数精度丢失。 |
| 4.6.2 | apply_status | apply_status | integer | 4 | 必填 | 1待处理、2处理中、3失败、4数量匹配成功、5数量不匹配。 |
| 4.6.3 | apply_quantity | 该条记录的申请数量 | integer | 2 | 必填 | 该条记录的申请数量。 |
| 4.6.4 | actual_quantity | 状态4/5为实际落库数量 | integer | 2 | 必填 | 状态4/5为实际落库数量,包含之后软删除的代码,因此可能大于 tcodes 长度;其他状态取申请记录中的返回数量。 |
| 4.6.5 | asin | asin | string | B0923L1BJ8 | 必填 | ASIN |
| 4.6.6 | seller_sku | seller_sku | string | DEMO-SKU | 必填 | MSKU |
| 4.6.7 | error_msg | 申请记录中的错误信息 | string | — | 必填 | 申请记录中的错误信息;无错误时为空字符串。 |
| 4.6.8 | tcodes | 仅返回属于该申请且未删除的已保存代码 | array<any> | ["DEMO-TCODE-001","DEMO-TCODE-002"] | 必填 | 仅返回属于该申请且未删除的已保存代码,按代码记录ID升序。状态4/5可在落库未全部完成时返回部分代码,应结合 finished 判断;其他状态为空数组。 |
领星ERP的接口:查询 T - Code 申请结果(/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。