海外运营撤单工坊订单查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-cancel-confirm-check-exist-gf-order。
技能介绍
这个技能解决什么问题
海外运营平台的撤单并不是一次干净的删除。订单可能已经关联了工坊(GF)订单,甚至已经下发到履约侧。如果直接撤单或盲目重试,要么漏掉已存在的工坊订单造成账实不符,要么把已经进入生产环节的订单当成空单处理,事后只能人工翻表对账。
check_exist_gf_order 就是撤单动作之前的那道闸门,它只回答一个问题:这个物流单下面到底有没有工坊订单。它不删除数据、不改状态、不重算金额,只做一次只读判断。
它如何工作
技能只封装一个原子动作,正式环境地址固定写在 frontmatter 的 base_url 中,调用时不接受用户输入覆盖。
- 请求方式:
GET,路径/order/orden/checkExistGFOrden - 入参:Query 参数
shippingCode,即待校验的物流单号 - 参数传递:统一使用嵌套的
params对象,最外层只放params,不要写成params.xxx这类点号顶层 key - 鉴权:登录态从
params.accessToken读取,执行器拼接Authorization: Bearer;若传入值已包含Bearer,不要重复拼接 - 其余部分:Path 走
params.path,Query 走params.query,Body 走params.body,额外 Header 走params.headers
返回的 RS 结构由上层 agent 解析,判断结果作为是否继续撤单的依据。
适用边界与注意点
- 这是查询/计算类接口,不会修改任何数据;接口返回后也不要自行补造订单号、金额、库存或物流状态
- 结果以接口响应为准。遇到认证失败、权限不足、参数错误或业务错误时,把原始错误码和错误信息原样传给上层,不要吞掉
- 调用仍然受当前登录态、租户和用户权限约束
- 单次调用只覆盖一个物流单。批量校验需要在上层编排循环,或由聚合 skill
platform-order-cancel-confirm统一调度 - 如果业务链路还需要多个接口步骤,本 skill 只负责这一步,其余由上层 agent 按计划文档串联
使用场景
- 海外运营平台收到撤单请求,需要先凭物流单号查询是否存在关联工坊订单,再决定是否继续撤单流程。
- 客服处理客户取消申请时,需确认该物流单下没有已下发的工坊订单,避免误撤已进入生产的订单。
- 上层 agent 编排撤单链路,调用本接口获取工坊订单判断结果,并把返回字段交给后续步骤。
- 批量撤单前的逐单校验环节,对每个物流单调用本接口做只读确认,不修改任何订单数据。
适合人员
- 海外运营平台的运营人员:日常处理撤单请求,需要在操作前确认物流单下是否存在工坊订单。
- 搭建撤单自动化链路的集成工程师:需要按接口契约调用原子 skill,处理鉴权、参数与错误返回。
- 客服与履约团队成员:收到取消申请时需核实关联工坊订单状态,再向客户反馈能否撤单。
- 聚合 skill 的编排设计者:将本接口纳入 platform-order-cancel-confirm 链路并定义各步骤衔接。