文档中心 > API类目 > 国际站商品API

国际站商品API

alibaba.icbu.product.add.draft (ICBU商品发布草稿接口)

发布商品草稿,支持sourcing/一口价商品，支持英文和多种语言原发商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
attributes ProductAttribute [] 可选
  • 最大列表长度：100
    		•  商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    bulk_discount_prices BulkDiscountPrice [] 可选
  • 最大列表长度：4
    		•  根据数量设置的折扣价
    • └ start_quantity
    • Number
    • 可选
    • 100
    • 默认值：1
    • 起始数量，范围是1-99999
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，范围是0.01-9999999.00
    category_id Number 必须 123 类目ID
    description String 可选 Enjoy your sports and music at the same time,very convenient
  • 最大长度：60000
    		•  商品详情描述，可包含图片中心的图片URL
    extra_context Json 可选 {} 补充信息
    group_id Number 可选 456 分组ID
    keywords String [] 可选 ["mp3","player"]
  • 最大列表长度：3
    		•  关键词，不要包含特殊符号（如,;），最多三个
    language String 必须 ENGLISH 语种，参见FAQ 语种枚举值
    main_image MainImage 可选 商品主图
    • └ images
    • String []
    • 可选
    • ["http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg","http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg"]
    • alibaba图片中心的图片URL列表，请使用alibaba.icbu.photobank.upload接口上传图片
    • └ watermark
    • Boolean
    • 可选
    • true
    • 默认值：false
    • 是否打水印，是(true)或否(false)
    • └ watermark_frame
    • String
    • 可选
    • N
    • 默认值：N
    • 水印是否有边框，有边框(Y)或者无边框(N)
    • └ watermark_position
    • String
    • 可选
    • center
    • 默认值：bottom
    • 水印位置，在中间(center)或者在底部(bottom)
    product_sku ProductSku 可选 商品SKU定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • special_skus
    • SkuDetail []
    • 可选
    • 单个SKU详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    • └ sku_code
    • String
    • 可选
    • 333333
    • 商品的SKU编码
    • inventory_dto_list
    • InventoryDetail []
    • 可选
    • 库存
    • └ store_code
    • String
    • 可选
    • china
    • 仓库code，默认不填
    • └ current_inventory
    • Number
    • 可选
    • 20
    • 想设置的库存
    • └ src_inventory
    • Number
    • 可选
    • 10
    • 原始库存
    • exclude_skus
    • SkuDetail []
    • 可选
    • 需要失效的SKU的详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID，自定义属性值时ID要小于0，并且不能重复
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg
    • 作为sku属性值时，用图形来展示；必须是alibaba图片中心的图片URL，请使用API alibaba.icbu.photobank.upload 上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时，自定义属性值名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    product_type String 必须 wholesale 商品类型，在线批发商品(wholesale)或者询盘商品(sourcing)，值为wholesale时，必须填写wholesale_trade
    sourcing_trade SourcingTrade 可选 询盘商品交易信息
    • └ fob_currency
    • String
    • 可选
    • USD
    • FOB货币价格，枚举值
    • └ fob_min_price
    • String
    • 可选
    • 12.34
    • FOB最小价格
    • └ fob_max_price
    • String
    • 可选
    • 56.78
    • FOB最大价格
    • └ fob_unit_type
    • String
    • 可选
    • piece
    • FOB计量单位，枚举值
    • └ payment_methods
    • String []
    • 可选
    • ["tt","lc"]
    • 付款方式，枚举值
    • └ min_order_quantity
    • String
    • 可选
    • 3.11
    • 最小起订量
    • └ min_order_unit_type
    • String
    • 可选
    • piece
    • 最小起订量计量单位，枚举值
    • └ supply_quantity
    • String
    • 可选
    • 10000.66
    • 供货能力
    • └ supply_unit_type
    • String
    • 可选
    • piece
    • 供货能力计量单位，枚举值
    • └ supply_period_type
    • String
    • 可选
    • week
    • 供货能力周期，枚举值
    • └ delivery_port
    • String
    • 可选
    • Shanghai
    • 发货港口
    • └ delivery_time
    • String
    • 可选
    • within 3 days
    • 发货期限
    • └ packaging_desc
    • String
    • 可选
    • packaging
    • 包装信息
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期，发货时间相关建议使用此项
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    subject String 可选 mp3 player
  • 最大长度：128
    		•  商品名称，最多128个字符
    wholesale_trade WholesaleTrade 可选 在线批发商品交易信息
    • └ unit_type
    • String
    • 可选
    • piece
    • 最小计量单位，枚举值
    • └ sale_type
    • String
    • 可选
    • batch
    • 销售方式，按件卖(normal)或者按批卖(batch)
    • └ batch_number
    • Number
    • 可选
    • 12
    • 每批数量，当sale_type=batch时生效，范围是1-99999
    • └ price
    • String
    • 可选
    • 12.34
    • 价格，单位是美元，精确到小数点后两位，范围是0.01-9999999.00
    • └ package_size
    • String
    • 可选
    • 2X3X4
    • 尺寸，单位是厘米，长宽高范围是1-9999999
    • └ weight
    • String
    • 可选
    • 123.456
    • 重量，单位是kg，精确到小数点后三位，范围是0.01-9999999.000
    • └ min_order_quantity
    • Number
    • 可选
    • 100
    • 最小起订量，范围是1-99999
    • └ shipping_line_template_id
    • Number
    • 可选
    • 123
    • 运费模板ID
    • └ handling_time
    • Number
    • 可选
    • 3
    • 备货期，单位是天，范围是1-60
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期，发货时间相关建议使用此项
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    market String 可选 onesite
  • 默认值：main
    		•  发布的市场，支持main/onesite，默认main发到主市场，填onesite发布为商机通产品
    is_smart_edit Boolean 可选 false 是否智能编辑，如果不传，默认为false
    custom_info CustomInfo 可选 定制信息
    • custom_contents
    • CustomContent []
    • 可选
    • 定制内容
    • └ min_order_quantity
    • Number
    • 可选
    • 10
    • 最小起订量
    • └ custom_type
    • String
    • 可选
    • LOGO
    • 定制类型，只允许填写英文字符

    响应参数

    名称 类型 示例值 描述
    product_id String AAEgRsnyACGxujcXDpIOlzJa 混淆后的产品ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIcbuProductAddDraftRequest req = new AlibabaIcbuProductAddDraftRequest();
