/erp/sc/routing/storage/shipment/updateListLogistics{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/storage/shipment/updateListLogistics"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 2,
"text": ""
},
"requestExample": {
"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"
}
]
}
}
}
]
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | data | 参数数组 | array<object> | — | 必填 | 参数数组 |
| 1.1 | order_sn | 发货单号 | string | — | 必填 | 发货单号 |
| 1.2 | expected_arrival_date | 到货时间 | string | — | 可选 | 到货时间,格式:Y-m-d |
| 1.3 | etd_date | 开船时间 | string | — | 可选 | 开船时间,格式:Y-m-d |
| 1.4 | eta_date | 预计到港时间 | string | — | 可选 | 预计到港时间,格式:Y-m-d |
| 1.5 | delivery_date | 实际妥投时间 | string | — | 可选 | 实际妥投时间,格式:Y-m-d |
| 1.6 | actual_shipment_time | 实际发货时间 | string | — | 可选 | 实际发货时间,格式:Y-m-d |
| 1.7 | tax_fee_type | 实际税费分配方式 | integer | — | 可选 | 实际税费分配方式:【默认0】 0 产品-计费重 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积/体积重 6 箱子-计费重 7 箱子-实重 8 产品-根据清关单价*税率占比 |
| 1.8 | logistics_channel_id | 物流渠道id | integer | — | 可选 | 物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】 |
| 1.9 | logistics_list_type | 物流信息版本 | integer | — | 可选 | 物流信息版本: 1 新版 |
| 1.10 | head_logistics_list | 新版头程物流信息 | object | — | 可选 | 新版头程物流信息 【对应 logistics_list_type = 1】 【注意:新版头程物流数据为覆盖式更新,包括tracking_list、estimate_expenses_list、actual_expenses_list,不传或者传空也会置空】 |
| 1.10.1 | logistics_tracking_number | 物流商单号 | string | — | 可选 | 物流商单号 |
| 1.10.2 | tracking_list | 轨迹信息数组 | array<object> | — | 必填 | 轨迹信息数组 |
| 1.10.2.1 | tracking_no | 查询单号 | string | — | 可选 | 查询单号 |
| 1.10.2.2 | transport_type | 运输类型 | integer | — | 必填 | 运输类型: 1 快递 2 海运 3 空运 4 其他 |
| 1.10.2.3 | order_type_code | 单号类型 | integer | — | 必填 | 单号类型:【注意:与运输类型联动关系】 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只能传空 |
| 1.10.2.4 | shippers | 承运商 | string | — | 可选 | 承运商,运输类型为海运时才有意义: 获取发货单头程物流-承运商信息接口获取 |
| 1.10.2.5 | remark | 备注 | string | — | 可选 | 备注 |
| 1.10.3 | estimate_expenses_list | 费用明细-预估费用 | object | — | 必填 | 费用明细-预估费用 |
| 1.10.3.1 | chargeable_weight | 计费重(单位KG)【废弃字段】 | string | — | 可选 | 计费重(单位KG)【废弃字段】 |
| 1.10.3.2 | price | 单价 | string | — | 必填 | 单价 |
| 1.10.3.3 | price_currency | 单价币种 | string | — | 必填 | 单价币种 |
| 1.10.3.4 | logistics_fee | 物流费用 | string | — | 必填 | 物流费用 |
| 1.10.3.5 | logistics_fee_currency | 物流费用币种 | string | — | 必填 | 物流费用币种 |
| 1.10.3.6 | remark | 备注 | string | — | 可选 | 备注 |
| 1.10.3.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | 必填 | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 1.10.3.7.1 | fee_type_id | 其他费id(20位) | string | — | 必填 | 其他费id(20位) |
| 1.10.3.7.2 | other_amount | 其他费金额 | string | — | 必填 | 其他费金额 |
| 1.10.3.7.3 | other_currency | 其他费币种 | string | — | 必填 | 其他费币种 |
| 1.10.4 | actual_expenses_list | 费用明细-实际费用 | object | — | 必填 | 费用明细-实际费用 |
| 1.10.4.1 | tax_fee | 税费 | string | — | 必填 | 税费 |
| 1.10.4.2 | tax_fee_currency | 税费币种 | string | — | 必填 | 税费币种 |
| 1.10.4.3 | price | 单价 | string | — | 必填 | 单价 |
| 1.10.4.4 | price_currency | 单价币种 | string | — | 必填 | 单价币种 |
| 1.10.4.5 | logistics_fee | 物流费用 | string | — | 必填 | 物流费用 |
| 1.10.4.6 | logistics_fee_currency | 物流费用币种 | string | — | 必填 | 物流费用币种 |
| 1.10.4.7 | remark | 备注 | string | — | 可选 | 备注 |
| 1.10.4.8 | other_fee_arr | 实际费用-其他费 | array<object> | — | 必填 | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 1.10.4.8.1 | fee_type_id | 其他费id | string | — | 必填 | 其他费id |
| 1.10.4.8.2 | other_amount | 其他费金额 | string | — | 必填 | 其他费金额 |
| 1.10.4.8.3 | other_currency | 其他费币种 | string | — | 必填 | 其他费币种 |
| 1.11 | logistics_list | 旧版物流信息 | array<object> | — | 必填 | 旧版物流信息,即将下线 |
| 1.11.1 | tracking_number | 物流商单号 | string | — | 必填 | 物流商单号 |
| 1.11.2 | replace_tracking_number | 跟踪号 | string | — | 必填 | 跟踪号 |
| 1.11.3 | transportation_cost | 实际物流费用 | number | — | 可选 | 实际物流费用,精度是小数点后2位 |
| 1.11.4 | transportation_currency | 实际物流费用币种 | string | — | 可选 | 实际物流费用币种,费用填写时必填 |
| 1.11.5 | other_cost | 实际其他费用 | number | — | 可选 | 实际其他费用,精度是小数点后2位 |
| 1.11.6 | other_currency | 实际其他费用币种 | string | — | 可选 | 实际其他费用币种,费用填写时必填 |
| 1.11.7 | other_cost_remark | 其他费用备注 | string | — | 可选 | 其他费用备注 |
| 1.11.8 | predicted_transportation_cost | 预估物流费用 | number | — | 可选 | 预估物流费用,精度是小数点后2位 |
| 1.11.9 | predicted_transportation_currency | 预估物流费用币种 | string | — | 可选 | 预估物流费用币种,费用填写时必填 |
| 1.11.10 | predicted_other_cost | 预估其他费用 | number | — | 可选 | 预估其他费用,精度是小数点后2位 |
| 1.11.11 | predicted_other_currency | 预估其他费用币种 | string | — | 可选 | 预估其他费用币种,费用填写时必填 |
| 2 | head_logistics_list | head_logistics_list | object | — | 可选 | |
| 2.1 | actual_expenses_list | actual_expenses_list | object | — | 可选 | |
| 2.1.1 | chargeable_weight | 计费重【废弃字段】 | string | — | 必填 | 计费重【废弃字段】 |
| 2.1.2 | weight | 实重(单位 | string | — | 必填 | 实重(单位:KG) |
| 2.1.3 | volume | 体积(单位 | string | — | 必填 | 体积(单位:m³) |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | — | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | 426951E6-1B62-1B12-90AF-07648AACC512 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-02-24 20:04:36 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 0 | 必填 | 总数 |
| 7 | data | 响应数据 | array<any> | | 必填 | 响应数据 |
领星ERP的接口:更新发货单物流信息(/erp/sc/routing/storage/shipment/updateListLogistics),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。