轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
产品 · POST · 请求参数 1 个(必填 1) · 响应参数 18 个
更新日期
2026-11-21

查询 T - Code 申请结果

POST/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&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"
          ]
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1task_no申请接口返回的任务编号string—必填申请接口返回的任务编号;新任务为 UUID 字符串,查询端只校验非空和最大长度。

接口响应参数

序号字段名称类型默认值必填描述
1code业务状态码integer—必填业务状态码
2msg提示消息string操作成功可选提示消息
3request_id请求追踪IDstring—可选请求追踪ID;为空时省略。
4data响应数据object—必填响应数据
4.1task_no查询的任务编号stringc6709f6a-1539-4606-80f0-eb14d062c0b5必填查询的任务编号。
4.2total_count任务下未删除申请记录的条数integer3必填任务下未删除申请记录的条数。
4.3completed_count已结束申请条数integer3必填已结束申请条数,包括失败以及代码已落库的成功/数量不匹配申请。
4.4progressprogressinteger100必填completed_count × 100 / total_count,取整数百分比。
4.5finished当前查询中所有申请均已结束booleantrue必填当前查询中所有申请均已结束;不代表全部成功。
4.6items按申请记录ID升序返回array<object>—必填按申请记录ID升序返回。
4.6.1log_id申请记录IDstring10001必填申请记录ID,以字符串返回,避免大整数精度丢失。
4.6.2apply_statusapply_statusinteger4必填1待处理、2处理中、3失败、4数量匹配成功、5数量不匹配。
4.6.3apply_quantity该条记录的申请数量integer2必填该条记录的申请数量。
4.6.4actual_quantity状态4/5为实际落库数量integer2必填状态4/5为实际落库数量,包含之后软删除的代码,因此可能大于 tcodes 长度;其他状态取申请记录中的返回数量。
4.6.5asinasinstringB0923L1BJ8必填ASIN
4.6.6seller_skuseller_skustringDEMO-SKU必填MSKU
4.6.7error_msg申请记录中的错误信息string—必填申请记录中的错误信息;无错误时为空字符串。
4.6.8tcodes仅返回属于该申请且未删除的已保存代码array<any>["DEMO-TCODE-001","DEMO-TCODE-002"]必填仅返回属于该申请且未删除的已保存代码,按代码记录ID升序。状态4/5可在落库未全部完成时返回部分代码,应结合 finished 判断;其他状态为空数组。

领星ERP的接口:查询 T - Code 申请结果(/erp/sc/routing/transparencyProduct/queryTCodeApplyProgress),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。