淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
param_list	SkuDo []	必须		最大列表长度：20	参数列表
└ ou_code String 可选 1062 小时达必填，门店或DC编码 └ sku_code String 必须 dsf123 商品编码 └ barcodes String 可选 2452,3565 条码列表,多个以英文逗号分隔。默认第一个条码为主条码，请配合条码更新策略字段barcode_update_type使用 └ sku_name String 可选鲜活中华鲟商品名称 └ main_pic_urls String 可选 https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png 主图地址 └ detail_pic_urls String 可选 https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png 详细图地址 └ shelf_life Number 可选 13 保质期天数 └ brand_name String 可选佳沛品牌名称 └ tax_rate String 可选 25 销项税率 └ suggested_price String 可选 10 建议零售价,单位元 └ weight_flag Number 可选 1 是否称重 └ org_no String 可选 kk 机构编号 └ weight String 可选 41 单品重量单位为克/g，必须为整数 └ height String 可选 7 高度 └ width String 可选 78 宽度 └ length String 可选 78 长度 └ hm_category_code String 可选 3452 平台类目编码 └ short_title String 可选鲜活中华鲟简称短标题 └ txt_desc String 可选鲜活中华鲟 2只文描 └ category_code String 可选 u08023 商家类目编码 └ invoice_content String 可选阿里巴巴开票内容 └ import_flag Number 可选 0 是否进口 └ net_content String 可选 250ml18盒/箱净含量，小时达必填 └ accounting_category String 可选 22 财务核算分类 └ sale_unit String 可选个销售单位，小时达必填 └ sale_price String 可选 10 该字段已经废弃，请使用sku_price字段 └ life_status String 可选 A 商品在机构内的生命周期，商品状态；A-正常、T-暂时停购、C-淘汰出清、R-清退、D-删除封挡 └ sale_spec String 可选 500g5/袋销售规格，小时达必填 └ avg_weight String 可选 0.001 均重（一个售卖单位平均为多少个库存单位，称重商品必填)，计算库存发布时会以库存数量/均重来进行转换；建议与库存单位保持一致。若库存单位是kg，售卖单位可以是g。此时均重、预扣款重量填0.001。APP最小起购量、APP购买步长填正整数。比如香蕉的库存单位是kg，销售单位是g，APP最小起购量、APP购买步长填500，表示在APP最少购买一斤，每加一档是加一斤。均重、预扣款重量填0.001的作用是，当用户购买500g，乘以0.001系数后=0.5kg，所以扣库存0.5kg └ pre_minus_weight String 可选 0.001 预扣款重量（购买一个售卖单位按照多少个库存单位来扣款），计算金额时，按照购买的售卖单位数量/预扣款重量*售价来计算；非称重品填1。若库存单位是kg，销售单位是g，填0.001 └ step_quantity Number 可选 1 app购买时每增加一次购买数量至少要增加多少个售卖单位。非称重品填1。称重品根据实际货品情况填写。步长除了是加购物车的数量之外还承载了最小售卖数量的意义。 └ purchase_quantity Number 可选 100 APP销售时，基于销售单位的起购量 └ sku_label_type String 可选无价签标价签类型 └ allow_app_sale Number 可选 0 商品是否适合在app销售，机构商品层级为总控，此字段为总开关，控制所有门店的是否APP可见，商品本身不可售，则app可售必须关闭。App可售关闭，则门店商品维度的app可见不允许打开。1：是? 0：否，（默认否） └ sub_title String 可选夏日必备解暑神器商品卖点；商品副标题，显示在APP商品详情页的标题下方。如可口可乐商品的副标题可以是“夏日必备解暑神器”。不超过80个字符。双方业务沟通一下，是否生鲜商品要定为必填 └ sub_title1 String 可选天然纯净卖点1内容 └ sub_title2 String 可选萦绕唇齿卖点2内容 └ title1 String 可选水中贵族卖点1名称 └ title2 String 可选丝滑甘醇卖点2名称 └ online_sale_flag Number 可选 1 门店来控制本门店是否在app上让该商品可见，? 1可见? 0不可见 └ delivery_unit String 可选 kg 大仓向门店配货的单位；淘鲜达合作商家默认填与库存单位一致的值 └ delivery_spec String 可选 1 一个配货单位等于多少个库存单位；淘鲜达合作商家填默认值1 └ delivery_way String 可选 2 商品到本仓的来源；淘鲜达商家填默认值“直配”(1:统配，2:直配，3:越库，4：自产；5：调拨)，基于采配链路的要求，加工品是不能够做直配的物流模式的，必须维护自产或者统配，目前包了一层逻辑“针对加工成品和加工半成品，如果是直配就转成自产” └ logistics String 可选 10086 商品关联的物流中心，DC。配送物流；配送方式是直配，此项不填（输入物流中心编码） └ delivery_warehouse String 可选 10086 配出仓,配货仓；配送方式是直配，此项不填(输入仓库编码) └ member_price String 可选 9.9 会员正常购买该商品的售价，2位小数，单位:元 └ cost_unit String 可选 kg 商品作为原料时对应的单位；淘鲜达合作商家默认填与库存单位一致的值 └ cost_no_price String 可选 0 商品加工所消耗的直接原料成本，去税；加工商品必填，加工品按照原料的消耗估算出的成本。因为淘鲜达暂不涉及成本计算，建议淘鲜达商家填默认值1，单位:元 └ cost_tax_price String 可选 0 商品加工所消耗的直接原料成本，含税，加工商品必填，加工品按照原料的消耗估算出的成本。因为淘鲜达暂不涉及成本计算，建议淘鲜达商家填默认值1，单位:元 └ cost_exchange_rate String 可选 1 一个库存单位对应多少个成本单位，原料加工的成本单位和存储单位之间的换算。因为淘鲜达暂不涉及成本计算，建议淘鲜达商家填默认值1 └ mass_output_rate String 可选 1 商品中对于加工可用的比例占整个商品的百分比；从原料到加工可用的原料之间的转化率。为了简化BOM的使用，建议淘鲜达商家填默认值1。 └ processing_unit String 可选 kg 每一组加工生产的单位，加工商品必填，仅当商品为加工品的时候，才能填写。从计量单位表中选择；淘鲜达合作商家默认填与库存单位一致的值 └ procs_exchange_rate String 可选 1 一组加工单位对应多少个库存单位商品；加工商品必填，每一个加工单位对应的存储单位数量。为了简化BOM的使用，建议淘鲜达商家填默认值1。 └ storage String 可选常温存储条件；填常温、冷藏、冷冻 └ pick_float_rate String 可选 0 商品拣货时可以超拣的比例，针对非标品。建议淘鲜达商家填默认值0 └ forbid_receive_days Number 可选 0 禁收时限；收货日期-商品生产日期<限收时限才允许收货。建议淘鲜达商家填默认值为保质期天数。或按进口商品保质期天数的2/3、非进口商品的1/2填写 └ forbid_sales_days Number 可选 0 商品生产日期+保质期-当前日期<禁售时限，不能出库销售。建议淘鲜达商家填默认值0。 └ overload_rate String 可选 0 商品收货时可以超过订货数量多少百分比进行收货；非标品供应商送货入库时，允许超收的比例。淘鲜达合作商家填默认值0 └ warn_days Number 可选 0 库存监控报表中，剩余天数少于该天数时需要预警，建议淘鲜达商家填默认值0 └ front_display_flag Number 可选 1 商品在门店是否在前场陈列；淘鲜达合作商家用不到， 0：否? 1：是 └ fixed_flag Number 可选 0 商品是否是供应商为企业进行定制；淘鲜达合作商家填默认值0， 0 否? 1 是 └ purchase_spec String 可选 1 一个采购单位等于多少个库存单位，淘鲜达合作商家默认填1 └ purchase_unit String 可选 kg 商品针对供应商订货时，对应的单位；淘鲜达合作商家默认填与库存单位一致的值 └ label_style_type String 可选无价签标价签类型；商品在门店陈列时，采用的售价标签类型。因不采用电子价签，建议淘鲜达商家填默认值“无价签” └ rich_text String 可选 <p><img align=\"absmiddle\" src=\"https://img.alicdn.com/imgextra/i4/2680068332/TB2l8332.jpg\" /></p> 文描,（同字段txt_desc）；优先使用本字段 └ back_cat_code String 可选 10086 平台类目编码（同字段hm_category_code），需要商家把自己的类目对应到平台的类目上，此字段暂时只能支持3、4级类目修改；优先使用本字段 └ sku_price String 可选 9.9 门店商品售价（同字段sale_price），单位:元；优先使用本字段 └ period Number 可选 15 商品的保质期天数（同字段shelf_life），必须为整数，0代表不管理保质期；优先使用本字段 └ item_type_new Number 可选 1 商品类型（同字段sku_type）1:普通商品、2:加工半成品、3:加工成品、4:原材料、5:耗材、6:卡券类商品；优先使用本字段 └ merchant_cat_code String 可选 10086 商家后台类目编码（同字段category_code），优先使用本字段 └ sku_pic_urls String 可选 https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png 在app上显示的商品图片cdn地址（同字段main_pic_urls和detail_pic_urls），https开头，多个图片用英文逗号切割。第一张图片会作为主图；优先使用本字段 sku_suppliers SkuSupplierDo [] 可选 [] 供货商信息 └ return_flag Number 可选 0 商品针对该供应商是否可以退货；因为淘鲜达商家不使用平台的采配功能，建议传默认值， 1：是 0：否（默认为0） └ minimum String 可选 100 最小起订量 └ purchase_price String 可选 9.9 采购单价；淘鲜达合作商家填默认值0；单位:元 └ supplier_no String 可选 10086 供应商编码 └ supplier_name String 可选张三供应商编码名称 └ main_flag Number 可选 1 是否主供应商 1是主供应商 0非主供 └ inventory_unit String 可选 kg 库存单位 └ channel_code String 可选 4 渠道编码，默认为4淘鲜达渠道、3对应饿了么渠道、-1对应批发渠道 └ producer_place String 可选中国\|辽宁省\|大连市产地，商品生产地点的描述，用于APP和电子价签展示，如果是可售，则小时达必填，若不清楚可以写为“见产品外包装” └ clean_sku_member_price Number 可选 1 是否清空会员价, 1清空会员价（操作之后没有会员价），0不清空会员价 └ barcode_update_type Number 可选 1 修改条码策略，默认为策略3。如商品现有主条码barcode1、非主条码barcode2 1、新增barcodes指定了新的主条码barcode3,会将原主条码barcde1改为非主条码,最终商品有三个条码,即:非主条码barcde1、非主条码barcode2、主条码barcode3 2、删除barcodes对应条码，除了主条码 3、替换主条码则会将现有主条码删除,新增指定主条码,只认barcodes中第一个条码，商品最终结果条码个数为两个条码:非主条码barcode2、主条码barcode3 4、除主条码外,所有条码替换为指定barcodes,不支持主条码修改。如果barcodes中为barcode3,barcode4,则商品最终条码为:主条码barcode1,非barcode3,barcode4。其中非主条码barcode2被删除 industry_props IndustryPropDo 可选行业属性 props PropDo [] 可选 [] 行业对应的属性 └ remove_opt Boolean 可选 false 是否移除该属性 └ value String 可选红色行业属性值 └ key String 可选 color 行业属性 └ industry_type String 可选 Industry_Clothes 行业类型 └ forest_cate_id Number 可选 126784428 forest类目id └ tax_code String 可选 1020301020000000 税收编码 └ fragile_flag Number 可选 0 是否易碎品标记，0否1是 └ delivery_storage String 可选常温配送条件；填常温、冷藏、冷冻 └ flagship_store_item_info String 可选 xxx 淘宝旗舰店同品信息，同城零售使用 └ temporary_flag Number 可选 0 是否现制现卖，0否1是；比如蛋糕只有下了单才能开始制作 └ product_identity String 可选 123456 聚合之后的产品id，商家需要保存该值 └ biz_type String 可选 txd 业务类型：txd淘鲜达，elm饿了么，shareStore共享库存，默认txd channel_props ChannelProp [] 可选 [] 渠道属性 props PropField [] 可选 [] 渠道属性，取值为key-value键值对形式 └ value String 可选 1 渠道属性value，取值见key定义 └ key String 可选 ONE_HOUR_STATUS 渠道属性key, 取值为"ONE_HOUR_STATUS" 代表小时达，value=0表示不可售, value=1表示可售；"WAVE_ARRIVE_STATUS" 代表波次达，value=0表示不可售,value=1表示可售 └ channel_type String 可选 shareStore 渠道类型：txd淘鲜达，elm饿了么，shareStore共享库存 process_props ProcessProp [] 可选 [] 加工属性 └ service_name String 可选宰杀服务名 └ clean_all_process_props Boolean 可选 true 清除所有加工属性 service_props ServiceProp [] 可选 [] 服务属性 └ prop_name String 可选温度属性名 prop_values ServicePropValue [] 可选 [] 属性值 └ name String 可选常温属性值名称 └ clean_all_service_props Boolean 可选 true 清除所有服务属性 mutex_props MutexRule [] 可选 [] 互斥属性 prop_a MutexProp 可选互斥属性A └ name String 可选温度服务属性名 └ value String 可选常温服务属性值 prop_b MutexProp 可选互斥属性B └ name String 可选加冰服务属性名 └ value String 可选少冰服务属性值 └ clean_all_mutex_props Boolean 可选 true 清除所有互斥规则 voucher_ext SelfPickUpVoucherInfoDO 可选券类商品扩展信息 └ start_time Date 可选 2024-01-28 00:00:00 核销开始时间 └ end_time Date 可选 2024-01-29 00:00:00 核销结束时间 └ association_skus String [] 可选 [] 关联实物品商品编码 └ stores String [] 可选 [] 适用门店 voucher_rule RuleDesc 可选使用规则 └ use_time String 可选到店核销，营业时间内可用使用时间 └ book_rule String 可选无需预约预约规则 └ use_desc String 可选到店核销使用方式 └ refund_rule String 可选随时可退、过期自动退，已核销的到店券不享受随时可退服务退款规则 └ other_rule String 可选其他其他规则

