新增一个sku到num_iid指定的商品中 传入的iid所对应的商品必须属于当前会话的用户
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| num_iid | Number | 必须 | 123456 | Sku所属商品数字id，可通过 taobao.item.get 获取。必选 | |
| properties | String | 必须 | 1627207:28326;1630696:3266779 | Sku属性串。格式:pid:vid;pid:vid,如:1627207:3232483;1630696:3284570,表示:机身颜色:军绿色;手机套餐:一电一充。 | |
| quantity | Number | 必须 | 3 | Sku的库存数量。sku的总数量应该小于等于商品总数量(Item的NUM)。取值范围:大于零的整数 | |
| price | Price | 必须 | 200.07 | Sku的销售价格。商品的价格要在商品所有的sku的价格之间。精确到2位小数;单位:元。如:200.07，表示:200元7分 | |
| outer_id | String | 可选 | 123456 | Sku的商家外部id | |
| lang | String | 可选 | zh_CN |
|
Sku文字的版本。可选值:zh_HK(繁体),zh_CN(简体);默认值:zh_CN |
| item_price | Price | 可选 | 200.07 | sku所属商品的价格。当用户新增sku，使商品价格不属于sku价格之间的时候，用于修改商品的价格，使sku能够添加成功 | |
| ignorewarning | String | 可选 | ,ifd_warning,FakeCredit_Warning, | 忽略警告提示. | |
| spec_id | Number | 可选 | 123 | 产品的规格信息 | |
| sku_delivery_time | String | 可选 | sku_delivery_time | sku_delivery_time | |
| sku_hd_length | String | 可选 | 20,30,30 | 家装建材类目，商品SKU的长度，正整数，单位为cm，部分类目必选。天猫商家专用。 数据和SKU一一对应，用,分隔，如：20,30,30 | |
| sku_hd_height | String | 可选 | 15-25,25-50,25-50 | 家装建材类目，商品SKU的高度，单位为cm，部分类目必选。天猫商家专用。 可选值为："0-15", "15-25", "25-50", "50-60", "60-80", "80-120", "120-160", "160-200"。 数据和SKU一一对应，用,分隔，如：15-25,25-50,25-50 | |
| sku_hd_lamp_quantity | String | 可选 | 3,5,7 | 家装建材类目，商品SKU的灯头数量，正整数，大于等于3，部分类目必选。天猫商家专用。 数据和SKU一一对应，用,分隔，如：3,5,7 |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| sku | Sku | sku | |
|
|||
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);ItemSkuAddTmallRequest req = new ItemSkuAddTmallRequest();req.setNumIid(123456L);req.setProperties("1627207:28326;1630696:3266779");req.setQuantity(3L);req.setPrice("200.07");req.setOuterId("123456");req.setLang("zh_CN");req.setItemPrice("200.07");req.setIgnorewarning(",ifd_warning,FakeCredit_Warning,");req.setSpecId(123L);req.setSkuDeliveryTime("sku_delivery_time");req.setSkuHdLength("20,30,30");req.setSkuHdHeight("15-25,25-50,25-50");req.setSkuHdLampQuantity("3,5,7");ItemSkuAddTmallResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 | <item_sku_add_tmall_response> <sku> <iid>asdf12323adfaa</iid> <num_iid>12345</num_iid> <created>2009-11-04 15:24:43</created> <sku_id>123</sku_id> <spec_id></spec_id> </sku></item_sku_add_tmall_response> |
1 2 3 4 5 6 | <error_response> <code>50</code> <msg>Remote service error</msg> <sub_code>isv.invalid-parameter</sub_code> <sub_msg>非法参数</sub_msg></error_response> |
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| isv.item-update-service-error:IC_CATEGORY_NOT_GRANT_FOR_B | 未授权发布此类目的商品 | |
| isv.item-update-service-error:IC_CHECKSTEP_NO_PERMISSION | 您未通过认证或已被处罚，请核实 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_FOUND_IN_ITEM | 宝贝销售属性出错（销售属性和商品属性不一致），请重新编辑 | |
| isv.item-update-service-error:ITEM_INPUT_PROPERTIES_ERROR | 输入属性错误 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_SALE | 宝贝销售属性出错（非销售属性），请重新编辑 | 1.前端要定期更新淘宝的类目属性数据，每天早上5点以后更新一次。2.发生次错误不能重试，需要提示用户重新编辑商品和sku的属性再上传（如果是新增sku报错误则重新编辑，如果是旧的sku报此错误需要删除旧的sku重新上传新的sku） |
| isv.item-update-service-error:GENERIC_FAILURE | 系统错误，请稍后再试 | |
| isv.item-update-service-error:QUANTITY_ITEM_CAT_TOO_LARGE | 您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额（卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate}，允许宝贝个数:${onlineLimitMax}），请您及时调整您的宝贝数量，再上传宝贝 | |
| isv.item-update-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY | 宝贝描述不能为空 | |
| isv.item-update-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR | 上架商品数量必须大于0 | 此接口需要在前端做好改进控制：1.编辑sku前需要对当前商品所有的sku进行判断，如果此sku是最后一个有数量的sku，不能将他更新为0，或者直接将sku下架即可。2.在批量对sku进行编辑的时候要注意编辑顺序，先增加sku或者先编辑数量不为0的sku，再编辑数量为0 的sku或者删除sku。3.出现此错误不能重试，要提示卖家重新编辑商品。 |
| isv.item-update-service-error:IC_INVALID_SPU_FOR_VERTICAL | 产品不在产品库内，请联系我们的小二！ | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_DUPLICATE | 宝贝销售属性出错（重复），请重新编辑 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_DUPLICATE | 宝贝销售属性出错（属性重复），请重新编辑 | |
| isv.item-is-delete:invalid-numIid-or-iid | 根据num_iid或iid查询到的商品一经被删除 | |
| isv.item-update-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU | 您已发布过同类宝贝，不允许重复发布 | |
| isv.missing-parameter:iid-or-numIid | 参数：iid或numIid没有传入 | |
| isv.item-update-service-error:ITEM_PROPERTIES_ERROR | ${lostPropText}属性出错 | 1.发生错误需要让卖家重新编辑商品，不能直接重试 2.发布商品前，需要对卖家发布商品的属性做好前端校验，看必填属性有没有缺失，可选属性有没有填错。属性最好直接让卖家选择，不要让卖家手工输入。 3.如果卖家的商品关联了product，最好将product取出来的关键属性直接填充到商品的属性中，避面因用户错选导致错误 。4.每天定期更新本地的类目属性数据（每天凌晨5点后更新，每天更新一次），保证本地数据的正确性。 |
| 错误码：40，子错误码：null | 缺少必要的传入参数 | 请根据返回的错误信息，将必传参数都填写好 |
| isv.item-update-service-error:IC_BRAND_NOT_GRANT_FOR_B | 未授权发布此品牌的商品 | 当发生此错误时不能重试，需要重新编辑整个商品的品牌相关信息。 |
| isv.item-update-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH | 商品的价格要位于sku的价格区间之中（例如，sku价格有5元、10元两种，那么商品的价格就需要大于等于5元，小于等于10元） | 需要对item价格或sku价格做更改时，在前端做好校验。发生错误后重新编辑商品价格再提交，不要直接重试。 |
| isv.item-update-service-error:IC_CHECKSTEP_SPU_NOT_EXIST | 您发布的商品无对应产品 | 请登录“淘宝网”先行发布产品 |
| isv.error-update-in-websit-for-first:CSPU_ERROR_UPDATE_IN_WEBSIT_FOR_FIRST | 受管控的类目和品牌下的商品第一次更新信息要到网站上完成 | 受管控的类目和品牌下的商品第一次更新信息要到网站上完成 |
| isv.error-spu-tmall-disabled:CSPU_ERROR_SPU_TMALL_DISABLED | 产品不存在 | 产品不存在 |
| isv.error-sku-no-have:CSPU_ERROR_SKU_MUST_BE_NEED | 必须要发布SKU | 必须要发布SKU |
| isv.error-sku-no-have-spec-id:CSPU_ERROR_SKU_NO_HAVE_SPEC_ID | 请选择产品规格后才能发布 | 请选择产品规格后才能发布 |
| isv.error-spec-status-ok:CSPU_ERROR_CSPU_MUST_XIAOER_CONFIRM | 该产品规格小二未审核，不能使用 | 该产品规格小二未审核，不能使用 |
| isv.error-spec-spu-not-match:CSPU_ERROR_CSPU_SPU_NOT_MATCH | 请选择 正确的产品规格 | 请选择 正确的产品规格 |
| isv.spect-not-saleproperty-publish-bypage:ISV_ERROR_CAT_BRAND_NOT_SALEPRO_TO_PAGE | 受管控的类目品牌，如果没有销售属性必须到页面上发布！ | 请到天猫后台产品发布页面上发布产品规格 |
| isv.error-inventory-invalid-item-quantity | 宝贝数量 必须大于预扣库存,否则会导致拍卖下未付款的卖家,付款失败 | 重新编辑宝贝数量,大于预扣库存数量 |
| isv.error-inventory-invalid-sku-quantity | 销售数量 必须大于预扣库存,否则会导致拍卖下未付款的卖家,付款失败 | 重新编辑sku 数量。大于预扣库存数量 |
| isv.error-trigger-fake-credit | 触发了防炒信规则警告 | 在 ignorewarning 字段中包含 “,FakeCredit_Warning,” 字样(引号内)，如果这样做，系统将认为用户确认了警告的内容并要求进行更新。 |