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 查询订单详情。 |
推荐流程
- 从
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 | 提交或订单异常信息,原样保留。 |
安全边界
- 不使用订单查询结果推断支付成功,除非状态字段明确说明。
- 不调用后台订单维护、撤单、删除、发货、同步接口。
- 公共 API 返回字符串时不要擅自改写为成功;解析失败就原样展示。
- 查询不到订单时说明使用的
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 |
Scan to join WeChat group