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

alibaba.icbu.product.update.field (商品按字段更新)

按字段修改国际站商品,支持询盘商品和在线批发商品,支持英文商品和多语言商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
attributes ProductAttribute [] 可选
  • 最大列表长度:500
  • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID
    • └ 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属性值时,自定义属性值名称
    bulk_discount_prices BulkDiscountPrice [] 可选
  • 最大列表长度:20
  • 根据数量设置的折扣价
    • └ price
    • String
    • 可选
    • 12.34
    • 价格,范围是0.01-9999999.00
    • └ start_quantity
    • Number
    • 可选
    • 100
    • 起始数量,范围是1-99999
    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"]
  • 最大列表长度:20
  • 关键词,不要包含特殊符号(如,;),最多三个
    language String 必须 ENGLISH 语种,当前只有english
    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
    • 是否打水印,是(true)或否(false)
    • └ watermark_frame
    • String
    • 可选
    • N
    • 水印是否有边框,有边框(Y)或者无边框(N)
    • └ watermark_position
    • String
    • 可选
    • center
    • 水印位置,在中间(center)或者在底部(bottom)
    product_sku ProductSku 可选 商品SKU定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ sku_custom_image_url
    • String
    • 可选
    • http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg
    • 作为sku属性值时,用图形来显示;必须是alibaba图片中心的图片URL,请使用alibaba.icbu.photobank.upload上传图片
    • └ sku_custom_value_name
    • String
    • 可选
    • light grey
    • 作为sku属性值时,自定义属性值名称
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID,自定义属性值时ID要小于0,并且不能重复
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • exclude_skus
    • SkuDetail []
    • 可选
    • 单个SKU详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID,自定义属性值时ID要小于0,并且不能重复
    • └ 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 上传图片
    • └ attribute_name
    • String
    • 可选
    • color
    • 属性名称
    • └ value_name
    • String
    • 可选
    • grey
    • 属性值名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格,单位是美元,精确到小数点后两位,范围是0.01-9999999.00
    • special_skus
    • SkuDetail []
    • 可选
    • 单个SKU详细定义
    • attributes
    • ProductAttribute []
    • 可选
    • 商品属性和属性值
    • └ attribute_id
    • Number
    • 可选
    • 123
    • 属性ID
    • └ value_id
    • Number
    • 可选
    • 456
    • 属性值ID,自定义属性值时ID要小于0,并且不能重复
    • └ 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 上传图片
    • └ attribute_name
    • String
    • 可选
    • 123
    • 属性名称
    • └ value_name
    • String
    • 可选
    • color
    • 属性值名称
    • └ price
    • String
    • 可选
    • 12.34
    • 价格,单位是美元,精确到小数点后两位,范围是0.01-9999999.00
    • └ sku_code
    • String
    • 可选
    • 1233KK
    • SKU编码
    • └ sku_id
    • Number
    • 可选
    • 1111
    • SKU id,唯一标识一个SKU
    • inventory_dto_list
    • InventoryDetail []
    • 可选
    • 库存对象列表
    • └ src_inventory
    • Number
    • 可选
    • 11111
    • 原始的库存,如果不确定,直接置0,同时skuId也置空
    • └ current_inventory
    • Number
    • 可选
    • 2222
    • 当前想设置的库存
    • └ store_code
    • String
    • 可选
    • CN_Local_01
    • 仓code,不填表示默认国内仓
    product_type String 必须 wholesale 商品类型,在线批发商品(wholesale)或者询盘商品(sourcing)
    sourcing_trade SourcingTrade 可选 询盘商品交易信息
    • └ delivery_port
    • String
    • 可选
    • Shanghai
    • 发货港口
    • └ delivery_time
    • String
    • 可选
    • within 3 days
    • 发货期限
    • └ fob_currency
    • String
    • 可选
    • USD
    • FOB价格货币,参见FAQ 货币枚举值
    • └ fob_max_price
    • String
    • 可选
    • 56.78
    • FOB最大价格
    • └ fob_min_price
    • String
    • 可选
    • 12.34
    • FOB最小价格
    • └ fob_unit_type
    • String
    • 可选
    • Piece
    • FOB计量单位,参见FAQ 计量单位枚举值
    • └ min_order_quantity
    • String
    • 可选
    • 3.11
    • 最小起订量
    • └ min_order_unit_type
    • String
    • 可选
    • Piece
    • 最小起订量计量单位,参见FAQ 计量单位枚举值
    • └ payment_methods
    • String []
    • 可选
    • ["T/T","L/C"]
    • 付款方式,参见FAQ 付款方式枚举值
    • └ supply_period_type
    • String
    • 可选
    • Week
    • 供货能力周期,参见FAQ 时间周期枚举值
    • └ supply_quantity
    • String
    • 可选
    • 10000.66
    • 供货能力
    • └ supply_unit_type
    • String
    • 可选
    • Piece
    • 供货能力计量单位,参见FAQ 计量单位枚举值
    • └ packaging_desc
    • String
    • 可选
    • packaging
    • 包装信息
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期,发货时间相关建议使用此项
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    subject String 可选 mp3 player 商品名称,最多128个字符
    wholesale_trade WholesaleTrade 可选 在线批发商品交易信息
    • └ batch_number
    • Number
    • 可选
    • 12
    • 每批数量,当sale_type=batch时生效,范围是1-99999
    • └ handling_time
    • Number
    • 可选
    • 3
    • 备货期,单位是天,范围是1-60
    • └ min_order_quantity
    • Number
    • 可选
    • 100
    • 最小起订量,范围是1-99999
    • └ package_size
    • String
    • 可选
    • 2X3X4
    • 尺寸,单位是厘米,长宽高范围是1-9999999
    • └ price
    • String
    • 可选
    • 12.34
    • 价格,单位是美元,精确到小数点后两位,范围是0.01-9999999.00
    • └ sale_type
    • String
    • 可选
    • batch
    • 销售方式,按件卖(normal)或者按批卖(batch)
    • └ shipping_line_template_id
    • Number
    • 可选
    • 123
    • 运费模板ID
    • └ unit_type
    • String
    • 可选
    • Piece
    • 最小计量单位,参见FAQ 计量单位枚举值
    • └ weight
    • String
    • 可选
    • 123.456
    • 重量,单位是kg,精确到小数点后三位,范围是0.01-9999999.000
    • deliver_periods
    • DeliverPeriod []
    • 可选
    • 发货周期,发货时间相关建议使用此项
    • └ process_period
    • Number
    • 可选
    • 1
    • 预计需要发货时间
    • └ quantity
    • Number
    • 可选
    • 10
    • 数量
    market String 可选 onesite
  • 默认值:main
  • 发布的市场,支持main/onesite,默认main发到主市场,填onesite发布为商机通产品
    custom_info CustomInfo 可选 定制信息
    • custom_contents
    • CustomContent []
    • 可选
    • 定制内容
    • └ min_order_quantity
    • Number
    • 可选
    • 10
    • 最小起订量
    • └ custom_type
    • String
    • 可选
    • LOGO
    • 定制类型,只允许填写英文字符
    is_smart_edit Boolean 可选 true 商品详情种类,true表示智能编辑,不填默认取商品原来的详情种类
    use_sku_price Boolean 可选 true 使用SKU价的时候需要传入这个参数
    product_id String 必须 6edvniewvnewovn 混淆商品ID

    响应参数

    名称 类型 示例值 描述
    product_id String 62wert43twrtw4 加密后的产品ID

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaIcbuProductUpdateFieldRequest req = new AlibabaIcbuProductUpdateFieldRequest();
    List<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute> list2 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute>();
    AlibabaIcbuProductUpdateFieldRequest.ProductAttribute obj3 = new AlibabaIcbuProductUpdateFieldRequest.ProductAttribute();
    list2.add(obj3);
    obj3.setAttributeId(123L);
    obj3.setAttributeName("color");
    obj3.setValueId(456L);
    obj3.setValueName("grey");
    obj3.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
    obj3.setSkuCustomValueName("light grey");
    req.setAttributes(list2);
    List<AlibabaIcbuProductUpdateFieldRequest.BulkDiscountPrice> list5 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.BulkDiscountPrice>();
    AlibabaIcbuProductUpdateFieldRequest.BulkDiscountPrice obj6 = new AlibabaIcbuProductUpdateFieldRequest.BulkDiscountPrice();
    list5.add(obj6);
    obj6.setPrice("12.34");
    obj6.setStartQuantity(100L);
    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");
    AlibabaIcbuProductUpdateFieldRequest.MainImage obj7 = new AlibabaIcbuProductUpdateFieldRequest.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);
    AlibabaIcbuProductUpdateFieldRequest.ProductSku obj8 = new AlibabaIcbuProductUpdateFieldRequest.ProductSku();
    List<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute> list10 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute>();
    AlibabaIcbuProductUpdateFieldRequest.ProductAttribute obj11 = new AlibabaIcbuProductUpdateFieldRequest.ProductAttribute();
    list10.add(obj11);
    obj11.setAttributeId(123L);
    obj11.setSkuCustomImageUrl("http://g03.s.alicdn.com/kf/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg/200042360/HTB1PYE9IpXXXXbsXVXXq6xXFXXXg.jpg");
    obj11.setSkuCustomValueName("light grey");
    obj11.setValueId(456L);
    obj11.setAttributeName("color");
    obj11.setValueName("grey");
    obj8.setAttributes(list10);
    List<AlibabaIcbuProductUpdateFieldRequest.SkuDetail> list13 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.SkuDetail>();
    AlibabaIcbuProductUpdateFieldRequest.SkuDetail obj14 = new AlibabaIcbuProductUpdateFieldRequest.SkuDetail();
    list13.add(obj14);
    List<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute> list17 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute>();
    AlibabaIcbuProductUpdateFieldRequest.ProductAttribute obj18 = new AlibabaIcbuProductUpdateFieldRequest.ProductAttribute();
    list17.add(obj18);
    obj18.setAttributeId(123L);
    obj18.setValueId(456L);
    obj18.setSkuCustomValueName("light grey");
    obj18.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
    obj18.setAttributeName("color");
    obj18.setValueName("grey");
    list15.setAttributes(list17);
    obj14.setPrice("12.34");
    obj8.setExcludeSkus(list13);
    List<AlibabaIcbuProductUpdateFieldRequest.SkuDetail> list20 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.SkuDetail>();
    AlibabaIcbuProductUpdateFieldRequest.SkuDetail obj21 = new AlibabaIcbuProductUpdateFieldRequest.SkuDetail();
    list20.add(obj21);
    List<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute> list24 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.ProductAttribute>();
    AlibabaIcbuProductUpdateFieldRequest.ProductAttribute obj25 = new AlibabaIcbuProductUpdateFieldRequest.ProductAttribute();
    list24.add(obj25);
    obj25.setAttributeId(123L);
    obj25.setValueId(456L);
    obj25.setSkuCustomValueName("light grey");
    obj25.setSkuCustomImageUrl("http://g01.s.alicdn.com/kf/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9/200042360/HTB1tNhsIFXXXXb2XXXXq6xXFXXX9.jpg");
    obj25.setAttributeName("123");
    obj25.setValueName("color");
    list22.setAttributes(list24);
    obj21.setPrice("12.34");
    obj21.setSkuCode("1233KK");
    obj21.setSkuId(1111L);
    List<AlibabaIcbuProductUpdateFieldRequest.InventoryDetail> list28 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.InventoryDetail>();
    AlibabaIcbuProductUpdateFieldRequest.InventoryDetail obj29 = new AlibabaIcbuProductUpdateFieldRequest.InventoryDetail();
    list28.add(obj29);
    obj29.setSrcInventory(11111L);
    obj29.setCurrentInventory(2222L);
    obj29.setStoreCode("CN_Local_01");
    list26.setInventoryDtoList(list28);
    obj8.setSpecialSkus(list20);
    req.setProductSku(obj8);
    req.setProductType("wholesale");
    AlibabaIcbuProductUpdateFieldRequest.SourcingTrade obj30 = new AlibabaIcbuProductUpdateFieldRequest.SourcingTrade();
    obj30.setDeliveryPort("Shanghai");
    obj30.setDeliveryTime("within 3 days");
    obj30.setFobCurrency("USD");
    obj30.setFobMaxPrice("56.78");
    obj30.setFobMinPrice("12.34");
    obj30.setFobUnitType("Piece");
    obj30.setMinOrderQuantity("3.11");
    obj30.setMinOrderUnitType("Piece");
    obj30.setPaymentMethods(""T/T","L/C"");
    obj30.setSupplyPeriodType("Week");
    obj30.setSupplyQuantity("10000.66");
    obj30.setSupplyUnitType("Piece");
    obj30.setPackagingDesc("packaging");
    List<AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod> list32 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod>();
    AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod obj33 = new AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod();
    list32.add(obj33);
    obj33.setProcessPeriod(1L);
    obj33.setQuantity(10L);
    obj30.setDeliverPeriods(list32);
    req.setSourcingTrade(obj30);
    req.setSubject("mp3 player");
    AlibabaIcbuProductUpdateFieldRequest.WholesaleTrade obj34 = new AlibabaIcbuProductUpdateFieldRequest.WholesaleTrade();
    obj34.setBatchNumber(12L);
    obj34.setHandlingTime(3L);
    obj34.setMinOrderQuantity(100L);
    obj34.setPackageSize("2X3X4");
    obj34.setPrice("12.34");
    obj34.setSaleType("batch");
    obj34.setShippingLineTemplateId(123L);
    obj34.setUnitType("Piece");
    obj34.setWeight("123.456");
    List<AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod> list36 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod>();
    AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod obj37 = new AlibabaIcbuProductUpdateFieldRequest.DeliverPeriod();
    list36.add(obj37);
    obj37.setProcessPeriod(1L);
    obj37.setQuantity(10L);
    obj34.setDeliverPeriods(list36);
    req.setWholesaleTrade(obj34);
    req.setMarket("onesite");
    AlibabaIcbuProductUpdateFieldRequest.CustomInfo obj38 = new AlibabaIcbuProductUpdateFieldRequest.CustomInfo();
    List<AlibabaIcbuProductUpdateFieldRequest.CustomContent> list40 = new ArrayList<AlibabaIcbuProductUpdateFieldRequest.CustomContent>();
    AlibabaIcbuProductUpdateFieldRequest.CustomContent obj41 = new AlibabaIcbuProductUpdateFieldRequest.CustomContent();
    list40.add(obj41);
    obj41.setMinOrderQuantity(10L);
    obj41.setCustomType("LOGO");
    obj38.setCustomContents(list40);
    req.setCustomInfo(obj38);
    req.setIsSmartEdit(true);
    req.setUseSkuPrice(true);
    req.setProductId("6edvniewvnewovn");
    AlibabaIcbuProductUpdateFieldResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_icbu_product_update_field_response>
        <product_id>62wert43twrtw4</product_id>
    </alibaba_icbu_product_update_field_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.product.not.exist 商品不存在 请检查商品ID
    isp.product.cannot.update 商品不能修改 商品处于一些状态(如审核中)时,不能编辑
    isp.system-service-error:PUB_BIZCHECK_PRODUCT_NOT_EDITABLE; 商品不可编辑 查看商品状态是否为审核中

    API工具

    如何获得此API

    FAQ

    返回
    顶部