海外运营平台订单预扣款检查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-cancel-confirm-check-withholding。
技能介绍
要解决的问题
在海外运营平台的撤单确认链路里,运营人员和上层 Agent 经常需要先判断一笔订单是否已经预扣款。如果不知道是否预扣,就贸然撤单,可能造成资金状态混乱:该退的预扣没退、不该动的订单被误操作,或者在客服、财务对账时找不到中间态记录。
靠人工在后台页面点开逐单查看,订单量一大就很慢;靠 Agent 直接猜或从其他接口反推,又容易和真实资金状态不一致。这个技能就是为了把「查订单预扣状态」这一步单独做成一个稳定、可复用的原子动作。
这个技能做什么
它只负责一个平台接口动作:check_withholding。调用正式环境固定地址:
GET https://www.kutetailor.com/api/order/order/orden/checkIsWithholding
核心能力很直接:传入 orderIds,接口返回 RS 结果,用来判断这些订单是否处于预扣款状态。
关键执行步骤:
- 参数组织:
tool arguments统一使用嵌套params对象,最外层只放params,不要使用params.xxx这类点号顶层 key。 - 地址约束:正式环境地址固定在 frontmatter 的
base_url,执行器必须使用该地址,调用时不要从用户输入覆盖base_url。 - 登录态处理:登录态接口使用
params.accessToken生成Authorization: Bearer;如果传入值已含Bearer,不要重复拼接。 - 参数落位:
Path参数写入params.path,Query参数写入params.query,JSON Body写入params.body,额外Header写入params.headers。 - 请求格式:
POST/PUT默认发送JSON body;如果上层接口网关另有约定,以网关契约为准。 - 方法与 URL:按接口表选择
HTTP method和URL;URL中{变量}从params.path替换。GET/DELETE查询参数放在URL query;POST/PUT请求体按参数列要求提交。
适用边界与注意点
这是一个最小颗粒度接口 skill,不是完整业务流程。它只完成本接口调用,并把关键返回字段交给后续 skill。
当用户需求需要多个接口步骤时,例如完整撤单确认流程,应由上层 Agent 按聚合 skill 或计划文档编排多个原子 skill。
返回结果必须以接口响应为事实来源,不要补造库存、价格、订单号、优惠金额或物流状态。
如果接口返回认证、权限、参数或业务错误,把原始错误码和错误信息传给上层 Agent,不要自行改写成其他状态。
这是查询或计算类接口,仍需遵守当前登录态、租户和用户权限。
使用场景
- 运营在处理撤单前,需要确认订单是否已预扣款。
- 客服核对订单资金状态时,需判断是否处于预扣款。
- Agent 编排撤单流程,先调用该接口获取关键返回字段。
- 财务对账时,需要确认相关订单的预扣款状态。
适合人员
- 海外运营平台的运营工程师,需要在撤单链路中确认订单资金状态。
- 负责撤单流程的后端开发者,需要编排原子接口调用并处理返回结果。
- 搭建业务 Agent 的工程师,需要把该检查动作纳入订单处理计划。
- 处理订单问题的客服技术支持,需要核对预扣款状态以定位问题。