Lingxing
切换旧版

更新发货单物流信息

POST/erp/sc/routing/storage/shipment/updateListLogistics

用于更新发货单内的【物流信息】

接口信息

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

请求参数

dataarray<object>必填
参数数组
隐藏子属性
order_snstring必填
发货单号
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
tax_fee_typeinteger
实际税费分配方式：【默认0】
0 产品-计费重
1 产品-实重
2 产品-体积重
3 产品-数量
4 自定义
5 箱子-体积/体积重
6 箱子-计费重
7 箱子-实重
8 产品-根据清关单价*税率占比
logistics_channel_idinteger
物流渠道id：按计费重分摊时必填，以获取材积参数用于计算
查询头程物流渠道列表接口对应字段【id】
logistics_list_typeinteger
物流信息版本：
1 新版
head_logistics_listobject
新版头程物流信息
【对应 logistics_list_type = 1】
【注意：新版头程物流数据为覆盖式更新，包括tracking_list、estimate_expenses_list、actual_expenses_list，不传或者传空也会置空】
隐藏子属性
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（20位）
other_amountstring必填
其他费金额
other_currencystring必填
其他费币种
actual_expenses_listobject必填
费用明细-实际费用
隐藏子属性
tax_feestring必填
税费
tax_fee_currencystring必填
税费币种
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
实际物流费用，精度是小数点后2位
transportation_currencystring
实际物流费用币种，费用填写时必填
other_costnumber
实际其他费用，精度是小数点后2位
other_currencystring
实际其他费用币种，费用填写时必填
other_cost_remarkstring
其他费用备注
predicted_transportation_costnumber
预估物流费用，精度是小数点后2位
predicted_transportation_currencystring
预估物流费用币种，费用填写时必填
predicted_other_costnumber
预估其他费用，精度是小数点后2位
predicted_other_currencystring
预估其他费用币种，费用填写时必填
head_logistics_listobject
隐藏子属性
actual_expenses_listobject
隐藏子属性
chargeable_weightstring必填
计费重【废弃字段】
weightstring必填
实重（单位：KG）
volumestring必填
体积（单位：m³）

请求示例

{
    "data": [{
        "order_sn": "SP220120057",
        "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",
	    "tax_fee_type":"0",
        "logistics_list": [{
            "tracking_number": "22",
            "replace_tracking_number": "20215486",
            "transportation_cost": 0,
            "transportation_currency": "CNY",
            "other_cost": 0,
            "other_currency": "CNY",
            "other_cost_remark": "其他费用备注",
            "predicted_transportation_cost": 44,
            "predicted_transportation_currency": "CNY",
            "predicted_other_cost": 12,
            "predicted_other_currency": "CNY"
        }],
        "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": {
                "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_detailsarray<any>必填
错误信息
request_idstring必填
请求链路id
示例 426951E6-1B62-1B12-90AF-07648AACC512
response_timestring必填
响应时间
示例 2022-02-24 20:04:36
totalinteger必填
总数
示例 0
dataarray<any>必填
响应数据
示例 &nbsp;