/erp/sc/routing/owms/inbound/createInbound{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/owms/inbound/createInbound"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"inbound_order_no": "20221116161351",
"s_wid": "1",
"r_wid": "3835",
"status": 60,
"estimated_time": "2022-05-11",
"arrival_time": "2022-05-13",
"share_id": "0",
"remark": "备注33",
"file_id": "",
"logistics_id": "35",
"method_id": "241261034153378816",
"logistics_list": [
{
"logistics_order_no": "YT21316212661013364",
"logistics_money": "10",
"logistics_money_unit": "TRY",
"other_money": "9.6",
"other_money_unit": "CNY",
"track_order_no": "H1018660368132401072",
"other_money_remark": "预估备注",
"real_logistics_money": "4",
"real_logistics_money_unit": "CNY",
"real_other_money": "4",
"real_other_money_unit": "CNY",
"real_other_money_remark": "实际备注"
}
],
"product_list": [
{
"product_id": "33664",
"fnsku": "",
"oversea_product_code": "LINGXING-YF",
"tariffs": 1,
"tariffs_currency_unit": "CNY",
"stock_num": "2",
"receive_num": "1",
"cg_product_gross_weight": 1,
"cg_package_length": 1,
"cg_package_width": 2,
"cg_package_height": 4
}
],
"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 | inbound_order_no | 客户参考号(唯一单号) | string | — | Required | 客户参考号(唯一单号) |
| 2 | custom_s_wid | 自定义仓库id | string | — | Optional | 自定义仓库id,custom_s_wid和s_wid其中一项必填,都填则优先custom_s_wid |
| 3 | s_wid | 发货仓库 | integer | — | Required | 发货仓库,仅限本地仓 |
| 4 | r_wid | 收货仓库 | integer | — | Required | 收货仓库,仅限海外仓 |
| 5 | logistics_id | 物流方式id | integer | — | Required | 物流方式id,查询头程物流渠道列表接口对应字段【id】 (按计费重分摊时,需有传对应物流方式,以获取材积参数用于计算) |
| 6 | status | 订单状态 | integer | — | Optional | 订单状态:【默认60】 40 待发货 50 待收货 60 已完成 注:收货仓支持三方海外仓的备货单状态只会到待发货 |
| 7 | estimated_time | 预计到货时间 | string | — | Optional | 预计到货时间 |
| 8 | arrival_time | 实际到货时间 | string | — | Optional | 实际到货时间 |
| 9 | share_id | 头程费分摊方式 | integer | — | Optional | 头程费分摊方式:【默认0】 0 按计费重 1 按实重 2 按体积重 3 按SKU数量 4 自定义 5 按箱子体积 注意:生成待发货状态备货单时,需要通过接口上传备货单装箱信息上传箱子信息; 待收货和已完成的订单不支持【上传备货单装箱信息】,无法按箱子体积分摊 |
| 10 | remark | 备注 | string | — | Optional | 备注 |
| 11 | file_id | 附件id | string | — | Optional | 附件id |
| 12 | overseas_type | 下单至第三方【默认2】 | integer | — | Optional | 下单至第三方【默认2】: 1 否,2 是 注:当收货仓为API海外仓时可填,不填默认为是 |
| 13 | real_delivery_time | 实际发货时间 | string | — | Optional | 实际发货时间 |
| 14 | logistics_list | 物流信息 | array<object> | — | Optional | 物流信息 |
| 14.1 | logistics_order_no | 物流单号 | string | — | Optional | 物流单号 |
| 14.2 | logistics_money | 预估物流费用 | string | — | Optional | 预估物流费用 |
| 14.3 | logistics_money_unit | 预估物流费用币种 | string | — | Optional | 预估物流费用币种 |
| 14.4 | other_money | 预估其他费用 | string | — | Optional | 预估其他费用 |
| 14.5 | other_money_unit | 预估其他费用币种 | string | — | Optional | 预估其他费用币种 |
| 14.6 | track_order_no | 追踪号 | string | — | Optional | 追踪号 |
| 14.7 | other_money_remark | 预估费用备注 | string | — | Optional | 预估费用备注 |
| 14.8 | real_logistics_money | 实际物流费用 | number | — | Optional | 实际物流费用 |
| 14.9 | real_logistics_money_unit | 实际物流费用币种 | string | — | Optional | 实际物流费用币种 |
| 14.10 | real_other_money | 实际其他费用 | number | — | Optional | 实际其他费用 |
| 14.11 | real_other_money_unit | 实际其他费用币种 | string | — | Optional | 实际其他费用币种 |
| 14.12 | real_other_money_remark | 实际其他费用备注 | string | — | Optional | 实际其他费用备注 |
| 14.13 | wool_id | 物流记录id | integer | — | Optional | 物流记录id |
| 15 | product_list | 产品信息 | array<object> | — | Required | 产品信息 |
| 15.1 | product_id | 本地商品id | integer | — | Required | 本地商品id |
| 15.2 | fnsku | fnsku | string | — | Optional | fnsku |
| 15.3 | tariffs | 报关费用 | number | — | Optional | 报关费用 |
| 15.4 | tariffs_currency_unit | 报关费用币种 | string | — | Optional | 报关费用币种 |
| 15.5 | cg_product_gross_weight | 单品净重(G) | number | — | Optional | 单品净重(G) |
| 15.6 | cg_package_length | 包装规格-长(CM) | number | — | Optional | 包装规格-长(CM) |
| 15.7 | cg_package_width | 包装规格-宽(CM) | number | — | Optional | 包装规格-宽(CM) |
| 15.8 | cg_package_height | 包装规格-高(CM) | number | — | Optional | 包装规格-高(CM) |
| 15.9 | stock_num | 备货数量 | integer | — | Required | 备货数量,整箱配对需要乘以配对数量 |
| 15.10 | receive_num | 收货数量(收货数量可以为0) | integer | — | Required | 收货数量(收货数量可以为0) |
| 15.11 | oversea_product_code | 三方sku编码 | string | — | Optional | 三方sku编码,查询系统产品与第三方海外仓产品映射列表接口对应字段【oversea_product_code】 【当仓库是有api海外仓必填】 |
| 15.12 | sid | 店铺id | string | — | Optional | 店铺id,有fnsku填 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 16 | logistics_list_type | 物流信息版本 | integer | — | Required | 物流信息版本:0或者不传:默认旧版物流信息 1:新版物流信息 |
| 17 | head_logistics_list | head_logistics_list | object | — | Required | 新版头程物流信息(当logistics_list_type 为1时才有意义) |
| 17.1 | tax_fee_type | 税费分摊方式 | integer | — | Required | 税费分摊方式: 0:产品-计费重 1:产品-实重 2:产品-体积重 3:产品-数量 4:自定义 5:箱子-体积) |
| 17.2 | tracking_list | 轨迹信息 | array<object> | — | Required | 轨迹信息 |
| 17.2.1 | tracking_no | 查询单号 | string | — | Required | 查询单号 |
| 17.2.2 | transport_type | 运输类型 | integer | — | Required | 运输类型: 1:快递 2:海运 3:空运 4:其他 |
| 17.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 |
| 17.2.4 | shippers | 承运商【运输类型为海运时才有意义】 | string | — | Required | 承运商【运输类型为海运时才有意义】 |
| 17.2.5 | remark | 备注 | string | — | Required | 备注 |
| 17.3 | estimate_expenses_list | 费用明细-预估费用 | object | — | Required | 费用明细-预估费用 |
| 17.3.1 | chargeable_weight | 计费重(单位KG) | string | — | Optional | 计费重(单位KG) |
| 17.3.2 | price | 单价 | string | — | Required | 单价 |
| 17.3.3 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 17.3.4 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 17.3.5 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 17.3.6 | remark | 备注 | string | — | Optional | 备注 |
| 17.3.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | Required | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 17.3.7.1 | fee_type_id | 其他费id(20位) | string | — | Required | 其他费id(20位) |
| 17.3.7.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 17.3.7.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 17.4 | actual_expenses_list | 费用明细-实际费用 | object | — | Required | 费用明细-实际费用 |
| 17.4.1 | tax_fee | 税费 | string | — | Required | 税费 |
| 17.4.2 | tax_fee_currency | 税费币种 | string | — | Required | 税费币种 |
| 17.4.3 | chargeable_weight | 计费重 | string | — | Required | 计费重 |
| 17.4.4 | price | 单价 | string | — | Required | 单价 |
| 17.4.5 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 17.4.6 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 17.4.7 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 17.4.8 | remark | 备注 | string | — | Optional | 备注 |
| 17.4.9 | other_fee_arr | 实际费用-其他费 | array<object> | — | Required | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 17.4.9.1 | fee_type_id | 其他费id(20位) | string | — | Required | 其他费id(20位) |
| 17.4.9.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 17.4.9.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 18 | method_id | method_id | string | — | Optional | 运输方式 查询运输方式列表接口对应字段【method_id】 |
| 19 | custom_fields | 自定义字段 | object | — | Optional | 自定义字段 |
| 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 | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | overseas_order_no | 系统备货单号 | string | — | Required | 系统备货单号 |
| 7 | total | 数据总量 | integer | | Required | 数据总量 |
The 创建待发货/待收货/已完成的备货单 API (/erp/sc/routing/owms/inbound/createInbound) 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.