KuteSmart 海外订单查询与状态追踪
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-order-query。
技能介绍
解决什么问题
海外运营平台订单提交后,工程师经常需要确认订单号、状态、物流单号,或把状态同步到外部系统。手动翻后台或重复调用不同接口容易混,尤其定制、成品、简定制和公共 API 返回结构不一致。platform-order-query 把这些只读查询收敛到一个技能里。
技能如何工作
- 内部订单接口:通过
params.action选择order_detail、finish_order_detail、design_order_detail或shipping_code。 - 公共接口:
public_order_status和public_order_details面向外部系统,路径参数为orderid,返回String。 - 调用约束:最外层只放
params;内部接口需要accessToken,详情需要orderId,物流需要ordenNo。 - 推荐路径:提交结果里拿到
orderId/ordenNo后,按已知类型优先查成品或简定制详情;不确定时使用order_detail并传type。
边界与注意
该技能只读,不提交、不撤单、不删除、不支付、不发货。状态是否支付成功必须以接口状态字段为准;公共 API 返回字符串时不要擅自改写成成功。查不到订单时保留 orderId 或 ordenNo 线索,不编造状态。
使用场景
- 定制订单提交后,根据订单 ID 查询成品或简定制详情并核对状态。
- 用户反馈物流信息时,用订单号查询物流单号并回复具体单号。
- 外部系统对账时,调用公共订单状态接口读取订单当前状态。
- 排查提交结果异常时,查询订单详情里的 error 或 errorList 字段。
适合人员
- 海外平台运营:提交后需要确认订单号、状态和物流单号。
- 后端工程师:把平台订单状态同步到外部系统或对账。
- 客服/业务支持:用户询问订单进度时需要查具体详情或物流。
- 集成测试工程师:验证公共订单 API 返回字符串是否符合预期。