调用海外运营平台商品详情、成品库存、产品价格、尺寸标准和尺码单位转换接口。用于根据商品候选 id 查看简定制或成品下单详情,取得 styleId、面料、品类、颜色尺码、库存和价格,为购物车、完整下单、客户量体、面料工艺 skill 提供可下单详情;当用户要看商品详情、查库存、查价格或确认可下单配置时触发。
kutesmart-海外运营平台商品详情库存价格-根据商品候选 id 查看简定制或成品下单详情是一项面向实际任务的技能,主要用于正式环境固定服务根地址: https://www.kutetailor.com/api/product;用于从商品候选进入可下单详情;
重要约束:。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
正式环境固定服务根地址:https://www.kutetailor.com/api/product
用于从商品候选进入可下单详情。这个 skill 只读,不写购物车、不提交订单。
调用本技能时,tool arguments 统一使用嵌套 params 对象:
{
"params": {
"action": "finish_detail",
"accessToken": "",
"source": "C",
"originSign": "",
"id": 123
}
}
重要约束:
params。source: C 和 originSign,不要只传 ctoken。id 是商品 id;styleId 是款式 id。保存购物车时用 styleId,不要把商品 id 当成 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 |
查询指定币种价格。 |
product_size |
GET |
/product/product/public/selectProductSize |
Query:id |
StandardSizeVO |
查询产品部位对应尺寸标准号。 |
switch_position |
GET |
/product/product/public/switchPosition |
Query:id 和转换参数 |
List |
厘米/英寸部位值切换。 |
platform-product-browse 返回的商品候选,读取 id、type、styleId。type=1 调 custom_detail;type=2 调 finish_detail。styleId、category、fabricCode、price、currencySymbol、size 和库存列表。product_stock 做最终库存确认。product_price。product_size;需要单位转换时调用 switch_position。platform-cart-address 或 platform-style-order-full。简定制详情 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 |
刺绣相关价格配置。 |
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 |
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章