Lingxing
切换旧版

创建待发货/待收货/已完成的备货单

POST/erp/sc/routing/owms/inbound/createInbound

支持创建“待发货/待收货/已完成”状态备货单,请求成功后,对应备货单在列表“待发货/待收货/已完成”状态。

若是已对接API的海外仓,提交到待发货状态为未申报状态。

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/owms/inbound/createInboundHTTPSPOST1

请求参数

inbound_order_nostring必填
客户参考号(唯一单号)
custom_s_widstring
自定义仓库id,custom_s_wid和s_wid其中一项必填,都填则优先custom_s_wid
s_widinteger必填
发货仓库,仅限本地仓
r_widinteger必填
收货仓库,仅限海外仓
logistics_idinteger必填
物流方式id,查询头程物流渠道列表接口对应字段【id】
(按计费重分摊时,需有传对应物流方式,以获取材积参数用于计算)
statusinteger
订单状态:【默认60】
40 待发货
50 待收货
60 已完成
注:收货仓支持三方海外仓的备货单状态只会到待发货
estimated_timestring
预计到货时间
arrival_timestring
实际到货时间
share_idinteger
头程费分摊方式:【默认0】
0 按计费重
1 按实重
2 按体积重
3 按SKU数量
4 自定义
5 按箱子体积
注意:生成待发货状态备货单时,需要通过接口上传备货单装箱信息上传箱子信息;
待收货和已完成的订单不支持【上传备货单装箱信息】,无法按箱子体积分摊
remarkstring
备注
file_idstring
附件id
overseas_typeinteger
下单至第三方【默认2】: 1 否,2 是
注:当收货仓为API海外仓时可填,不填默认为是
real_delivery_timestring
实际发货时间
logistics_listarray<object>
物流信息
隐藏子属性
logistics_order_nostring
物流单号
logistics_moneystring
预估物流费用
logistics_money_unitstring
预估物流费用币种
other_moneystring
预估其他费用
other_money_unitstring
预估其他费用币种
track_order_nostring
追踪号
other_money_remarkstring
预估费用备注
real_logistics_moneynumber
实际物流费用
real_logistics_money_unitstring
实际物流费用币种
real_other_moneynumber
实际其他费用
real_other_money_unitstring
实际其他费用币种
real_other_money_remarkstring
实际其他费用备注
wool_idinteger
物流记录id
product_listarray<object>必填
产品信息
隐藏子属性
product_idinteger必填
本地商品id
fnskustring
fnsku
tariffsnumber
报关费用
tariffs_currency_unitstring
报关费用币种
cg_product_gross_weightnumber
单品净重(G)
cg_package_lengthnumber
包装规格-长(CM)
cg_package_widthnumber
包装规格-宽(CM)
cg_package_heightnumber
包装规格-高(CM)
stock_numinteger必填
备货数量,整箱配对需要乘以配对数量
receive_numinteger必填
收货数量(收货数量可以为0)
oversea_product_codestring
三方sku编码,查询系统产品与第三方海外仓产品映射列表接口对应字段【oversea_product_code】
【当仓库是有api海外仓必填】
sidstring
店铺id,有fnsku填 ,对应查询亚马逊店铺列表接口对应字段【sid】
logistics_list_typeinteger必填
物流信息版本:0或者不传:默认旧版物流信息
1:新版物流信息
head_logistics_listobject必填
新版头程物流信息(当logistics_list_type 为1时才有意义)
隐藏子属性
tax_fee_typeinteger必填
税费分摊方式:
0:产品-计费重
1:产品-实重
2:产品-体积重
3:产品-数量
4:自定义
5:箱子-体积)
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
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(20位)
other_amountstring必填
其他费金额
other_currencystring必填
其他费币种
actual_expenses_listobject必填
费用明细-实际费用
隐藏子属性
tax_feestring必填
税费
tax_fee_currencystring必填
税费币种
chargeable_weightstring必填
计费重
pricestring必填
单价
price_currencystring必填
单价币种
logistics_feestring必填
物流费用
logistics_fee_currencystring必填
物流费用币种
remarkstring
备注
other_fee_arrarray<object>必填
实际费用-其他费:
获取发货单头程物流-其他费类型接口获取
隐藏子属性
fee_type_idstring必填
其他费id(20位)
other_amountstring必填
其他费金额
other_currencystring必填
其他费币种
method_idstring
运输方式 查询运输方式列表接口对应字段【method_id】
custom_fieldsobject
自定义字段

请求示例

{
    "inbound_order_no": "20221116161351",
    "s_wid": "1",
    "r_wid": "3835",
    "status": 60,
    "estimated_time": "2022-05-11",
    "arrival_time": "2022-05-13",
    "share_id": "0",
    "remark": "备注33",
    "file_id": "",
    "logistics_id": "35",
    "method_id": "241261034153378816",
    "logistics_list": [
        {
            "logistics_order_no": "YT21316212661013364",
            "logistics_money": "10",
            "logistics_money_unit": "TRY",
            "other_money": "9.6",
            "other_money_unit": "CNY",
            "track_order_no": "H1018660368132401072",
            "other_money_remark": "预估备注",
            "real_logistics_money": "4",
            "real_logistics_money_unit": "CNY",
            "real_other_money": "4",
            "real_other_money_unit": "CNY",
            "real_other_money_remark": "实际备注"
        }
    ],
    "product_list": [
        {
            "product_id": "33664",
            "fnsku": "",
            "oversea_product_code": "LINGXING-YF",
            "tariffs": 1,
            "tariffs_currency_unit": "CNY",
            "stock_num": "2",
            "receive_num": "1",
            "cg_product_gross_weight": 1,
            "cg_package_length": 1,
            "cg_package_width": 2,
            "cg_package_height": 4
        }
    ],
    "logistics_list_type": 0,
    "head_logistics_list": {
        "tax_fee_type": 1,
        "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",
            "chargeable_weight": "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_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 D17B0688-C52D-1BA9-1BCC-50AA00058A3F
response_timestring必填
响应时间
示例 2022-08-23 16:56:31
dataobject必填
响应数据
隐藏子属性
overseas_order_nostring必填
系统备货单号
totalinteger必填
数据总量
示例 &nbsp;