Agent Skills
返回列表
酷特海外平台订单查询

酷特海外平台订单查询

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-query。

技能介绍

要解决什么问题

在海外运营平台完成下单或对接提交之后,业务侧最常见的是「订单到底建没建成、号是多少、现在什么状态、物流单号有没有」。这些动作如果靠人工翻后台或混用多个接口,很容易把 内部 Bearer 接口 和 /api/public/order/* 公开接口 的参数、返回格式搞混——后者返回的是 String,和内部 RS 结构并不一样。

本技能面向 提交后的只读追踪:查详情、查状态、查物流、对接公共 API,不改单、撤单、删除或走支付/发货等写接口。

技能如何工作

正式环境服务根地址固定为 https://www.kutetailor.com/api/order(由 frontmatter 配置,调用时不必让用户填)。所有 tool arguments 必须包在 params 对象里,最外层只能放 params。

按 params.action 选择动作,典型组合如下:

  • order_detail:定制类通用入口,GET /order/orden/selectOrdenDetails,Query 传 orderId,可选 type。
  • finish_order_detail / design_order_detail:已知成品或简定制时,分别走 selectFinishOrdenDetails / selectDesignOrdenDetails。
  • shipping_code:用订单号 ordenNo 查物流,GET /order/orden/getShippingCode。
  • public_order_status / public_order_details:路径参数 orderid,公开对接;鉴权与签名以部署环境为准。

内部详情类接口需要 params.accessToken(Authorization: Bearer)。推荐流程:先从 platform-coupon-checkout 或 platform-style-order-full 的提交结果里取 ordenId、ordenNo;不确定品类时用 order_detail 并传 type;问物流时用 ordenNo 调 shipping_code。

返回里重点看 ordenNo、status/statusStr、客户与款式字段,以及 error/errorCode/errorList——异常信息应原样保留。

边界与注意点

  • 不要用查询结果 推断支付成功,除非状态字段明确说明。
  • 查不到订单时,说明实际使用的 orderId 或 ordenNo,不要编造状态。
  • 公共 API 字符串解析失败就原样展示,不要擅自改写成成功。

使用场景

  • 完成 platform-style-order-full 提交后,用返回的 orderId 拉取成品或简定制订单详情核对字段
  • 客户催物流时,已有 ordenNo,调用 shipping_code 查询物流单号并回传
  • 对接外部 WMS/ERP 时,通过 public_order_status 按 orderid 拉取公开状态字符串
  • 下单后用户问「提交成功没、单号多少」,从 checkout 结果取 ordenId/ordenNo 再查详情与 status

适合人员

  • 对接酷特海外运营 API、需在提交后串联查单与对账的后端集成工程师
  • 处理海外定制/成品订单客诉,需凭订单号或 id 查状态与物流的客服或运营
  • 维护 platform-coupon-checkout 与订单查询 skill 联调、核对 errorList 的全链路交付同学
  • 用公开 /api/public/order 对接第三方、需区分内部 Bearer 与公开返回格式的对接开发