酷特海外平台物流单号查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-shipping-query-shipping-by-code。
技能介绍
要解决什么问题
在海外运营场景里,客服、履约或运营同学经常只有一条物流单号,需要确认当前物流节点、承运信息或接口侧返回的原始状态。若每次让 Agent 手写 URL、拼 Query、处理 Bearer 登录态,容易出错,也会和正式环境地址不一致。
本技能是酷特海外运营平台上的最小颗粒度原子接口:只负责 shipping_by_code 这一动作——用物流单号拉取单条物流信息,并把接口真实响应交给上层编排。
技能如何工作
- 固定走正式环境:
GEThttps://www.kutetailor.com/api/shipping/shipping/getShippingOne,不接受用户输入覆盖base_url。 - 调用参数统一放在嵌套对象
params中:Query 写入params.query(本接口需传code);需登录时在params.accessToken中传 token,生成Authorization: Bearer …(若已含Bearer则不重复拼接)。 - 返回以接口响应为准:不补造库存、价格、订单号、优惠或物流状态;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息向上传递。
适用边界与注意点
- 若用户需求涉及多步(查单、改址、批量对账等),本技能只完成本接口;完整链路需由上层 Agent 按聚合 skill(如
platform-shipping-query)或计划文档组合多个原子 skill。 - 仍为查询类接口,需遵守当前登录态、租户与用户权限;Path/Body/额外 Header 分别走
params.path、params.body、params.headers,与网关约定冲突时以网关为准。
使用场景
- 客诉工单里只有物流单号,需在酷特正式环境拉取该单号的接口原始物流信息再回复用户。
- 履约跟进海外订单时,用客户或仓库提供的 `code` 核对平台侧单条运单记录是否与预期一致。
- 编排 `platform-shipping-query` 链路时,先调用本原子接口拿到 RS 再交给后续改址或对账 skill。
- 内部 Bot 收到「查这个单号物流」的指令,需按规范传 `params.query.code` 与登录 token 完成一次 GET 查询。
适合人员
- 处理酷特海外订单客诉、需凭物流单号回查平台运单详情的客服或售后专员
- 在 kutetailor 海外运营后台跟进发货、要用单号对齐承运与节点信息的履约协调人员
- 把 `shipping_by_code` 编入多步 Agent 计划、需固定正式环境地址与 params 规范的后端或集成工程师
- 做物流状态核对或对账前、只需单条 `getShippingOne` 结果而非整表导出的运营分析同事