/erp/sc/routing/storage/shipment/createReadySendOrderByShipmentPlan{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/storage/shipment/createReadySendOrderByShipmentPlan"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"requestExample": {
"wid": "WH001",
"box_type": "SINGLE",
"plan_list": [
{
"shipment_plan_sn": "R260602006",
"num": 1
}
]
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | wid | 客户仓库编号 | string | — | Optional | 客户仓库编号;wid 与 sys_wid 至少填写一个。 最大长度:16 |
| 2 | sys_wid | 系统仓库 ID | integer | — | Optional | 系统仓库 ID;wid 未填写时必填。 |
| 3 | expected_arrival_date | 预计到货日期 | string | — | Optional | 预计到货日期。 |
| 4 | etd_date | 运输开始时间 | string | — | Optional | 运输开始时间。 |
| 5 | eta_date | 运输到达时间 | string | — | Optional | 运输到达时间。 |
| 6 | delivery_date | delivery_date | string | — | Optional | |
| 7 | head_fee_type | 头程费分配方式 | integer | — | Optional | 头程费分配方式;0=按计费重,1=按实重,2=按体积重,3=按SKU数量,4=自定义,5=按箱子体积。 可选值:0、1、2、3、4、5 |
| 8 | tax_fee_type | 实际税费分配方式 | integer | — | Optional | 实际税费分配方式;0=产品-计费重,1=产品-实重,2=产品-体积重,3=产品-数量,4=自定义,5=箱子-体积。 可选值:0、1、2、3、4、5 |
| 9 | is_points_behind | 是否分抛计算 | integer | — | Optional | 是否分抛计算;0=否,1=是。仅头程费分配方式为按计费重时使用。 可选值:0、1 |
| 10 | points_behind_coeffient | 分抛系数 | integer | — | Optional | 分抛系数;is_points_behind=1 时必填。 最小值:0 最大值:100 |
| 11 | remark | 发货单备注 | string | — | Optional | 发货单备注。 最大长度:1000 |
| 12 | is_related | 是否自动扣减单品库存 | integer | — | Optional | 是否自动扣减单品库存。 可选值:0、1 |
| 13 | is_pick | 是否创建后立即发起拣货 | integer | — | Optional | 是否创建后立即发起拣货。 可选值:0、1 |
| 14 | principal_uids | 发货单负责人 UID 列表 | array<any> | — | Optional | 发货单负责人 UID 列表。 |
| 15 | request_flag | 最大长度 | string | — | Optional | 最大长度:255 |
| 16 | ship_mode | 1=常规发货 | integer | — | Optional | 1=常规发货,2=工厂直发。 可选值:1、2 |
| 17 | hand_pick_purchase | 工厂直发时手动选择采购批次 | integer | — | Optional | 工厂直发时手动选择采购批次,2=是。 可选值:1、2 |
| 18 | logistics_channel_id | 最大长度 | string | — | Optional | 最大长度:255 |
| 19 | head_logistics_list | 新版头程物流信息 | object | — | Optional | 新版头程物流信息。仅支持该字段,不接受 logistics_list_type 和 logistics_list。 |
| 19.1 | tracking_list | 轨迹信息数组 | array<object> | — | Optional | 轨迹信息数组。 |
| 19.1.1 | tracking_no | 查询单号 | string | — | Optional | 查询单号。 |
| 19.1.2 | transport_type | 运输类型 | string | — | Optional | 运输类型;1=快递,2=海运,3=空运,4=其他。 可选值:1、2、3、4 |
| 19.1.3 | order_type_code | 单号类型 | integer | — | Optional | 单号类型;1=订舱号,2=提单号,3=箱号,4=其他,5=跟踪单号,6=航班号。transport_type=1 时只能传5;=2 时只能传1、2、3、4;=3 时只能传2、6;=4 时必须为空。 可选值:1、2、3、4、5、6 |
| 19.1.4 | shippers | 承运商 | string | — | Optional | 承运商;仅海运时有意义,通过“获取发货单头程物流-承运商信息”接口获取。 |
| 19.1.5 | remark | 备注 | string | — | Optional | 备注。 |
| 19.2 | estimate_expenses_list | 费用明细-预估费用 | object | — | Optional | 费用明细-预估费用。 |
| 19.2.1 | chargeable_weight | 计费重 | string | — | Optional | 计费重,单位KG。 |
| 19.2.2 | price | 单价 | string | — | Required | 单价。 |
| 19.2.3 | price_currency | 单价币种 | string | — | Required | 单价币种。 |
| 19.2.4 | logistics_fee | 物流费用 | string | — | Required | 物流费用。 |
| 19.2.5 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种。 |
| 19.2.6 | remark | 备注 | string | — | Optional | 备注。 |
| 19.2.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | Optional | 预估费用-其他费;其他费类型通过“获取发货单头程物流-其他费类型”接口获取。 |
| 19.2.7.1 | fee_type_id | 其他费ID | string | — | Required | 其他费ID。 |
| 19.2.7.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额。 |
| 19.2.7.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种。 |
| 19.3 | actual_expenses_list | 费用明细-实际费用 | object | — | Optional | 费用明细-实际费用。 |
| 19.3.1 | tax_fee | 税费 | string | — | Required | 税费。 |
| 19.3.2 | tax_fee_currency | 税费币种 | string | — | Required | 税费币种。 |
| 19.3.3 | chargeable_weight | 计费重 | string | — | Required | 计费重,废弃字段。 |
| 19.3.4 | weight | 实重 | string | — | Required | 实重,单位KG。 |
| 19.3.5 | volume | 体积 | string | — | Required | 体积,单位m³。 |
| 19.3.6 | price | 单价 | string | — | Required | 单价。 |
| 19.3.7 | price_currency | 单价币种 | string | — | Required | 单价币种。 |
| 19.3.8 | logistics_fee | 物流费用 | string | — | Required | 物流费用。 |
| 19.3.9 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种。 |
| 19.3.10 | remark | 备注 | string | — | Optional | 备注。 |
| 19.3.11 | other_fee_arr | 实际费用-其他费 | array<object> | — | Optional | 实际费用-其他费;其他费类型通过“获取发货单头程物流-其他费类型”接口获取。 |
| 19.3.11.1 | fee_type_id | 其他费ID | string | — | Required | 其他费ID。 |
| 19.3.11.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额。 |
| 19.3.11.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种。 |
| 20 | box_type | 可选值 | string | — | Optional | 可选值:SINGLE、MULTIPLE |
| 21 | box_list | MULTIPLE 时必填 | array<object> | — | Optional | MULTIPLE 时必填;box_skus 只按 shipment_plan_sn 引用 plan_list。 |
| 21.1 | box_num | 最小值 | integer | — | Optional | 最小值:0 |
| 21.2 | cg_box_length | 最小值 | number | — | Optional | 最小值:0 |
| 21.3 | cg_box_width | 最小值 | number | — | Optional | 最小值:0 |
| 21.4 | cg_box_height | 最小值 | number | — | Optional | 最小值:0 |
| 21.5 | cg_box_weight | 最小值 | number | — | Optional | 最小值:0 |
| 21.6 | box_skus | box_skus | array<object> | — | Required | |
| 21.6.1 | shipment_plan_sn | 本次 plan_list 中的计划编号 | string | — | Required | 本次 plan_list 中的计划编号。 最大长度:50 |
| 21.6.2 | quantity_in_case | 最小值 | integer | — | Required | 最小值:1 |
| 22 | plan_list | 发货计划商品列表 | array<object> | — | Required | 发货计划商品列表;shipment_plan_sn 不可重复。 |
| 22.1 | shipment_plan_sn | 发货计划编号 | string | — | Required | 发货计划编号。 最大长度:50 |
| 22.2 | num | 本次发货数量 | integer | — | Required | 本次发货数量;小于计划数量时服务端按拆分计划处理。 最小值:1 |
| 22.3 | warehouse_seller_id | 发货仓店铺 ID | integer | — | Optional | 发货仓店铺 ID;已锁定库存的计划不得修改。 最小值:0 |
| 22.4 | warehouse_fnsku | 仓库 FNSKU | string | — | Optional | 仓库 FNSKU;已锁定库存的计划不得修改。 最大长度:50 |
| 22.5 | cg_product_gross_weight | 未传或为空时使用计划商品毛重 | number | — | Optional | 未传或为空时使用计划商品毛重。 最小值:0 |
| 22.6 | cg_product_net_weight | 未传或为空时使用计划商品净重 | number | — | Optional | 未传或为空时使用计划商品净重。 最小值:0 |
| 22.7 | cg_package_length | 未传或为空时使用计划包装长 | number | — | Optional | 未传或为空时使用计划包装长。 最小值:0 |
| 22.8 | cg_package_width | 未传或为空时使用计划包装宽 | number | — | Optional | 未传或为空时使用计划包装宽。 最小值:0 |
| 22.9 | cg_package_height | 未传或为空时使用计划包装高 | number | — | Optional | 未传或为空时使用计划包装高。 最小值:0 |
| 22.10 | cg_box_weight | 未传或为空时使用计划箱重 | number | — | Optional | 未传或为空时使用计划箱重。 最小值:0 |
| 22.11 | transport_cost | 最小值 | number | — | Optional | 最小值:0 |
| 22.12 | remark | 最大长度 | string | — | Optional | 最大长度:255 |
| 22.13 | purchase_items | 沿用既有发货单采购关联字段 | array<any> | — | Optional | 沿用既有发货单采购关联字段。 |
| 22.14 | warehouse_items | 多仓出库明细 | array<object> | — | Optional | 多仓出库明细。 |
| 22.14.1 | wid | 最大长度 | string | — | Optional | 最大长度:16 |
| 22.14.2 | sys_wid | sys_wid | integer | — | Optional | |
| 22.14.3 | out_num | 最小值 | integer | — | Required | 最小值:1 |
| 22.14.4 | warehouse_seller_id | 最小值 | integer | — | Optional | 最小值:0 |
| 22.14.5 | warehouse_fnsku | 最大长度 | string | — | Optional | 最大长度:50 |
| 22.14.6 | purchase_items | purchase_items | array<any> | — | Optional |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | code | integer | 1 | Required | |
| 2 | msg | msg | string | success | Required | |
| 3 | require_id | require_id | string | — | Optional | |
| 4 | data | data | object | — | Required | |
| 4.1 | order_sn | 新生成的发货单号 | string | — | Required | 新生成的发货单号。 |
The 生成待发货发货单(关联发货计划) API (/erp/sc/routing/storage/shipment/createReadySendOrderByShipmentPlan) 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.