/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"
}
]
}
}
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | inbound_order_no | 客户参考号(唯一单号) | string | — | 必填 | 客户参考号(唯一单号) |
| 2 | custom_s_wid | 自定义仓库id | string | — | 可选 | 自定义仓库id,custom_s_wid和s_wid其中一项必填,都填则优先custom_s_wid |
| 3 | s_wid | 发货仓库 | integer | — | 必填 | 发货仓库,仅限本地仓 |
| 4 | r_wid | 收货仓库 | integer | — | 必填 | 收货仓库,仅限海外仓 |
| 5 | logistics_id | 物流方式id | integer | — | 必填 | 物流方式id,查询头程物流渠道列表接口对应字段【id】 (按计费重分摊时,需有传对应物流方式,以获取材积参数用于计算) |
| 6 | status | 订单状态 | integer | — | 可选 | 订单状态:【默认60】 40 待发货 50 待收货 60 已完成 注:收货仓支持三方海外仓的备货单状态只会到待发货 |
| 7 | estimated_time | 预计到货时间 | string | — | 可选 | 预计到货时间 |
| 8 | arrival_time | 实际到货时间 | string | — | 可选 | 实际到货时间 |
| 9 | share_id | 头程费分摊方式 | integer | — | 可选 | 头程费分摊方式:【默认0】 0 按计费重 1 按实重 2 按体积重 3 按SKU数量 4 自定义 5 按箱子体积 注意:生成待发货状态备货单时,需要通过接口上传备货单装箱信息上传箱子信息; 待收货和已完成的订单不支持【上传备货单装箱信息】,无法按箱子体积分摊 |
| 10 | remark | 备注 | string | — | 可选 | 备注 |
| 11 | file_id | 附件id | string | — | 可选 | 附件id |
| 12 | overseas_type | 下单至第三方【默认2】 | integer | — | 可选 | 下单至第三方【默认2】: 1 否,2 是 注:当收货仓为API海外仓时可填,不填默认为是 |
| 13 | real_delivery_time | 实际发货时间 | string | — | 可选 | 实际发货时间 |
| 14 | logistics_list | 物流信息 | array<object> | — | 可选 | 物流信息 |
| 14.1 | logistics_order_no | 物流单号 | string | — | 可选 | 物流单号 |
| 14.2 | logistics_money | 预估物流费用 | string | — | 可选 | 预估物流费用 |
| 14.3 | logistics_money_unit | 预估物流费用币种 | string | — | 可选 | 预估物流费用币种 |
| 14.4 | other_money | 预估其他费用 | string | — | 可选 | 预估其他费用 |
| 14.5 | other_money_unit | 预估其他费用币种 | string | — | 可选 | 预估其他费用币种 |
| 14.6 | track_order_no | 追踪号 | string | — | 可选 | 追踪号 |
| 14.7 | other_money_remark | 预估费用备注 | string | — | 可选 | 预估费用备注 |
| 14.8 | real_logistics_money | 实际物流费用 | number | — | 可选 | 实际物流费用 |
| 14.9 | real_logistics_money_unit | 实际物流费用币种 | string | — | 可选 | 实际物流费用币种 |
| 14.10 | real_other_money | 实际其他费用 | number | — | 可选 | 实际其他费用 |
| 14.11 | real_other_money_unit | 实际其他费用币种 | string | — | 可选 | 实际其他费用币种 |
| 14.12 | real_other_money_remark | 实际其他费用备注 | string | — | 可选 | 实际其他费用备注 |
| 14.13 | wool_id | 物流记录id | integer | — | 可选 | 物流记录id |
| 15 | product_list | 产品信息 | array<object> | — | 必填 | 产品信息 |
| 15.1 | product_id | 本地商品id | integer | — | 必填 | 本地商品id |
| 15.2 | fnsku | fnsku | string | — | 可选 | fnsku |
| 15.3 | tariffs | 报关费用 | number | — | 可选 | 报关费用 |
| 15.4 | tariffs_currency_unit | 报关费用币种 | string | — | 可选 | 报关费用币种 |
| 15.5 | cg_product_gross_weight | 单品净重(G) | number | — | 可选 | 单品净重(G) |
| 15.6 | cg_package_length | 包装规格-长(CM) | number | — | 可选 | 包装规格-长(CM) |
| 15.7 | cg_package_width | 包装规格-宽(CM) | number | — | 可选 | 包装规格-宽(CM) |
| 15.8 | cg_package_height | 包装规格-高(CM) | number | — | 可选 | 包装规格-高(CM) |
| 15.9 | stock_num | 备货数量 | integer | — | 必填 | 备货数量,整箱配对需要乘以配对数量 |
| 15.10 | receive_num | 收货数量(收货数量可以为0) | integer | — | 必填 | 收货数量(收货数量可以为0) |
| 15.11 | oversea_product_code | 三方sku编码 | string | — | 可选 | 三方sku编码,查询系统产品与第三方海外仓产品映射列表接口对应字段【oversea_product_code】 【当仓库是有api海外仓必填】 |
| 15.12 | sid | 店铺id | string | — | 可选 | 店铺id,有fnsku填 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 16 | logistics_list_type | 物流信息版本 | integer | — | 必填 | 物流信息版本:0或者不传:默认旧版物流信息 1:新版物流信息 |
| 17 | head_logistics_list | head_logistics_list | object | — | 必填 | 新版头程物流信息(当logistics_list_type 为1时才有意义) |
| 17.1 | tax_fee_type | 税费分摊方式 | integer | — | 必填 | 税费分摊方式: 0:产品-计费重 1:产品-实重 2:产品-体积重 3:产品-数量 4:自定义 5:箱子-体积) |
| 17.2 | tracking_list | 轨迹信息 | array<object> | — | 必填 | 轨迹信息 |
| 17.2.1 | tracking_no | 查询单号 | string | — | 必填 | 查询单号 |
| 17.2.2 | transport_type | 运输类型 | integer | — | 必填 | 运输类型: 1:快递 2:海运 3:空运 4:其他 |
| 17.2.3 | order_type_code | 单号类型 | integer | — | 必填 | 单号类型:【注意:与运输类型联动关系】 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 | — | 必填 | 承运商【运输类型为海运时才有意义】 |
| 17.2.5 | remark | 备注 | string | — | 必填 | 备注 |
| 17.3 | estimate_expenses_list | 费用明细-预估费用 | object | — | 必填 | 费用明细-预估费用 |
| 17.3.1 | chargeable_weight | 计费重(单位KG) | string | — | 可选 | 计费重(单位KG) |
| 17.3.2 | price | 单价 | string | — | 必填 | 单价 |
| 17.3.3 | price_currency | 单价币种 | string | — | 必填 | 单价币种 |
| 17.3.4 | logistics_fee | 物流费用 | string | — | 必填 | 物流费用 |
| 17.3.5 | logistics_fee_currency | 物流费用币种 | string | — | 必填 | 物流费用币种 |
| 17.3.6 | remark | 备注 | string | — | 可选 | 备注 |
| 17.3.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | 必填 | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 17.3.7.1 | fee_type_id | 其他费id(20位) | string | — | 必填 | 其他费id(20位) |
| 17.3.7.2 | other_amount | 其他费金额 | string | — | 必填 | 其他费金额 |
| 17.3.7.3 | other_currency | 其他费币种 | string | — | 必填 | 其他费币种 |
| 17.4 | actual_expenses_list | 费用明细-实际费用 | object | — | 必填 | 费用明细-实际费用 |
| 17.4.1 | tax_fee | 税费 | string | — | 必填 | 税费 |
| 17.4.2 | tax_fee_currency | 税费币种 | string | — | 必填 | 税费币种 |
| 17.4.3 | chargeable_weight | 计费重 | string | — | 必填 | 计费重 |
| 17.4.4 | price | 单价 | string | — | 必填 | 单价 |
| 17.4.5 | price_currency | 单价币种 | string | — | 必填 | 单价币种 |
| 17.4.6 | logistics_fee | 物流费用 | string | — | 必填 | 物流费用 |
| 17.4.7 | logistics_fee_currency | 物流费用币种 | string | — | 必填 | 物流费用币种 |
| 17.4.8 | remark | 备注 | string | — | 可选 | 备注 |
| 17.4.9 | other_fee_arr | 实际费用-其他费 | array<object> | — | 必填 | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 17.4.9.1 | fee_type_id | 其他费id(20位) | string | — | 必填 | 其他费id(20位) |
| 17.4.9.2 | other_amount | 其他费金额 | string | — | 必填 | 其他费金额 |
| 17.4.9.3 | other_currency | 其他费币种 | string | — | 必填 | 其他费币种 |
| 18 | method_id | method_id | string | — | 可选 | 运输方式 查询运输方式列表接口对应字段【method_id】 |
| 19 | custom_fields | 自定义字段 | object | — | 可选 | 自定义字段 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 信息提示 | string | success | 必填 | 信息提示 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | D17B0688-C52D-1BA9-1BCC-50AA00058A3F | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-08-23 16:56:31 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | overseas_order_no | 系统备货单号 | string | — | 必填 | 系统备货单号 |
| 7 | total | 数据总量 | integer | | 必填 | 数据总量 |
领星ERP的接口:创建待发货/待收货/已完成的备货单(/erp/sc/routing/owms/inbound/createInbound),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。