正式环境固定服务根地址：https://www.kutetailor.com/api/order
用于提交后的只读追踪。这个 skill 不修改订单、不撤单、不删除订单。
调用本技能时，tool arguments 统一使用嵌套 params 对象：
{
"params": {
"action": "finish_order_detail",
"accessToken": "<access_token>",
"orderId": 123
}
}
重要约束：
params。Authorization: Bearer 。/api/public/order/* 是公开对接接口，返回 String，鉴权和签名要求以部署环境为准。| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| --- | --- | ---: | --- |
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 | 查询订单详情，定制类通用入口。 |
finish_order_detail | GET | /order/orden/selectFinishOrdenDetails | Query：orderId | RS | 查询成品订单详情。 |
design_order_detail | GET | /order/orden/selectDesignOrdenDetails | Query：orderId | RS | 查询简定制订单详情。 |
shipping_code | GET | /order/orden/getShippingCode | Query：ordenNo | RS | 根据订单号查询物流单号。 |
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 查询订单详情。 |
platform-coupon-checkout 或 platform-style-order-full 的提交结果里读取 ordenId、ordenNo。finish_order_detail；已知简定制时优先 design_order_detail；不确定时使用 order_detail 并传 type。shipping_code，参数为订单号 ordenNo。/api/public/order/*，注意返回是字符串，需要按实际内容解析或原样展示。| 字段 | 说明 |
|---|---|
| --- | --- |
orderId / ordenId | 订单 id。 |
ordenNo | 订单号，查物流常用。 |
status / statusStr | 订单状态，以接口返回为准。 |
category / ordenType | 品类和订单类型。 |
customer / cust | 客户信息。 |
product / style | 商品/款式信息。 |
price / salePrice / amount | 价格和数量。 |
error / errorCode / errorList | 提交或订单异常信息，原样保留。 |
orderId 或 ordenNo，不要编造状态。| 项目 | 路径 |
|---|---|
| --- | --- |
| 订单详情/物流接口 | 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 |
共 3 个版本