kutesmart-海外运营平台物流查询-platform-shipping-query
正式环境固定服务根地址：https://www.kutetailor.com/api/shipping
用于只读物流追踪。创建物流单和更新物流单属于 platform-shipping-manage。
调用参数要求
{
"params": {
"action": "track_by_waybill",
"accessToken": "<access_token>",
"waybillNo": "YT123"
}
}
动作表
| action | 请求 | URL | 参数 | 返回 | 用途 |
|---|---|---|---|---|---|
shipping_list |
GET |
/shipping |
Query：ShippingVO、分页 |
IPage<ShippingVO> |
物流单列表。 |
shipping_detail |
GET |
/shipping/{id} |
Path：id |
ShippingDetailVO |
物流单详情。 |
shipping_by_code |
GET |
/shipping/getShippingOne |
Query：code |
RS |
根据物流单号查询物流信息。 |
shipping_by_waybill |
GET |
/shipping/getShippingByWaybillNo |
Query：waybillNo |
ShippingDetailVO |
根据运单号查询物流单详情。 |
track_by_waybill |
GET |
/shipping/get/{waybillNo} |
Path：waybillNo |
List<WaybillnoResult> |
根据运单号查询轨迹。 |
waybill_route |
GET |
/shipping/express/waybill |
Query：waybillNo、快递公司编码等 |
RS<QueryTrackResp> |
查询快递100路由。 |
list_shipping_express |
POST |
/shipping/listShippingExpress |
Body：waybillNoList |
RS<Map<String,DictSystemVO>> |
根据运单号识别快递公司。 |
shipping_address |
GET |
/shipping-address/getShippingAddress |
Query：shippingCode |
RS<ShippingAddress> |
获取发货地址信息。 |
推荐流程
- 有运单号时先
track_by_waybill，需要快递公司再list_shipping_express或waybill_route。 - 有物流单号时先
shipping_by_code，需要详情再用返回 id 调shipping_detail。 - 用户问发货地址时用
shipping_address。 - 返回时保留物流单号、运单号、快递公司、最新轨迹、时间和状态。
安全边界
- 不创建、确认、删除、更新物流单。
- 不调用
/shipping/confirm或/shipping/public/status。 - 查询不到时说明使用的参数，不编造轨迹。
来源
| 项目 | 路径 |
|---|---|
| 物流接口 | rcmtm-cloud-shipping/src/main/java/com/kutesmart/cloud/shipping/controller/ShippingController.java |
| 发货地址接口 | rcmtm-cloud-shipping/src/main/java/com/kutesmart/cloud/shipping/controller/ShippingAddressController.java |
| 接口清单 | doc/interface-list.md |
