【旧接口】商品发布接口文档

【旧接口已经不允许新商家接入，请使用新的商品接口！】

【旧接口已经不允许新商家接入，请使用新的商品接口！】

【旧接口已经不允许新商家接入，请使用新的商品接口！】

本文档完整描述通过API发布商品的具体流程，包括接口参数设置以及发品相关接口的调用时机，旨在对第三方发品做一个指导。

一. 发布接口总览

发布商品是通过alibaba.icbu.product.add接口（下文简称add接口），将商品信息设置到对应的接口入参中，不同的入参字段对应有不同的业务含义。

下面会按照阿里后台表单填写的顺序，逐步讲解如何在API填写商品信息。

接口	作用	说明文档
alibaba.icbu.product.add	发布商品,支持sourcing/一口价商品，只支持英文商品	https://open.taobao.com/api.htm?docId=25347&docType=2

二. 发品明细流程

2.1 填写类目

【是否必填】是

【对应字段】category_id

【填写说明】

由于发布商品时，**必须**先指定一个叶子类目。从接口alibaba.icbu.category.get中获取国际站的类目树信息，返回结果中的字段leaf_category表明该类目是否是叶子类目，category_id字段是该类目的id。

接口	作用	说明文档
alibaba.icbu.category.get	获取商品发布类目	https://open.taobao.com/api.htm?docId=25349&docType=2

2.2 填写商品类型

【是否必填】是

【对应字段】product_type

【填写说明】

当前国际站商品分为询盘品和下单品，在线批发商品用字符串**wholesale**表示，询盘商品用字符串 sourcing 表示。

2.3 基础信息Basic Information

2.3.1 填写标题

【是否必填】是

【对应字段】subject。类型String，最大长度128。

2.3.2 填写关键词

【是否必填】是

【对应字段】keywords。类型String[]，最多3个数组，每个数组最大字符串长度128。

2.3.3 填写商品分组

【是否必填】否

【填写说明】

通过接口alibaba.icbu.product.group.get获取当前商家的分组信息，通过alibaba.icbu.product.group.add来新增产品分组。

接口	作用	说明文档
alibaba.icbu.product.group.get	分组信息获取	https://open.taobao.com/api.htm?docId=25299&docType=2
alibaba.icbu.product.group.add	增加商品分组	https://open.taobao.com/api.htm?docId=25300&docType=2

2.3.4 填写类目属性

【是否必填】不同的属性必填信息不同，以具体的属性为准。

【对应字段】attributes。属性对象数组，最大长度100

【填写说明】

不同种类的类目属性，需要填写的字段不同。

具体地：对于选择型属性（类型为single_select或multi_select），需填写attribute_id, value_id和value_name。对于输入型属性（类型为input），需填写attribute_id 和 value_name。如果在系统属性里找不到想填的属性，可以自定义属性，需填写attribute_id=-1，attribute_name 和 value_name。有的属性带有单位，则在填写属性值字段value_name的时候，格式为“数值 单位”，中间用空格隔开。

获取方式：属性信息包括属性种类，可以通过alibaba.icbu.category.attribute.get获取，返回结果中的input_type表明属性类型，选择型属性对应的值为single_select或multi_select，输入型属性对应的值为为input。返回结果中的required表明该属性是否必填。返回结果中的units为属性的单位。

接口	作用	说明文档
alibaba.icbu.category.attribute.get	根据类目ID获取系统定义的属性，自定义属性不在其中	https://open.taobao.com/api.htm?docId=25348&docType=2

3.3 交易信息Trade Information

3.3.1填写价格信息和最小起订量

【是否必填】是

【对应字段】

1. 需要设置阶梯价时，在接口字段bulk_discount_prices中填入阶梯价对象数组，最多4个阶梯价，此时商品最小起订量是最小阶梯的起订量。
2. 需要设置FOB价时，在接口字段sourcing_trade的下级字段中，sourcing_trade.fob_min_price填写FOB最小价格，sourcing_trade.fob_max_price填写FOB最大价格，sourcing_trade.fob_currency填写FOB的货币单位,sourcing_trade.fob_unit_type填写Fob价对应的计量单位。sourcing_trade.min_order_quantity填写最小起订量。
3. 需要设置SKU价时，则需要在字段product_sku中填写具体价格，详见规格属性填写部分。最小起订量写在字段 wholesale_trade.min_order_quantity

