酷特海外平台订单进度
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-order-progress。
技能介绍
要解决什么问题
订单在酷特海外运营平台提交之后,业务侧和用户侧往往还需要知道:预提交是否成功、采购与生产走到哪一步、面料买了什么、单耗是多少、最晚交期何时。若只靠 platform-order-query 的基础详情,通常不足以回答「进度类」问题。本技能面向正式环境根地址 https://www.kutetailor.com/api/order,专门做提交后的过程追踪,与查询类技能互补。
技能如何工作
通过固定 action 映射到只读 GET 接口,典型流程如下:
- 从提交结果拿到
ordenNo/orderId。 - 问「提交处理结果」→
pre_submit_result(/order/orden-pre-submit/selectByOrdenNo,Query:ordenNo,可选id)。 - 问「采购或生产进度」→
purchase_progress(Path:orderId);需要面料采购细节时补purchase_information。 - 问「面料单耗」→
fabric_usage_by_order_no(Query:ordenNo)。 - 批量问「最晚交期」→
last_delivery_date(Query:orderIds)。
各动作返回均为文档中的 RS 结构,状态与字段以接口为准,不宜自行推断。
边界与注意点
- 只读:不调用
addProgress、updateFabricUsage等写接口或回调。 - 进度语义:不要把采购进度接口的结果当成「订单已最终完成」;完成与否以返回数据为准。
- 参数来源:
orderId/ordenNo应来自合法提交链路,避免用错号查错单。
使用场景
- 客户刚在海外平台提交订单,客服需用订单号确认预提交是否成功及返回明细
- 用户追问「做到哪了」,需用 orderId 拉采购/生产进度并必要时补面料采购信息
- 对账或排产争议时,按 ordenNo 查询该单面料单耗与接口返回的用量字段
- 多单合并发货前,用 orderIds 批量查询各单最晚交期以排期
适合人员
- 对接 Kutetailor 正式环境、在 Agent 里编排订单查询链路的集成工程师
- 海外运营客服:用户问提交结果或生产进度时需按 ordenNo/orderId 调对应 action
- 跟单或计划人员:需看采购进度、面料采购与最晚交期,但不负责写回进度回调
- 与 platform-order-query 配合使用的业务运维:详情查基础状态、本技能查提交后过程