返回 Skill 列表
extension
分类: 其它需要 API Key

kutesmart-海外运营平台订单查询与状态-在提交后查询订单详情、订单状态、物流单号、提交结果追踪

调用海外运营平台订单详情、成品订单详情、简定制订单详情、物流单号和公共订单状态/详情接口。用于在提交后查询订单详情、订单状态、物流单号、提交结果追踪,以及按订单 id 或订单号核验订单;当用户要查订单、查物流、查提交结果或查看订单明细时触发。

person作者: user_ac9585d3hubcommunity

kutesmart-海外运营平台订单查询与状态-在提交后查询订单详情、订单状态、物流单号、提交结果追踪

正式环境固定服务根地址:https://www.kutetailor.com/api/order

用于提交后的只读追踪。这个 skill 不修改订单、不撤单、不删除订单。

调用参数要求

调用本技能时,tool arguments 统一使用嵌套 params 对象:

{
  "params": {
    "action": "finish_order_detail",
    "accessToken": "<access_token>",
    "orderId": 123
  }
}

重要约束:

  • 最外层只能放 params
  • 平台内部订单详情接口带 Authorization: Bearer <accessToken>
  • /api/public/order/* 是公开对接接口,返回 String,鉴权和签名要求以部署环境为准。
  • 这是只读 skill,不调用提交、撤单、删除、支付、发货等写接口。

触发场景

  • “查一下这个订单”
  • “提交后订单号是多少”
  • “看成品订单详情”
  • “看简定制订单详情”
  • “查物流单号”
  • “查公共 API 订单状态”

输入参数

| 参数 | 类型 | 必填 | 说明 | |---|---|---:|---| | frontmatter.base_url | string | 固定 | 正式环境服务根地址,调用时不由用户传入。 | | params.action | string | 是 | 见下方动作表。 | | params.accessToken | string | 内部接口必填 | Bearer token。 | | params.orderId | number | 内部详情必填 | 订单 id。 | | params.type | number | order_detail 可选 | 订单类型,按后端口径传。 | | params.ordenNo | string | shipping_code 必填 | 订单号。 | | params.orderid | string | 公共接口必填 | 公共 API 使用的订单 id/订单号路径参数。 |

动作表

| action | 请求 | URL | 参数 | 返回 | 用途 | |---|---|---|---|---|---| | order_detail | GET | /order/orden/selectOrdenDetails | Query:orderId、可选 type | RS<OrdenListVO> | 查询订单详情,定制类通用入口。 | | finish_order_detail | GET | /order/orden/selectFinishOrdenDetails | Query:orderId | RS<OrdenFinishDetailVO> | 查询成品订单详情。 | | design_order_detail | GET | /order/orden/selectDesignOrdenDetails | Query:orderId | RS<OrdenDesignDetailVO> | 查询简定制订单详情。 | | shipping_code | GET | /order/orden/getShippingCode | Query:ordenNo | RS<List<String>> | 根据订单号查询物流单号。 | | public_order_status | GET | /api/public/order/status/{orderid} | Path:orderid | String | 公共 API 查询订单状态。 | | public_order_details | GET | /api/public/order/details/{orderid} | Path:orderid | String | 公共 API 查询订单详情。 |

推荐流程

  1. platform-coupon-checkoutplatform-style-order-full 的提交结果里读取 ordenIdordenNo
  2. 已知成品订单时优先 finish_order_detail;已知简定制时优先 design_order_detail;不确定时使用 order_detail 并传 type
  3. 用户问物流时使用 shipping_code,参数为订单号 ordenNo
  4. 对接外部系统状态时使用 /api/public/order/*,注意返回是字符串,需要按实际内容解析或原样展示。

返回字段重点

| 字段 | 说明 | |---|---| | orderId / ordenId | 订单 id。 | | ordenNo | 订单号,查物流常用。 | | status / statusStr | 订单状态,以接口返回为准。 | | category / ordenType | 品类和订单类型。 | | customer / cust | 客户信息。 | | product / style | 商品/款式信息。 | | price / salePrice / amount | 价格和数量。 | | error / errorCode / errorList | 提交或订单异常信息,原样保留。 |

安全边界

  • 不使用订单查询结果推断支付成功,除非状态字段明确说明。
  • 不调用后台订单维护、撤单、删除、发货、同步接口。
  • 公共 API 返回字符串时不要擅自改写为成功;解析失败就原样展示。
  • 查询不到订单时说明使用的 orderIdordenNo,不要编造状态。

来源

| 项目 | 路径 | |---|---| | 订单详情/物流接口 | rcmtm-cloud-order/src/main/java/com/kutesmart/cloud/order/controller/OrdenController.java | | 公共订单 API | rcmtm-cloud-order/src/main/java/com/kutesmart/cloud/order/controller/OrderOpenApi.java | | 接口清单 | doc/interface-list.md |