【填写说明】

商品只允许填写一种价格信息。当前询盘品支持FOB价和阶梯价， 下单品支持阶梯价和SKU价。

3.3.2 设置规格属性

【是否必填】根据具体属性判定

【对应字段】product_sku

【填写说明】规则属性是和商品类目相关的，叶子类目上有规格属性，商品才能设置规格属性（又称SKU属性，下文用SKU属性代称）。设置sku属性过程如下：

product_sku.attributes字段用于设置商品拥有的sku属性对，即属性名和属性值名，例如颜色:红色、颜色:绿色、尺寸:大、尺寸:中、尺寸:小。

product_sku.attributes字段的填写模式，和attributes字段的填写类似，对于选择型属性（类型为single_select或multi_select），需填写attribute_id, value_id和value_name。对于输入型属性（类型为input），需填写attribute_id 和 value_name。如果在系统属性里找不到想填的属性，并且该属性支持自定义属性，则可以自定义属性，需填写attribute_id=-1，attribute_name 和 value_name。**注意，如果一个属性有多个自定义属性，则它们的attribute_id必须是不重复的负值。**

sku属性对设置完成后，则商品上拥有的sku路径也会随之确定。sku路径的含义是，不同属性的sku属性对组合，如**颜色:绿色;尺寸:小** ?，默认地，商品的所有sku路径，由设置的sku属性对的笛卡尔积组成。例如设置的sku属性对为：颜色:红色、颜色:绿色、尺寸:大、尺寸:小；则商品的sku路径默认为：颜色:红色;尺寸:大 ? ?颜色:红色;尺寸:小 ? 颜色:绿色;尺寸:大 ? 颜色:绿色;尺寸:小。如果想将某些sku路径给排除掉，则可以在product_sku.exclude_skus中将不启用的sku路径填入。如果想为具体的sku路径，设置价格，库存，sku编码等信息，则可以在product_sku.special_skus中填写每条sku路径的价格库存信息。

【获取方式】

获取sku属性的方式和普通属性一致，从alibaba.icbu.category.attribute.get接口中获取。判断返回的属性是否是SKU属性，使用字段skuAttribute来标识，sku属性是否支持自定义，通过customize_value字段来判断。

3.3.3 设置库存信息 - 下单品特有

【是否必填】否

【对应字段】product_sku.special_sku.inventory_dto_list

【字段结构】

库存信息的结构是：

inventoryList{

storeCode: 仓code 默认为空，表示国内仓，后续支持更多仓库类型

srcValue:库存原始值，如果是新发则置空或者0.

currentValue :当前设置的值。如果是新发，则将想要设置的值直接放在这个字段。

}

【填写说明】

add接口中保存库存，都是增量更新，即每次在原来的库存上进行加减。详细数据格式可参见附录5.5的demo

3.3.4 填写计量单位

【是否必填】必填

【对应字段】sourcing_trade.min_order_unit_type 和 wholesale_trade.unit_type

【传入格式】字符串

【填写说明】

询盘品时，使用字段sourcing_trade.fob_unit_type， 下单品时，使用字段wholesale_trade.unit_type。计量单位的种类是固定的，具体枚举见附录5.4【计量单位枚举值】

3.3.5 填写付款方式 - 询盘品特有

【是否必填】否

【对应字段】sourcing_trade.payment_methods

【传入格式】 字符串数组

【填写说明】系统中预设了一些付款方式，具体枚举见附录5.3【付款方式枚举值】，如果系统预设不满足需求，可以传入自定义字符串。

3.4 物流信息Logistics Information

3.4.1 发货周期

【是否必填】询盘品选填，下单品必填

【对应字段】deliver_periods

【传入格式】发货周期对象数组，数组长度最大3

【填写说明】

询盘品时，使用字段sourcing_trade.deliver_periods,下单品时，使用字段wholesale_trade.deliver_periods

3.4.2 发货港口 - 询盘品特有

【是否必填】否

【对应字段】港口对应字段sourcing_trade.delivery_port

3.4.3 包装信息

【是否必填】否

【对应字段】sourcing_trade.packaging_desc

3.4.3 供货能力填写 - 询盘品特有

【是否必填】否

【对应字段】供货数量对应字段supply_quantity， 供货数量单位对应字段supply_unit_type，单位枚举值参见附录5.4计量单位枚举值，供货周期单位对应字段 supply_period_type，周期单位枚举值参见附录5.1时间周期枚举

