/erp/sc/routing/storage/shipment/createReadySendOrder{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/storage/shipment/createReadySendOrder"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"sys_wid": 1,
"expected_arrival_date": "",
"etd_date": "",
"eta_date": "",
"delivery_date": "",
"actual_shipment_time": "",
"head_fee_type": 0,
"tax_fee_type": 0,
"is_points_behind": 0,
"points_behind_coeffient": 0,
"logistics_channel_id": 0,
"remark": "",
"is_related": "",
"vat_code": "",
"is_pick": 0,
"logistics_list": [
{
"tracking_number": "",
"replace_tracking_number": "",
"transportation_cost": 0,
"transportation_currency": "",
"other_cost": 0,
"other_currency": "",
"other_cost_remark": "",
"predicted_transportation_cost": 0,
"predicted_transportation_currency": "",
"predicted_other_cost": 0,
"predicted_other_currency": ""
}
],
"list": [
{
"seller_id": "",
"warehouse_seller_id": 0,
"marketplace_id": "",
"shipment_id": "",
"fulfillment_network_sku": "",
"fnsku": "",
"num": 0,
"box_num": 0,
"sku": "",
"tax_currency": "",
"tax_amount": "",
"cg_product_gross_weight": "",
"cg_product_net_weight": "",
"cg_package_length": "",
"cg_package_width": "",
"cg_package_height": "",
"cg_box_weight": "",
"transport_cost": "",
"cg_box_length": "",
"cg_box_width": "",
"cg_box_height": "",
"quantity_in_case": 0,
"remark": ""
}
],
"box_type": "",
"box_remark": "",
"box_list": [
{
"box_num": "3",
"cg_box_length": 20,
"cg_box_width": 30,
"cg_box_height": 40,
"cg_box_weight": 1.33,
"box_skus": [
{
"seller_id": "A1MQMW3JWPNCBX",
"marketplace_id": "xxxxxxxxxxxxxxxx",
"shipment_id": "FBA16XNMN3N4",
"fulfillment_network_sku": "B09MT3989Q",
"quantity_in_case": 32,
"sku": "0530-1"
}
]
}
],
"logistics_list_type": 0,
"head_logistics_list": {
"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",
"weight": "111.00",
"volume": "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 | wid | 自定义仓库 ID | integer | — | Optional | 自定义仓库 ID。wid 和 sys_wid 至少传一个,若都传则优先用 wid。 |
| 2 | sys_wid | 系统仓库 ID | integer | — | Optional | 系统仓库 ID。wid 和 sys_wid 至少传一个,若都传则优先用 wid。多仓库发货时传 -1。 |
| 3 | expected_arrival_date | 预计到达时间 | string | — | Optional | 预计到达时间,格式:Y-m-d |
| 4 | etd_date | 开船时间 | string | — | Optional | 开船时间,格式:Y-m-d |
| 5 | eta_date | 预计到港时间 | string | — | Optional | 预计到港时间,格式:Y-m-d |
| 6 | delivery_date | 实际妥投时间 | string | — | Optional | 实际妥投时间,格式:Y-m-d |
| 7 | actual_shipment_time | 实际发货时间 | string | — | Optional | 实际发货时间,格式:Y-m-d |
| 8 | head_fee_type | 头程费分配方式 | integer | — | Optional | 头程费分配方式:【默认0】 0 按计费重 1 按实重 2 按体积重 3 按SKU数量 4 自定义 5 按箱子体积 |
| 9 | tax_fee_type | 实际税费分配方式 | integer | — | Optional | 实际税费分配方式:【默认0】 0 产品-计费重 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积 |
| 10 | is_points_behind | 是否分抛计算 | integer | — | Optional | 是否分抛计算:0 否,1 是;头程分摊方式为按计费重时用 |
| 11 | points_behind_coeffient | 分抛系数 | integer | — | Optional | 分抛系数:0~100,分抛计算选是时必填 |
| 12 | logistics_channel_id | 物流渠道id | integer | — | Optional | 物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】 |
| 13 | is_related | 是否关联普通商品 | integer | — | Optional | 是否关联普通商品: 0 否 1 是【会拆分组合商品】 |
| 14 | vat_code | 店铺VAT税号 | string | — | Optional | 店铺VAT税号 |
| 15 | is_pick | 是否拣货 | integer | — | Optional | 是否拣货:【默认0】 0 否 1 是 |
| 16 | remark | 备注 | string | — | Optional | 备注 |
| 17 | principal_uids | 负责人UID | array<any> | — | Optional | 负责人UID,来源:查询ERP用户信息列表返回的 data>>uid |
| 18 | ship_mode | 发货方式 | integer | — | Optional | 发货方式:1-默认,2-工厂直发 |
| 19 | hand_pick_purchase | 工厂直发时手动选择出库批次 | integer | — | Optional | 工厂直发时手动选择出库批次:1-否,2-是 |
| 20 | list | list | array<object> | — | Required | |
| 20.1 | seller_id | 亚马逊店铺id | string | — | Required | 亚马逊店铺id |
| 20.2 | warehouse_seller_id | 仓库店铺id | integer | — | Optional | 仓库店铺id |
| 20.3 | marketplace_id | 亚马逊市场id | string | — | Required | 亚马逊市场id,对应查询亚马逊店铺列表接口的marketplace_id字段 |
| 20.4 | shipment_id | 货件单号 | string | — | Required | 货件单号 |
| 20.5 | fulfillment_network_sku | 货件fnsku | string | — | Required | 货件fnsku |
| 20.6 | fnsku | 本地发货的fnsku | string | — | Optional | 本地发货的fnsku,默认空 |
| 20.7 | num | 发货数量 | integer | — | Required | 发货数量 |
| 20.8 | box_num | 箱数 | integer | — | Optional | 箱数 |
| 20.9 | sku | sku | string | — | Required | sku |
| 20.10 | tax_currency | 报关税费币种 | string | — | Optional | 报关税费币种 |
| 20.11 | tax_amount | 税费值 | string | — | Optional | 税费值 |
| 20.12 | cg_product_gross_weight | 采购 | string | — | Optional | 采购:单品毛重(G);不传值则自动取【商品管理】模块维护的SKU“单品毛重”;按计费重分摊时需用到该字段 |
| 20.13 | cg_product_net_weight | 采购 | string | — | Optional | 采购:单品净重(G);不传值则自动取【商品管理】模块维护的SKU“单品净重”; |
| 20.14 | cg_package_length | 采购 | string | — | Optional | 采购:包装规格-长(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-长”;按计费重分摊时需用到该字段 |
| 20.15 | cg_package_width | 采购 | string | — | Optional | 采购:包装规格-宽(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-宽”;按计费重分摊时需用到该字段 |
| 20.16 | cg_package_height | 采购 | string | — | Optional | 采购:包装规格-高(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-高”;按计费重分摊时需用到该字段 |
| 20.17 | cg_box_weight | 采购 | string | — | Optional | 采购:单箱重量(KG);不传值则自动取【商品管理】模块维护的SKU“单箱重量”;按计费重分摊时需用到该字段 |
| 20.18 | transport_cost | 自定义头程费 | string | — | Optional | 自定义头程费,head_fee_type为4才生效 |
| 20.19 | cg_box_length | 箱规-长(CM) | string | — | Optional | 箱规-长(CM) |
| 20.20 | cg_box_width | 箱规-宽(CM) | string | — | Optional | 箱规-宽(CM) |
| 20.21 | cg_box_height | 箱规-高(CM) | string | — | Optional | 箱规-高(CM) |
| 20.22 | quantity_in_case | 单箱数量(PCS) | integer | — | Optional | 单箱数量(PCS) |
| 20.23 | remark | 备注 | string | — | Optional | 备注 |
| 20.24 | purchase_items | 工厂直发手动选择出库批次 | array<object> | — | Optional | 工厂直发手动选择出库批次 |
| 20.24.1 | relation_num | 关联量 | integer | — | Required | 关联量 |
| 20.24.2 | purchase_sn | 系统采购单号 | string | — | Optional | 系统采购单号 |
| 20.24.3 | custom_purchase_sn | 自定义采购单号(无系统采购单号时必填) | string | — | Optional | 自定义采购单号(无系统采购单号时必填) |
| 20.25 | warehouse_items | 多仓发货商品 | array<object> | — | Optional | 多仓发货商品 |
| 20.25.1 | sys_wid | 多仓系统仓库id | integer | — | Optional | 多仓系统仓库id |
| 20.25.2 | warehouse_seller_id | 多仓发货仓库店铺id | integer | — | Optional | 多仓发货仓库店铺id |
| 20.25.3 | warehouse_fnsku | 多仓发货仓库fnsku | string | — | Optional | 多仓发货仓库fnsku |
| 20.25.4 | out_num | 调出量 | integer | — | Optional | 调出量 |
| 21 | box_type | 装箱类型 | string | — | Optional | 装箱类型:SINGLE-每箱只允许一款SKU,MULTIPLE-每箱允许多款SKU |
| 22 | box_remark | 装箱备注 | string | — | Optional | 装箱备注 |
| 23 | box_list | 箱规列表 | array<object> | — | Required | 箱规列表,每个子项代表一个箱规,在装箱类型为MULTIPLE时必填 |
| 23.1 | box_num | 箱子数 | string | — | Required | 箱子数 |
| 23.2 | cg_box_length | 箱子长(CM) | number | — | Required | 箱子长(CM) |
| 23.3 | cg_box_width | 箱子宽(CM) | number | — | Required | 箱子宽(CM) |
| 23.4 | cg_box_height | 箱子高(CM) | number | — | Required | 箱子高(CM) |
| 23.5 | cg_box_weight | 箱子重(KG) | number | — | Required | 箱子重(KG) |
| 23.6 | box_skus | 箱子内包含的SKU信息 | array<object> | — | Required | 箱子内包含的SKU信息,需与list里的数据保持一致 |
| 23.6.1 | seller_id | 亚马逊店铺id | string | — | Required | 亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】 |
| 23.6.2 | marketplace_id | 亚马逊市场id | string | — | Required | 亚马逊市场id |
| 23.6.3 | shipment_id | 货件单号 | string | — | Required | 货件单号 |
| 23.6.4 | fulfillment_network_sku | 货件fnsku | string | — | Required | 货件fnsku |
| 23.6.5 | quantity_in_case | 单箱数量 | number | — | Required | 单箱数量 |
| 23.6.6 | sku | sku | string | — | Required | SKU |
| 24 | logistics_list_type | 物流信息版本 | integer | — | Optional | 物流信息版本: 0 旧版 1 新版 |
| 25 | head_logistics_list | 新版头程物流信息 | object | — | Required | 新版头程物流信息 |
| 25.1 | tracking_list | 轨迹信息数组 | array<object> | — | Optional | 轨迹信息数组 |
| 25.1.1 | tracking_no | 查询单号 | string | — | Optional | 查询单号 |
| 25.1.2 | transport_type | 运输类型 | string | — | Optional | 运输类型: 1 快递 2 海运 3 空运 4 其他 |
| 25.1.3 | order_type_code | 单号类型 | integer | — | Optional | 单号类型:【注意:与运输类型联动关系】 1 订舱号 2 提单号 3 箱号 4 其他 5 跟踪单号 6航班号 当transport_type=1时只能传5 当transport_type=2时只能传1、2、3、4 当transport_type=3时只能传2、6 当transport_type=4只能传空 |
| 25.1.4 | shippers | 承运商 | string | — | Optional | 承运商,运输类型为海运时才有意义: 获取发货单头程物流-承运商信息接口获取 |
| 25.1.5 | remark | 备注 | string | — | Optional | 备注 |
| 25.2 | estimate_expenses_list | 费用明细-预估费用 | object | — | Optional | 费用明细-预估费用 |
| 25.2.1 | chargeable_weight | 计费重(单位KG) | string | — | Optional | 计费重(单位KG) |
| 25.2.2 | price | 单价 | string | — | Required | 单价 |
| 25.2.3 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 25.2.4 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 25.2.5 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 25.2.6 | remark | 备注 | string | — | Optional | 备注 |
| 25.2.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | Required | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 25.2.7.1 | fee_type_id | 其他费id | string | — | Required | 其他费id |
| 25.2.7.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 25.2.7.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 25.3 | actual_expenses_list | 费用明细-实际费用 | object | — | Optional | 费用明细-实际费用 |
| 25.3.1 | tax_fee | 税费 | string | — | Required | 税费 |
| 25.3.2 | tax_fee_currency | 税费币种 | string | — | Required | 税费币种 |
| 25.3.3 | chargeable_weight | 计费重【废弃字段】 | string | — | Required | 计费重【废弃字段】 |
| 25.3.4 | weight | 实重(单位 | string | — | Required | 实重(单位:KG) |
| 25.3.5 | volume | 体积(单位 | string | — | Required | 体积(单位:m³) |
| 25.3.6 | price | 单价 | string | — | Required | 单价 |
| 25.3.7 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 25.3.8 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 25.3.9 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 25.3.10 | remark | 备注 | string | — | Optional | 备注 |
| 25.3.11 | other_fee_arr | 实际费用-其他费 | array<object> | — | Required | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 25.3.11.1 | fee_type_id | 其他费id | string | — | Required | 其他费id |
| 25.3.11.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 25.3.11.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 26 | logistics_list | 旧版物流信息 | array<object> | — | Optional | 旧版物流信息,即将下线 |
| 26.1 | tracking_number | 物流商单号 | string | — | Optional | 物流商单号 |
| 26.2 | replace_tracking_number | 跟踪号 | string | — | Optional | 跟踪号 |
| 26.3 | transportation_cost | 实际物流费用 | number | — | Optional | 实际物流费用 |
| 26.4 | transportation_currency | 实际物流费用币种 | string | — | Optional | 实际物流费用币种 |
| 26.5 | other_cost | 实际其他费用 | number | — | Optional | 实际其他费用 |
| 26.6 | other_currency | 实际其他费用币种 | string | — | Optional | 实际其他费用币种 |
| 26.7 | other_cost_remark | 其他费用备注 | string | — | Optional | 其他费用备注 |
| 26.8 | predicted_transportation_cost | 预估物流费用 | number | — | Optional | 预估物流费用 |
| 26.9 | predicted_transportation_currency | 预估物流费用币种 | string | — | Optional | 预估物流费用币种 |
| 26.10 | predicted_other_cost | 预估其他费用 | number | — | Optional | 预估其他费用 |
| 26.11 | predicted_other_currency | 预估其他费用币种 | string | — | Optional | 预估其他费用币种 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | string | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | C3D9F541-8083-E376-EB5C-606A872F5C89 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-12-08 18:27:13 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | order_sn | 发货单号 | string | | Required | 发货单号 |
The 生成待发货发货单(关联货件) API (/erp/sc/routing/storage/shipment/createReadySendOrder) 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.