List<AlibabaIcbuProductAddDraftRequest.ProductAttribute> list2 = new ArrayList<AlibabaIcbuProductAddDraftRequest.ProductAttribute>();
AlibabaIcbuProductAddDraftRequest.ProductAttribute obj3 = new AlibabaIcbuProductAddDraftRequest.ProductAttribute();
list2.add(obj3);
obj3.setAttributeId(123L);
obj3.setAttributeName("color");
obj3.setValueId(456L);
obj3.setValueName("grey");
obj3.setSkuCustomValueName("light grey");
obj3.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
req.setAttributes(list2);
List<AlibabaIcbuProductAddDraftRequest.BulkDiscountPrice> list5 = new ArrayList<AlibabaIcbuProductAddDraftRequest.BulkDiscountPrice>();
AlibabaIcbuProductAddDraftRequest.BulkDiscountPrice obj6 = new AlibabaIcbuProductAddDraftRequest.BulkDiscountPrice();
list5.add(obj6);
obj6.setStartQuantity(100L);
obj6.setPrice("12.34");
req.setBulkDiscountPrices(list5);
req.setCategoryId(123L);
req.setDescription("Enjoy your sports and music at the same time,very convenient");
req.setExtraContextString("{}");
req.setGroupId(456L);
req.setKeywords(""mp3","player"");
req.setLanguage("ENGLISH");
AlibabaIcbuProductAddDraftRequest.MainImage obj7 = new AlibabaIcbuProductAddDraftRequest.MainImage();
obj7.setImages(""http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg","http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg"");
obj7.setWatermark(true);
obj7.setWatermarkFrame("N");
obj7.setWatermarkPosition("center");
req.setMainImage(obj7);
AlibabaIcbuProductAddDraftRequest.ProductSku obj8 = new AlibabaIcbuProductAddDraftRequest.ProductSku();
List<AlibabaIcbuProductAddDraftRequest.ProductAttribute> list10 = new ArrayList<AlibabaIcbuProductAddDraftRequest.ProductAttribute>();
AlibabaIcbuProductAddDraftRequest.ProductAttribute obj11 = new AlibabaIcbuProductAddDraftRequest.ProductAttribute();
list10.add(obj11);
obj11.setAttributeId(123L);
obj11.setAttributeName("color");
obj11.setValueId(456L);
obj11.setValueName("grey");
obj11.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj11.setSkuCustomValueName("light grey");
obj8.setAttributes(list10);
List<AlibabaIcbuProductAddDraftRequest.SkuDetail> list13 = new ArrayList<AlibabaIcbuProductAddDraftRequest.SkuDetail>();
AlibabaIcbuProductAddDraftRequest.SkuDetail obj14 = new AlibabaIcbuProductAddDraftRequest.SkuDetail();
list13.add(obj14);
List<AlibabaIcbuProductAddDraftRequest.ProductAttribute> list17 = new ArrayList<AlibabaIcbuProductAddDraftRequest.ProductAttribute>();
AlibabaIcbuProductAddDraftRequest.ProductAttribute obj18 = new AlibabaIcbuProductAddDraftRequest.ProductAttribute();
list17.add(obj18);
obj18.setAttributeId(123L);
obj18.setAttributeName("color");
obj18.setValueId(456L);
obj18.setValueName("grey");
obj18.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj18.setSkuCustomValueName("light grey");
list15.setAttributes(list17);
obj14.setPrice("12.34");
obj14.setSkuCode("333333");
List<AlibabaIcbuProductAddDraftRequest.InventoryDetail> list21 = new ArrayList<AlibabaIcbuProductAddDraftRequest.InventoryDetail>();
AlibabaIcbuProductAddDraftRequest.InventoryDetail obj22 = new AlibabaIcbuProductAddDraftRequest.InventoryDetail();
list21.add(obj22);
obj22.setStoreCode("china");
obj22.setCurrentInventory(20L);
obj22.setSrcInventory(10L);
list19.setInventoryDtoList(list21);
obj8.setSpecialSkus(list13);
List<AlibabaIcbuProductAddDraftRequest.SkuDetail> list24 = new ArrayList<AlibabaIcbuProductAddDraftRequest.SkuDetail>();
AlibabaIcbuProductAddDraftRequest.SkuDetail obj25 = new AlibabaIcbuProductAddDraftRequest.SkuDetail();
list24.add(obj25);
List<AlibabaIcbuProductAddDraftRequest.ProductAttribute> list28 = new ArrayList<AlibabaIcbuProductAddDraftRequest.ProductAttribute>();
AlibabaIcbuProductAddDraftRequest.ProductAttribute obj29 = new AlibabaIcbuProductAddDraftRequest.ProductAttribute();
list28.add(obj29);
obj29.setAttributeId(123L);
obj29.setAttributeName("color");
obj29.setValueId(456L);
obj29.setValueName("grey");
obj29.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
obj29.setSkuCustomValueName("light grey");
list26.setAttributes(list28);
obj25.setPrice("12.34");
obj8.setExcludeSkus(list24);
req.setProductSku(obj8);
req.setProductType("wholesale");
AlibabaIcbuProductAddDraftRequest.SourcingTrade obj30 = new AlibabaIcbuProductAddDraftRequest.SourcingTrade();
obj30.setFobCurrency("USD");
obj30.setFobMinPrice("12.34");
obj30.setFobMaxPrice("56.78");
obj30.setFobUnitType("piece");
obj30.setPaymentMethods(""tt","lc"");
obj30.setMinOrderQuantity("3.11");
obj30.setMinOrderUnitType("piece");
obj30.setSupplyQuantity("10000.66");
obj30.setSupplyUnitType("piece");
obj30.setSupplyPeriodType("week");
obj30.setDeliveryPort("Shanghai");
obj30.setDeliveryTime("within 3 days");
obj30.setPackagingDesc("packaging");
List<AlibabaIcbuProductAddDraftRequest.DeliverPeriod> list32 = new ArrayList<AlibabaIcbuProductAddDraftRequest.DeliverPeriod>();
AlibabaIcbuProductAddDraftRequest.DeliverPeriod obj33 = new AlibabaIcbuProductAddDraftRequest.DeliverPeriod();
list32.add(obj33);
obj33.setProcessPeriod(1L);
obj33.setQuantity(10L);
obj30.setDeliverPeriods(list32);
req.setSourcingTrade(obj30);
req.setSubject("mp3 player");
AlibabaIcbuProductAddDraftRequest.WholesaleTrade obj34 = new AlibabaIcbuProductAddDraftRequest.WholesaleTrade();
obj34.setUnitType("piece");
obj34.setSaleType("batch");
obj34.setBatchNumber(12L);
obj34.setPrice("12.34");
obj34.setPackageSize("2X3X4");
obj34.setWeight("123.456");
obj34.setMinOrderQuantity(100L);
obj34.setShippingLineTemplateId(123L);
obj34.setHandlingTime(3L);
List<AlibabaIcbuProductAddDraftRequest.DeliverPeriod> list36 = new ArrayList<AlibabaIcbuProductAddDraftRequest.DeliverPeriod>();
AlibabaIcbuProductAddDraftRequest.DeliverPeriod obj37 = new AlibabaIcbuProductAddDraftRequest.DeliverPeriod();
list36.add(obj37);
obj37.setProcessPeriod(1L);
obj37.setQuantity(10L);
obj34.setDeliverPeriods(list36);
req.setWholesaleTrade(obj34);
req.setMarket("onesite");
req.setIsSmartEdit(false);
AlibabaIcbuProductAddDraftRequest.CustomInfo obj38 = new AlibabaIcbuProductAddDraftRequest.CustomInfo();
List<AlibabaIcbuProductAddDraftRequest.CustomContent> list40 = new ArrayList<AlibabaIcbuProductAddDraftRequest.CustomContent>();
AlibabaIcbuProductAddDraftRequest.CustomContent obj41 = new AlibabaIcbuProductAddDraftRequest.CustomContent();
list40.add(obj41);
obj41.setMinOrderQuantity(10L);
obj41.setCustomType("LOGO");
obj38.setCustomContents(list40);
req.setCustomInfo(obj38);
AlibabaIcbuProductAddDraftResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_icbu_product_add_draft_response>
    <product_id>AAEgRsnyACGxujcXDpIOlzJa</product_id>
