/erp/sc/routing/owms/inbound/updateInbound{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/owms/inbound/updateInbound"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"overseas_order_no": "OWS220624005",
"logistics_id": 35,
"share_id": 1,
"overseas_type": 1,
"arrival_time": "2022-06-24 12:10:25",
"estimated_time": "2022-06-25 12:10:25",
"real_delivery_time": "2022-6-24 12:00:25",
"remark": "999",
"file_id": "",
"logistics_list": [
{
"wool_id": 2949,
"operation_type": 2,
"logistics_money": "77.00",
"logistics_money_unit": "CNY",
"other_money": "5",
"other_money_unit": "CNY",
"other_money_remark": "",
"real_logistics_money": "300.00",
"real_logistics_money_unit": "CNY",
"real_other_money": "10.00",
"real_other_money_unit": "CNY",
"real_other_money_remark": "",
"logistics_order_no": "99",
"track_order_no": "2333"
}
],
"product_list": [
{
"product_id": 2117299,
"product_code": "TESTSKU1",
"cg_package_height": "50.00",
"cg_package_length": "20.00",
"cg_package_width": "10.02",
"cg_product_gross_weight": "20.00",
"fba_cost": "9",
"fba_cost_currency_unit": "CNY",
"tariffs": "8",
"tariffs_currency_unit": "CNY",
"fnsku": "",
"sid": 0,
"stock_num": 7,
"remark": "商品备注999999999999999"
}
],
"logistics_list_type": 0,
"head_logistics_list": {
"tax_fee_type": 1,
"tracking_list": [
{
"tracking_no": "cxdhxxxxxx123",
"transport_type": "1",
"order_type_code": "5",
"shippers": "coscoxxx",
"remark": "备注"
}
],
"estimate_expenses_list": {
"chargeable_weight": "111.00",
"price": "1.00",
"price_currency": "CNY",
"logistics_fee": "1.00",
"logistics_fee_currency": "CNY",
"remark": "预估费用备注",
"other_fee_arr": [
{
"fee_type_id": "241192037543649792",
"other_amount": "1.00",
"other_currency": "CNY"
}
]
},
"actual_expenses_list": {
"tax_fee": "1",
"tax_fee_currency": "CNY",
"chargeable_weight": "111.00",
"price": "111.00",
"price_currency": "CNY",
"logistics_fee": "111.00",
"logistics_fee_currency": "CNY",
"remark": "实际费用备注",
"other_fee_arr": [
{
"fee_type_id": "241192037543649792",
"other_amount": "111.00",
"other_currency": "CNY"
}
]
}
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | overseas_order_no | 海外仓备货单号 | string | — | Required | 海外仓备货单号 |
| 2 | logistics_id | 物流方式id【按计费重分摊时 | integer | — | Optional | 物流方式id【按计费重分摊时,需传对应物流方式,以获取材积参数用于计算】 |
| 3 | product_list | 产品信息 | array<object> | — | Optional | 产品信息 |
| 3.1 | product_id | 本地商品id | integer | — | Optional | 本地商品id |
| 3.2 | fnsku | fnsku | string | — | Optional | fnsku |
| 3.3 | tariffs | 报关费用 | number | — | Optional | 报关费用 |
| 3.4 | tariffs_currency_unit | 报关费用币种 | string | — | Optional | 报关费用币种 |
| 3.5 | cg_product_gross_weight | 单品净重(G) | number | — | Optional | 单品净重(G) |
| 3.6 | cg_package_length | 包装规格-长(CM) | number | — | Optional | 包装规格-长(CM) |
| 3.7 | cg_package_width | 包装规格-宽(CM) | number | — | Optional | 包装规格-宽(CM) |
| 3.8 | cg_package_height | 包装规格-高(CM) | number | — | Optional | 包装规格-高(CM) |
| 3.9 | stock_num | 备货数量 | integer | — | Optional | 备货数量,整箱配对需要乘以配对数量 |
| 3.10 | sid | 店铺id | string | — | Optional | 店铺id,有fnsku填 |
| 3.11 | product_code | 三方产品编码 | string | — | Optional | 三方产品编码 |
| 3.12 | fba_cost | 单位头程费用 | number | — | Optional | 单位头程费用 |
| 3.13 | fba_cost_currency_unit | 单位头程费用币种单位 | string | — | Optional | 单位头程费用币种单位 |
| 3.14 | remark | 商品备注 | string | — | Optional | 商品备注 |
| 4 | estimated_time | 预计到货时间 | string | — | Optional | 预计到货时间 |
| 5 | arrival_time | 实际到货时间 | string | — | Optional | 实际到货时间 |
| 6 | share_id | 头程费分配方式 | integer | — | Optional | 头程费分配方式: 0 按计费重【默认值】 1 按实重 2 按体积重 3 按SKU数量 4自定义 |
| 7 | remark | 备注 | string | — | Optional | 备注 |
| 8 | file_id | 附件id | string | — | Optional | 附件id |
| 9 | overseas_type | 下单至第三方【当收货仓为API海外仓时可填 | integer | — | Optional | 下单至第三方【当收货仓为API海外仓时可填,不填默认为是】:1 否,2 是【默认】 |
| 10 | real_delivery_time | 实际发货时间 | string | — | Optional | 实际发货时间,格式:Y-m-d H:i:s |
| 11 | logistics_list_type | 物流信息版本 | integer | — | Required | 物流信息版本:0或者不传:默认旧版物流信息 1:新版物流信息 |
| 12 | head_logistics_list | head_logistics_list | object | — | Required | 新版头程物流信息(当logistics_list_type 为1时才有意义) |
| 12.1 | tax_fee_type | 税费分摊方式 | integer | — | Required | 税费分摊方式: 0:产品-计费重 1:产品-实重 2:产品-体积重 3:产品-数量 4:自定义 5:箱子-体积) |
| 12.2 | tracking_list | 轨迹信息 | array<object> | — | Required | 轨迹信息 |
| 12.2.1 | tracking_no | 查询单号 | string | — | Required | 查询单号 |
| 12.2.2 | transport_type | 运输类型 | integer | — | Required | 运输类型: 1:快递 2:海运 3:空运 4:其他 |
| 12.2.3 | order_type_code | 单号类型 | integer | — | Required | 单号类型:【注意:与运输类型联动关系】 1:订舱号 2:提单号 3:箱号 4:其他 5:跟踪单号 6:航班号 当transport_type=1时只能传5 当transport_type=2时只能传1、2、3、4 当transport_type=3时只能传2、6 |
| 12.2.4 | shippers | 承运商【运输类型为海运时才有意义】 | string | — | Required | 承运商【运输类型为海运时才有意义】 |
| 12.2.5 | remark | 备注 | string | — | Required | 备注 |
| 12.3 | estimate_expenses_list | 费用明细-预估费用 | object | — | Required | 费用明细-预估费用 |
| 12.3.1 | chargeable_weight | 计费重(单位KG) | string | — | Optional | 计费重(单位KG),已废弃,同页面功能计费重不支持编辑 |
| 12.3.2 | price | 单价 | string | — | Required | 单价 |
| 12.3.3 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 12.3.4 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 12.3.5 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 12.3.6 | remark | 备注 | string | — | Optional | 备注 |
| 12.3.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | Required | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 12.3.7.1 | fee_type_id | 其他费id(20位) | string | — | Required | 其他费id(20位) |
| 12.3.7.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 12.3.7.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 12.4 | actual_expenses_list | 费用明细-实际费用 | object | — | Required | 费用明细-实际费用 |
| 12.4.1 | tax_fee | 税费 | string | — | Required | 税费 |
| 12.4.2 | tax_fee_currency | 税费币种 | string | — | Required | 税费币种 |
| 12.4.3 | chargeable_weight | 计费重 | string | — | Required | 计费重,已废弃,同页面功能计费重不支持编辑 |
| 12.4.4 | price | 单价 | string | — | Required | 单价 |
| 12.4.5 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 12.4.6 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 12.4.7 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 12.4.8 | remark | 备注 | string | — | Optional | 备注 |
| 12.4.9 | other_fee_arr | 实际费用-其他费 | array<object> | — | Required | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 12.4.9.1 | fee_type_id | 其他费id(20位) | string | — | Required | 其他费id(20位) |
| 12.4.9.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 12.4.9.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 13 | logistics_list | 旧版物流信息 | array<object> | — | Optional | 旧版物流信息,即将下线 |
| 13.1 | logistics_order_no | 物流单号 | string | — | Optional | 物流单号 |
| 13.2 | logistics_money | 预估物流费用 | string | — | Optional | 预估物流费用 |
| 13.3 | logistics_money_unit | 预估物流费用币种 | string | — | Optional | 预估物流费用币种 |
| 13.4 | other_money | 预估其他费用 | string | — | Optional | 预估其他费用 |
| 13.5 | other_money_unit | 预估其他费用币种 | string | — | Optional | 预估其他费用币种 |
| 13.6 | track_order_no | 追踪号 | string | — | Optional | 追踪号 |
| 13.7 | other_money_remark | 预估费用备注 | string | — | Optional | 预估费用备注 |
| 13.8 | real_logistics_money | 实际物流费用 | number | — | Optional | 实际物流费用 |
| 13.9 | real_logistics_money_unit | 实际物流费用币种 | string | — | Optional | 实际物流费用币种 |
| 13.10 | real_other_money | 实际其他费用 | number | — | Optional | 实际其他费用 |
| 13.11 | real_other_money_unit | 实际其他费用币种 | string | — | Optional | 实际其他费用币种 |
| 13.12 | real_other_money_remark | 实际其他费用备注 | string | — | Optional | 实际其他费用备注 |
| 13.13 | wool_id | 物流记录id | integer | — | Optional | 物流记录id |
| 13.14 | operation_type | 物流费用操作类型 | integer | — | Optional | 物流费用操作类型:=新增2=修改3=删除 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 信息提示 | string | success | Required | 信息提示 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | D17B0688-C52D-1BA9-1BCC-50AA00058A3F | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-08-23 16:56:31 | Required | 响应时间 |
| 6 | data | 响应数据 | array<any> | | Required | 响应数据 |
The 更新备货单 API (/erp/sc/routing/owms/inbound/updateInbound) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.