3.4.4 快递信息填写 - 下单品特有

【是否必填】是

【填写说明】

销售方式对应字段wholesale_trade.sale_type，“normal”表示按件卖，“batch”表示按批卖

每批数量对应字段wholesale_trade.batch_number，当sale_type=batch时生效，范围是1-99999

包装尺寸对应字段 wholesale_trade.package_size 单位是厘米，长宽高范围是1-9999999

毛重对应字段是wholesale_trade.weight, 单位是kg，精确到小数点后三位，范围是0.01-9999999.000

运费模板id对应字段是 shipping_line_template_id，获取商家下面的所有运费模板，使用接口 alibaba.wholesale.shippingline.template.list

接口	作用	说明文档
alibaba.wholesale.shippingline.template.list	获取商家的物流模板	https://open.taobao.com/api.htm?docId=25394&docType=2

3.5 商品描述Product description

3.5.1 设置商品主图

【是否必填】是

【对应字段】main_image

【填写说明】

在设置商品图片的时候，先使用接口 alibaba.icbu.photobank.upload将图片上传到卖家的图片银行中，然后将返回结果里的图片url设置到main_image.images字段。

如果卖家之前已经在图片银行里有发布图片，则可以用alibaba.icbu.photobank.list 获取客户图片url。

【注意】

1. 图片url使用http前缀。
2. 发布/更新商品使用的图片，都**必须**是来自图片银行里的图片，通过product.get接口获取的商品主图url，无法直接用来发布商品。
   | 接口 | 作用 | 说明文档 |
   | — | — | — |
   | alibaba.icbu.photobank.upload | 图片银行图片上传开放接口 | https://open.taobao.com/api.htm?docId=24463&docType=2 |
   | alibaba.icbu.photobank.list | 国际站图片银行查询接口 | https://open.taobao.com/api.htm?docId=24459&docType=2 |

3.5.2 设置商品详情

【是否必填】否

【对应字段】description，is_smart_edit

【填写说明】

当前国际站支持两种详情种类，普通编辑和智能编辑。普通编辑是将富文本html设置到description字段，同时is_smart_edit设置为false。

api只支持编辑修改普通编辑详情。

3.6. 特殊服务Featured services & others

3.6.1 定制服务

【是否必填】否

【对应字段】custom_info

【传入格式】

定制信息对象数据，custom_type字段设置定制项的名称，当前系统预设的定制项名称有三种：Customized logo，Customized packaging，Graphic customization。 min_order_quantity设置定制项的起订量。

三. 发布RTS品

rts品的判定条件包括三个：

1. 商品是下单品。这个提交需要用户将商品类型设置为下单品。设置商品类型 参见2.2
2. 有明确的运费。这一个条件需要用户设置合理的运费模板，并将运费模板设置到商品中。设置运费模板 参见 3.4.4
3. 最小起订量的交期小于15天。 商品上设置了最小起订量，同时设置了发货周期，当前发货周期设置是根据起订量范围而设置的，如果商品的最小起订量，符合某个发货周期的时间范围，并且该发货周期小于等于15天，则满足该条件。例如最小起订量是10，而发货周期设置为 ?起订量 < 8, 发货期 = 10；起订量 >= 8, 发货期 = 20。由于最小起订量是10，对应的发货周期是20，则不满足条件，相反，如果最小起订量是5，对应的发货期则是10，满足条件。设置发货周期 参见 3.4.1

四. Q&A

4.1 为什么类目校验不通过？

只能在叶子类目下发布商品。

有些类目需要相关资质才能发布商品，请参考http://www.alibaba.com/help/safety_security/policies_rules/product_listing/005.html(English) 或者http://waimaoquan.alibaba.com/archive/cgs/integrity/prohibitselling/prohibitselling009.html(Chinese)

4.2 为什么产品数量已发满？

不同的供应商，会有不同的产品数量限制；同时，不同类型（wholesale 或sourcing ）的产品会有不同的数量限制。免费会员状态的账户不能发布商品，付费账户可以发布商品。

五. 附录

5.1 时间周期枚举值

可选 Day,Week,Month,Quarter,Year

5.2 货币枚举值

可选 USD,RMB,AUD,CHF,HKD,SGD,GBP,EUR,CAD,JPY,NZD,NTD

