Lingxing
切换旧版

生成待发货发货单(关联货件)

POST/erp/sc/routing/storage/shipment/createReadySendOrder

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/shipment/createReadySendOrderHTTPSPOST1

请求参数

widinteger
自定义仓库 ID。wid 和 sys_wid 至少传一个，若都传则优先用 wid。
sys_widinteger
系统仓库 ID。wid 和 sys_wid 至少传一个，若都传则优先用 wid。多仓库发货时传 -1。
expected_arrival_datestring
预计到达时间，格式：Y-m-d
etd_datestring
开船时间，格式：Y-m-d
eta_datestring
预计到港时间，格式：Y-m-d
delivery_datestring
实际妥投时间，格式：Y-m-d
actual_shipment_timestring
实际发货时间，格式：Y-m-d
head_fee_typeinteger
头程费分配方式：【默认0】
0 按计费重
1 按实重
2 按体积重
3 按SKU数量
4 自定义
5 按箱子体积
tax_fee_typeinteger
实际税费分配方式：【默认0】
0 产品-计费重
1 产品-实重
2 产品-体积重
3 产品-数量
4 自定义
5 箱子-体积
is_points_behindinteger
是否分抛计算：0 否，1 是；头程分摊方式为按计费重时用
points_behind_coeffientinteger
分抛系数：0~100,分抛计算选是时必填
logistics_channel_idinteger
物流渠道id：按计费重分摊时必填，以获取材积参数用于计算
查询头程物流渠道列表接口对应字段【id】
is_relatedinteger
是否关联普通商品：
0 否
1 是【会拆分组合商品】
vat_codestring
店铺VAT税号
is_pickinteger
是否拣货：【默认0】
0 否
1 是
remarkstring
备注
principal_uidsarray<any>
负责人UID，来源：查询ERP用户信息列表返回的 data>>uid
ship_modeinteger
发货方式：1-默认，2-工厂直发
hand_pick_purchaseinteger
工厂直发时手动选择出库批次：1-否，2-是
listarray<object>必填
隐藏子属性
seller_idstring必填
亚马逊店铺id
warehouse_seller_idinteger
仓库店铺id
marketplace_idstring必填
亚马逊市场id，对应查询亚马逊店铺列表接口的marketplace_id字段
shipment_idstring必填
货件单号
fulfillment_network_skustring必填
货件fnsku
fnskustring
本地发货的fnsku，默认空
numinteger必填
发货数量
box_numinteger
箱数
skustring必填
sku
tax_currencystring
报关税费币种
tax_amountstring
税费值
cg_product_gross_weightstring
采购：单品毛重（G）；不传值则自动取【商品管理】模块维护的SKU“单品毛重”；按计费重分摊时需用到该字段
cg_product_net_weightstring
采购：单品净重（G）；不传值则自动取【商品管理】模块维护的SKU“单品净重”；
cg_package_lengthstring
采购：包装规格-长（CM）；不传值则自动取【商品管理】模块维护的SKU“包装规格-长”；按计费重分摊时需用到该字段
cg_package_widthstring
采购：包装规格-宽（CM）；不传值则自动取【商品管理】模块维护的SKU“包装规格-宽”；按计费重分摊时需用到该字段
cg_package_heightstring
采购：包装规格-高（CM）；不传值则自动取【商品管理】模块维护的SKU“包装规格-高”；按计费重分摊时需用到该字段
cg_box_weightstring
采购：单箱重量（KG）；不传值则自动取【商品管理】模块维护的SKU“单箱重量”；按计费重分摊时需用到该字段
transport_coststring
自定义头程费，head_fee_type为4才生效
cg_box_lengthstring
箱规-长（CM）
cg_box_widthstring
箱规-宽（CM）
cg_box_heightstring
箱规-高（CM）
quantity_in_caseinteger
单箱数量（PCS）
remarkstring
备注
purchase_itemsarray<object>
工厂直发手动选择出库批次
隐藏子属性
relation_numinteger必填
关联量
purchase_snstring
系统采购单号
custom_purchase_snstring
自定义采购单号(无系统采购单号时必填)
warehouse_itemsarray<object>
多仓发货商品
隐藏子属性
sys_widinteger
多仓系统仓库id
warehouse_seller_idinteger
多仓发货仓库店铺id
warehouse_fnskustring
多仓发货仓库fnsku
out_numinteger
调出量
box_typestring
装箱类型：SINGLE-每箱只允许一款SKU，MULTIPLE-每箱允许多款SKU
box_remarkstring
装箱备注
box_listarray<object>必填
箱规列表，每个子项代表一个箱规，在装箱类型为MULTIPLE时必填
隐藏子属性
box_numstring必填
箱子数
cg_box_lengthnumber必填
箱子长（CM）
cg_box_widthnumber必填
箱子宽（CM）
cg_box_heightnumber必填
箱子高（CM）
cg_box_weightnumber必填
箱子重（KG）
box_skusarray<object>必填
箱子内包含的SKU信息，需与list里的数据保持一致
隐藏子属性
seller_idstring必填
亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】
marketplace_idstring必填
亚马逊市场id
shipment_idstring必填
货件单号
fulfillment_network_skustring必填
货件fnsku
quantity_in_casenumber必填
单箱数量
skustring必填
SKU
logistics_list_typeinteger
物流信息版本：
0 旧版
1 新版
head_logistics_listobject必填
新版头程物流信息
隐藏子属性
tracking_listarray<object>
轨迹信息数组
隐藏子属性
tracking_nostring
查询单号
transport_typestring
运输类型：
1 快递
2 海运
3 空运
4 其他
order_type_codeinteger
单号类型：【注意：与运输类型联动关系】
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只能传空
shippersstring
承运商，运输类型为海运时才有意义：
获取发货单头程物流-承运商信息接口获取
remarkstring
备注
estimate_expenses_listobject
费用明细-预估费用
隐藏子属性
chargeable_weightstring
计费重(单位KG)
pricestring必填
单价
price_currencystring必填
单价币种
logistics_feestring必填
物流费用
logistics_fee_currencystring必填
物流费用币种
remarkstring
备注
other_fee_arrarray<object>必填
预估费用-其他费：
获取发货单头程物流-其他费类型接口获取
隐藏子属性
fee_type_idstring必填
其他费id
other_amountstring必填
其他费金额
other_currencystring必填
其他费币种
actual_expenses_listobject
费用明细-实际费用
隐藏子属性
tax_feestring必填
税费
tax_fee_currencystring必填
税费币种
chargeable_weightstring必填
计费重【废弃字段】
weightstring必填
实重（单位：KG）
volumestring必填
体积（单位：m³）
pricestring必填
单价
price_currencystring必填
单价币种
logistics_feestring必填
物流费用
logistics_fee_currencystring必填
物流费用币种
remarkstring
备注
other_fee_arrarray<object>必填
实际费用-其他费：
获取发货单头程物流-其他费类型接口获取
隐藏子属性
fee_type_idstring必填
其他费id
other_amountstring必填
其他费金额
other_currencystring必填
其他费币种
logistics_listarray<object>
旧版物流信息，即将下线
隐藏子属性
tracking_numberstring
物流商单号
replace_tracking_numberstring
跟踪号
transportation_costnumber
实际物流费用
transportation_currencystring
实际物流费用币种
other_costnumber
实际其他费用
other_currencystring
实际其他费用币种
other_cost_remarkstring
其他费用备注
predicted_transportation_costnumber
预估物流费用
predicted_transportation_currencystring
预估物流费用币种
predicted_other_costnumber
预估其他费用
predicted_other_currencystring
预估其他费用币种

请求示例

{
    "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"
                }
            ]
        }
    }
}

返回结果

Json Object

codeinteger必填
状态码，0 成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsstring必填
错误信息
request_idstring必填
请求链路id
示例 C3D9F541-8083-E376-EB5C-606A872F5C89
response_timestring必填
响应时间
示例 2022-12-08 18:27:13
dataobject必填
响应数据
隐藏子属性
order_snstring必填
发货单号
示例 &nbsp;