</alibaba_icbu_product_add_draft_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

    错误码解释

    错误码 错误描述 解决方案
    isp.validation.error 校验失败 请检查输入参数
    isv.auth.expired 授权过期 请重新授权
    isp.av.info.incomplete 供应商av信息校验未完成 请供应商完成AV资质认证
    isp.category.invalid 类目校验不通过 请检查类目ID，必须是叶子类目，并且有此类目的发布权限
    isp.category.service.failed 类目服务不可用 请重试
    isp.attribute.invalid 属性校验不通过 请检查属性参数
    isp.attribute.service.failed 属性服务不可用 请重试
    isp.post.forbidden 供应商被禁止发布商品 请供应商联系客服人员
    isp.max.product.number 产品数量已发满 请检查商品总数，和可发商品数量
    isp.no.wholesale.product 不能发布wholesale产品 请供应商联系客服人员
    isp.invalid.currency 货币种类校验不通过 请检查sourcingTrade的货币种类参数
    isp.invalid.unit 计量单位校验不通过 请检查sourcingTrade的计量单位参数
    isp.fob.price.invalid FOB校验不通过 请检查sourcingTrade的FOB相关参数
    isp.keyword.invalid 关键词校验不通过 请检查关键词参数。最多指定三个关键词，每个关键词不能超过256个字符，不能包含特殊字符（如,;）
    isp.supply.invalid 供货能力校验不通过 请检查sourcingTrade的供货能力相关参数
    isp.moq.invalid MOQ校验不通过 请检查sourcingTrade的MOQ相关参数
    isp.description.invalid 详情描述校验不通过 请检查详情描述。详情描述允许使用HTML标签，允许使用图片中心的图片URL。
    isp.main.image.invalid 产品主图校验不通过 请检查主图参数，只能使用图片中心的图片
    isp.wholesale.invalid wholesale信息校验不通过 请检查wholesaleTrade参数
    isp.sku.invalid SKU信息校验不通过 请检查SKU参数
    CATEGORY_FORBIDDEN 该类目禁止发布 重新选择类目
    MARKET_GOODS_IN_BLACK_LIST 该类目下无法发布下单品 请发布询盘品或重新选择发布类目
    -5 产品包含有违禁词 请根据检查结果，剔除违禁词

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部
    阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
    关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
    网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号