Lingxing
切换旧版

申请透明计划 T - Code

POST/basicOpen/openapi/transparencyProduct/applyTCode

校验商品和账号后,先保存整批申请记录,随后异步调用亚马逊申请 TCode。成功响应只表示任务记录已创建,不表示亚马逊申请已完成。同一请求内 asin、seller_sku、fnsku 三字段组合不得重复,数量或批次号不同仍视为重复。三个字符串字段不做特殊字符清洗,须与商品数据一致;JSON 中实际反斜杠必须转义为两个反斜杠。跨请求不按该组合去重。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/openapi/transparencyProduct/applyTCodeHTTPSPOST1

请求参数

listarray<object>必填
申请列表;三字段组合不可重复。
隐藏子属性
asinstring
商品 ASIN,须与已存在商品一致;未提供时按空字符串处理。
seller_skustring
MSKU,须与已存在商品一致;未提供时按空字符串处理。特殊字符按 JSON 字符串规则转义,不应直接清洗或替换。
fnskustring
商品 FNSKU;可为空,未提供时按空字符串处理。
quantityinteger必填
申请数量,必须大于0。
keyarray<any>
共享请求 DTO 保留字段,当前申请入口不使用。
lot_numberstring
可选批次号,最多20个字符,仅支持 ASCII 字符;非空时传给亚马逊。
lot_number_typestring
批次号类型:0无、1发货计划、2FBA货件、3发货单、4采购单;可省略。
print_typeinteger
共享请求 DTO 保留字段,当前申请入口不使用。
from_fbaboolean
共享请求 DTO 保留字段,当前申请入口不使用。

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/openapi/transparencyProduct/applyTCode?app_key=value&timestamp=value&sign=value' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <access_token>' \
--data '{
  "list": [
    {
      "asin": "B0923L1BJ8",
      "seller_sku": "DEMO-SKU",
      "fnsku": "X000XF6OGV",
      "quantity": 2,
      "key": [],
      "lot_number": "LOT001",
      "lot_number_type": ""
    }
  ],
  "print_type": 0
}'

返回结果

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

codeinteger必填
业务状态码
msgstring
提示消息
示例 操作成功
request_idstring
请求追踪ID;为空时省略。
dataobject必填
响应数据
隐藏子属性
task_nostring必填
本次整批申请共享的独立任务编号。
示例 c6709f6a-1539-4606-80f0-eb14d062c0b5

返回成功示例

{
  "code": 1,
  "msg": "操作成功",
  "request_id": "",
  "data": {
    "task_no": "c6709f6a-1539-4606-80f0-eb14d062c0b5"
  }
}