Qeasy Cloud
Get Started

领星ERP 查询 T - Code 申请结果 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
产品 · POST · 请求参数 1 个(必填 1) · 响应参数 18 个
Updated At
2026-11-21

查询 T - Code 申请结果

POST/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress
Factory
{
  "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&timestamp=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"
          ]
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1task_no申请接口返回的任务编号string—Required申请接口返回的任务编号;新任务为 UUID 字符串,查询端只校验非空和最大长度。

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code业务状态码integer—Required业务状态码
2msg提示消息string操作成功Optional提示消息
3request_id请求追踪IDstring—Optional请求追踪ID;为空时省略。
4data响应数据object—Required响应数据
4.1task_no查询的任务编号stringc6709f6a-1539-4606-80f0-eb14d062c0b5Required查询的任务编号。
4.2total_count任务下未删除申请记录的条数integer3Required任务下未删除申请记录的条数。
4.3completed_count已结束申请条数integer3Required已结束申请条数,包括失败以及代码已落库的成功/数量不匹配申请。
4.4progressprogressinteger100Requiredcompleted_count × 100 / total_count,取整数百分比。
4.5finished当前查询中所有申请均已结束booleantrueRequired当前查询中所有申请均已结束;不代表全部成功。
4.6items按申请记录ID升序返回array<object>—Required按申请记录ID升序返回。
4.6.1log_id申请记录IDstring10001Required申请记录ID,以字符串返回,避免大整数精度丢失。
4.6.2apply_statusapply_statusinteger4Required1待处理、2处理中、3失败、4数量匹配成功、5数量不匹配。
4.6.3apply_quantity该条记录的申请数量integer2Required该条记录的申请数量。
4.6.4actual_quantity状态4/5为实际落库数量integer2Required状态4/5为实际落库数量,包含之后软删除的代码,因此可能大于 tcodes 长度;其他状态取申请记录中的返回数量。
4.6.5asinasinstringB0923L1BJ8RequiredASIN
4.6.6seller_skuseller_skustringDEMO-SKURequiredMSKU
4.6.7error_msg申请记录中的错误信息string—Required申请记录中的错误信息;无错误时为空字符串。
4.6.8tcodes仅返回属于该申请且未删除的已保存代码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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.