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，后面要加购”
• “看简定制商品下单需要哪些信息”

输入参数

动作表

推荐流程

1. 接收 platform-product-browse 返回的商品候选，读取 id、type、styleId。
2. type=1 调 custom_detail；type=2 调 finish_detail。
3. 从详情返回中保留 styleId、category、fabricCode、price、currencySymbol、size 和库存列表。
4. 成品商品如果用户选了颜色和尺码，调用 product_stock 做最终库存确认。
5. 需要币种价格时调用 product_price。
6. 简定制需要尺寸标准时调用 product_size；需要单位转换时调用 switch_position。
7. 把整理后的可下单摘要交给 platform-cart-address 或 platform-style-order-full。

返回字段重点

简定制详情 OrderProductVO：

成品详情 OrderFinishInfoVO：

价格 ProductPriceVO：

安全边界

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

来源