酷特海外运营平台物流查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-shipping-query。
技能介绍
要解决什么问题
海外运营、客服或履约同学经常要在系统外核对物流:手里只有运单号或物流单号,需要查轨迹、快递公司、单号详情,有时还要确认发货地址。本技能面向 Kutetailor 正式环境的只读物流接口(服务根地址:https://www.kutetailor.com/api/shipping),把「该调哪个 action、参数怎么带、结果里该保留哪些字段」整理成可执行的查询流程,避免误用创建/确认类接口。
技能如何工作
技能按 action 表组织调用,核心能力包括:
- 列表与详情:
shipping_list分页拉物流单;shipping_detail用 id 取详情;shipping_by_code按物流单号查一条。 - 运单维度:
shipping_by_waybill按运单号取物流单详情;track_by_waybill按运单号拉轨迹列表。 - 快递识别与路由:
list_shipping_express用运单号列表识别快递公司;waybill_route查快递 100 路由(需运单号及快递公司编码等 Query)。 - 发货地址:
shipping_address用shippingCode取发货地址信息。
推荐流程:有运单号时优先 track_by_waybill,需要快递公司再 list_shipping_express 或 waybill_route;有物流单号时先 shipping_by_code,需要详情再用返回的 id 调 shipping_detail;问发货地址时用 shipping_address。对外回复时应保留物流单号、运单号、快递公司、最新轨迹、时间与状态。
边界与注意点
- 只读:不创建、确认、删除或更新物流单;不调用
/shipping/confirm或/shipping/public/status。写操作属于 platform-shipping-manage。 - 查不到时:说明实际使用的参数(如
waybillNo、code),不编造轨迹或状态。
使用场景
- 客户只提供运单号,需在 Kutetailor 正式环境拉取最新轨迹并说明当前状态与时间。
- 手里是物流单号而非运单号,要先按 code 定位单据,再按需用 id 查完整详情。
- 批量运单尚未识别快递公司,需先识别承运商再调用快递 100 路由查询节点信息。
- 客诉涉及发货地核对,需用 shippingCode 查询对应发货地址并与订单信息对照。
适合人员
- 处理 Kutetailor 海外订单、日常用运单号回复在途状态的客服或运营专员
- 需要分页核对物流单列表、但无权创建或确认单据的履约协调人员
- 对接 `kutetailor.com/api/shipping` 做查询封装、必须避开 manage 写接口的后端或集成工程师
- 在 Agent 工作流里自动查轨迹与发货地址、且查无结果时需如实报参数的数据分析或运维支持