酷特海外订单明细列表查询
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-components-order-detail-list。
技能介绍
要解决什么问题
在海外运营场景里,订单往往由多行组成明细(SKU、数量、价格、定制项等)。上层 agent 若要把「查一单」拆成多步接口,需要先拿到订单明细列表,再交给后续 skill 做库存核对、改单或对账。本技能是酷特海外运营平台上的原子接口 skill,只负责 order_detail_list 这一动作:按订单 ID 拉取组成明细,不包办整条业务链路。
技能如何工作
- 固定环境:执行器使用 frontmatter 中的正式环境
base_url(https://www.kutetailor.com/api),调用路径为GET /order/orden-detail/getOrdenDetail,不接受用户输入覆盖 base_url。 - 传参约定:tool arguments 最外层仅包含嵌套对象
params;Query 参数ordenId写在params.query;登录态通过params.accessToken生成Authorization: Bearer(值已含Bearer时不重复拼接)。 - 返回事实:以接口响应为准,不向用户或上层 agent 补造库存、价格、订单号、优惠或物流状态;认证、权限、参数或业务错误时,应把原始错误码与信息向上传递。
适用边界与注意点
若用户需求涉及登录、订单列表、改价、发货等多步操作,需由上层按聚合 skill platform-order-components 或计划文档编排多个原子 skill;本 skill 只完成本接口调用并把关键返回字段交给后续步骤。查询类接口仍受当前登录态、租户与用户权限约束。
使用场景
- 客服接到海外客户询单时,已有平台订单号,需按 ordenId 拉取组成明细核对 SKU 与数量
- 对账前 agent 先调用本接口获取订单行项目,再与 ERP 或仓储回传数据逐行比对
- 改单或拆单流程中,上层编排先查询当前订单明细列表,再决定后续改价或取消行项接口
- 运营排查「一单多行」异常时,用固定 GET 接口查看平台侧订单组成,避免手工登录后台翻页
适合人员
- 对接酷特海外运营 API 的集成工程师,需要在 agent 工具链里封装 ordenId 查询明细
- 海外 B2B 运营专员,经常要核对定制订单各行物料与平台展示是否一致
- 构建 platform-order-components 聚合 skill 的 agent 维护者,要插入 order_detail_list 原子步骤
- 财务或供应链同事,在自动化对账脚本里需要权威订单行明细作为比对输入