开发文档
商品接口变动说明
更新时间：2024/04/01
访问次数：6363
#2024-04-02 支持发布半托管商品
功能生效时间：2024年4月2号 中午12点全量生效
核心改动：
1.新增semiManaged组件，用于表达该商品是否需要发布成半托管商品
2.开放boxPackaging组件，用于表达商品关联的箱规列表
3.新增半托管商品相关校验
如何发布成半托管商品？
1.商家必须在后台完成半托管的商家准入，否则该商家无法发布半托管
2.发布的商品信息必须满足如下条件：
● 商品开启支持半托管商品（对应组件semiManaged）
● 确定性产品价格（价格类型是sku价 or 阶梯价，如果是询盘品则涉及组件scPrice；如果是RTS品则涉及组件marketPrice）
● 所有启用库存总和>=1（有sku则是sku维度库存，对应组件skuStock；无sku则是商品维度库存，对应组件inventory）
● 商品必须要配置箱规，按箱规发货（对应组件boxPackaging）
● 半托管物流可承运
● 核心国家之一运费可计算（涉及组件shippingTemplateId、pkgWeight、pkgMeasure）
箱规数据（boxPackaging）填写说明
使用alibaba.icbu.product.schema.get接口获取箱规列表，对应示例如下
<field id=\"boxPackaging\" name=\"Box gauge\" type=\"multiCheck\">
<rules>
<rule name=\"valueTypeRule\" value=\"long\"/>
<rule name=\"tipRule\" value=\"账号下的箱规列表请参考
<options>，并将选择的箱子id用作组件的value，并将totalWeight（装满后总重）、maxCount（最大装箱数量）填写到属性中。示例：
<field id=\\"boxPackaging\\" name=\\"Box gauge\\" type=\\"multiCheck\\">
<values>
<value maxCount=\\"2\\" totalWeight=\\"5.79\\">22275361</value>
</values>
</field>。\"/>
</rules>
<options>
<option displayName=\"id:23254128;name:566;length:20.00;width:20.00;height:20.00\" value=\"23254128\"/>
<option displayName=\"id:18958013;name:小号;length:20.00;width:15.00;height:10.00\" value=\"18958013\"/>
<option displayName=\"id:21862063;name:123655;length:32.00;width:20.00;height:5.00\" value=\"21862063\"/>
<option displayName=\"id:22317145;name:箱子;length:100.00;width:100.00;height:100.00\" value=\"22317145\"/>
<option displayName=\"id:20886001;name:500500500;length:500.00;width:500.00;height:500.00\" value=\"20886001\"/>
<option displayName=\"id:20424020;name:大号纸箱;length:60.00;width:60.00;height:40.00\" value=\"20424020\"/>
<option displayName=\"id:17968008;name:三国杀;length:15.00;width:15.00;height:15.00\" value=\"17968008\"/>
<option displayName=\"id:20319001;name:箱规校验测试;length:1.00;width:5.00;height:19.00\" value=\"20319001\"/>
<option displayName=\"id:22199029;name:半托管箱规10;length:40.00;width:60.00;height:40.00\" value=\"22199029\"/>
<option displayName=\"id:19978001;name:麦麦;length:20.00;width:20.00;height:20.00\" value=\"19978001\"/>
<option displayName=\"id:18853012;name:半托管箱规2;length:10.00;width:10.00;height:10.00\" value=\"18853012\"/>
<option displayName=\"id:16186003;name:50件/箱;length:60.00;width:50.00;height:50.00\" value=\"16186003\"/>
<option displayName=\"id:330002;name:test_bug;length:93.00;width:39.00;height:29.00\" value=\"330002\"/>
<option displayName=\"id:156267;name:1_62919;length:2.00;width:1.00;height:11.00\" value=\"156267\"/>
<option displayName=\"id:13424017;name:球衣：1600624445370（同温测试勿删球衣）;length:40.00;width:30.00;height:25.00\" value=\"13424017\"/>
<option displayName=\"id:146001;name:一般快递最大箱子1;length:51.00;width:52.00;height:53.00\" value=\"146001\"/>
<option displayName=\"id:178412;name:纸箱测试2号;length:30.00;width:30.00;height:15.00\" value=\"178412\"/>
<option displayName=\"id:120976;name:无忧专线1号箱*;length:44.00;width:37.00;height:7.00\" value=\"120976\"/>
<option displayName=\"id:4254014;name:测试11111;length:20.00;width:20.00;height:20.00\" value=\"4254014\"/>
<option displayName=\"id:172033;name:中号纸箱1号箱;length:30.00;width:20.00;height:15.00\" value=\"172033\"/>
<option displayName=\"id:151506;name:大号纸箱11号1;length:60.00;width:40.00;height:30.00\" value=\"151506\"/>
<option displayName=\"id:158785;name:衣服;length:12.00;width:12.00;height:10.00\" value=\"158785\"/>
<option displayName=\"id:146980;name:小箱子1号;length:60.00;width:60.00;height:40.00\" value=\"146980\"/>
<option displayName=\"id:146688;name:小纸箱1号;length:20.00;width:20.00;height:10.00\" value=\"146688\"/>
</options>
</field>
数据解释：其中每个option标签代表一个已经存在的箱规，长度（length）、宽度（width）、高度（height）、箱子重量（weight)，如果没有options选项，代表客户账号下目前没有箱规，客户可以去后台创建
客户需要根据这些信息，填写每个箱子可以装的商品数量（maxCount）、装箱后的总重量（totalWeight）
填写后的箱规组件示例如下，代表136906这个箱规最多可以装入商品2件，装箱后重量是5.79kg，18958013这个箱子最多可以装入200件商品，装箱后重量是9.19kg。
<field id=\"boxPackaging\" name=\"Box gauge\" type=\"multiCheck\"> <values> <value maxCount=\"2\" totalWeight=\"5.79\">136906</value> <value maxCount=\"200\" totalWeight=\"9.19\">18958013</value> </values> </field>
发布半托管商品数据完整填写示例
<itemSchema>
<field id=\"scPrice\" name=\"Price Setting\" type=\"singleCheck\">
<value>1</value>
</field>
<field id=\"logisticsProperty\" name=\"Logistics attribute\" type=\"multiCheck\">
<values>
<value >general_cargo_0</value>
</values>
</field>
<field id=\"productTitle\" name=\"Product name\" type=\"input\">
<value>High quality Amazon hot selling premium beard comb and brush set</value>
</field>
<field id=\"catId\" type=\"input\">
<value>12020302</value>
</field>
<field id=\"market\" name=\"Type of product\" type=\"singleCheck\">
<value>2</value>
</field>
<field id=\"priceUnit\" name=\"Unit\" type=\"singleCheck\">
<value>20</value>
</field>
<field id=\"productKeywords\" name=\"Product keywords\" type=\"complex\">
<complex-value>
<field id=\"productKeywords_0\" type=\"input\">
<value>wooden Beard Comb Bamboo Brush</value>
</field>
<field id=\"productKeywords_1\" type=\"input\">
<value>Eco-Friendly Bamboo Comb</value>
</field>
<field id=\"productKeywords_2\" type=\"input\">
<value>Wooden Beard Brush Set</value>
</field>
</complex-value>
</field>
<field id=\"scImages\" name=\"Product photos\" type=\"complex\">
<complex-value>
<field id=\"scImages_0\" name=\"Product Photo\" type=\"input\">
<value fileId=\"8420460812\">//sc04.alicdn.com/kf/Hc1cf666f034d4596b33724aad22c2d5fD/200042360/Hc1cf666f034d4596b33724aad22c2d5fD.jpeg</value>
</field>
</complex-value>
</field>
<field id=\"ladderPrice\" name=\"Quantity price\" type=\"complex\">
<complex-value>
<field id=\"ladderPrice_0\" type=\"complex\">
<complex-value>
<field id=\"quantity\" name=\"MOQ\" type=\"input\">
<value>200</value>
</field>
<field id=\"price\" name=\"FOB Price\" type=\"input\">
<value>1.90</value>
</field>
</complex-value>
</field>
</complex-value>
</field>
<field id=\"saleType\" name=\"Sale Type \" type=\"singleCheck\">
<value>normal</value>
</field>
<field id=\"pkgMeasure\" name=\"Dimensions\" type=\"complex\">
<complex-value>
<field id=\"length\" type=\"input\">
<value>30</value>
</field>
<field id=\"width\" type=\"input\">
<value>20</value>
</field>
<field id=\"height\" type=\"input\">
<value>30</value>
</field>
</complex-value>
</field>
<field id=\"pkgWeight\" name=\"Gross Weight \" type=\"input\">
<value>0.800</value>
</field>
<field id=\"shippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\">
<value>2046618003</value>
</field>
<field id=\"ladderPeriod\" name=\"Shipping\" type=\"complex\">
<complex-value>
<field id=\"ladderPeriod_0\" type=\"complex\">
<complex-value>
<field id=\"quantity\" name=\"Quantity\" type=\"input\">
<value>1000</value>
</field>
<field id=\"day\" name=\"Est. Lead Time\" type=\"input\">
<value>7</value>
</field>
</complex-value>
</field>
</complex-value>
</field>
<field id=\"wholeSalePkgDesc\" name=\"Packaging description\" type=\"input\">
<value>normally 1pcs/opp bag</value>
</field>
<field id=\"productLightCustom\" name=\"Customization\" type=\"singleCheck\">
<value>1</value>
</field>
<field id=\"marketSamplingQuantity\" name=\"Maximum samples per order\" type=\"input\">
<value>1</value>
</field>
<field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\">
<complex-value>
<field id=\"p-191294249\" name=\"OE NO.\" type=\"multiInput\">
<values>
<value inputValue=\"vb\">-1</value>
</values>
</field>
<field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\">
<value inputValue=\"Anguilla\">100000421</value>
</field>
<field id=\"p-100008447\" name=\"Warranty\" type=\"complex\">
<complex-value>
<field id=\"number\" type=\"input\">
<value>12</value>
</field>
<field id=\"unit_type\" type=\"input\">
<value>Months</value>
</field>
</complex-value>
</field>
<field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\">
<value inputValue=\"Used\">190063281</value>
</field>
</complex-value>
</field>
<field id=\"marketSample\" name=\"Product samples\" type=\"singleCheck\">
<value>1</value>
</field>
<field id=\"ecIntegration\" name=\"One-Stop Service\" type=\"singleCheck\">
<value>2</value>
</field>
<field id=\"produceVisualization\" name=\"Production View Service\" type=\"singleCheck\">
<value>2</value>
</field>
<field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\">
<complex-value>
<field id=\"p-191294249\" type=\"multiInput\">
<values>
<value inputValue=\"vb\">-1</value>
</values>
</field>
<field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\">
<value inputValue=\"Anguilla\">100000421</value>
</field>
<field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\">
<value inputValue=\"Used\">190063281</value>
</field>
</complex-value>
</field>
<field id=\"inventory\" type=\"multiInput\">
<values>
<value srcValue=\"0\" warehouseCode=\"CN_LOCAL_01\">40</value>
</values>
</field>
<field id=\"boxPackaging\" name=\"Box gauge\" type=\"multiCheck\">
<values>
<value maxCount=\"2\" totalWeight=\"5.79\">136906</value>
<value maxCount=\"200\" totalWeight=\"9.19\">18958013</value>
</values>
</field>
<field id=\"semiManaged\" name=\"半托管服务\" type=\"singleCheck\">
<value>true</value>
</field>
</itemSchema>
半托管商品部分条件不符合时返回的业务错误码
PUB_BIZCHECK_PRODUCT_SEMI_MANAGE_PRICE_TYPE_INVALID：半托管商品必须是阶梯价或者sku价
PUB_BIZCHECK_PRODUCT_SEMI_MANAGE_INVENTORY_INVALID：半托管商品所有非禁用的sku总本地仓库的可售数量大于等于1
PUB_BIZCHECK_SEMI_MANAGED_BOX_PACKAGING：该类目下半托管商品必须要启用箱规
如果不想发布半托管怎么办？是否需要改造？
由于本身是新增组件，因此理论上是完全兼容升级，如果不想发布半托管商品，客户保持原有发品数据不变即可（不填写boxPackaging和semiManaged）
2024-01-26 产品关键升级公告
【通知】国际站预计于2024年2月1号（下周四）左右对“产品关键词”进行三框合一升级，此次合框不影响关键词在搜索排序。
升级前：产品关键词3个框，每个框128字符
升级后：产品关键词1个框，合计384个字符（128*3）
升级后效果截图如下
需ISV准备：
辛苦各位ISV做好对应产品关键词合框，否则一旦国际站升级为一个框，ISV保留3个框，会出现数据同步失败的问题
技术改造方式：
原有的关键词field对应的值格式保持不变，但数量变成只允许填写一个，填写示例如下：
<field id=\"productKeywords\" type=\"complex\">
<complex-value>
<field id=\"productKeywords_0\" type=\"input\">
<value>key words</value>
</field>
</complex-value>
</field>
异常情况提示，如果填写的关键词数量>1，发品接口会返回错误码如下，提示关键词数量超出限制
isp.system-service-error:PUB_BIZCHECK_KEYWORD_EXCEED_COUNT;
2023-12-7 询盘品可交易化涉及API功能优化
影响面：技术、业务均为兼容升级，isv理论上不需要进行技术变更
问题：由于isv通过在获取发布规则时alibaba.icbu.product.schema.get无法区分RTS品和souring品，而部分情况下规则中只会获取到sample类型的物流组件，导致isv在发布RTS品的过程中存在兼容问题。
优化方案：对于使用OpenAPI的商家，统一只返回非sample的组件，sample类型的组件不再返回，与交易化升级之前保持一致，组件列表如下：shippingTemplateId、pkgMeasure、pkgWeight、logisticsProperty
ISV侧不再感知灰度逻辑，不需要处理sample和非sample的两套组件。对于使用OpenAPI的商家，对于全部类目统一返回非sample组件，客户在渲染和提交均使用统一的非sample组件即可，具体的业务灰度逻辑由API提供方进行兼容。
2023-11-25 询盘品可交易化涉及API功能变动
1.背景
近期国际站针对部分行业进行了询盘品交易化升级，主要包括：支持在商品上表达运费模版、长宽高等物流信息，去除非确定性的价格类型-区间价等，当前主要在汽配行业进行了升级，后续会扩展到全行业、全商家。
从11.30开始，逐步分类目、分商家进行灰度，预计到12.14号全量开放询盘品交易化。
具体的业务规则变动见下方语雀文档
https://www.yuque.com/sunwei-ua9i2/hsiqwg/udnb3amys0r5qmo2
为了满足商家通过ERP等方式将商品升级为可交易商品的需求，统一API和国际站后台的业务逻辑，我们决定对API功能也进行升级，在此周知到对接商品相关API的ISV。
2.影响范围
适配上述业务变更，我们将询盘品本身的物流组件和询盘品支持样品时的样品物流组件进行了拆分，本次只影响询盘品逻辑，在灰度期间，具体组件变动如下:
业务含义 |
原组件 |
新组件 |
运费模版 |
shippingTemplateId |
商品关联的运费模版：shippingTemplateId，询盘品支持样品时关联的运费模版：sampleShippingTemplateId |
长宽高 |
pkgMeasure |
商品长宽高：pkgMeasure，询盘品支持样品时配置的长宽高：samplePkgMeasure |
商品毛重 |
pkgWeight |
商品重量：pkgWeight，询盘品支持样品时配置的重量：samplePkgWeight |
物流属性 |
logisticsProperty |
商品物流属性：logisticsProperty，询盘品支持样品时配置的物流属性：sampleLogisticsProperty |
在原有逻辑中（2023.11.30发布之前），询盘品只有在设置了支持样品（对应组件为marketSample的值为1）时，才需要填写组件shippingTemplateId、pkgMeasure、pkgWeight的值，用来配置询盘品样品的物流信息。
在升级后，可分为两种情况:
第一种，在进行了询盘品交易化升级的类目下，使用alibaba.icbu.product.schema.get获取新发规则，以及使用alibaba.icbu.product.schema.render渲染存量的询盘商品时，依然只会获取到shippingTemplateId、pkgMeasure、pkgWeight三个组件，但三个组件的填写已经与是否支持样品无关，可以理解为直接表达在商品上的物流信息，并且在部分类目下是必填，如果不填会导致发布失败。
第二种，在尚未进行询盘品交易化升级的类目下或者商家暂未在灰度中，使用alibaba.icbu.product.schema.get获取新发规则，以及使用alibaba.icbu.product.schema.render渲染存量的询盘品时，已经不会获取到shippingTemplateId、pkgMeasure、pkgWeight三个组件，这是因为在这部分类目下只支持样品上表达询盘品的物流信息，因此会获取到sampleShippingTemplateId、samplePkgMeasure、samplePkgWeight三个组件（设置了支持样品的情况下）并且在设置了支持样品的前提下，三个组件为必填，不填写会导致发布失败，提示样品物流组件缺失。
3.建议的后续Action
由于后续该变动会持续扩展到其他类目，建议各个ISV做如下适配：
a.关于灰度。由于功能变动会分类目进行运营，分商家按照比例灰度，因此可能会出现部分商家在部分类目下可以单独设置询盘品本身的物流，而其他商家或者其他类目下只能设置样品上关联的物流，属于正常情况，并且和商家在国际站后台看到的业务规则是一致的。
b.样品和商品的两套物流组件拆分。与当前业务对齐，拆分上述组件，将样品物流信息与商品物流信息分开（组件格式实际上没有变动，样品的物流组件和商品的物流组件是一致的，国际站后台也是保持一致的）
c.商品发布提交数据升级。按照逻辑：渲染什么组件，就提交什么组件进行适配。使用alibaba.icbu.product.schema.get、alibaba.icbu.product.schema.render进行渲染的时候，根据获取到的具体的组件name进行渲染，如：获取的组件是sampleLogistisProperty，那么在客户填写完对应信息后进行新发或者编辑时，请将组件的值带入到sampleLogistisProperty中。获取的组件是logistisProperty，那么在客户填写完对应信息后进行新发或者编辑时，请将组件的值带入到logistisProperty中，其他组件同理。
d.新的业务规则较复杂，请注意数据校验和对客提示的友好性。按照获取到的组件中的required做好必填校验：部分类目下物流信息为必填，部分类目下为选填；设置支持样品的商品，样品的物流信息为必填。否则，可能导致发布失败
4.相关case举例
更新商品物流信息：类目已经支持询盘品交易化并且商家已经在灰度中
{ "cat_id": 201331610, "product_id": 1600995740618, "language": "en_US", "xml": "<itemSchema><field id=\"pkgWeight\" name=\"Gross Weight\n\" type=\"input\"><value>0.02</value></field><field id=\"pkgMeasure\" name=\"Dimensions\" type=\"complex\"><complex-value><field id=\"width\" type=\"input\"><value>0.22</value></field><field id=\"length\" type=\"input\"><value>0.22</value></field><field id=\"height\" type=\"input\"><value>0.11</value></field></complex-value><fields><field id=\"length\" type=\"input\"><rules><rule name=\"valueTypeRule\" value=\"double\"/><rule name=\"requiredRule\" value=\"true\"/></rules></field><field id=\"width\" type=\"input\"><rules><rule name=\"valueTypeRule\" value=\"double\"/><rule name=\"requiredRule\" value=\"true\"/></rules></field><field id=\"height\" type=\"input\"><rules><rule name=\"valueTypeRule\" value=\"double\"/><rule name=\"requiredRule\" value=\"true\"/></rules></field></fields></field><field id=\"shippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\"><value>2041443005</value></field><field id=\"shippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\"><value>2041519018</value></field><field id=\"logisticsProperty\" name=\"Logistics attribute\" type=\"multiCheck\"><values><value >general_cargo_0</value></values></field></itemSchema>" }
更新样品物流信息：类目尚未支持询盘品交易商品或者商家尚未在灰度中
{ "cat_id":100003290, "language":"en_US", "xml":"<itemSchema><field id=\"logisticsProperty\" name=\"Logistics attribute\" type=\"multiCheck\"><values><value >general_cargo_0</value></values></field><field id=\"productTitle\" name=\"Product name\" type=\"input\"><value>High quality Amazon hot selling premium beard comb and brush set</value></field><field id=\"catId\" type=\"input\"><value>12020302</value></field><field id=\"market\" name=\"Type of product\" type=\"singleCheck\"><value>2</value></field><field id=\"priceUnit\" name=\"Unit\" type=\"singleCheck\"><value>20</value></field><field id=\"productKeywords\" name=\"Product keywords\" type=\"complex\"><complex-value><field id=\"productKeywords_0\" type=\"input\"><value>wooden Beard Comb Bamboo Brush</value></field><field id=\"productKeywords_1\" type=\"input\"><value>Eco-Friendly Bamboo Comb</value></field><field id=\"productKeywords_2\" type=\"input\"><value>Wooden Beard Brush Set</value></field></complex-value></field><field id=\"scImages\" name=\"Product photos\" type=\"complex\"><complex-value><field id=\"scImages_0\" name=\"Product Photo\" type=\"input\"><value fileId=\"8420460812\">//sc04.alicdn.com/kf/Hc1cf666f034d4596b33724aad22c2d5fD/200042360/Hc1cf666f034d4596b33724aad22c2d5fD.jpeg</value></field></complex-value></field><field id=\"ladderPrice\" name=\"Quantity price\" type=\"complex\"><complex-value><field id=\"ladderPrice_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"MOQ\" type=\"input\"><value>200</value></field><field id=\"price\" name=\"FOB Price\" type=\"input\"><value>1.90</value></field></complex-value></field></complex-value></field><field id=\"saleType\" name=\"Sale Type \" type=\"singleCheck\"><value>normal</value></field><field id=\"pkgMeasure\" name=\"Dimensions\" type=\"complex\"><complex-value><field id=\"length\" type=\"input\"><value>30</value></field><field id=\"width\" type=\"input\"><value>20</value></field><field id=\"height\" type=\"input\"><value>30</value></field></complex-value></field><field id=\"pkgWeight\" name=\"Gross Weight \" type=\"input\"><value>0.800</value></field><field id=\"shippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\"><value>2026803036</value></field><field id=\"ladderPeriod\" name=\"Shipping\" type=\"complex\"><complex-value><field id=\"ladderPeriod_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"Quantity\" type=\"input\"><value>1000</value></field><field id=\"day\" name=\"Est. Lead Time\" type=\"input\"><value>7</value></field></complex-value></field></complex-value></field><field id=\"logisticsMode\" name=\"Logistics mode\" type=\"multiCheck\"><rules><rule name=\"requiredRule\" value=\"true\"/></rules><values><value>1</value></values><options><option displayName=\"Express\n\" value=\"1\"/><option displayName=\"Ocean\" value=\"2\"/><option displayName=\"Land\" value=\"3\"/><option displayName=\"Air\" value=\"4\"/></options></field><field id=\"wholeSalePkgDesc\" name=\"Packaging description\" type=\"input\"><value>normally 1pcs/opp bag</value></field><field id=\"productLightCustom\" name=\"Customization\" type=\"singleCheck\"><value>1</value></field><field id=\"marketSamplingQuantity\" name=\"Maximum samples per order\" type=\"input\"><value>1</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" name=\"OE NO.\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-100008447\" name=\"Warranty\" type=\"complex\"><complex-value><field id=\"number\" type=\"input\"><value>12</value></field><field id=\"unit_type\" type=\"input\"><value>Months</value></field></complex-value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"marketSample\" name=\"Product samples\" type=\"singleCheck\"><value>1</value></field><field id=\"ecIntegration\" name=\"One-Stop Service\" type=\"singleCheck\"><value>2</value></field><field id=\"produceVisualization\" name=\"Production View Service\" type=\"singleCheck\"><value>2</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"inventory\" type=\"multiInput\"><values><value srcValue=\"0\" warehouseCode=\"CN_LOCAL_01\">40</value></values></field><field id=\"marketSamplingPrice\" name=\"Sample Price\" type=\"input\"><value>0.11</value></field></itemSchema>" }
新发布商品：类目已经支持询盘交易化，并且商家已经在灰度中
{ "cat_id":333, "language":"en_US", "xml":"<itemSchema><field id=\"sampleLogisticsProperty\" name=\"Logistics attribute\" type=\"multiCheck\"><values><value >general_cargo_0</value></values></field><field id=\"productTitle\" name=\"Product name\" type=\"input\"><value>High quality Amazon hot selling premium beard comb and brush set</value></field><field id=\"catId\" type=\"input\"><value>12020302</value></field><field id=\"market\" name=\"Type of product\" type=\"singleCheck\"><value>2</value></field><field id=\"priceUnit\" name=\"Unit\" type=\"singleCheck\"><value>20</value></field><field id=\"productKeywords\" name=\"Product keywords\" type=\"complex\"><complex-value><field id=\"productKeywords_0\" type=\"input\"><value>wooden Beard Comb Bamboo Brush</value></field><field id=\"productKeywords_1\" type=\"input\"><value>Eco-Friendly Bamboo Comb</value></field><field id=\"productKeywords_2\" type=\"input\"><value>Wooden Beard Brush Set</value></field></complex-value></field><field id=\"scImages\" name=\"Product photos\" type=\"complex\"><complex-value><field id=\"scImages_0\" name=\"Product Photo\" type=\"input\"><value fileId=\"8420460812\">//sc04.alicdn.com/kf/Hc1cf666f034d4596b33724aad22c2d5fD/200042360/Hc1cf666f034d4596b33724aad22c2d5fD.jpeg</value></field></complex-value></field><field id=\"ladderPrice\" name=\"Quantity price\" type=\"complex\"><complex-value><field id=\"ladderPrice_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"MOQ\" type=\"input\"><value>200</value></field><field id=\"price\" name=\"FOB Price\" type=\"input\"><value>1.90</value></field></complex-value></field></complex-value></field><field id=\"saleType\" name=\"Sale Type \" type=\"singleCheck\"><value>normal</value></field><field id=\"samplePkgMeasure\" name=\"Dimensions\" type=\"complex\"><complex-value><field id=\"length\" type=\"input\"><value>30</value></field><field id=\"width\" type=\"input\"><value>20</value></field><field id=\"height\" type=\"input\"><value>30</value></field></complex-value></field><field id=\"samplePkgWeight\" name=\"Gross Weight \" type=\"input\"><value>0.800</value></field><field id=\"sampleShippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\"><value>2026803036</value></field><field id=\"ladderPeriod\" name=\"Shipping\" type=\"complex\"><complex-value><field id=\"ladderPeriod_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"Quantity\" type=\"input\"><value>1000</value></field><field id=\"day\" name=\"Est. Lead Time\" type=\"input\"><value>7</value></field></complex-value></field></complex-value></field><field id=\"logisticsMode\" name=\"Logistics mode\" type=\"multiCheck\"><rules><rule name=\"requiredRule\" value=\"true\"/></rules><values><value>1</value></values><options><option displayName=\"Express\n\" value=\"1\"/><option displayName=\"Ocean\" value=\"2\"/><option displayName=\"Land\" value=\"3\"/><option displayName=\"Air\" value=\"4\"/></options></field><field id=\"wholeSalePkgDesc\" name=\"Packaging description\" type=\"input\"><value>normally 1pcs/opp bag</value></field><field id=\"productLightCustom\" name=\"Customization\" type=\"singleCheck\"><value>1</value></field><field id=\"marketSamplingQuantity\" name=\"Maximum samples per order\" type=\"input\"><value>1</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" name=\"OE NO.\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-100008447\" name=\"Warranty\" type=\"complex\"><complex-value><field id=\"number\" type=\"input\"><value>12</value></field><field id=\"unit_type\" type=\"input\"><value>Months</value></field></complex-value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"marketSample\" name=\"Product samples\" type=\"singleCheck\"><value>1</value></field><field id=\"ecIntegration\" name=\"One-Stop Service\" type=\"singleCheck\"><value>2</value></field><field id=\"produceVisualization\" name=\"Production View Service\" type=\"singleCheck\"><value>2</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"inventory\" type=\"multiInput\"><values><value srcValue=\"0\" warehouseCode=\"CN_LOCAL_01\">40</value></values></field><field id=\"marketSamplingPrice\" name=\"Sample Price\" type=\"input\"><value>0.11</value></field></itemSchema>" }
新发布商品(支持样品)：类目尚未支持询盘交易化，或者商家尚未在灰度中
{ "cat_id":333, "language":"en_US", "xml":"<itemSchema><field id=\"logisticsProperty\" name=\"Logistics attribute\" type=\"multiCheck\"><values><value >general_cargo_0</value></values></field><field id=\"productTitle\" name=\"Product name\" type=\"input\"><value>High quality Amazon hot selling premium beard comb and brush set</value></field><field id=\"catId\" type=\"input\"><value>12020302</value></field><field id=\"market\" name=\"Type of product\" type=\"singleCheck\"><value>2</value></field><field id=\"priceUnit\" name=\"Unit\" type=\"singleCheck\"><value>20</value></field><field id=\"productKeywords\" name=\"Product keywords\" type=\"complex\"><complex-value><field id=\"productKeywords_0\" type=\"input\"><value>wooden Beard Comb Bamboo Brush</value></field><field id=\"productKeywords_1\" type=\"input\"><value>Eco-Friendly Bamboo Comb</value></field><field id=\"productKeywords_2\" type=\"input\"><value>Wooden Beard Brush Set</value></field></complex-value></field><field id=\"scImages\" name=\"Product photos\" type=\"complex\"><complex-value><field id=\"scImages_0\" name=\"Product Photo\" type=\"input\"><value fileId=\"8420460812\">//sc04.alicdn.com/kf/Hc1cf666f034d4596b33724aad22c2d5fD/200042360/Hc1cf666f034d4596b33724aad22c2d5fD.jpeg</value></field></complex-value></field><field id=\"ladderPrice\" name=\"Quantity price\" type=\"complex\"><complex-value><field id=\"ladderPrice_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"MOQ\" type=\"input\"><value>200</value></field><field id=\"price\" name=\"FOB Price\" type=\"input\"><value>1.90</value></field></complex-value></field></complex-value></field><field id=\"saleType\" name=\"Sale Type \" type=\"singleCheck\"><value>normal</value></field><field id=\"samplePkgMeasure\" name=\"Dimensions\" type=\"complex\"><complex-value><field id=\"length\" type=\"input\"><value>30</value></field><field id=\"width\" type=\"input\"><value>20</value></field><field id=\"height\" type=\"input\"><value>30</value></field></complex-value></field><field id=\"samplePkgWeight\" name=\"Gross Weight \" type=\"input\"><value>0.800</value></field><field id=\"shippingTemplateId\" name=\"Shipping template\" type=\"singleCheck\"><value>2026803036</value></field><field id=\"ladderPeriod\" name=\"Shipping\" type=\"complex\"><complex-value><field id=\"ladderPeriod_0\" type=\"complex\"><complex-value><field id=\"quantity\" name=\"Quantity\" type=\"input\"><value>1000</value></field><field id=\"day\" name=\"Est. Lead Time\" type=\"input\"><value>7</value></field></complex-value></field></complex-value></field><field id=\"logisticsMode\" name=\"Logistics mode\" type=\"multiCheck\"><rules><rule name=\"requiredRule\" value=\"true\"/></rules><values><value>1</value></values><options><option displayName=\"Express\n\" value=\"1\"/><option displayName=\"Ocean\" value=\"2\"/><option displayName=\"Land\" value=\"3\"/><option displayName=\"Air\" value=\"4\"/></options></field><field id=\"wholeSalePkgDesc\" name=\"Packaging description\" type=\"input\"><value>normally 1pcs/opp bag</value></field><field id=\"productLightCustom\" name=\"Customization\" type=\"singleCheck\"><value>1</value></field><field id=\"marketSamplingQuantity\" name=\"Maximum samples per order\" type=\"input\"><value>1</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" name=\"OE NO.\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-100008447\" name=\"Warranty\" type=\"complex\"><complex-value><field id=\"number\" type=\"input\"><value>12</value></field><field id=\"unit_type\" type=\"input\"><value>Months</value></field></complex-value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"marketSample\" name=\"Product samples\" type=\"singleCheck\"><value>1</value></field><field id=\"ecIntegration\" name=\"One-Stop Service\" type=\"singleCheck\"><value>2</value></field><field id=\"produceVisualization\" name=\"Production View Service\" type=\"singleCheck\"><value>2</value></field><field id=\"icbuCatProp\" name=\"Product feature\" type=\"complex\"><complex-value><field id=\"p-191294249\" type=\"multiInput\"><values><value inputValue=\"vb\">-1</value></values></field><field id=\"p-1\" name=\"Place of Origin\" type=\"singleCheck\"><value inputValue=\"Anguilla\">100000421</value></field><field id=\"p-200007734\" name=\"Condition\" type=\"singleCheck\"><value inputValue=\"Used\">190063281</value></field></complex-value></field><field id=\"inventory\" type=\"multiInput\"><values><value srcValue=\"0\" warehouseCode=\"CN_LOCAL_01\">40</value></values></field></itemSchema>" }
后台样品物流示例：
后台商品物流示例：
#2021.04.21 商品新接口上线
商品旧接口后续会陆续下线，除部分特殊说明的除外，请接入方使用新的接口。
1. 商品发布接口变动
商品发布旧接口不再维护和答疑，后续将会陆续下线，请各位开发者及时调整使用新接口的切换
功能 |
旧接口 |
新接口 |
发布草稿 |
先获取发布规则，alibaba.icbu.product.schema.get 根据规则填充数据然后提交?alibaba.icbu.product.schema.add.draft 草稿发布成正式 ，将草稿数据通过下面接口提交 |
|
正式提交 |
先获取发布规则，alibaba.icbu.product.schema.get 根据规则填充数据 |
|
全量更新 |
暂无? |
|
部分更新接口 |
先获取商品详情 |
|
商品id解密接口 |
alibaba.icbu.product.id.decrypt （该接口不会下线) |
新的商品发布使用明文id，无需解密 |
单个商品详情获取 |
alibaba.icbu.product.get （该接口不会下线) |
alibaba.icbu.product.schema.render? |
获取草稿商品详情 |
无 |
2. 类目接口变动
功能 |
旧接口 |
新接口 |
获取发布类目树（旧接口不会下线，新旧接口可以混用） |
alibaba.icbu.category.get |
|
获取类目属性 |
alibaba.icbu.category.attribute.get [alibaba.icbu.category.attrvalue.get] [alibaba.icbu.category.attr.get] |
新发布体系，不用额外获取类目属性规则，类目填写规则包含在表单规则中，都从alibaba.icbu.product.schema.get?统一获取。 |
层级属性的子属性获取 |
alibaba.icbu.category.schema.level.get https://open.taobao.com/api.htm?docId=51873&docType=2 |
3. 图片银行接口升级
功能 |
旧接口 |
新接口 |
获取图片列表 |
alibaba.icbu.photobank.list? |
4. 新增商品加密接口
由于新开的商品接口，接受的商品id都是明文id，但是旧的接口都使用密文id，这里提供了商品的加解密接口来过渡新老商品id。
商品加密接口：alibaba.icbu.product.id.encrypt
商品解密接口：alibaba.icbu.product.id.decrypt
5. 新增其他发布接口
库存读取和更新接口
库存读取：alibaba.icbu.product.sku.inventory.get
库存更新：alibaba.icbu.product.inventory.update
商家发品能力查询：alibaba.icbu.product.type.available.get
6. 其他接口功能暂无变化
图片银行：
alibaba.icbu.photobank.group.operate
alibaba.icbu.photobank.group.list
alibaba.icbu.photobank.upload
商品分组
alibaba.icbu.product.group.get
alibaba.icbu.product.group.add
商品其他操作接口
alibaba.icbu.product.batch.update.display
alibaba.icbu.product.list
