# 接口地址
测试环境: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 | |
| 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 | |
| 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 | |
| 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 | |
| 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 | 批次订单信息 |