/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"
}
]
}
}
}
]
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | data | 参数数组 | array<object> | — | Required | 参数数组 |
| 1.1 | order_sn | 发货单号 | string | — | Required | 发货单号 |
| 1.2 | expected_arrival_date | 到货时间 | string | — | Optional | 到货时间,格式:Y-m-d |
| 1.3 | etd_date | 开船时间 | string | — | Optional | 开船时间,格式:Y-m-d |
| 1.4 | eta_date | 预计到港时间 | string | — | Optional | 预计到港时间,格式:Y-m-d |
| 1.5 | delivery_date | 实际妥投时间 | string | — | Optional | 实际妥投时间,格式:Y-m-d |
| 1.6 | actual_shipment_time | 实际发货时间 | string | — | Optional | 实际发货时间,格式:Y-m-d |
| 1.7 | tax_fee_type | 实际税费分配方式 | integer | — | Optional | 实际税费分配方式:【默认0】 0 产品-计费重 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积/体积重 6 箱子-计费重 7 箱子-实重 8 产品-根据清关单价*税率占比 |
| 1.8 | logistics_channel_id | 物流渠道id | integer | — | Optional | 物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】 |
| 1.9 | logistics_list_type | 物流信息版本 | integer | — | Optional | 物流信息版本: 1 新版 |
| 1.10 | head_logistics_list | 新版头程物流信息 | object | — | Optional | 新版头程物流信息 【对应 logistics_list_type = 1】 【注意:新版头程物流数据为覆盖式更新,包括tracking_list、estimate_expenses_list、actual_expenses_list,不传或者传空也会置空】 |
| 1.10.1 | logistics_tracking_number | 物流商单号 | string | — | Optional | 物流商单号 |
| 1.10.2 | tracking_list | 轨迹信息数组 | array<object> | — | Required | 轨迹信息数组 |
| 1.10.2.1 | tracking_no | 查询单号 | string | — | Optional | 查询单号 |
| 1.10.2.2 | transport_type | 运输类型 | integer | — | Required | 运输类型: 1 快递 2 海运 3 空运 4 其他 |
| 1.10.2.3 | order_type_code | 单号类型 | integer | — | Required | 单号类型:【注意:与运输类型联动关系】 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 | — | Optional | 承运商,运输类型为海运时才有意义: 获取发货单头程物流-承运商信息接口获取 |
| 1.10.2.5 | remark | 备注 | string | — | Optional | 备注 |
| 1.10.3 | estimate_expenses_list | 费用明细-预估费用 | object | — | Required | 费用明细-预估费用 |
| 1.10.3.1 | chargeable_weight | 计费重(单位KG)【废弃字段】 | string | — | Optional | 计费重(单位KG)【废弃字段】 |
| 1.10.3.2 | price | 单价 | string | — | Required | 单价 |
| 1.10.3.3 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 1.10.3.4 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 1.10.3.5 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 1.10.3.6 | remark | 备注 | string | — | Optional | 备注 |
| 1.10.3.7 | other_fee_arr | 预估费用-其他费 | array<object> | — | Required | 预估费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 1.10.3.7.1 | fee_type_id | 其他费id(20位) | string | — | Required | 其他费id(20位) |
| 1.10.3.7.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 1.10.3.7.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 1.10.4 | actual_expenses_list | 费用明细-实际费用 | object | — | Required | 费用明细-实际费用 |
| 1.10.4.1 | tax_fee | 税费 | string | — | Required | 税费 |
| 1.10.4.2 | tax_fee_currency | 税费币种 | string | — | Required | 税费币种 |
| 1.10.4.3 | price | 单价 | string | — | Required | 单价 |
| 1.10.4.4 | price_currency | 单价币种 | string | — | Required | 单价币种 |
| 1.10.4.5 | logistics_fee | 物流费用 | string | — | Required | 物流费用 |
| 1.10.4.6 | logistics_fee_currency | 物流费用币种 | string | — | Required | 物流费用币种 |
| 1.10.4.7 | remark | 备注 | string | — | Optional | 备注 |
| 1.10.4.8 | other_fee_arr | 实际费用-其他费 | array<object> | — | Required | 实际费用-其他费: 获取发货单头程物流-其他费类型接口获取 |
| 1.10.4.8.1 | fee_type_id | 其他费id | string | — | Required | 其他费id |
| 1.10.4.8.2 | other_amount | 其他费金额 | string | — | Required | 其他费金额 |
| 1.10.4.8.3 | other_currency | 其他费币种 | string | — | Required | 其他费币种 |
| 1.11 | logistics_list | 旧版物流信息 | array<object> | — | Required | 旧版物流信息,即将下线 |
| 1.11.1 | tracking_number | 物流商单号 | string | — | Required | 物流商单号 |
| 1.11.2 | replace_tracking_number | 跟踪号 | string | — | Required | 跟踪号 |
| 1.11.3 | transportation_cost | 实际物流费用 | number | — | Optional | 实际物流费用,精度是小数点后2位 |
| 1.11.4 | transportation_currency | 实际物流费用币种 | string | — | Optional | 实际物流费用币种,费用填写时必填 |
| 1.11.5 | other_cost | 实际其他费用 | number | — | Optional | 实际其他费用,精度是小数点后2位 |
| 1.11.6 | other_currency | 实际其他费用币种 | string | — | Optional | 实际其他费用币种,费用填写时必填 |
| 1.11.7 | other_cost_remark | 其他费用备注 | string | — | Optional | 其他费用备注 |
| 1.11.8 | predicted_transportation_cost | 预估物流费用 | number | — | Optional | 预估物流费用,精度是小数点后2位 |
| 1.11.9 | predicted_transportation_currency | 预估物流费用币种 | string | — | Optional | 预估物流费用币种,费用填写时必填 |
| 1.11.10 | predicted_other_cost | 预估其他费用 | number | — | Optional | 预估其他费用,精度是小数点后2位 |
| 1.11.11 | predicted_other_currency | 预估其他费用币种 | string | — | Optional | 预估其他费用币种,费用填写时必填 |
| 2 | head_logistics_list | head_logistics_list | object | — | Optional | |
| 2.1 | actual_expenses_list | actual_expenses_list | object | — | Optional | |
| 2.1.1 | chargeable_weight | 计费重【废弃字段】 | string | — | Required | 计费重【废弃字段】 |
| 2.1.2 | weight | 实重(单位 | string | — | Required | 实重(单位:KG) |
| 2.1.3 | volume | 体积(单位 | string | — | Required | 体积(单位:m³) |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | 426951E6-1B62-1B12-90AF-07648AACC512 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2022-02-24 20:04:36 | Required | 响应时间 |
| 6 | total | 总数 | integer | 0 | Required | 总数 |
| 7 | data | 响应数据 | array<any> | | Required | 响应数据 |
The 更新发货单物流信息 API (/erp/sc/routing/storage/shipment/updateListLogistics) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.