# 接口地址

测试环境:https://open-api-test.xhsnw.com (opens new window)

# 商品

# POST 商品查询

POST /product/OpenApi/ProductSku/getProductList

Body 请求参数

{
  "cwSkuCodeList": [],
  "pageSize": "10",
  "pageNo": "1",
  "updateTimeFrom": 1725120000000,
  "updateTimeTo": 1727712000000,
  "cwProviderCode": "XHS",
  "cwProviderName": "芯宏柿",
  "cwCustomCode": "OkWpRpmIGu",
  "cwAppKey": "",
  "cwAccessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiIydVU0VFZ0NGZQcVlKS3dIIiwib2lkIjoxLCJleHAiOjE3MzUzMTM0NzZ9.uhkARndIHjKHAZ6ga9pwuubbjhm_r4e4LQIzxLicxP0",
  "platform": "Temu"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
platform header string 否 none
sellercode header string 否 none
SELLERCODE header string 否 none
body body object 否 none
» cwSkuCodeList body [string] 否 SKU none
» pageSize body integer 是 每页数据条数 none
» pageNo body integer 是 页码 none
» updateTimeFrom body integer 否 更新时间(毫秒) 更新时间大于等于指定时间(updated_at)
» updateTimeTo body integer 否 更新时间(毫秒) 更新时间小于等于指定时间(updated_at)

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727233161,
  "result": {
    "totalCount": 1,
    "skuInfoList": [
      {
        "cwSkuCode": "XH0016-2565484",
        "cnName": "XG墨8-计算器-大号-橄榄绿",
        "name": "2565484",
        "length": "2.00",
        "width": "1.00",
        "height": "2.00",
        "weight": "4.000",
        "specialGoods": [101, 102],
        "cwExtCodeList": [],
        "specification": ""
      }
    ]
  }
}
{
  "success": false,
  "errorCode": 500,
  "errorMsg": "参数错误",
  "serverTime": 1727233269,
  "result": []
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none 系统时间,秒级时间戳
» result object true none none
»» totalCount integer true none 查询结果记录的总数量
»» skuInfoList [object] true none 商品 sku 列表信息
»»» cwSkuCode string false none 商品编码(sku)
»»» cnName string false none 商品中文名称(name_cn)
»»» name string false none 商品英文名称(name_en)
»»» length string false none wms 长度(单位:cm,保留两位小数)(received_length)
»»» width string false none wms 宽度(单位:cm,保留两位小数)(received_width)
»»» height string false none wms 高度(单位:cm,保留两位小数)(received_height)
»»» weight string false none 重量(单位:g,保留两位小数)(received_weight)
»»» specialGoods [integer] false none 特殊货品
101:含有电池(2 带电带磁、3 带电、11 纯电池、16 内置电池);
102:含有液体(12 纯液体、13 带液体、15 少量液体)
103:含有化学品(芯宏无对应字段)
»»» cwExtCodeList [string] false none 商品条码列表
»»» specification string false none 商品规格

# 出库单

# POST temu 发起履约订单

POST /owms/inner/temu/outbound/order/create

Body 请求参数

{
  "batchOrderNo": "string",
  "consignee": {
    "addressLine1": "string",
    "addressLine2": "string",
    "cityName": "string",
    "email": "string",
    "houseNo": "string",
    "mobile": "string",
    "postCode": "string",
    "receiptName": "string",
    "regionCode": "string",
    "stateName": "string"
  },
  "createOrderTs": 0,
  "cwAccessToken": "string",
  "cwCustomCode": "string",
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwWarehouseCode": "string",
  "cwWarehouseRegionCode": "string",
  "interface_type": "string",
  "logisticsProductList": ["string"],
  "orderList": [
    {
      "cwSkuCode": "string",
      "orderSn": "string",
      "qty": 0
    }
  ],
  "platform": "string",
  "scene_id": 0,
  "sign": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» consignee body object 是 none
»» addressLine1 body string 是 none
»» addressLine2 body string 是 none
»» cityName body string 是 none
»» email body string 是 none
»» houseNo body string 是 none
»» mobile body string 是 none
»» postCode body string 是 none
»» receiptName body string 是 none
»» regionCode body string 是 none
»» stateName body string 是 none
» createOrderTs body integer 是 none
» cwAccessToken body string 是 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» cwWarehouseCode body string 是 none
» cwWarehouseRegionCode body string 是 none
» interface_type body string 是 none
» logisticsProductList body [string] 是 物流产品列表 none
» orderList body [object] 是 none
»» cwSkuCode body string 否 none
»» orderSn body string 否 none
»» qty body integer 否 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 出库单费用查询

POST /wfms/OpenApi/OutboundOrder/getFeeDetail

Body 请求参数

{
  "batchOrderNo": "WOXH0038-240919-00001",
  "trackingNumber": ""
}

# 请求参数

名称 位置 类型 必选 中文名 说明
platform header string 否 none
sellercode header string 否 none
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 Temu 批次订单号(卖家订单号)
» trackingNumber body string 否 追踪单号(跟踪号)

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727427454,
  "result": {
    "weight": 120000,
    "length": 1210,
    "width": 1210,
    "height": 1210,
    "volume": 127776000,
    "volumeWeight": 0,
    "chargeWeight": 0,
    "currency": "CNY",
    "totalFee": "0.1406",
    "innerWarehouseFee": "0.1406",
    "tailReturnFee": "0",
    "tailDeliveryFee": "0",
    "tailOtherFee": "0",
    "feeList": [
      {
        "fee": "0",
        "currency": "CNY",
        "feeDesc": "",
        "feeCode": "XH31",
        "platformFeeType": "",
        "feeType": "1"
      },
      {
        "fee": "0.1406",
        "currency": "CNY",
        "feeDesc": "代发用的包材",
        "feeCode": "XH32",
        "platformFeeType": "",
        "feeType": "1"
      }
    ]
  }
}
{
  "success": false,
  "errorCode": 500,
  "errorMsg": "参数错误",
  "serverTime": 1727233269,
  "result": []
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none none
» result object true none none
»» weight integer true none 重量(mg)(出库单称重-重量)
»» length integer true none 长(mm)(出库单称重-长)
»» width integer true none 宽(mm)(出库单称重-宽)
»» height integer true none 高(mm)(出库单称重-高)
»» volume integer true none 体积(mm3)(出库单称重-体积)
»» volumeWeight integer false none 体积重(mm3)
»» chargeWeight integer true none 计费重(mg)
»» currency string true none 币种,默认 USD
»» totalFee string true none 总费用
»» innerWarehouseFee string true none 仓内费用
»» tailReturnFee string false none 尾程退货费用
»» tailDeliveryFee string true none 尾程派送费用(派送费、超长超重、燃油费等)
»» tailOtherFee string true none 尾程其它费用(保险、成人签收等)
»» feeList [object] true none 费用列表
»»» fee string true none 费用金额
»»» currency string true none 币种,默认 USD
»»» feeDesc string true none 费用名称
»»» feeCode string true none 费用项编码
»»» platformFeeType string true none 平台费用类型: 0:基础物流费、1:常规附加 费、2:常规附加费-旺季附加费、3:偏远地区附加 费、 4:住址附加费、5:住址附加费-旺季附加费、6:燃 油附加费、7:其它
»»» feeType string true none 费用类型:库内(1)、尾程派送(2)、尾程退货 (3)、尾程其它(4)

# POST temu 发起履约订单-带面单

POST /owms/inner/temu/outbound/order/createWithLabel

Body 请求参数

{
  "batchOrderNo": "string",
  "consignee": {
    "addressLine1": "string",
    "addressLine2": "string",
    "cityName": "string",
    "email": "string",
    "houseNo": "string",
    "mobile": "string",
    "postCode": "string",
    "receiptName": "string",
    "regionCode": "string",
    "stateName": "string"
  },
  "createOrderTs": 0,
  "cwAccessToken": "string",
  "cwCustomCode": "string",
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwWarehouseCode": "string",
  "cwWarehouseRegionCode": "string",
  "interface_type": "string",
  "logisticsProductList": ["string"],
  "orderList": [
    {
      "cwSkuCode": "string",
      "orderSn": "string",
      "qty": 0
    }
  ],
  "platform": "string",
  "scene_id": 0,
  "sign": "string",
  "carrierName": "string",
  "trackingNumber": "string",
  "shippingLabel": "string",
  "imgType": "string",
  "imgRotateDegree": 0,
  "carrierService": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» consignee body object 是 none
»» addressLine1 body string 是 none
»» addressLine2 body string 是 none
»» cityName body string 是 none
»» email body string 是 none
»» houseNo body string 是 none
»» mobile body string 是 none
»» postCode body string 是 none
»» receiptName body string 是 none
»» regionCode body string 是 none
»» stateName body string 是 none
» createOrderTs body integer 是 none
» cwAccessToken body string 是 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» cwWarehouseCode body string 是 none
» cwWarehouseRegionCode body string 是 none
» interface_type body string 是 none
» logisticsProductList body [string] 是 none
» orderList body [object] 是 none
»» cwSkuCode body string 否 none
»» orderSn body string 否 none
»» qty body integer 否 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none
» carrierName body string 是 物流商名称
» trackingNumber body string 是 运单号
» shippingLabel body string 是 面单图片
» imgType body string 是 面单类型
» imgRotateDegree body integer 是 图片旋转角度
» carrierService body string 是 物流服务

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 取消履约订单

POST /owms/inner/temu/outbound/order/cancel

Body 请求参数

{
  "batchOrderNo": "string",
  "cwAccessToken": "string",
  "cwAppKey": "string",
  "cwCustomCode": "string",
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "interface_type": "string",
  "platform": "string",
  "scene_id": 0,
  "sign": "string",
  "source_app_key": "string",
  "target_app_key": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» cwAccessToken body string 是 none
» cwAppKey body string 是 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» interface_type body string 是 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none
» source_app_key body string 是 none
» target_app_key body string 是 none

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# 库存

# POST 库存查询

POST /ics/OpenApi/Inventory/getInventoryList

对应平台接口路径:/bg/certified/warehouse/inventory/batch/get 接口:bg.certified.warehouse.inventory.batch.get

Body 请求参数

{
  "cwSkuCodeList": ["64"],
  "cwCustomCode": "95"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
Token header string 否 none
PLATFORM header string 是 平台
SELLERCODE header string 是 卖家代码
REGIONCODE header string 是 平台区域
COMPANY header string 是 公司
body body object 否 none
» cwSkuCodeList body [string] 是 仓库商品 sku 仓库 wsku:ics_inventory.sku
» cwCustomCode body string 是 货主 code 开放平台 AppId

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727355168,
  "result": {
    "inventoryInfoMap": {
      "XH0038-10004251": [
        {
          "cwSkuCode": "XH0038-10004251",
          "cwWarehouseCode": "CDMX4",
          "cwWarehouseName": "724",
          "cwWarehouseRegionCode": "MX",
          "inStockQty": 1298,
          "onOrderQty": "0",
          "usableQty": "1287"
        }
      ],
      "XH0038-10004241": [
        {
          "cwSkuCode": "XH0038-10004241",
          "cwWarehouseCode": "CDMX4",
          "cwWarehouseName": "724",
          "cwWarehouseRegionCode": "MX",
          "inStockQty": 12,
          "onOrderQty": "30",
          "usableQty": "8"
        }
      ]
    }
  }
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success string true none 请求是否成功 none
» errorCode string true none 错误码 none
» errorMsg string true none 错误信息 none
» result object true none 返回结果 none
»» inventoryInfoMap object true none none
»»» 商品编码 [object] true none cwSkuCode 仓库 wsku:ics_inventory.sku
»»»» cwSkuCode string true none 商品编码 仓库 wsku:ics_inventory.sku
»»»» cwWarehouseCode string true none 仓库编码 仓库编码:ics_inventory.warehouse_code
»»»» cwWarehouseName string true none 仓库名称 仓库中文名称:ics_warehouse.warehouse_name_zh
»»»» cwWarehouseRegionCode string true none 区域仓编码 平台区域码
»»»» inStockQty string true none 在库总库存 代发可用+不良品+已冻结+待出库:ics_warehouse.(csg_available_qty + csg_defective_qty + csg_frozen_qty + csg_to_be_shipped_qty)
»»»» onOrderQty string true none 在途待入库 代发海外在途:ics_warehouse.csgo_in_transit_qty
»»»» usableQty string true none 可用库存 代发海外可用:ics_warehouse.csg_available_qty
» serverTime string true none 服务器时间,秒级时间戳 当前请求时间戳

# POST 库存流水查询

POST /ics/OpenApi/Inventory/getInventoryFlowList

Body 请求参数

{
  "cwSkuCode": "12",
  "cwWarehouseCode": "9",
  "startTime": "1991-01-04 11:43:35",
  "endTime": "2000-10-30 11:17:23",
  "pageNo": "dolore",
  "pageSize": "esse tempor in est"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
Token header string 否 none
SELLERCODE header string 是 卖家代码
APPID header string 是 AppID
PLATFORM header string 是 平台
REGIONCODE header string 是 平台区域
COMPANY header string 是 公司
body body object 否 none
» cwSkuCode body string 是 仓库商品 sku 仓库 wsku:ics_inventory_flow.sku
» cwWarehouseCode body string 是 对接仓仓库编码 仓库编码:ics_inventory_flow.warehouse_code
» startTime body string 是 起始时间,秒级时间戳 创建开始时间:ics_inventory_flow.created_at
» endTime body string 是 截止时间,秒级时间戳 创建结束时间:ics_inventory_flow.created_at
» pageNo body string 是 页码 none
» pageSize body string 是 每页显示数量 none

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727356919,
  "result": {
    "inventoryChangeList": [
      {
        "uniqueId": "24121255569339137",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-037-21813300616311295",
        "startQty": "459",
        "endQty": "449",
        "changeQty": "-10",
        "changeTime": 1727254385,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24121766058075787",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 110,
        "refNo": "RTAAR-240925-02633",
        "startQty": "449",
        "endQty": "456",
        "changeQty": "+7",
        "changeTime": 1727258280,
        "remark": "退件上架"
      },
      {
        "uniqueId": "24122490389176225",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-05770864744311843",
        "startQty": "456",
        "endQty": "454",
        "changeQty": "-2",
        "changeTime": 1727263806,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24122561153396194",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-05595716348790807111",
        "startQty": "454",
        "endQty": "452",
        "changeQty": "-2",
        "changeTime": 1727264346,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24122671150759880",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-05926269339512197",
        "startQty": "452",
        "endQty": "450",
        "changeQty": "-2",
        "changeTime": 1727265185,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24122837377628151",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 110,
        "refNo": "RTAAR-240925-03053",
        "startQty": "450",
        "endQty": "451",
        "changeQty": "+1",
        "changeTime": 1727266453,
        "remark": "退件上架"
      },
      {
        "uniqueId": "24129757142236808",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-055957163487908072",
        "startQty": "451",
        "endQty": "449",
        "changeQty": "-2",
        "changeTime": 1727319247,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24131408666001335",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-05595716348790807",
        "startQty": "449",
        "endQty": "446",
        "changeQty": "-3",
        "changeTime": 1727331847,
        "remark": "提交出库单"
      },
      {
        "uniqueId": "24131961316102251",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 110,
        "refNo": "RTAAR-240925-03134",
        "startQty": "446",
        "endQty": "447",
        "changeQty": "+1",
        "changeTime": 1727336063,
        "remark": "退件上架"
      },
      {
        "uniqueId": "24132179039972175",
        "cwSkuCode": "75851964",
        "cwWarehouseCode": "CDMX4",
        "platformOpt": false,
        "optType": 130,
        "refNo": "PO-211-06064917688953163",
        "startQty": "447",
        "endQty": "445",
        "changeQty": "-2",
        "changeTime": 1727337725,
        "remark": "提交出库单"
      }
    ],
    "totalCount": 11
  }
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success string true none 请求是否成功 none
» errorCode string true none 错误码 none
» errorMsg string true none 错误信息 none
» result object true none 返回结果 none
»» totalCount string true none 总条数 none
»» inventoryChangeList [object] true none none
»»» uniqueId string true none 流水唯一 id 库存流水雪花 ID:ics_inventory_flow.inventory_flow_id
»»» cwSkuCode string true none 商品编码 仓库 wsku:ics_inventory_flow.sku
»»» cwWarehouseCode string true none 仓库编码 仓库编码:ics_inventory_flow.warehouse_code
»»» platformOpt string true none 是否 temu 平台操作 默认 false
»»» optType string true none 操作类型 流水操作类型:ics_inventory_flow.operation_type 100:入库上架 —— 2:上架、25:无单上架、28:库存转换上架 110:退货上架 —— 19:退件上架、20:退件暂存上架 120:盘盈 —— 9:盘盈 130:平台出库 —— 6:提交出库单 140:非平台出库 —— 14:提交(代转中)、15:提交增值单 150:盘亏 —— 10:盘亏 160:退供出库 —— 无 170:正转残 —— 无 180:残转正 —— 无 190:其它库存增加 —— 12:中转转代发、24:换标增值单完成、16:取消转换单、22:取消增值单 200:其它库存减少 —— 无 201:temu 平台取消库存减增加 —— 8:出库单作废
»»» refNo string true none 操作单号 库存操作类型为:130 和 201 返回卖家订单号,其他对应类型单据号: ics_inventory_flow.associated_order_number
»»» startQty string true none 期初数量 期初库存:ics_inventory_flow.beginning_qty
»»» endQty string true none 期末数量 期末库存:ics_inventory_flow.ending_qty
»»» changeQty string true none 变动数量(正负) 变更数量:ics_inventory_flow.change_qty
»»» changeTime string true none 变动时间,秒级时间戳 创建时间:ics_inventory_flow.created_at
»»» remark string true none 备注,库存变动原因 对应仓库操作类型名称
» serverTime string true none 服务器时间,秒级时间戳 当前请求时间戳

# POST 推送库存变动流水

POST /java/bg/certified/warehouse/inventory/change/push

Body 请求参数

{
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwSkuCode": "string",
  "cwCustomerCode": "string",
  "cwWarehouseCode": "string",
  "platformOpt": 0,
  "uniqueId": "string",
  "optType": "string",
  "refNo": "string",
  "startQty": 0,
  "endQty": 0,
  "changeQty": 0,
  "changeTime": "string",
  "remark": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
APPID header string 否 AppID
PLATFORM header string 否 平台
SELLERCODE header string 否 卖家代码
REGIONCODE header string 否 平台区域码
body body object 否 none
» cwProviderCode body string 是 服务商 code 开放平台填充
» cwProviderName body string 是 服务商名称 开放平台填充
» cwSkuCode body string 是 商品编码 仓库 wsku:ics_inventory_flow.sku
» cwCustomerCode body string 是 货主 code 开放平台 AppId
» cwWarehouseCode body string 是 仓库编码 仓库编码:ics_inventory_flow.warehouse_code
» platformOpt body integer 是 是否 temu 平台操作 默认 false
» uniqueId body string 是 流水唯一 id 库存流水雪花 ID:ics_inventory_flow.inventory_flow_id
» optType body string 是 操作类型 流水操作类型:ics_inventory_flow.operation_type 100:入库上架 —— 2:上架、25:无单上架 110:退货上架 —— 19:退件上架、20:退件暂存上架 120:盘盈 —— 9:盘盈 130:平台出库 —— 6:提交出库单 140:非平台出库 —— 11:代发转中转、24:换标增值单完成 150:盘亏 —— 10:盘亏 160:退供出库 —— 无 170:正转残 —— 无 180:残转正 —— 无 190:其它库存增加 —— 12:中转转代发、24:换标增值单完成 200:其它库存减少 —— 无 201:temu 平台取消库存减增加 —— 8:出库单作废
» refNo body string 是 操作单号 库存操作类型为:130 和 201 返回卖家订单号,其他对应类型单据号: ics_inventory_flow.associated_order_number
» startQty body integer 是 期初数量 期初库存:ics_inventory_flow.beginning_qty
» endQty body integer 是 期末数量 期末库存:ics_inventory_flow.ending_qty
» changeQty body integer 是 变动数量(正负) 变更数量:ics_inventory_flow.change_qty
» changeTime body string 是 变动时间,秒级时间戳 创建时间:ics_inventory_flow.created_at
» remark body string 是 备注,库存变动原因 对应仓库操作类型名称

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727233161,
  "result": {}
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none none
» result object true none none
»» success string true none none
»» errorCode string true none none
»» errorMsg string true none none

# 物流

# POST 批量查询某个仓库支持的物流产品

POST /lims/inner/temu/product/list

Body 请求参数

{
  "cwWarehouseCode": ""
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body TemuProductListReq 否 none

返回示例

{
  "success": false,
  "result": {
    "logisticsProductMap": [
      {
        "crossCountry": false,
        "cwWarehouseCode": "",
        "logisticsProductCode": "",
        "logisticsProductName": ""
      }
    ]
  },
  "errorCode": 0,
  "serverTime": 0
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 费用预估

POST /lims/inner/temu/delivery/fee/calc

Body 请求参数

{
  "cwCustomCode": "{{cwCustomCode}}",
  "cwAccessToken": "{{cwAccessToken}}",
  "cwProviderCode": "66",
  "cwProviderName": "人着张好识低",
  "cwAppKey": "est",
  "platform": "pariatur do qui labore",
  "regionCode": "MX",
  "stateName": "",
  "cityName": "",
  "postCode": "76047",
  "batchGroupId": "1",
  "batchOrderInfoList": [
    {
      "batchId": "1",
      "cwWarehouseCode": "CS009",
      "logisticsProductCode": "1760123609124904964",
      "orderList": [
        {
          "cwSkuCode": "XH0016-1929551",
          "qty": 39
        }
      ]
    }
  ]
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body TemuFeeCalcReq 否 none

返回示例

{
  "success": false,
  "result": null,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 0
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none TemuResult

# 仓库

# POST 获取仓库

POST /ics/OpenApi/Warehouse/getWarehouses

'warehouse_code' => 'cwWarehouseCode', 'warehouse_name_zh' => 'cwWarehouseName', 'warehouse_name_en' => 'cwWarehouseName', 'site_code' => 'cwWarehouseRegionCode', 'province_id' => 'cwWarehouseStateName', 'city' => 'cwWarehouseCityName', 'county' => 'cwWarehouseDistrict', 'postal_code' => 'cwWarehousePostCode', 'contacts_phone' => 'cwWarehousePhone',

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727317394,
  "result": [
    {
      "warehouse_id": "20327124274945864",
      "cwWarehouseCode": "CDMX4",
      "cwWarehouseName": "724yin",
      "cwWarehouseRegionCode": "MX",
      "cwWarehouseStateName": "联邦直辖区",
      "cwWarehouseCityName": "Mexico_City",
      "cwWarehouseDistrict": "Ciudad de México",
      "cwWarehousePostCode": "02300",
      "cwWarehousePhone": "5525100872"
    },
    {
      "warehouse_id": "23781157263072714",
      "cwWarehouseCode": "520521",
      "cwWarehouseName": "shenzhencang",
      "cwWarehouseRegionCode": "444111555",
      "cwWarehouseStateName": "湖南省永州市",
      "cwWarehouseCityName": "2222",
      "cwWarehouseDistrict": "",
      "cwWarehousePostCode": "23223",
      "cwWarehousePhone": "323223"
    }
  ]
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none none
» result [object] true none none
»» warehouse_id string true none none
»» cwWarehouseCode string true none 仓库编码
»» cwWarehouseName string true none 仓库名称
»» cwWarehouseRegionCode string true none 国家二字码
»» cwWarehouseStateName string true none 省/州
»» cwWarehouseCityName string true none 仓库所在城市
»» cwWarehouseDistrict string true none 区/县
»» cwWarehousePostCode string true none 邮编
»» cwWarehousePhone string true none 联系人手机号

# 开放平台接口

# POST 5.1 批量查询某个仓库支持的物流产品

POST /bg/certified/warehouse/logistics/product/list/batch/get

Body 请求参数

{
  "cwProviderCode": "",
  "cwProviderName": "",
  "cwCustomCode": "{{cwCustomCode}}",
  "cwAppKey": "",
  "cwAccessToken": "{{cwAccessToken}}",
  "platform": "Temu",
  "cwWarehouseCode": "cs001"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body TemuProductListReq 否 none

返回示例

{
  "success": false,
  "result": {
    "logisticsProductMap": [
      {
        "crossCountry": false,
        "cwWarehouseCode": "",
        "logisticsProductCode": "",
        "logisticsProductName": ""
      }
    ]
  },
  "errorCode": 0,
  "serverTime": 0
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 4.1 temu 发起履约订单

POST /bg/certified/warehouse/order/create

Body 请求参数

{
  "batchOrderNo": "string",
  "consignee": {
    "addressLine1": "string",
    "addressLine2": "string",
    "cityName": "string",
    "email": "string",
    "houseNo": "string",
    "mobile": "string",
    "postCode": "string",
    "receiptName": "string",
    "regionCode": "string",
    "stateName": "string"
  },
  "createOrderTs": 0,
  "cwAccessToken": "string",
  "cwCustomCode": "string",
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwWarehouseCode": "string",
  "cwWarehouseRegionCode": "string",
  "interface_type": "string",
  "logisticsProductList": ["string"],
  "orderList": [
    {
      "cwSkuCode": "string",
      "orderSn": "string",
      "qty": 0
    }
  ],
  "platform": "string",
  "scene_id": 0,
  "sign": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» consignee body object 是 none
»» addressLine1 body string 是 none
»» addressLine2 body string 是 none
»» cityName body string 是 none
»» email body string 是 none
»» houseNo body string 是 none
»» mobile body string 是 none
»» postCode body string 是 none
»» receiptName body string 是 none
»» regionCode body string 是 none
»» stateName body string 是 none
» createOrderTs body integer 是 none
» cwAccessToken body string 是 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» cwWarehouseCode body string 是 none
» cwWarehouseRegionCode body string 是 none
» interface_type body string 是 none
» logisticsProductList body [string] 是 none
» orderList body [object] 是 none
»» cwSkuCode body string 否 none
»» orderSn body string 否 none
»» qty body integer 否 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 6.1 运费预估

POST /bg/certified/warehouse/delivery/fee/calc

Body 请求参数

{
  "cwCustomCode": "{{cwCustomCode}}",
  "cwAccessToken": "{{cwAccessToken}}",
  "cwProviderCode": "1",
  "cwProviderName": "1",
  "cwAppKey": "",
  "platform": "Temu",
  "stateName": "",
  "cityName": "",
  "regionCode": "MX",
  "postCode": "76047",
  "batchGroupId": "1",
  "batchOrderInfoList": [
    {
      "batchId": "1",
      "cwWarehouseCode": "CS009",
      "logisticsProductCode": "1760123609124904964",
      "orderList": [
        {
          "cwSkuCode": "74197700",
          "qty": 1
        }
      ]
    }
  ]
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body TemuFeeCalcReq 否 none

返回示例

{
  "success": false,
  "result": null,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 0
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 6.3 出库单费用查询

POST /bg/certified/warehouse/outbound/order/fee/get

Body 请求参数

{
  "batchOrderNo": "WOXH0038-240919-00001",
  "trackingNumber": "",
  "cwProviderCode": "",
  "cwProviderName": "",
  "cwCustomCode": "",
  "cwAppKey": "",
  "cwAccessToken": "",
  "platform": ""
}

# 请求参数

名称 位置 类型 必选 中文名 说明
platform header string 否 none
sellercode header string 否 none
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 Temu 批次订单号(卖家订单号)
» trackingNumber body string 是 追踪单号(跟踪号)
» cwProviderCode body string 是 服务商 code
» cwProviderName body string 是 服务商名称
» cwCustomCode body string 是 合作仓仓库的货主 code
» cwAppKey body string 否 合作仓仓库仓库的授权 key
» cwAccessToken body string 是 合作仓仓库仓库的授权 token
» platform body string 是 平台,默认 "Temu"

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727427454,
  "result": {
    "weight": 120000,
    "length": 1210,
    "width": 1210,
    "height": 1210,
    "volume": 127776000,
    "volumeWeight": 0,
    "chargeWeight": 0,
    "currency": "CNY",
    "totalFee": "0.1406",
    "innerWarehouseFee": "0.1406",
    "tailReturnFee": "0",
    "tailDeliveryFee": "0",
    "tailOtherFee": "0",
    "feeList": [
      {
        "fee": "0",
        "currency": "CNY",
        "feeDesc": "",
        "feeCode": "XH31",
        "platformFeeType": "",
        "feeType": "1"
      },
      {
        "fee": "0.1406",
        "currency": "CNY",
        "feeDesc": "代发用的包材",
        "feeCode": "XH32",
        "platformFeeType": "",
        "feeType": "1"
      }
    ]
  }
}
{
  "success": false,
  "errorCode": 500,
  "errorMsg": "参数错误",
  "serverTime": 1727233269,
  "result": []
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none none
» result object true none none
»» weight integer true none 重量(mg)(出库单称重-重量)
»» length integer true none 长(mm)(出库单称重-长)
»» width integer true none 宽(mm)(出库单称重-宽)
»» height integer true none 高(mm)(出库单称重-高)
»» volume integer true none 体积(mm3)(出库单称重-体积)
»» volumeWeight integer false none 体积重(mm3)
»» chargeWeight integer true none 计费重(mg)
»» currency string true none 币种,默认 USD
»» totalFee string true none 总费用
»» innerWarehouseFee string true none 仓内费用
»» tailReturnFee string false none 尾程退货费用
»» tailDeliveryFee string true none 尾程派送费用(派送费、超长超重、燃油费等)
»» tailOtherFee string true none 尾程其它费用(保险、成人签收等)
»» feeList [object] true none 费用列表
»»» fee string true none 费用金额
»»» currency string true none 币种,默认 USD
»»» feeDesc string true none 费用名称
»»» feeCode string true none 费用项编码
»»» platformFeeType string true none 平台费用类型: 0:基础物流费、1:常规附加 费、2:常规附加费-旺季附加费、3:偏远地区附加 费、 4:住址附加费、5:住址附加费-旺季附加费、6:燃 油附加费、7:其它
»»» feeType string true none 费用类型:库内(1)、尾程派送(2)、尾程退货 (3)、尾程其它(4)

# POST 3.1 库存查询

POST /bg/certified/warehouse/inventory/batch/get

Body 请求参数

{
  "cwSkuCodeList": ["XH0038-10004241", "XH0038-10004251"],
  "cwCustomCode": "{{cwCustomCode}}",
  "cwAccessToken": "{{cwAccessToken}}",
  "platform": "Temu"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
Token header string 否 none
Platform header string 是 none
Sellercode header string 是 none
SELLERCODE header string 否 none
body body object 否 none
» cwSkuCodeList body [string] 是 仓库商品 sku 仓库 wsku:ics_inventory.sku
» cwCustomCode body string 是 货主 code none
» cwAccessToken body string 是 合作仓仓库仓库的授权 token none
» cwProviderName body string 是 服务商名称 none
» cwProviderCode body string 是 服务商 code none
» cwAppKey body string 否 合作仓仓库仓库的授权 key none
» platform body string 是 平台,默认 "Temu" none

返回示例

200 Response

{
  "success": "string",
  "errorCode": "string",
  "errorMsg": "string",
  "result": {
    "inventoryInfoMap": {
      "商品编码": [
        {
          "cwSkuCode": "string",
          "cwWarehouseCode": "string",
          "cwWarehouseName": "string",
          "cwWarehouseRegionCode": "string",
          "inStockQty": "string",
          "onOrderQty": "string",
          "usableQty": "string"
        }
      ]
    }
  },
  "serverTime": "string"
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success string true none 请求是否成功 none
» errorCode string true none 错误码 none
» errorMsg string true none 错误信息 none
» result object true none 返回结果 none
»» inventoryInfoMap object true none none
»»» 商品编码 [object] true none wsku none
»»»» cwSkuCode string true none 商品编码 仓库 wsku:ics_inventory.sku
»»»» cwWarehouseCode string true none 仓库编码 仓库编码:ics_inventory.warehouse_code
»»»» cwWarehouseName string true none 仓库名称 仓库中文名称:ics_warehouse.warehouse_name_zh
»»»» cwWarehouseRegionCode string true none 区域仓编码 区域仓编码:ics_warehouse.region_code
»»»» inStockQty string true none 在库总库存 代发可用+不良品+已冻结+待出库:ics_warehouse.(csg_available_qty + csg_defective_qty + csg_frozen_qty + csg_to_be_shipped_qty)
»»»» onOrderQty string true none 在途待入库 代发海外在途:ics_warehouse.csgo_in_transit_qty
»»»» usableQty string true none 可用库存 代发海外可用:ics_warehouse.csg_available_qty
» serverTime string true none 服务器时间,秒级时间戳 当前请求时间戳

# POST 2.1 商品查询

POST /bg/certified/warehouse/skuInfos/list/get

Body 请求参数

{
  "cwSkuCodeList": [],
  "pageSize": "10",
  "pageNo": "1",
  "updateTimeFrom": 1725120000000,
  "updateTimeTo": 1727712000000,
  "cwProviderCode": "XHS",
  "cwProviderName": "芯宏柿",
  "cwCustomCode": "OkWpRpmIGu",
  "cwAppKey": "",
  "cwAccessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiIydVU0VFZ0NGZQcVlKS3dIIiwib2lkIjoxLCJleHAiOjE3MzUzMTM0NzZ9.uhkARndIHjKHAZ6ga9pwuubbjhm_r4e4LQIzxLicxP0",
  "platform": "Temu"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» cwSkuCodeList body [string] 否 SKU none
» pageSize body integer 是 每页数据条数 none
» pageNo body integer 是 页码 none
» updateTimeFrom body integer 否 更新时间(毫秒) 更新时间大于等于指定时间(updated_at)
» updateTimeTo body integer 否 更新时间(毫秒) 更新时间小于等于指定时间(updated_at)
» cwProviderCode body string 是 服务商 code none
» cwProviderName body string 是 服务商名称 none
» cwCustomCode body string 是 仓库的货主 code 对接仓仓库的货主 code
» cwAppKey body string 否 仓库的授权 key 对接仓仓库仓库的授权 key
» cwAccessToken body string 是 仓库的授权 token 对接仓仓库仓库的授权 token
» platform body string 是 平台 默认 "Temu"

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727233161,
  "result": {
    "totalCount": 1,
    "skuInfoList": [
      {
        "csSkuCode": "XH0016-2565484",
        "cnName": "XG墨8-计算器-大号-橄榄绿",
        "name": "2565484",
        "length": "2.00",
        "width": "1.00",
        "height": "2.00",
        "weight": "4.000",
        "specialGoods": [101, 102],
        "cwExtCodeList": [],
        "specification": ""
      }
    ]
  }
}
{
  "success": false,
  "errorCode": 500,
  "errorMsg": "参数错误",
  "serverTime": 1727233269,
  "result": []
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none 系统时间,秒级时间戳
» result object true none none
»» totalCount integer true none 查询结果记录的总数量
»» skuInfoList [object] true none 商品 sku 列表信息
»»» csSkuCode string false none 商品编码(sku)
»»» cnName string false none 商品中文名称(name_cn)
»»» name string false none 商品英文名称(name_en)
»»» length string false none wms 长度(单位:cm,保留两位小数)(received_length)
»»» width string false none wms 宽度(单位:cm,保留两位小数)(received_width)
»»» height string false none wms 高度(单位:cm,保留两位小数)(received_height)
»»» weight string false none 重量(单位:g,保留两位小数)(received_weight)
»»» specialGoods [integer] false none 特殊货品
101:含有电池(2 带电带磁、3 带电、11 纯电池、16 内置电池);
102:含有液体(12 纯液体、13 带液体、15 少量液体)
103:含有化学品(芯宏无对应字段)
»»» cwExtCodeList [string] false none 商品条码列表
»»» specification string false none 商品规格

# POST 获取仓库

POST /bg/certified/warehouse/basic/get

'warehouse_code' => 'cwWarehouseCode', 'warehouse_name_zh' => 'cwWarehouseName', 'warehouse_name_en' => 'cwWarehouseName', 'site_code' => 'cwWarehouseRegionCode', 'province_id' => 'cwWarehouseStateName', 'city' => 'cwWarehouseCityName', 'county' => 'cwWarehouseDistrict', 'postal_code' => 'cwWarehousePostCode', 'contacts_phone' => 'cwWarehousePhone',

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none

返回示例

{
  "success": true,
  "errorCode": 0,
  "errorMsg": "",
  "serverTime": 1727317394,
  "result": [
    {
      "warehouse_id": "20327124274945864",
      "cwWarehouseCode": "CDMX4",
      "cwWarehouseName": "724yin",
      "cwWarehouseRegionCode": "MX",
      "cwWarehouseStateName": "联邦直辖区",
      "cwWarehouseCityName": "Mexico_City",
      "cwWarehouseDistrict": "Ciudad de México",
      "cwWarehousePostCode": "02300",
      "cwWarehousePhone": "5525100872"
    },
    {
      "warehouse_id": "23781157263072714",
      "cwWarehouseCode": "520521",
      "cwWarehouseName": "shenzhencang",
      "cwWarehouseRegionCode": "444111555",
      "cwWarehouseStateName": "湖南省永州市",
      "cwWarehouseCityName": "2222",
      "cwWarehouseDistrict": "",
      "cwWarehousePostCode": "23223",
      "cwWarehousePhone": "323223"
    }
  ]
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success boolean true none none
» errorCode integer true none none
» errorMsg string true none none
» serverTime integer true none none
» result [object] true none none
»» warehouse_id string true none none
»» cwWarehouseCode string true none 仓库编码
»» cwWarehouseName string true none 仓库名称
»» cwWarehouseRegionCode string true none 国家二字码
»» cwWarehouseStateName string true none 省/州
»» cwWarehouseCityName string true none 仓库所在城市
»» cwWarehouseDistrict string true none 区/县
»» cwWarehousePostCode string true none 邮编
»» cwWarehousePhone string true none 联系人手机号

# POST 4.5 temu 发起履约订单-带面单

POST /bg/certified/warehouse/order/createWithLabel

Body 请求参数

{
  "batchOrderNo": "string",
  "consignee": {
    "addressLine1": "string",
    "addressLine2": "string",
    "cityName": "string",
    "email": "string",
    "houseNo": "string",
    "mobile": "string",
    "postCode": "string",
    "receiptName": "string",
    "regionCode": "string",
    "stateName": "string"
  },
  "createOrderTs": 0,
  "cwAccessToken": "string",
  "cwCustomCode": "string",
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwWarehouseCode": "string",
  "cwWarehouseRegionCode": "string",
  "interface_type": "string",
  "logisticsProductList": ["string"],
  "orderList": [
    {
      "cwSkuCode": "string",
      "orderSn": "string",
      "qty": 0
    }
  ],
  "platform": "string",
  "scene_id": 0,
  "sign": "string",
  "carrierName": "string",
  "trackingNumber": "string",
  "shippingLabel": "string",
  "imgType": "string",
  "imgRotateDegree": 0,
  "carrierService": "string"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» consignee body object 是 none
»» addressLine1 body string 是 none
»» addressLine2 body string 是 none
»» cityName body string 是 none
»» email body string 是 none
»» houseNo body string 是 none
»» mobile body string 是 none
»» postCode body string 是 none
»» receiptName body string 是 none
»» regionCode body string 是 none
»» stateName body string 是 none
» createOrderTs body integer 是 none
» cwAccessToken body string 是 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» cwWarehouseCode body string 是 none
» cwWarehouseRegionCode body string 是 none
» interface_type body string 是 none
» logisticsProductList body [string] 是 none
» orderList body [object] 是 none
»» cwSkuCode body string 否 none
»» orderSn body string 否 none
»» qty body integer 否 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none
» carrierName body string 是 物流商名称
» trackingNumber body string 是 运单号
» shippingLabel body string 是 面单图片
» imgType body string 是 面单类型
» imgRotateDegree body integer 是 图片旋转角度
» carrierService body string 是 物流服务

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# POST 3.2 库存流水查询

POST /bg/certified/warehouse/inventory/change/list/get

Body 请求参数

{
  "cwSkuCode": "75851964",
  "cwWarehouseCode": "CDMX4",
  "startTime": "1727193600",
  "endTime": "1727366400",
  "pageNo": "1",
  "pageSize": "10",
  "cwAccessToken": "{{cwAccessToken}}",
  "cwCustomCode": "{{cwCustomCode}}",
  "platform": "Temu"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
Token header string 否 none
Platform header string 是 none
Sellercode header string 是 none
SELLERCODE header string 否 none
body body object 否 none
» cwSkuCode body string 是 仓库商品 sku 仓库 wsku:ics_inventory_flow.sku
» cwWarehouseCode body string 是 对接仓仓库编码 仓库编码:ics_inventory_flow.warehouse_code
» startTime body string 是 起始时间,秒级时间戳 创建开始时间:ics_inventory_flow.created_at
» endTime body string 是 截止时间,秒级时间戳 创建结束时间:ics_inventory_flow.created_at
» pageNo body string 是 页码 none
» pageSize body string 是 每页显示数量 none
» cwAccessToken body string 是 对接仓仓库仓库的授权 token none
» cwCustomCode body string 是 对接仓仓库的货主 code none
» cwProviderCode body string 是 服务商 code none
» cwProviderName body string 是 服务商名称 none
» cwAppKey body string 否 对接仓仓库仓库的授权 key none
» platform body string 是 平台,默认 "Temu" none

返回示例

200 Response

{
  "success": "string",
  "errorCode": "string",
  "errorMsg": "string",
  "result": {
    "totalCount": "string",
    "inventoryChangeList": [
      {
        "uniqueId": "string",
        "cwSkuCode": "string",
        "cwWarehouseCode": "string",
        "platformOpt": "string",
        "optType": "string",
        "refNo": "string",
        "startQty": "string",
        "endQty": "string",
        "changeQty": "string",
        "changeTime": "string",
        "remark": "string"
      }
    ]
  },
  "serverTime": "string"
}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

状态码 200

名称 类型 必选 约束 中文名 说明
» success string true none 请求是否成功 none
» errorCode string true none 错误码 none
» errorMsg string true none 错误信息 none
» result object true none 返回结果 none
»» totalCount string true none 总条数 none
»» inventoryChangeList [object] true none none
»»» uniqueId string true none 流水唯一 id 库存流水雪花 ID:ics_inventory_flow.inventory_flow_id
»»» cwSkuCode string true none 商品编码 仓库 wsku:ics_inventory_flow.sku
»»» cwWarehouseCode string true none 仓库编码 仓库编码:ics_inventory_flow.warehouse_code
»»» platformOpt string true none 是否 temu 平台操作 默认 false
»»» optType string true none 操作类型 流水操作类型:ics_inventory_flow.operation_type 100:入库上架 —— 2:上架、25:无单上架 110:退货上架 —— 19:退件上架、20:退件暂存上架 120:盘盈 —— 9:盘盈 130:平台出库 —— 6:提交出库单 140:非平台出库 —— 11:代发转中转、24:换标增值单完成 150:盘亏 —— 10:盘亏 160:退供出库 —— 无 170:正转残 —— 无 180:残转正 —— 无 190:其它库存增加 —— 12:中转转代发、24:换标增值单完成 200:其它库存减少 —— 无 201:temu 平台取消库存减增加 —— 8:出库单作废
»»» refNo string true none 操作单号 库存操作类型为:130 和 201 返回卖家订单号,其他对应类型单据号: ics_inventory_flow.associated_order_number
»»» startQty string true none 期初数量 期初库存:ics_inventory_flow.beginning_qty
»»» endQty string true none 期末数量 期末库存:ics_inventory_flow.ending_qty
»»» changeQty string true none 变动数量(正负) 变更数量:ics_inventory_flow.change_qty
»»» changeTime string true none 变动时间,秒级时间戳 创建时间:ics_inventory_flow.created_at
»»» remark string true none 备注,库存变动原因 对应仓库操作类型名称
» serverTime string true none 服务器时间,秒级时间戳 当前请求时间戳

# POST 4.2 取消履约订单

POST /bg/certified/warehouse/order/cancel

Body 请求参数

{
  "batchOrderNo": "ex Excepteur laborum nulla",
  "cwAppKey": "quis pariatur in in",
  "cwCustomCode": "{{cwCustomCode}}",
  "cwAccessToken": "{{cwAccessToken}}",
  "cwProviderCode": "17",
  "cwProviderName": "安做法说民由",
  "interface_type": "aliqua ea elit pariatur",
  "platform": "laboris nulla commodo",
  "scene_id": 22,
  "sign": "irure ea",
  "source_app_key": "tempor",
  "target_app_key": "Ut exercitation aliquip"
}

# 请求参数

名称 位置 类型 必选 中文名 说明
SELLERCODE header string 否 none
body body object 否 none
» batchOrderNo body string 是 none
» cwAccessToken body string 是 none
» cwAppKey body string 否 none
» cwCustomCode body string 是 none
» cwProviderCode body string 是 none
» cwProviderName body string 是 none
» interface_type body string 是 none
» platform body string 是 none
» scene_id body integer 是 none
» sign body string 是 none
» source_app_key body string 是 none
» target_app_key body string 是 none

返回示例

200 Response

{}

# 返回结果

状态码 状态码含义 说明 数据模型
200 OK (opens new window) none Inline

# 返回数据结构

# 数据模型

JSONObject

{
  "key": {}
}

# 属性

名称 类型 必选 约束 中文名 说明
key object¦null false none none

TemuProductListReq

{
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwCustomCode": "string",
  "cwAppKey": "string",
  "cwAccessToken": "string",
  "platform": "string",
  "cwWarehouseCode": "string"
}

# 属性

名称 类型 必选 约束 中文名 说明
cwProviderCode string¦null true none 服务商 code
cwProviderName string¦null true none 服务商名称
cwCustomCode string¦null true none 合作仓仓库的货主 code
cwAppKey string¦null false none 合作仓仓库仓库的授权 key
cwAccessToken string¦null false none 合作仓仓库仓库的授权 token
platform string¦null true none 平台,默认 "Temu"
cwWarehouseCode string¦null true none 合作仓的实际仓库代码

LogisticsProductMap

{
  "crossCountry": true,
  "cwWarehouseCode": "string",
  "logisticsProductCode": "string",
  "logisticsProductName": "string"
}

# 属性

名称 类型 必选 约束 中文名 说明
crossCountry boolean¦null false none none
cwWarehouseCode string¦null false none 仓库 code none
logisticsProductCode string¦null false none 渠道 code none
logisticsProductName string¦null false none 渠道名称 none

TemuProductListResp

{
  "logisticsProductMap": {
    "key": [
      {
        "crossCountry": true,
        "cwWarehouseCode": "string",
        "logisticsProductCode": "string",
        "logisticsProductName": "string"
      }
    ]
  }
}

# 属性

名称 类型 必选 约束 中文名 说明
logisticsProductMap Map«List«LogisticsProductMap»» false none none

TemuResult«TemuProductListResp»

{
  "success": true,
  "result": {
    "logisticsProductMap": {
      "key": [
        {
          "crossCountry": true,
          "cwWarehouseCode": "string",
          "logisticsProductCode": "string",
          "logisticsProductName": "string"
        }
      ]
    }
  },
  "errorCode": 0,
  "errorMsg": "string",
  "serverTime": 0
}

# 属性

名称 类型 必选 约束 中文名 说明
success boolean¦null false none none
result TemuProductListResp false none none
errorCode integer¦null false none none
errorMsg string¦null false none none
serverTime integer¦null false none none

key

{
  "crossCountry": true,
  "cwWarehouseCode": "string",
  "logisticsProductCode": "string",
  "logisticsProductName": "string"
}

# 属性

名称 类型 必选 约束 中文名 说明
crossCountry boolean¦null false none none
cwWarehouseCode string¦null false none none
logisticsProductCode string¦null false none none
logisticsProductName string¦null false none none

Map«List«LogisticsProductMap»»

{
  "key": [
    {
      "crossCountry": true,
      "cwWarehouseCode": "string",
      "logisticsProductCode": "string",
      "logisticsProductName": "string"
    }
  ]
}

# 属性

名称 类型 必选 约束 中文名 说明
key [key]¦null false none none

TemuResult«Void»

{
  "success": true,
  "result": null,
  "errorCode": 0,
  "errorMsg": "string",
  "serverTime": 0
}

# 属性

名称 类型 必选 约束 中文名 说明
success boolean¦null false none none
result null¦null false none none
errorCode integer¦null false none none
errorMsg string¦null false none none
serverTime integer¦null false none none

Order

{
  "cwSkuCode": "string",
  "qty": 1
}

# 属性

名称 类型 必选 约束 中文名 说明
cwSkuCode string¦null true none 商品 sku
qty integer¦null true none 商品的 sku 数量

BatchOrderInfo

{
  "batchId": "string",
  "cwWarehouseCode": "string",
  "logisticsProductCode": "string",
  "orderList": [
    {
      "cwSkuCode": "string",
      "qty": 1
    }
  ]
}

# 属性

名称 类型 必选 约束 中文名 说明
batchId string¦null true none 批次 id
cwWarehouseCode string¦null true none 合作仓的实际仓库代码
logisticsProductCode string¦null true none 物流产品 code
orderList [Order]¦null true none 订单列表信息

Object

{}

# 属性

None

TemuResult

{
  "success": true,
  "result": {},
  "errorCode": 0,
  "errorMsg": "string",
  "serverTime": 0
}

# 属性

名称 类型 必选 约束 中文名 说明
success boolean¦null false none none
result Object false none none
errorCode integer¦null false none none
errorMsg string¦null false none none
serverTime integer¦null false none none

TemuFeeCalcReq

{
  "cwProviderCode": "string",
  "cwProviderName": "string",
  "cwCustomCode": "string",
  "cwAppKey": "string",
  "cwAccessToken": "string",
  "platform": "string",
  "regionCode": "string",
  "stateName": "string",
  "cityName": "string",
  "postCode": "string",
  "batchGroupId": "string",
  "batchOrderInfoList": [
    {
      "batchId": "string",
      "cwWarehouseCode": "string",
      "logisticsProductCode": "string",
      "orderList": [
        {
          "cwSkuCode": "string",
          "qty": 1
        }
      ]
    }
  ]
}

# 属性

名称 类型 必选 约束 中文名 说明
cwProviderCode string¦null true none 服务商 code
cwProviderName string¦null true none 服务商名称
cwCustomCode string¦null true none 合作仓仓库的货主 code
cwAppKey string¦null false none 合作仓仓库仓库的授权 key
cwAccessToken string¦null true none 合作仓仓库仓库的授权 token
platform string¦null true none 平台,默认 "Temu"
regionCode string¦null true none 目的区域二字码
stateName string¦null false none 目的地州或省
cityName string¦null false none 目的地城市
postCode string¦null true none 邮编
batchGroupId string¦null true none 批次组 id
batchOrderInfoList [BatchOrderInfo]¦null true none 批次订单信息