酷特海外运营平台·按订单号查预提交结果
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-progress-pre-submit-result。
技能介绍
要解决什么问题
在海外运营平台上,订单在「预提交」阶段会落一条可查的状态与结果。业务同学或上层 Agent 往往只有 订单号(ordenNo),需要确认该单预提交是否成功、接口返回了哪些字段,再决定是否继续提交、改单或走别的接口。
本技能是 最小颗粒度 的接口封装:只负责 pre_submit_result 这一次 GET,不负责整条订单进度编排。
技能如何工作
- 固定走正式环境:
base_url来自技能 frontmatter(https://www.kutetailor.com/api/order路径体系),不接受用户改域名或环境。 - 调用 GET
/order/orden-pre-submit/selectByOrdenNo,查询参数放在params.query:必填ordenNo,可选id。 - 工具参数统一为顶层
params对象;登录态通过params.accessToken生成Authorization: Bearer(值里已有Bearer则不重复拼接)。 - 执行器按表选择 method 与 URL;返回以 接口响应为唯一事实来源,不补造库存、价格、优惠或物流状态。
适用边界与注意点
- 若用户需求涉及多步(登录、列表、提交、进度汇总),应由上层 Agent 按聚合 skill
platform-order-progress或计划文档串联多个原子 skill;本技能只完成本接口并把关键字段交给后续步骤。 - 认证、权限、参数或业务错误时,应把 原始错误码与错误信息 向上传递,便于上层重试或改参。
- 仍为查询类接口:须遵守当前租户、用户与登录态权限约束。
使用场景
- 上层 Agent 在提交正式订单前,已拿到 `ordenNo`,需调用正式环境接口确认该单预提交结果再决定是否继续下一步。
- 客服或运营收到客户提供的订单号,要在酷特海外运营平台核对预提交是否成功及接口返回的关键字段。
- 按 `platform-order-progress` 聚合链路编排时,将本技能作为单步,只负责 `selectByOrdenNo` 查询并把 RS 交给后续 skill。
- 对账或异常排查时,仅凭订单号回溯预提交阶段状态,不自行编造价格、库存或物流信息。
适合人员
- 负责酷特海外运营平台订单流转、需在预提交与正式提交之间做状态核对的运营或履约同事
- 为酷特相关 Agent 编排多接口链路,需要可复用的 `pre_submit_result` 原子调用的集成或后端工程师
- 对接 `kutetailor.com` 订单 API、按规范封装 `params.query.ordenNo` 与 Bearer 登录态的内部工具维护者
- 处理海外定制订单工单,经常只有订单号、需快速查询预提交结果再回复客户或改单的客服主管