Lingxing
切换旧版

查询 T - Code 申请结果

POST/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/transparencyProduct/queryTCodeApplyProgressHTTPSPOST—

请求参数

task_nostring必填
申请接口返回的任务编号;新任务为 UUID 字符串,查询端只校验非空和最大长度。

请求cURL示例

curl --location 'https://openapi.lingxing.com/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress?app_key=value&timestamp=value&sign=value' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \
--data '{
  "task_no": "c6709f6a-1539-4606-80f0-eb14d062c0b5"
}'

返回结果

HTTP 200 同时承载成功与业务失败;必须读取响应体 code:1 成功,0 失败。

codeinteger必填
业务状态码
msgstring
提示消息
示例 操作成功
request_idstring
请求追踪ID;为空时省略。
dataobject必填
响应数据
隐藏子属性
task_nostring必填
查询的任务编号。
示例 c6709f6a-1539-4606-80f0-eb14d062c0b5
total_countinteger必填
任务下未删除申请记录的条数。
示例 3
completed_countinteger必填
已结束申请条数,包括失败以及代码已落库的成功/数量不匹配申请。
示例 3
progressinteger必填
completed_count × 100 / total_count,取整数百分比。
示例 100
finishedboolean必填
当前查询中所有申请均已结束;不代表全部成功。
示例 true
itemsarray<object>必填
按申请记录ID升序返回。
隐藏子属性
log_idstring必填
申请记录ID,以字符串返回,避免大整数精度丢失。
示例 10001
apply_statusinteger必填
1待处理、2处理中、3失败、4数量匹配成功、5数量不匹配。
示例 4
apply_quantityinteger必填
该条记录的申请数量。
示例 2
actual_quantityinteger必填
状态4/5为实际落库数量,包含之后软删除的代码,因此可能大于 tcodes 长度;其他状态取申请记录中的返回数量。
示例 2
asinstring必填
ASIN
示例 B0923L1BJ8
seller_skustring必填
MSKU
示例 DEMO-SKU
error_msgstring必填
申请记录中的错误信息;无错误时为空字符串。
tcodesarray<any>必填
仅返回属于该申请且未删除的已保存代码,按代码记录ID升序。状态4/5可在落库未全部完成时返回部分代码,应结合 finished 判断;其他状态为空数组。
示例 ["DEMO-TCODE-001","DEMO-TCODE-002"]

返回成功示例

{
  "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"
        ]
      }
    ]
  }
}