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