海外运营撤单-物流单工坊订单查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-cancel-confirm-check-exist-gf-order。
技能介绍
要解决什么问题
海外运营在订单撤单确认前,需要知道某张物流单下面是否已经挂了工坊订单。若存在工坊单,撤单或后续处理往往要走不同规则;若只靠人工在多个系统里翻查,容易漏判、拖慢确认节奏。
本技能对应平台原子动作 check_exist_gf_order:用物流单号做一次明确查询,把「有没有工坊订单」交给上层 agent 或聚合 skill(如 platform-order-cancel-confirm)继续编排。
技能如何工作
- 固定环境:正式环境只调用 frontmatter 中的
base_url,完整路径为GET /order/orden/checkExistGFOrden,不接受用户输入覆盖域名或基址。 - 入参形态:tool arguments 最外层仅包含嵌套对象
params;查询条件放在params.query,其中shippingCode为物流单号。 - 鉴权:登录态通过
params.accessToken生成Authorization: Bearer;若 token 已带Bearer前缀则不再重复拼接。 - 返回原则:以接口原始响应为准,不自行编造订单号、库存或物流状态;认证、权限、参数或业务错误时,应把错误码与错误信息原样交给上层决策。
适用边界与注意点
这是最小颗粒度接口 skill,只完成本 GET 查询,不串联撤单、改址或其它订单操作。用户描述的是多步业务流程时,应由上层按聚合 skill 或计划文档组合多个原子 skill。查询与计算类接口仍受当前登录态、租户与用户权限约束。
使用场景
- 海外运营收到撤单申请,需先按物流单号确认该单下是否已存在工坊订单再决定是否放行。
- 编排 platform-order-cancel-confirm 聚合流程时,在撤单确认节点调用本接口获取是否存在 GF 订单。
- 客服或运营提供 shippingCode,由 agent 调用 check_exist_gf_order 并把布尔结果交给后续撤单 skill。
- 对接 kutetailor 正式环境时,仅需原子查询「物流单下是否有工坊订单」,不执行撤单或其它写操作。
适合人员
- 负责酷特海外运营平台订单撤单审核、需按物流单核对工坊订单状态的运营人员
- 正在把 kutesmart 原子 skill 串成撤单确认链路的 agent 或工作流搭建者
- 对接 GET /order/orden/checkExistGFOrden、用 accessToken 调登录态查询接口的内部系统集成工程师
- 维护 platform-order-cancel-confirm 聚合文档、需要明确 check_exist_gf_order 入参与返回的上层编排开发者