kutesmart-海外运营平台商品详情库存价格-根据商品候选 id 查看简定制或成品下单详情

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

用于从商品候选进入可下单详情。这个 skill 只读，不写购物车、不提交订单。

调用参数要求

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

{
  "params": {
    "action": "finish_detail",
    "accessToken": "<access_token>",
    "source": "C",
    "originSign": "<site-sign>",
    "id": 123
  }
}

重要约束：

最外层只能放 params。
C 站商品详情接口必须带 source: C 和 originSign，不要只传 ctoken。
id 是商品 id；styleId 是款式 id。保存购物车时用 styleId，不要把商品 id 当成 styleId。
成品下单前必须查颜色/尺码库存；库存为 0 不进入提交订单。
这是只读 skill，不调用购物车和订单写接口。

触发场景

“查看这个商品详情”
“这个成品有哪些颜色尺码”
“查一下库存”
“查这个产品价格”
“拿到 styleId，后面要加购”
“看简定制商品下单需要哪些信息”

输入参数

| 参数 | 类型 | 必填 | 说明 | |---|---|---:|---| | frontmatter.base_url | string | 固定 | 正式环境服务根地址，调用时不由用户传入。 | | params.action | string | 是 | 见下方动作表。 | | params.accessToken | string | 条件 | 登录态调用建议传；发送为 Bearer token。 | | params.source | string | C站建议 | 通常为 C。 | | params.originSign | string | C站详情必填 | C 站站点标识。 | | params.id | number | 详情/库存/尺寸必填 | 商品 id。 | | params.productId | number | 价格必填 | 产品 id，通常等于商品详情的 id。 | | params.currency | number/string | 价格必填 | 币种 id 或后端要求的币种值。 | | params.color | string | 库存必填 | 成品颜色。 | | params.size | string | 库存必填 | 成品尺码名称。 | | params.unit | string | 转换可选 | 厘米/英寸切换时按后端口径传。 | | params.body | object | 转换可选 | switch_position 需要的其他查询参数。 |

动作表

| action | 请求 | URL | 参数 | 返回 | 用途 | |---|---|---|---|---|---| | custom_detail | GET | /product/product/public/selectProductOrden | Query：id | OrderProductVO | 简定制商品详情/下单页详情。 | | finish_detail | GET | /product/product/public/selectFinishOrder | Query：id | OrderFinishInfoVO | 成品商品详情/下单页详情。 | | product_stock | GET | /product/product/public/selectProductCountById | Query：id、color、size | BigDecimal | 按商品、颜色、尺码查询成品库存。 | | product_price | GET | /product-price/{productId}/{currency} | Path：productId、currency | RS<ProductPriceVO> | 查询指定币种价格。 | | product_size | GET | /product/product/public/selectProductSize | Query：id | StandardSizeVO | 查询产品部位对应尺寸标准号。 | | switch_position | GET | /product/product/public/switchPosition | Query：id 和转换参数 | List<SizeListVO> | 厘米/英寸部位值切换。 |

返回字段重点

简定制详情 OrderProductVO：

| 字段 | 说明 | |---|---| | id | 商品 id。 | | styleId | 款式 id，后续保存购物车/订单关键字段。 | | category | 品类。 | | fabricCode | 默认或当前面料编码。 | | price / currencySymbol | 价格与币种展示。 | | size | 尺寸摘要。 | | categoryList | 简定制品类配置。 | | craft | 默认或可选工艺摘要。 | | fabricsList | 可选面料列表。 | | measuresType | 量体方式。 |

成品详情 OrderFinishInfoVO：

| 字段 | 说明 | |---|---| | id | 商品 id。 | | styleId | 款式 id，首轮加购必须使用。 | | name | 商品名称。 | | price / currencySymbol | 价格与币种展示。 | | size | 尺码摘要。 | | productFinishStock / productFinishStockList | 成品颜色、尺码和库存信息。 |

价格 ProductPriceVO：

| 字段 | 说明 | |---|---| | retailPrice | 零售价。 | | taxRate | 税率。 | | ifCharge | 是否收费标识。 | | embroidery | 刺绣相关价格配置。 |

安全边界

不在库存为 0 或缺少颜色/尺码时建议提交。
不生成未返回的 styleId、价格或库存。
不调用 saveStyleMyCart、saveStyleOrden、submitOrdenList。
后端返回业务错误时原样反馈，并提示缺少的参数或上下文。

来源

| 项目 | 路径 | |---|---| | 商品详情/库存/尺寸接口 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductController.java | | 产品价格接口 | rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductPriceController.java | | 接口清单 | doc/interface-list.md |

kutesmart-海外运营平台商品详情库存价格-根据商品候选 id 查看简定制或成品下单详情

kutesmart-海外运营平台商品详情库存价格-根据商品候选 id 查看简定制或成品下单详情

调用参数要求

触发场景

输入参数

动作表

推荐流程

返回字段重点

安全边界

来源