酷特海外平台订单查询
将以下提示词粘贴到你的 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 与公开返回格式的对接开发