Lingxing
切换旧版

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

POST/erp/sc/storage/shipment/createSendedOrder

支持推送已发货的FBA发货单到领星ERP,并扣减发货仓库库存

接口信息

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

请求参数

widinteger
自定义仓库id,wid和sys_wid其中一项必填,都填则优先wid
sys_widinteger必填
系统仓库id,wid和sys_wid其中一项必填,都填则优先wid
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 产品-数量
5 箱子-体积
is_points_behindinteger
是否分抛计算:0 否,1 是,头程分摊方式为按计费重时用
points_behind_coeffientinteger
分抛系数:0~100,分抛计算选是时必填
logistics_channel_idinteger
物流渠道id:按计费重分摊时必填,以获取材积参数用于计算
查询头程物流渠道列表接口对应字段【id】
is_relatedinteger
组合商品扣减库存时是否自动拆分成单品进行扣减:
0 否
1 是【会拆分组合商品】
request_flagstring
自定义请求标识,本次请求超时后可根据此标识查询此次请求的结果,由请求方保持标识唯一性
ship_modeinteger
发货方式:1-默认,2-工厂直发
hand_pick_purchaseinteger
工厂直发时手动选择出库批次:1-否,2-是
remarkstring
备注
principal_uidsarray<any>
负责人UID,来源:查询ERP用户信息列表返回的 data>>uid
listarray<object>必填
隐藏子属性
seller_idstring必填
亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】
warehouse_seller_idinteger
仓库店铺id
marketplace_idstring必填
市场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_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才生效
purchase_itemsarray<object>
工厂直发手动选择出库批次
隐藏子属性
relation_numinteger必填
关联量
purchase_snstring
系统采购单号
custom_purchase_snstring
自定义采购单号(无系统采购单号时必填)
box_typestring
装箱类型:
SINGLE 每箱只允许一款SKU
MULTIPLE 每箱允许多款SKU
box_remarkstring
装箱备注
box_listarray<object>
箱规列表,每个子项代表一个箱规,在装箱类型为MULTIPLE时必填
隐藏子属性
box_numstring必填
箱子数
cg_box_lengthnumber必填
箱子长
cg_box_widthnumber必填
箱子宽
cg_box_heightnumber必填
箱子高
cg_box_weightnumber必填
箱子重
box_skusarray<object>必填
箱子内包含的SKU信息,需与list里的数据保持一致
隐藏子属性
seller_idstring必填
亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】
marketplace_idstring必填
市场id
shipment_idstring必填
货件单号
fulfillment_network_skustring必填
货件fnsku
quantity_in_caseinteger必填
单箱数量
skustring必填
SKU
logistics_list_typeinteger
物流信息版本:
0 旧版
1 新版
head_logistics_listobject必填
新版头程物流信息
隐藏子属性
tracking_listarray<object>
轨迹信息数组
隐藏子属性
tracking_nostring
查询单号
transport_typeinteger
运输类型:
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": "2022-05-06",
    "etd_date": "2022-05-06",
    "eta_date": "2022-05-06",
    "delivery_date": "2022-05-06",
    "actual_shipment_time": "2022-05-06",
    "head_fee_type": 1,
    "tax_fee_type": 0,
    "is_points_behind": 1,
    "points_behind_coeffient": 1,
    "logistics_channel_id": 1,
    "remark": "发货单备注",
    "request_flag": "1123123aaaaaa",
    "logistics_list": [{
        "tracking_number": "aaaaaa",
        "replace_tracking_number": "bbbbbb",
        "transportation_cost": 1,
        "transportation_currency": "CNY",
        "other_cost": 1,
        "other_currency": "1.00",
        "other_cost_remark": "其他费备注",
        "predicted_transportation_cost": 1,
        "predicted_transportation_currency": "CNY",
        "predicted_other_cost": 1,
        "predicted_other_currency": "CNY"
    }],
    "list": [{
        "seller_id": "",
        "warehouse_seller_id": 0,
        "marketplace_id": "",
        "shipment_id": "FBA19M79VH0H",
        "fulfillment_network_sku": "",
        "fnsku": "",
        "num": 0,
        "box_num": 0,
        "sku": "",
        "tax_currency": "",
        "tax_amount": "",
        "cg_product_gross_weight": "",
        "cg_package_length": "",
        "cg_package_width": "",
        "cg_package_height": "",
        "cg_box_weight": "",
        "transport_cost": ""
    }],
    "is_related": "",
    "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;