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> | 获取发货地址信息。 |

推荐流程

1. 有运单号时先 track_by_waybill，需要快递公司再 list_shipping_express 或 waybill_route。
2. 有物流单号时先 shipping_by_code，需要详情再用返回 id 调 shipping_detail。
3. 用户问发货地址时用 shipping_address。
4. 返回时保留物流单号、运单号、快递公司、最新轨迹、时间和状态。

安全边界

• 不创建、确认、删除、更新物流单。
• 不调用 /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 |