5.3 付款方式枚举值

可选 L/C,D/A,D/P,T/T,Western Union,MoneyGram

5.4 计量单位枚举值

可选 Acre,Ampere,Bag,Barrel,Blade,Box,Bushel,Carat,Carton,Case,Centimeter,Chain,Cubic Centimeter,Cubic Foot,Cubic Inch,Cubic Meter,Cubic Yard,Degrees Celsius,Degrees Fahrenheit,Dozen,Dram,Fluid Ounce,Foot,Forty-Foot Container ,Furlong,Gallon,Gill,Grain,Gram,Gross,Hectare,Hertz,Inch,Kiloampere,Kilogram,Kilohertz,Kilometer,Kiloohm,Kilovolt,Kilowatt,Liter,Long Ton,Megahertz,Meter,Metric Ton,Mile,Milliampere,Milligram,Millihertz,Milliliter,Millimeter,Milliohm,Millivolt,Milliwatt,Nautical Mile,Ohm,Ounce,Pack,Pallet,Pair,Parcel,Perch,Piece,Pint,Plant,Pole,Pound,Quart,Quarter,Rod,Roll,Set,Sheet,Short Ton,Square Centimeter,Square Foot,Square Inch,Square Meter,Square Mile,Square Yard,Stone,Strand,Ton,Tonne,Tray,Twenty-Foot Container,Unit,Volt,Watt,Wp,Yard

5.5 SKU属性填写demo

{

“special_skus”: [

{

“sku_id”: null,

“inventory_dto_list”: [

{

“src_inventory”: 999,

“current_inventory”: 999,

“store_code”: “CN_LOCAL_01”

}

]//设置库存信息

,

“price”: 33,// 设置sku价

“attributes”: [

{

“sku_custom_value_name”: “34”,

“attribute_id”: “222038415”,

“sku_custom_image_url”: null,

“attribute_name”: “EUR Size”,

“value_id”: “-2”,

“value_name”: “34”

},

{

“sku_custom_value_name”: “Green”,

“attribute_id”: “191288010”,

“sku_custom_image_url”: “//sc02.alicdn.com/kf/H5b6665fcf0244c8e8dbe8a5090c50cceM.jpg”,

“attribute_name”: “Color”,

“value_id”: “216016296”,

“value_name”: “Green”

}

],

“sku_code”: “516-5lv34”

}// 为颜色绿 尺寸34设置具体的价格信息和库存信息

],

“exclude_skus”: [

{

“attributes”: [

{

“sku_custom_value_name”: “34”,

“attribute_id”: “222038415”,

“sku_custom_image_url”: null,

“attribute_name”: “EUR Size”,

“value_id”: “-2”,

“value_name”: “34”

},

{

“sku_custom_value_name”: “Black”,

“attribute_id”: “191288010”,

“sku_custom_image_url”: “//sc01.alicdn.com/kf/Hc35941f6044b4717bfe98b20c0a6c82ac.jpg”,

“attribute_name”: “Color”,

“value_id”: “3327837”,

“value_name”: “Black”

}

]

}// 颜色黑尺寸34的sku路径不启用

],

“attributes”: [

{

“sku_custom_value_name”: “34”,

“attribute_id”: “222038415”,

“sku_custom_image_url”: null,

“attribute_name”: “EUR Size”,

“value_id”: “-2”,

“value_name”: “34”

},

{

“sku_custom_value_name”: “Green”,

“attribute_id”: “191288010”,

“sku_custom_image_url”: “//sc02.alicdn.com/kf/H5b6665fcf0244c8e8dbe8a5090c50cceM.jpg”,

“attribute_name”: “Color”,

“value_id”: “216016296”,

“value_name”: “Green”

},

{

“sku_custom_value_name”: “35”,

“attribute_id”: “222038415”,

“sku_custom_image_url”: null,

“attribute_name”: “EUR Size”,

“value_id”: “190000791”,

“value_name”: “35”

},

{

“sku_custom_value_name”: “Black”,

“attribute_id”: “191288010”,

“sku_custom_image_url”: “//sc01.alicdn.com/kf/Hc35941f6044b4717bfe98b20c0a6c82ac.jpg”,

“attribute_name”: “Color”,

“value_id”: “3327837”,

“value_name”: “Black”

}

]//设置sku属性对

}

FAQ

关于此文档暂时还没有FAQ