淘宝开放平台

请求地址：

环境	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	商品列表
└ barcodes String 可选 2017440 必填，条码，支持一品多码,多个条码以半角逗号分隔 └ brand_name String 可选帝皇鲜小时达必填，品牌名称 └ category_code String 可选 454545 商家后台类目编码 └ ou_code String 可选 1062 必填，门店或DC编码 └ height String 可选 3.0 高度（高） └ inventory_unit String 可选 2kg 必填，库存单位 └ length String 可选 10 长度(深) └ main_pic_urls String 可选 https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png 主图图片地址 └ manufacturer_address String 可选挪威生产商地址 └ manufacturer_name String 可选日日鲜生产商名称 └ detail_pic_urls String 可选 https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png 详情图片地址 └ producer_place String 可选中国\|辽宁省\|大连市小时达必填，产地，商品生产地点的描述，用于APP和电子价签展示，如果是可售，则必填 └ shelf_life Number 可选 15 保质期天数，商品的保质期（单位：天）,0表示没有保质期 └ sku_code String 可选 190100200014 必填，商品唯一编码 └ sku_name String 可选小龙虾 30-40g/只称重必填，名称，对商品直观的描述，通常包含了品牌、规格等信息 └ sku_type Number 可选 1 类型 1:普通商品、2:加工半成品、3:加工成品、4:原材料、5:耗材；如果是新增商家产品，字段含义是货品类型，1普通商品、2赠品、3包材、4耗材、5组合商品、6分销商品、7附属品、8虚拟商品、9其他、10直投广告、11原材料、13加工产成品 └ standard_no String 可选 UII9999 产品标准号 └ storage_type Number 可选 1 存储条件类型 241=常温,242=冷藏,243=冷冻,635=热链,636=室温,637=鲜活 └ suggested_price String 可选 5990 建议零售价，单位:元 └ tax_rate String 可选 15 销项税率 └ weight String 可选 30 小时达必填，单品重量单位为克/g，必须为整数 └ weight_flag Number 可选 1 必填，是否称重标识商品是否是称重商品? 1：是0：否（默认为0） └ width String 可选 3 宽度（宽） └ hm_category_code String 可选 57q34 平台后台类目编码 └ short_title String 可选鲜活中华鲟两斤商品短标题 └ txt_desc String 可选鲜活中华鲟两斤文描 └ invoice_content String 可选阿里巴巴开票内容 └ input_invoice_content String 可选阿里巴巴输入开票内容 └ accounting_category String 可选 22 财务核算分类 └ net_content String 可选 250ml18盒/箱小时达必填，净含量 └ import_flag Number 可选 0 是否进口，是1，否0，默认非进口 └ sale_unit String 可选个小时达必填，销售单位 └ sale_price String 可选 10 商品销售价格，单位:元 └ life_status String 可选 A 商品在机构内的生命周期，商品状态；A-正常、T-暂时停购、C-淘汰出清、R-清退、D-删除封挡 └ sale_spec String 可选 100g5袋必填，销售规格 └ 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非主供 industry_props IndustryPropDo 可选行业属性 └ industry_type String 可选 Industry_Clothes 行业类型 props PropDo [] 可选 [] 行业对应的属性 └ key String 可选 color 行业属性 └ value String 可选红色类目属性值 └ remove_opt Boolean 可选 false 是否移除该属性 └ 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 可选 123 产品聚合码，程序会把聚合码相同的sku聚合到一起；比如衣服有大中小号3中sku，通过聚合码聚合到一起；该字段在同城零售发布场景才能使用 └ biz_type String 可选 txd 业务类型：txd淘鲜达，elm饿了么，shareStore共享库存，默认txd channel_props ChannelProp [] 可选 [] 渠道属性 └ channel_type String 可选 shareStore 渠道类型：txd淘鲜达，elm饿了么，shareStore共享库存 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表示可售 └ spec_type String 可选 1 1一品多码（只支持非称重品） └ trans_ratio String 可选 10 与母商品的库存转换系数，例如10，则转换到母商品的库存为10此商品的库存，可空，当新增一品多规格品的时候不能为空 └ parent_sku_code String 可选 111111 母商品的sku_code可空，当新增一品多规格品的时候不能为空 └ is_online Number 可选 1 是否线上的品 1:是 0:否 process_props ProcessProp [] 可选 [] 加工属性 └ service_name String 可选宰杀服务名 service_props ProcessProp [] 可选 [] 服务属性 └ prop_name String 可选温度服务属性名 prop_values ServicePropValue [] 可选 [] 服务属性值 └ name String 可选常温值名称 mutex_props ServiceProp [] 可选 [] 互斥属性（A与B互斥） prop_a MutexProp 可选互斥属性对象A └ name String 可选温度属性名 └ value String 可选常温属性值 prop_b MutexProp 可选互斥属性对象B └ name String 可选加冰属性名 └ value String 可选少冰属性值 voucher_ext SelfPickUpVoucherInfoDO 可选券类商品扩展信息，item_type_new为6时必填 └ voucher_type Number 可选 2 券类型，1：提货券 2: 代金券 └ 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 [] 请参见子字段信息 models └ err_code String ILLEGAL_PARAMETERS 错误编码 └ err_msg String 门店商品已存在错误信息 └ success Boolean true 单个商品新增是否成功 └ model String 190100200014 skuCode商品编码 └ product_id String 123456 聚合之后的产品id，商家需要保存该值 └ success Boolean true 接口返回成功标志

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaWdkSkuAddRequest req = new AlibabaWdkSkuAddRequest();
List<AlibabaWdkSkuAddRequest.SkuDo> list2 = new ArrayList<AlibabaWdkSkuAddRequest.SkuDo>();
AlibabaWdkSkuAddRequest.SkuDo obj3 = new AlibabaWdkSkuAddRequest.SkuDo();
list2.add(obj3);
obj3.setBarcodes("2017440");
obj3.setBrandName("帝皇鲜");
obj3.setCategoryCode("454545");
obj3.setOuCode("1062");
obj3.setHeight("3.0");
obj3.setInventoryUnit("2kg");
obj3.setLength("10");
obj3.setMainPicUrls("https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png");
obj3.setManufacturerAddress("挪威");
obj3.setManufacturerName("日日鲜");
obj3.setDetailPicUrls("https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png");
obj3.setProducerPlace("中国|辽宁省|大连市");
obj3.setShelfLife(15L);
obj3.setSkuCode("190100200014");
obj3.setSkuName("小龙虾 30-40g/只 称重");
obj3.setSkuType(1L);
obj3.setStandardNo("UII9999");
obj3.setStorageType(1L);
obj3.setSuggestedPrice("5990");
obj3.setTaxRate("15");
obj3.setWeight("30");
obj3.setWeightFlag(1L);
obj3.setWidth("3");
obj3.setHmCategoryCode("57q34");
obj3.setShortTitle("鲜活中华鲟 两斤");
obj3.setTxtDesc("鲜活中华鲟 两斤");
obj3.setInvoiceContent("阿里巴巴");
obj3.setInputInvoiceContent("阿里巴巴");
obj3.setAccountingCategory("22");
obj3.setNetContent("250ml*18盒/箱");
obj3.setImportFlag(0L);
obj3.setSaleUnit("个");
obj3.setSalePrice("10");
obj3.setLifeStatus("A");
obj3.setSaleSpec("100g*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<AlibabaWdkSkuAddRequest.SkuSupplierDo> list6 = new ArrayList<AlibabaWdkSkuAddRequest.SkuSupplierDo>();
AlibabaWdkSkuAddRequest.SkuSupplierDo obj7 = new AlibabaWdkSkuAddRequest.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);
AlibabaWdkSkuAddRequest.IndustryPropDo obj9 = new AlibabaWdkSkuAddRequest.IndustryPropDo();
obj9.setIndustryType("Industry_Clothes");
List<AlibabaWdkSkuAddRequest.PropDo> list11 = new ArrayList<AlibabaWdkSkuAddRequest.PropDo>();
AlibabaWdkSkuAddRequest.PropDo obj12 = new AlibabaWdkSkuAddRequest.PropDo();
list11.add(obj12);
obj12.setKey("color");
obj12.setValue("红色");
obj12.setRemoveOpt(false);
obj9.setProps(list11);
list8.setIndustryProps(obj9);
obj3.setForestCateId(126784428L);
obj3.setTaxCode("1020301020000000");
obj3.setFragileFlag(0L);
obj3.setDeliveryStorage("常温");
obj3.setFlagshipStoreItemInfo("xxx");
obj3.setTemporaryFlag(0L);
obj3.setProductIdentity("123");
obj3.setBizType("txd");
List<AlibabaWdkSkuAddRequest.ChannelProp> list15 = new ArrayList<AlibabaWdkSkuAddRequest.ChannelProp>();
AlibabaWdkSkuAddRequest.ChannelProp obj16 = new AlibabaWdkSkuAddRequest.ChannelProp();
list15.add(obj16);
obj16.setChannelType("shareStore");
List<AlibabaWdkSkuAddRequest.PropField> list19 = new ArrayList<AlibabaWdkSkuAddRequest.PropField>();
AlibabaWdkSkuAddRequest.PropField obj20 = new AlibabaWdkSkuAddRequest.PropField();
list19.add(obj20);
obj20.setValue("1");
obj20.setKey("ONE_HOUR_STATUS");
list17.setProps(list19);
list13.setChannelProps(list15);
obj3.setSpecType("1");
obj3.setTransRatio("10");
obj3.setParentSkuCode("111111");
obj3.setIsOnline(1L);
List<AlibabaWdkSkuAddRequest.ProcessProp> list23 = new ArrayList<AlibabaWdkSkuAddRequest.ProcessProp>();
AlibabaWdkSkuAddRequest.ProcessProp obj24 = new AlibabaWdkSkuAddRequest.ProcessProp();
list23.add(obj24);
obj24.setServiceName("宰杀");
list21.setProcessProps(list23);
List<AlibabaWdkSkuAddRequest.ProcessProp> list27 = new ArrayList<AlibabaWdkSkuAddRequest.ProcessProp>();
AlibabaWdkSkuAddRequest.ProcessProp obj28 = new AlibabaWdkSkuAddRequest.ProcessProp();
list27.add(obj28);
obj28.setPropName("温度");
List<AlibabaWdkSkuAddRequest.ServicePropValue> list31 = new ArrayList<AlibabaWdkSkuAddRequest.ServicePropValue>();
AlibabaWdkSkuAddRequest.ServicePropValue obj32 = new AlibabaWdkSkuAddRequest.ServicePropValue();
list31.add(obj32);
obj32.setName("常温");
list29.setPropValues(list31);
list25.setServiceProps(list27);
List<AlibabaWdkSkuAddRequest.ServiceProp> list35 = new ArrayList<AlibabaWdkSkuAddRequest.ServiceProp>();
AlibabaWdkSkuAddRequest.ServiceProp obj36 = new AlibabaWdkSkuAddRequest.ServiceProp();
list35.add(obj36);
AlibabaWdkSkuAddRequest.MutexProp obj38 = new AlibabaWdkSkuAddRequest.MutexProp();
obj38.setName("温度");
obj38.setValue("常温");
list37.setPropA(obj38);
AlibabaWdkSkuAddRequest.MutexProp obj40 = new AlibabaWdkSkuAddRequest.MutexProp();
obj40.setName("加冰");
obj40.setValue("少冰");
list39.setPropB(obj40);
list33.setMutexProps(list35);
AlibabaWdkSkuAddRequest.SelfPickUpVoucherInfoDO obj42 = new AlibabaWdkSkuAddRequest.SelfPickUpVoucherInfoDO();
obj42.setVoucherType(2L);
obj42.setStartTime(StringUtils.parseDateTime("2024-01-28 00:00:00"));
obj42.setEndTime(StringUtils.parseDateTime("2024-01-29 00:00:00"));
obj42.setAssociationSkus("");
obj42.setStores("");
AlibabaWdkSkuAddRequest.RuleDesc obj43 = new AlibabaWdkSkuAddRequest.RuleDesc();
obj43.setUseTime("到店核销，营业时间内可用");
obj43.setBookRule("无需预约");
obj43.setUseDesc("到店核销");
obj43.setRefundRule("随时可退、过期自动退，已核销的到店券不享受随时可退服务");
obj43.setOtherRule("其他");
obj42.setVoucherRule(obj43);
list41.setVoucherExt(obj42);
req.setParamList(list2);
AlibabaWdkSkuAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaWdkSkuAddRequest req = new AlibabaWdkSkuAddRequest();
List<AlibabaWdkSkuAddRequest.SkuDoDomain> list2 = new List<AlibabaWdkSkuAddRequest.SkuDoDomain>();
AlibabaWdkSkuAddRequest.SkuDoDomain obj3 = new AlibabaWdkSkuAddRequest.SkuDoDomain();
list2.Add(obj3);
obj3.Barcodes = "2017440";
obj3.BrandName = "帝皇鲜";
obj3.CategoryCode = "454545";
obj3.OuCode = "1062";
obj3.Height = "3.0";
obj3.InventoryUnit = "2kg";
obj3.Length = "10";
obj3.MainPicUrls = "https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
obj3.ManufacturerAddress = "挪威";
obj3.ManufacturerName = "日日鲜";
obj3.DetailPicUrls = "https://img.alicdn.com/a.png,https://img.alicdn.com/b.png,https://img.alicdn.com/c.png";
obj3.ProducerPlace = "中国|辽宁省|大连市";
obj3.ShelfLife = 15L;
obj3.SkuCode = "190100200014";
obj3.SkuName = "小龙虾 30-40g/只 称重";
obj3.SkuType = 1L;
obj3.StandardNo = "UII9999";
obj3.StorageType = 1L;
obj3.SuggestedPrice = "5990";
obj3.TaxRate = "15";
obj3.Weight = "30";
obj3.WeightFlag = 1L;
obj3.Width = "3";
obj3.HmCategoryCode = "57q34";
obj3.ShortTitle = "鲜活中华鲟 两斤";
obj3.TxtDesc = "鲜活中华鲟 两斤";
obj3.InvoiceContent = "阿里巴巴";
obj3.InputInvoiceContent = "阿里巴巴";
obj3.AccountingCategory = "22";
obj3.NetContent = "250ml*18盒/箱";
obj3.ImportFlag = 0L;
obj3.SaleUnit = "个";
obj3.SalePrice = "10";
obj3.LifeStatus = "A";
obj3.SaleSpec = "100g*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<AlibabaWdkSkuAddRequest.SkuSupplierDoDomain> list5 = new List<AlibabaWdkSkuAddRequest.SkuSupplierDoDomain>();
AlibabaWdkSkuAddRequest.SkuSupplierDoDomain obj6 = new AlibabaWdkSkuAddRequest.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;
AlibabaWdkSkuAddRequest.IndustryPropDoDomain obj7 = new AlibabaWdkSkuAddRequest.IndustryPropDoDomain();
obj7.IndustryType = "Industry_Clothes";
List<AlibabaWdkSkuAddRequest.PropDoDomain> list9 = new List<AlibabaWdkSkuAddRequest.PropDoDomain>();
AlibabaWdkSkuAddRequest.PropDoDomain obj10 = new AlibabaWdkSkuAddRequest.PropDoDomain();
list9.Add(obj10);
obj10.Key = "color";
obj10.Value = "红色";
obj10.RemoveOpt = false;
obj7.Props= list9;
obj3.IndustryProps= obj7;
obj3.ForestCateId = 126784428L;
obj3.TaxCode = "1020301020000000";
obj3.FragileFlag = 0L;
obj3.DeliveryStorage = "常温";
obj3.FlagshipStoreItemInfo = "xxx";
obj3.TemporaryFlag = 0L;
obj3.ProductIdentity = "123";
obj3.BizType = "txd";
List<AlibabaWdkSkuAddRequest.ChannelPropDomain> list12 = new List<AlibabaWdkSkuAddRequest.ChannelPropDomain>();
AlibabaWdkSkuAddRequest.ChannelPropDomain obj13 = new AlibabaWdkSkuAddRequest.ChannelPropDomain();
list12.Add(obj13);
obj13.ChannelType = "shareStore";
List<AlibabaWdkSkuAddRequest.PropFieldDomain> list15 = new List<AlibabaWdkSkuAddRequest.PropFieldDomain>();
AlibabaWdkSkuAddRequest.PropFieldDomain obj16 = new AlibabaWdkSkuAddRequest.PropFieldDomain();
list15.Add(obj16);
obj16.Value = "1";
obj16.Key = "ONE_HOUR_STATUS";
obj13.Props= list15;
obj3.ChannelProps= list12;
obj3.SpecType = "1";
obj3.TransRatio = "10";
obj3.ParentSkuCode = "111111";
obj3.IsOnline = 1L;
List<AlibabaWdkSkuAddRequest.ProcessPropDomain> list18 = new List<AlibabaWdkSkuAddRequest.ProcessPropDomain>();
AlibabaWdkSkuAddRequest.ProcessPropDomain obj19 = new AlibabaWdkSkuAddRequest.ProcessPropDomain();
list18.Add(obj19);
obj19.ServiceName = "宰杀";
obj3.ProcessProps= list18;
List<AlibabaWdkSkuAddRequest.ProcessPropDomain> list21 = new List<AlibabaWdkSkuAddRequest.ProcessPropDomain>();
AlibabaWdkSkuAddRequest.ProcessPropDomain obj22 = new AlibabaWdkSkuAddRequest.ProcessPropDomain();
list21.Add(obj22);
obj22.PropName = "温度";
List<AlibabaWdkSkuAddRequest.ServicePropValueDomain> list24 = new List<AlibabaWdkSkuAddRequest.ServicePropValueDomain>();
AlibabaWdkSkuAddRequest.ServicePropValueDomain obj25 = new AlibabaWdkSkuAddRequest.ServicePropValueDomain();
list24.Add(obj25);
obj25.Name = "常温";
obj22.PropValues= list24;
obj3.ServiceProps= list21;
List<AlibabaWdkSkuAddRequest.ServicePropDomain> list27 = new List<AlibabaWdkSkuAddRequest.ServicePropDomain>();
AlibabaWdkSkuAddRequest.ServicePropDomain obj28 = new AlibabaWdkSkuAddRequest.ServicePropDomain();
list27.Add(obj28);
AlibabaWdkSkuAddRequest.MutexPropDomain obj29 = new AlibabaWdkSkuAddRequest.MutexPropDomain();
obj29.Name = "温度";
obj29.Value = "常温";
obj28.PropA= obj29;
AlibabaWdkSkuAddRequest.MutexPropDomain obj30 = new AlibabaWdkSkuAddRequest.MutexPropDomain();
obj30.Name = "加冰";
obj30.Value = "少冰";
obj28.PropB= obj30;
obj3.MutexProps= list27;
AlibabaWdkSkuAddRequest.SelfPickUpVoucherInfoDODomain obj31 = new AlibabaWdkSkuAddRequest.SelfPickUpVoucherInfoDODomain();
obj31.VoucherType = 2L;
obj31.StartTime = DateTime.Parse(2024-01-28 00:00:00");
obj31.EndTime = DateTime.Parse(2024-01-29 00:00:00");
obj31.AssociationSkus = "";
obj31.Stores = "";
AlibabaWdkSkuAddRequest.RuleDescDomain obj32 = new AlibabaWdkSkuAddRequest.RuleDescDomain();
obj32.UseTime = "到店核销，营业时间内可用";
obj32.BookRule = "无需预约";
obj32.UseDesc = "到店核销";
obj32.RefundRule = "随时可退、过期自动退，已核销的到店券不享受随时可退服务";
obj32.OtherRule = "其他";
obj31.VoucherRule= obj32;
obj3.VoucherExt= obj31;
req.ParamList_ = list2;
AlibabaWdkSkuAddResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaWdkSkuAddRequest;
$param_list = new SkuDo;
$param_list->barcodes="2017440";
$param_list->brand_name="帝皇鲜";
$param_list->category_code="454545";
$param_list->ou_code="1062";
$param_list->height="3.0";
$param_list->inventory_unit="2kg";
$param_list->length="10";
$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->manufacturer_address="挪威";
$param_list->manufacturer_name="日日鲜";
$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->producer_place="中国|辽宁省|大连市";
$param_list->shelf_life="15";
$param_list->sku_code="190100200014";
$param_list->sku_name="小龙虾 30-40g/只 称重";
$param_list->sku_type="1";
$param_list->standard_no="UII9999";
$param_list->storage_type="1";
$param_list->suggested_price="5990";
$param_list->tax_rate="15";
$param_list->weight="30";
$param_list->weight_flag="1";
$param_list->width="3";
$param_list->hm_category_code="57q34";
$param_list->short_title="鲜活中华鲟 两斤";
$param_list->txt_desc="鲜活中华鲟 两斤";
$param_list->invoice_content="阿里巴巴";
$param_list->input_invoice_content="阿里巴巴";
$param_list->accounting_category="22";
$param_list->net_content="250ml*18盒/箱";
$param_list->import_flag="0";
$param_list->sale_unit="个";
$param_list->sale_price="10";
$param_list->life_status="A";
$param_list->sale_spec="100g*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;
$industry_props = new IndustryPropDo;
$industry_props->industry_type="Industry_Clothes";
$props = new PropDo;
$props->key="color";
$props->value="红色";
$props->remove_opt="false";
$industry_props->props = $props;
$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="123";
$param_list->biz_type="txd";
$channel_props = new ChannelProp;
$channel_props->channel_type="shareStore";
$props = new PropField;
$props->value="1";
$props->key="ONE_HOUR_STATUS";
$channel_props->props = $props;
$param_list->channel_props = $channel_props;
$param_list->spec_type="1";
$param_list->trans_ratio="10";
$param_list->parent_sku_code="111111";
$param_list->is_online="1";
$process_props = new ProcessProp;
$process_props->service_name="宰杀";
$param_list->process_props = $process_props;
$service_props = new ProcessProp;
$service_props->prop_name="温度";
$prop_values = new ServicePropValue;
$prop_values->name="常温";
$service_props->prop_values = $prop_values;
$param_list->service_props = $service_props;
$mutex_props = new ServiceProp;
$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;
$voucher_ext = new SelfPickUpVoucherInfoDO;
$voucher_ext->voucher_type="2";
$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.add' \
-d 'partner_id=apidoc' \
-d 'session=2a4c7721-7aa9-4ddc-bed9-cb2e2aa3bcfe' \
-d 'sign=1685C5A5E73B0CFD1C364063E2B1212D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-08-23+11%3A35%3A46' \
-d 'v=2.0' \
-d 'param_list=null'

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

req=top.api.AlibabaWdkSkuAddRequest(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.add");
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.add', {
	'param_list':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

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

{
    "alibaba_wdk_sku_add_response":{
        "result":{
            "err_code":"ILLEGAL_PARAMETERS",
            "err_msg":"请参见子字段信息",
            "models":{
                "api_result":[
                    {
                        "err_code":"ILLEGAL_PARAMETERS",
                        "err_msg":"门店商品已存在",
                        "success":true,
                        "model":"190100200014",
                        "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.add (新增商品)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