名称	类型	示例值	描述
result	ApiResults	请参见子字段信息	执行结果
└ err_code String ILLEGAL_PARAMETERS 错误码 └ err_msg String 请参见子字段信息错误信息 models ApiResult [] 请参见子字段信息各条记录结果 └ model String 190100200014 sku编码 └ success Boolean true sku商品操作成功标志 └ err_msg String 门店商品不存在 sku商品操作错误信息 └ err_code String ILLEGAL_PARAMETERS sku商品操作错误码 └ product_id String 123456 聚合之后的产品id，商家需要保存该值 └ success Boolean true 接口调用成功标志

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkSkuUpdateRequest req = new AlibabaWdkSkuUpdateRequest();
List<AlibabaWdkSkuUpdateRequest.SkuDo> list2 = new ArrayList<AlibabaWdkSkuUpdateRequest.SkuDo>();
AlibabaWdkSkuUpdateRequest.SkuDo obj3 = new AlibabaWdkSkuUpdateRequest.SkuDo();
list2.add(obj3);
obj3.setOuCode("1062");
obj3.setSkuCode("dsf123");
obj3.setBarcodes("2452,3565");
obj3.setSkuName("鲜活中华鲟");
obj3.setMainPicUrls("https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png");
obj3.setDetailPicUrls("https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png");
obj3.setShelfLife(13L);
obj3.setBrandName("佳沛");
obj3.setTaxRate("25");
obj3.setSuggestedPrice("10");
obj3.setWeightFlag(1L);
obj3.setOrgNo("kk");
obj3.setWeight("41");
obj3.setHeight("7");
obj3.setWidth("78");
obj3.setLength("78");
obj3.setHmCategoryCode("3452");
obj3.setShortTitle("鲜活中华鲟");
obj3.setTxtDesc("鲜活中华鲟 2只");
obj3.setCategoryCode("u08023");
obj3.setInvoiceContent("阿里巴巴");
obj3.setImportFlag(0L);
obj3.setNetContent("250ml*18盒/箱");
obj3.setAccountingCategory("22");
obj3.setSaleUnit("个");
obj3.setSalePrice("10");
obj3.setLifeStatus("A");
obj3.setSaleSpec("500g*5/袋");
obj3.setAvgWeight("0.001");
obj3.setPreMinusWeight("0.001");
obj3.setStepQuantity(1L);
obj3.setPurchaseQuantity(100L);
obj3.setSkuLabelType("无价签");
obj3.setAllowAppSale(0L);
obj3.setSubTitle("夏日必备 解暑神器");
obj3.setSubTitle1("天然纯净");
obj3.setSubTitle2("萦绕唇齿");
obj3.setTitle1("水中贵族");
obj3.setTitle2("丝滑甘醇");
obj3.setOnlineSaleFlag(1L);
obj3.setDeliveryUnit("kg");
obj3.setDeliverySpec("1");
obj3.setDeliveryWay("2");
obj3.setLogistics("10086");
obj3.setDeliveryWarehouse("10086");
obj3.setMemberPrice("9.9");
obj3.setCostUnit("kg");
obj3.setCostNoPrice("0");
obj3.setCostTaxPrice("0");
obj3.setCostExchangeRate("1");
obj3.setMassOutputRate("1");
obj3.setProcessingUnit("kg");
obj3.setProcsExchangeRate("1");
obj3.setStorage("常温");
obj3.setPickFloatRate("0");
obj3.setForbidReceiveDays(0L);
obj3.setForbidSalesDays(0L);
obj3.setOverloadRate("0");
obj3.setWarnDays(0L);
obj3.setFrontDisplayFlag(1L);
obj3.setFixedFlag(0L);
obj3.setPurchaseSpec("1");
obj3.setPurchaseUnit("kg");
obj3.setLabelStyleType("无价签");
obj3.setRichText("<p><img align=\\"absmiddle\\" src=\\"https://img.alicdn.com/imgextra/i4/2680068332/TB2l8332.jpg\\" /></p>");
obj3.setBackCatCode("10086");
obj3.setSkuPrice("9.9");
obj3.setPeriod(15L);
obj3.setItemTypeNew(1L);
obj3.setMerchantCatCode("10086");
obj3.setSkuPicUrls("https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png");
List<AlibabaWdkSkuUpdateRequest.SkuSupplierDo> list6 = new ArrayList<AlibabaWdkSkuUpdateRequest.SkuSupplierDo>();
AlibabaWdkSkuUpdateRequest.SkuSupplierDo obj7 = new AlibabaWdkSkuUpdateRequest.SkuSupplierDo();
list6.add(obj7);
obj7.setReturnFlag(0L);
obj7.setMinimum("100");
obj7.setPurchasePrice("9.9");
obj7.setSupplierNo("10086");
obj7.setSupplierName("张三");
obj7.setMainFlag(1L);
list4.setSkuSuppliers(list6);
obj3.setInventoryUnit("kg");
obj3.setChannelCode("4");
obj3.setProducerPlace("中国|辽宁省|大连市");
obj3.setCleanSkuMemberPrice(1L);
obj3.setBarcodeUpdateType(1L);
AlibabaWdkSkuUpdateRequest.IndustryPropDo obj9 = new AlibabaWdkSkuUpdateRequest.IndustryPropDo();
List<AlibabaWdkSkuUpdateRequest.PropDo> list11 = new ArrayList<AlibabaWdkSkuUpdateRequest.PropDo>();
AlibabaWdkSkuUpdateRequest.PropDo obj12 = new AlibabaWdkSkuUpdateRequest.PropDo();
list11.add(obj12);
obj12.setRemoveOpt(false);
obj12.setValue("红色");
obj12.setKey("color");
obj9.setProps(list11);
obj9.setIndustryType("Industry_Clothes");
list8.setIndustryProps(obj9);
obj3.setForestCateId(126784428L);
obj3.setTaxCode("1020301020000000");
obj3.setFragileFlag(0L);
obj3.setDeliveryStorage("常温");
obj3.setFlagshipStoreItemInfo("xxx");
obj3.setTemporaryFlag(0L);
obj3.setProductIdentity("123456");
obj3.setBizType("txd");
List<AlibabaWdkSkuUpdateRequest.ChannelProp> list15 = new ArrayList<AlibabaWdkSkuUpdateRequest.ChannelProp>();
AlibabaWdkSkuUpdateRequest.ChannelProp obj16 = new AlibabaWdkSkuUpdateRequest.ChannelProp();
list15.add(obj16);
List<AlibabaWdkSkuUpdateRequest.PropField> list19 = new ArrayList<AlibabaWdkSkuUpdateRequest.PropField>();
AlibabaWdkSkuUpdateRequest.PropField obj20 = new AlibabaWdkSkuUpdateRequest.PropField();
list19.add(obj20);
obj20.setValue("1");
obj20.setKey("ONE_HOUR_STATUS");
list17.setProps(list19);
obj16.setChannelType("shareStore");
list13.setChannelProps(list15);
List<AlibabaWdkSkuUpdateRequest.ProcessProp> list23 = new ArrayList<AlibabaWdkSkuUpdateRequest.ProcessProp>();
AlibabaWdkSkuUpdateRequest.ProcessProp obj24 = new AlibabaWdkSkuUpdateRequest.ProcessProp();
list23.add(obj24);
obj24.setServiceName("宰杀");
list21.setProcessProps(list23);
obj3.setCleanAllProcessProps(true);
List<AlibabaWdkSkuUpdateRequest.ServiceProp> list27 = new ArrayList<AlibabaWdkSkuUpdateRequest.ServiceProp>();
AlibabaWdkSkuUpdateRequest.ServiceProp obj28 = new AlibabaWdkSkuUpdateRequest.ServiceProp();
list27.add(obj28);
obj28.setPropName("温度");
List<AlibabaWdkSkuUpdateRequest.ServicePropValue> list31 = new ArrayList<AlibabaWdkSkuUpdateRequest.ServicePropValue>();
AlibabaWdkSkuUpdateRequest.ServicePropValue obj32 = new AlibabaWdkSkuUpdateRequest.ServicePropValue();
list31.add(obj32);
obj32.setName("常温");
list29.setPropValues(list31);
list25.setServiceProps(list27);
obj3.setCleanAllServiceProps(true);
List<AlibabaWdkSkuUpdateRequest.MutexRule> list35 = new ArrayList<AlibabaWdkSkuUpdateRequest.MutexRule>();
AlibabaWdkSkuUpdateRequest.MutexRule obj36 = new AlibabaWdkSkuUpdateRequest.MutexRule();
list35.add(obj36);
AlibabaWdkSkuUpdateRequest.MutexProp obj38 = new AlibabaWdkSkuUpdateRequest.MutexProp();
obj38.setName("温度");
obj38.setValue("常温");
list37.setPropA(obj38);
AlibabaWdkSkuUpdateRequest.MutexProp obj40 = new AlibabaWdkSkuUpdateRequest.MutexProp();
obj40.setName("加冰");
obj40.setValue("少冰");
list39.setPropB(obj40);
list33.setMutexProps(list35);
obj3.setCleanAllMutexProps(true);
AlibabaWdkSkuUpdateRequest.SelfPickUpVoucherInfoDO obj42 = new AlibabaWdkSkuUpdateRequest.SelfPickUpVoucherInfoDO();
obj42.setStartTime(StringUtils.parseDateTime("2024-01-28 00:00:00"));
obj42.setEndTime(StringUtils.parseDateTime("2024-01-29 00:00:00"));
obj42.setAssociationSkus("");
obj42.setStores("");
AlibabaWdkSkuUpdateRequest.RuleDesc obj43 = new AlibabaWdkSkuUpdateRequest.RuleDesc();
obj43.setUseTime("到店核销，营业时间内可用");
obj43.setBookRule("无需预约");
obj43.setUseDesc("到店核销");
obj43.setRefundRule("随时可退、过期自动退，已核销的到店券不享受随时可退服务");
obj43.setOtherRule("其他");
obj42.setVoucherRule(obj43);
list41.setVoucherExt(obj42);
req.setParamList(list2);
AlibabaWdkSkuUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaWdkSkuUpdateRequest req = new AlibabaWdkSkuUpdateRequest();
List<AlibabaWdkSkuUpdateRequest.SkuDoDomain> list2 = new List<AlibabaWdkSkuUpdateRequest.SkuDoDomain>();
AlibabaWdkSkuUpdateRequest.SkuDoDomain obj3 = new AlibabaWdkSkuUpdateRequest.SkuDoDomain();
list2.Add(obj3);
obj3.OuCode = "1062";
obj3.SkuCode = "dsf123";
obj3.Barcodes = "2452,3565";
obj3.SkuName = "鲜活中华鲟";
obj3.MainPicUrls = "https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
obj3.DetailPicUrls = "https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
obj3.ShelfLife = 13L;
obj3.BrandName = "佳沛";
obj3.TaxRate = "25";
obj3.SuggestedPrice = "10";
obj3.WeightFlag = 1L;
obj3.OrgNo = "kk";
obj3.Weight = "41";
obj3.Height = "7";
obj3.Width = "78";
obj3.Length = "78";
obj3.HmCategoryCode = "3452";
obj3.ShortTitle = "鲜活中华鲟";
obj3.TxtDesc = "鲜活中华鲟 2只";
obj3.CategoryCode = "u08023";
obj3.InvoiceContent = "阿里巴巴";
obj3.ImportFlag = 0L;
obj3.NetContent = "250ml*18盒/箱";
obj3.AccountingCategory = "22";
obj3.SaleUnit = "个";
obj3.SalePrice = "10";
obj3.LifeStatus = "A";
obj3.SaleSpec = "500g*5/袋";
obj3.AvgWeight = "0.001";
obj3.PreMinusWeight = "0.001";
obj3.StepQuantity = 1L;
obj3.PurchaseQuantity = 100L;
obj3.SkuLabelType = "无价签";
obj3.AllowAppSale = 0L;
obj3.SubTitle = "夏日必备 解暑神器";
obj3.SubTitle1 = "天然纯净";
obj3.SubTitle2 = "萦绕唇齿";
obj3.Title1 = "水中贵族";
obj3.Title2 = "丝滑甘醇";
obj3.OnlineSaleFlag = 1L;
obj3.DeliveryUnit = "kg";
obj3.DeliverySpec = "1";
obj3.DeliveryWay = "2";
obj3.Logistics = "10086";
obj3.DeliveryWarehouse = "10086";
obj3.MemberPrice = "9.9";
obj3.CostUnit = "kg";
obj3.CostNoPrice = "0";
obj3.CostTaxPrice = "0";
obj3.CostExchangeRate = "1";
obj3.MassOutputRate = "1";
obj3.ProcessingUnit = "kg";
obj3.ProcsExchangeRate = "1";
obj3.Storage = "常温";
obj3.PickFloatRate = "0";
obj3.ForbidReceiveDays = 0L;
obj3.ForbidSalesDays = 0L;
obj3.OverloadRate = "0";
obj3.WarnDays = 0L;
obj3.FrontDisplayFlag = 1L;
obj3.FixedFlag = 0L;
obj3.PurchaseSpec = "1";
obj3.PurchaseUnit = "kg";
obj3.LabelStyleType = "无价签";
obj3.RichText = "<p><img align=\\"absmiddle\\" src=\\"https://img.alicdn.com/imgextra/i4/2680068332/TB2l8332.jpg\\" /></p>";
obj3.BackCatCode = "10086";
obj3.SkuPrice = "9.9";
obj3.Period = 15L;
obj3.ItemTypeNew = 1L;
obj3.MerchantCatCode = "10086";
obj3.SkuPicUrls = "https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
List<AlibabaWdkSkuUpdateRequest.SkuSupplierDoDomain> list5 = new List<AlibabaWdkSkuUpdateRequest.SkuSupplierDoDomain>();
AlibabaWdkSkuUpdateRequest.SkuSupplierDoDomain obj6 = new AlibabaWdkSkuUpdateRequest.SkuSupplierDoDomain();
list5.Add(obj6);
obj6.ReturnFlag = 0L;
obj6.Minimum = "100";
obj6.PurchasePrice = "9.9";
obj6.SupplierNo = "10086";
obj6.SupplierName = "张三";
obj6.MainFlag = 1L;
obj3.SkuSuppliers= list5;
obj3.InventoryUnit = "kg";
obj3.ChannelCode = "4";
obj3.ProducerPlace = "中国|辽宁省|大连市";
obj3.CleanSkuMemberPrice = 1L;
obj3.BarcodeUpdateType = 1L;
AlibabaWdkSkuUpdateRequest.IndustryPropDoDomain obj7 = new AlibabaWdkSkuUpdateRequest.IndustryPropDoDomain();
List<AlibabaWdkSkuUpdateRequest.PropDoDomain> list9 = new List<AlibabaWdkSkuUpdateRequest.PropDoDomain>();
AlibabaWdkSkuUpdateRequest.PropDoDomain obj10 = new AlibabaWdkSkuUpdateRequest.PropDoDomain();
list9.Add(obj10);
obj10.RemoveOpt = false;
obj10.Value = "红色";
obj10.Key = "color";
obj7.Props= list9;
obj7.IndustryType = "Industry_Clothes";
obj3.IndustryProps= obj7;
obj3.ForestCateId = 126784428L;
obj3.TaxCode = "1020301020000000";
obj3.FragileFlag = 0L;
obj3.DeliveryStorage = "常温";
obj3.FlagshipStoreItemInfo = "xxx";
obj3.TemporaryFlag = 0L;
obj3.ProductIdentity = "123456";
obj3.BizType = "txd";
List<AlibabaWdkSkuUpdateRequest.ChannelPropDomain> list12 = new List<AlibabaWdkSkuUpdateRequest.ChannelPropDomain>();
AlibabaWdkSkuUpdateRequest.ChannelPropDomain obj13 = new AlibabaWdkSkuUpdateRequest.ChannelPropDomain();
list12.Add(obj13);
List<AlibabaWdkSkuUpdateRequest.PropFieldDomain> list15 = new List<AlibabaWdkSkuUpdateRequest.PropFieldDomain>();
AlibabaWdkSkuUpdateRequest.PropFieldDomain obj16 = new AlibabaWdkSkuUpdateRequest.PropFieldDomain();
list15.Add(obj16);
obj16.Value = "1";
obj16.Key = "ONE_HOUR_STATUS";
obj13.Props= list15;
obj13.ChannelType = "shareStore";
obj3.ChannelProps= list12;
List<AlibabaWdkSkuUpdateRequest.ProcessPropDomain> list18 = new List<AlibabaWdkSkuUpdateRequest.ProcessPropDomain>();
AlibabaWdkSkuUpdateRequest.ProcessPropDomain obj19 = new AlibabaWdkSkuUpdateRequest.ProcessPropDomain();
list18.Add(obj19);
obj19.ServiceName = "宰杀";
obj3.ProcessProps= list18;
obj3.CleanAllProcessProps = true;
List<AlibabaWdkSkuUpdateRequest.ServicePropDomain> list21 = new List<AlibabaWdkSkuUpdateRequest.ServicePropDomain>();
AlibabaWdkSkuUpdateRequest.ServicePropDomain obj22 = new AlibabaWdkSkuUpdateRequest.ServicePropDomain();
list21.Add(obj22);
obj22.PropName = "温度";
List<AlibabaWdkSkuUpdateRequest.ServicePropValueDomain> list24 = new List<AlibabaWdkSkuUpdateRequest.ServicePropValueDomain>();
AlibabaWdkSkuUpdateRequest.ServicePropValueDomain obj25 = new AlibabaWdkSkuUpdateRequest.ServicePropValueDomain();
list24.Add(obj25);
obj25.Name = "常温";
obj22.PropValues= list24;
obj3.ServiceProps= list21;
obj3.CleanAllServiceProps = true;
List<AlibabaWdkSkuUpdateRequest.MutexRuleDomain> list27 = new List<AlibabaWdkSkuUpdateRequest.MutexRuleDomain>();
AlibabaWdkSkuUpdateRequest.MutexRuleDomain obj28 = new AlibabaWdkSkuUpdateRequest.MutexRuleDomain();
list27.Add(obj28);
AlibabaWdkSkuUpdateRequest.MutexPropDomain obj29 = new AlibabaWdkSkuUpdateRequest.MutexPropDomain();
obj29.Name = "温度";
obj29.Value = "常温";
obj28.PropA= obj29;
AlibabaWdkSkuUpdateRequest.MutexPropDomain obj30 = new AlibabaWdkSkuUpdateRequest.MutexPropDomain();
obj30.Name = "加冰";
obj30.Value = "少冰";
obj28.PropB= obj30;
obj3.MutexProps= list27;
obj3.CleanAllMutexProps = true;
AlibabaWdkSkuUpdateRequest.SelfPickUpVoucherInfoDODomain obj31 = new AlibabaWdkSkuUpdateRequest.SelfPickUpVoucherInfoDODomain();
obj31.StartTime = DateTime.Parse(2024-01-28 00:00:00");
obj31.EndTime = DateTime.Parse(2024-01-29 00:00:00");
obj31.AssociationSkus = "";
obj31.Stores = "";
AlibabaWdkSkuUpdateRequest.RuleDescDomain obj32 = new AlibabaWdkSkuUpdateRequest.RuleDescDomain();
obj32.UseTime = "到店核销，营业时间内可用";
obj32.BookRule = "无需预约";
obj32.UseDesc = "到店核销";
obj32.RefundRule = "随时可退、过期自动退，已核销的到店券不享受随时可退服务";
obj32.OtherRule = "其他";
obj31.VoucherRule= obj32;
obj3.VoucherExt= obj31;
req.ParamList_ = list2;
AlibabaWdkSkuUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaWdkSkuUpdateRequest;
$param_list = new SkuDo;
$param_list->ou_code="1062";
$param_list->sku_code="dsf123";
$param_list->barcodes="2452,3565";
$param_list->sku_name="鲜活中华鲟";
$param_list->main_pic_urls="https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
$param_list->detail_pic_urls="https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
$param_list->shelf_life="13";
$param_list->brand_name="佳沛";
$param_list->tax_rate="25";
$param_list->suggested_price="10";
$param_list->weight_flag="1";
$param_list->org_no="kk";
$param_list->weight="41";
$param_list->height="7";
$param_list->width="78";
$param_list->length="78";
$param_list->hm_category_code="3452";
$param_list->short_title="鲜活中华鲟";
$param_list->txt_desc="鲜活中华鲟 2只";
$param_list->category_code="u08023";
$param_list->invoice_content="阿里巴巴";
$param_list->import_flag="0";
$param_list->net_content="250ml*18盒/箱";
$param_list->accounting_category="22";
$param_list->sale_unit="个";
$param_list->sale_price="10";
$param_list->life_status="A";
$param_list->sale_spec="500g*5/袋";
$param_list->avg_weight="0.001";
$param_list->pre_minus_weight="0.001";
$param_list->step_quantity="1";
$param_list->purchase_quantity="100";
$param_list->sku_label_type="无价签";
$param_list->allow_app_sale="0";
$param_list->sub_title="夏日必备 解暑神器";
$param_list->sub_title1="天然纯净";
$param_list->sub_title2="萦绕唇齿";
$param_list->title1="水中贵族";
$param_list->title2="丝滑甘醇";
$param_list->online_sale_flag="1";
$param_list->delivery_unit="kg";
$param_list->delivery_spec="1";
$param_list->delivery_way="2";
$param_list->logistics="10086";
$param_list->delivery_warehouse="10086";
$param_list->member_price="9.9";
$param_list->cost_unit="kg";
$param_list->cost_no_price="0";
$param_list->cost_tax_price="0";
$param_list->cost_exchange_rate="1";
$param_list->mass_output_rate="1";
$param_list->processing_unit="kg";
$param_list->procs_exchange_rate="1";
$param_list->storage="常温";
$param_list->pick_float_rate="0";
$param_list->forbid_receive_days="0";
$param_list->forbid_sales_days="0";
$param_list->overload_rate="0";
$param_list->warn_days="0";
$param_list->front_display_flag="1";
$param_list->fixed_flag="0";
$param_list->purchase_spec="1";
$param_list->purchase_unit="kg";
$param_list->label_style_type="无价签";
$param_list->rich_text="<p><img align=\\"absmiddle\\" src=\\"https://img.alicdn.com/imgextra/i4/2680068332/TB2l8332.jpg\\" /></p>";
$param_list->back_cat_code="10086";
$param_list->sku_price="9.9";
$param_list->period="15";
$param_list->item_type_new="1";
$param_list->merchant_cat_code="10086";
$param_list->sku_pic_urls="https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
$sku_suppliers = new SkuSupplierDo;
$sku_suppliers->return_flag="0";
$sku_suppliers->minimum="100";
$sku_suppliers->purchase_price="9.9";
$sku_suppliers->supplier_no="10086";
$sku_suppliers->supplier_name="张三";
$sku_suppliers->main_flag="1";
$param_list->sku_suppliers = $sku_suppliers;
$param_list->inventory_unit="kg";
$param_list->channel_code="4";
$param_list->producer_place="中国|辽宁省|大连市";
$param_list->clean_sku_member_price="1";
$param_list->barcode_update_type="1";
$industry_props = new IndustryPropDo;
$props = new PropDo;
$props->remove_opt="false";
$props->value="红色";
$props->key="color";
$industry_props->props = $props;
$industry_props->industry_type="Industry_Clothes";
$param_list->industry_props = $industry_props;
$param_list->forest_cate_id="126784428";
$param_list->tax_code="1020301020000000";
$param_list->fragile_flag="0";
$param_list->delivery_storage="常温";
$param_list->flagship_store_item_info="xxx";
$param_list->temporary_flag="0";
$param_list->product_identity="123456";
$param_list->biz_type="txd";
$channel_props = new ChannelProp;
$props = new PropField;
$props->value="1";
$props->key="ONE_HOUR_STATUS";
$channel_props->props = $props;
$channel_props->channel_type="shareStore";
$param_list->channel_props = $channel_props;
$process_props = new ProcessProp;
$process_props->service_name="宰杀";
$param_list->process_props = $process_props;
$param_list->clean_all_process_props="true";
$service_props = new ServiceProp;
$service_props->prop_name="温度";
$prop_values = new ServicePropValue;
$prop_values->name="常温";
$service_props->prop_values = $prop_values;
$param_list->service_props = $service_props;
$param_list->clean_all_service_props="true";
$mutex_props = new MutexRule;
$prop_a = new MutexProp;
$prop_a->name="温度";
$prop_a->value="常温";
$mutex_props->prop_a = $prop_a;
$prop_b = new MutexProp;
$prop_b->name="加冰";
$prop_b->value="少冰";
$mutex_props->prop_b = $prop_b;
$param_list->mutex_props = $mutex_props;
$param_list->clean_all_mutex_props="true";
$voucher_ext = new SelfPickUpVoucherInfoDO;
$voucher_ext->start_time="2024-01-28 00:00:00";
$voucher_ext->end_time="2024-01-29 00:00:00";
$voucher_ext->association_skus="[]";
$voucher_ext->stores="[]";
$voucher_rule = new RuleDesc;
$voucher_rule->use_time="到店核销，营业时间内可用";
$voucher_rule->book_rule="无需预约";
$voucher_rule->use_desc="到店核销";
$voucher_rule->refund_rule="随时可退、过期自动退，已核销的到店券不享受随时可退服务";
$voucher_rule->other_rule="其他";
$voucher_ext->voucher_rule = $voucher_rule;
$param_list->voucher_ext = $voucher_ext;
$req->setParamList(json_encode($param_list));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.wdk.sku.update' \
-d 'partner_id=apidoc' \
-d 'session=0e79ba5f-077b-45cc-994e-928f242bf2ff' \
-d 'sign=8195CEBADB9527751341FB7A1256C45C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-21+17%3A12%3A06' \
-d 'v=2.0' \
-d 'param_list=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaWdkSkuUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.param_list="[]"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.wdk.sku.update");
add_param(pRequest,"param_list","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.wdk.sku.update', {
	'param_list':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_wdk_sku_update_response>
    <result>
        <err_code>ILLEGAL_PARAMETERS</err_code>
        <err_msg>请参见子字段信息</err_msg>
        <models>
            <api_result>
                <model>190100200014</model>
                <success>true</success>
                <err_msg>门店商品不存在</err_msg>
                <err_code>ILLEGAL_PARAMETERS</err_code>
                <product_id>123456</product_id>
            </api_result>
        </models>
        <success>true</success>
    </result>
</alibaba_wdk_sku_update_response>

{
    "alibaba_wdk_sku_update_response":{
        "result":{
            "err_code":"ILLEGAL_PARAMETERS",
            "err_msg":"请参见子字段信息",
            "models":{
                "api_result":[
                    {
                        "model":"190100200014",
                        "success":true,
                        "err_msg":"门店商品不存在",
                        "err_code":"ILLEGAL_PARAMETERS",
                        "product_id":"123456"
                    }
                ]
            },
            "success":true
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

开放平台

五道口API

alibaba.wdk.sku.update (更新商品)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