更新商品SKU的价格
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| 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)，sku数量变化后item的总数量也会随着变化。取值范围:大于等于零的整数 | |
| price | Price | 可选 | 207.02 | Sku的销售价格。精确到2位小数;单位:元。如:200.07，表示:200元7分。修改后的sku价格要保证商品的价格在所有sku价格所形成的价格区间内（例如：商品价格为6元，sku价格有5元、10元两种，如果要修改5元sku的价格，那么修改的范围只能是0-6元之间；如果要修改10元的sku，那么修改的范围只能是6到无穷大的区间中） | |
| outer_id | String | 可选 | 123456 | Sku的商家外部id | |
| lang | String | 可选 | zh_CN |
|
Sku文字的版本。可选值:zh_HK(繁体),zh_CN(简体);默认值:zh_CN |
| item_price | Price | 可选 | 204 | sku所属商品的价格。当用户更新sku，使商品价格不属于sku价格之间的时候，用于修改商品的价格，使sku能够更新成功 | |
| ignorewarning | String | 可选 | ,ifd_warning,FakeCredit_Warning, | 忽略警告提示. |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| sku | Sku | 商品SKU信息（只包含num_iid和modified） | |
|
|||
1 2 3 4 5 6 7 8 9 10 11 12 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);ItemSkuPriceUpdateRequest req = new ItemSkuPriceUpdateRequest();req.setNumIid(123456L);req.setProperties("1627207:28326;1630696:3266779");req.setQuantity(3L);req.setPrice("207.02");req.setOuterId("123456");req.setLang("zh_CN");req.setItemPrice("204");req.setIgnorewarning(",ifd_warning,FakeCredit_Warning,");ItemSkuPriceUpdateResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 | <item_sku_price_update_response> <sku> <iid>asdf12323adfaa</iid> <num_iid>12345</num_iid> <modified>2009-11-04 15:24:43</modified> <sku_id>123</sku_id> </sku></item_sku_price_update_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_SKU_MUST_IN_SPU_RANGE | 商品所选择销售属性超出产品许可范围，请联系小二确认 | |
| isv.item-update-service-error:IC_BRAND_NOT_GRANT_FOR_B | 未授权发布此品牌的商品 | 当发生此错误时不能重试，需要重新编辑整个商品的品牌相关信息。 |
| isv.item-update-service-error:ITEM_NOT_FOUND | 没有找到宝贝 | |
| isv.item-update-service-error:IC_CHECKSTEP_PRICE_ERROR | 不符合类目价格限制，此类目下最高价格为${CATEGORY_PRICE_LIMITED_HIGHT}，最低价格为${CATEGORY_PRICE_LIMITED_LOW} | |
| isv.item-update-service-error:ITEM_INPUT_PROPERTIES_ERROR | 输入属性错误 | |
| isv.item-update-service-error:IC_INVALID_SPU_FOR_VERTICAL | 产品不在产品库内，请联系我们的小二！ | |
| isv.item-get-service-error:ITEM_NOT_FOUND | 没有找到宝贝 | 1. 确认num_iid是否正确，请通过taobao.items.get/taobao.items.search等查询接口获取正确的宝贝 num_iid，再通过taobao.item.sku.update接口更新sku信息； 2. 如果num_iid无误，则对应的宝贝可能已违规或进入历史库，在本地增加逻辑：发现报商品不存在的错误（ITEM_NOT_FOUND）就将本地的商品 记录删除掉，防止卖家或者系统自动重试再次发生这个问题。3. 这个是业务不可避免的错误。当商品被删除一定时间、或者商品长达3个月都没有被编辑过以后，商品会被移到历史库中再也找不到。解决该问题，可以使用增量 api监控商品被删除的消息，及时把发生这个错误的商品从本地数据库中删除掉，随时保持数据的同步性。发生这个错误时不要重试。 |
| isv.item-update-service-error:IC_CATEGORY_NOT_GRANT_FOR_B | 未授权发布此类目的商品 | |
| isv.item-is-delete:invalid-numIid-or-iid | 该商品已被删除 | 1. 出现此错误不要重试，通过增量接口taobao.increment.items.get获取被删除的商品，在本地数据库更新； 2. 为减少此错误的发生量，平时应增加逻辑：用增量接口taobao.increment.items.get监控商品状态，定时更新数据库 |
| isv.item-update-service-error:QUANTITY_ITEM_CAT_TOO_LARGE | 您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额（卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate}，允许宝贝个 数:${onlineLimitMax}），请您及时调整您的宝贝数量，再上传宝贝 | 1.发生该错误时不能重试。2.将这个用户和这个类目做上关联标记，用户不能再到这个类目下发布在售商品或编辑、上架商品，需要等卖家下架其他商品后再手动解除其限制。 |
| isv.item-update-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU | 您已发布过同类宝贝，不允许重复发布 | 当前商品所属的产品下已经有一个一样的商品了，出现此错误不可重试，重新编辑商品为下架状态，或者下架另外一个商品后再编辑此商品。 |
| isv.item-update-service-error:IC_PRICE_LIMIT_FOR_DPC | 宝贝价格须在指定零售价范围内（${lowPriceForDpc}-${highPriceForDpc}元），如有异常，请您登陆分销平台同步商品信息 | |
| isv.missing-parameter:sku-quantity-or-price | quantity和price有一个或都没有传入 | 每次编辑sku的时候，如果是用户新加的sku，增加校验quantity和price的步骤，这两个参数都必须要传进来。或者每次编辑都将这两个参数传回来，不传就前端报错，不允许调用接口。 |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_DUPLICATE | 宝贝销售属性出错（重复），请重新编辑 | |
| isv.item-update-service-error:ITEM_PROPERTIES_ERROR | ${lostPropText}属性出错 | 1.发生错误需要让卖家重新编辑商品，不能直接重试 2.发布商品前，需要对卖家发布商品的属性做好前端校验，看必填属性有没有缺失，可选属性有没有填错。属性最好直接让卖家选择，不要让卖家手工输入。 3.如果卖家的商品关联了product，最好将product取出来的关键属性直接填充到商品的属性中，避面因用户错选导致错误 。4.每天定期更新本地的类目属性数据（每天凌晨5点后更新，每天更新一次），保证本地数据的正确性。 |
| isv.missing-parameter:iid-or-numIid | 参数：iid或numIid没有传入 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_FOUND_IN_ITEM | 宝贝销售属性出错（销售属性和商品属性不一致），请重新编辑 | |
| isv.item-update-service-error:ERROR_SHOP_CATEGORY_HAS_SUB_CATEGORIES | 自定义店铺分类不存在或者店铺分类错误 | 更新自定义店铺类目的时候要先搜一下店铺该类目下是否有商品，如果有商品，要同时更新商品的seller_cids，但如果是用户在淘宝后台更改自定义类目，则出现错误后不要重试，然后用户到淘宝后台修改 |
| isv.item-update-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY | 商品描述为空 | 出现问题后不要重试 |
| isv.item-update-service-error:IC_CHECKSTEP_NO_PERMISSION | 您未通过认证或已被处罚，请核实 | 发生该错误时不要重试，将这个用户做上标记后让用户检查自己的权限问题，等用户处理好了再让用户来手动取消禁止标记。否则就不允许用户发布或者编辑商品 |
| isv.item-update-service-error:IC_ITEM_3C_RULE_INVOICE | 淘宝电器城商品必须有发票/有保修/卖家包邮 | |
| isv.item-update-service-error:IC_SELLER_NEED_PAY_POSTFEE | 必须由卖家承担运费 | |
| 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_CHECKSTEP_SKU_PROP_NOT_SALE | 宝贝销售属性出错（非销售属性），请重新编辑 | 1.前端要定期更新淘宝的类目属性数据，每天早上5点以后更新一次。2.发生次错误不能重试，需要提示用户重新编辑商品和sku的属性再上传（如果是新增sku报错误则重新编辑，如果是旧的sku报此错误需要删除旧的sku重新上传新的sku） |
| isv.item-update-service-error:IC_CHECKSTEP_SPU_NOT_EXIST | 您发布的商品无对应产品 | 请登录“淘宝网”先行发布产品 |
| isv.item-update-service-error:GENERIC_FAILURE | 系统错误，请稍后再试 | |
| isv.item-update-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH | 商品的价格要位于sku的价格区间之中（例如，sku价格有5元、10元两种，那么商品的价格就需要大于等于5元，小于等于10元） | 需要对item价格或sku价格做更改时，在前端做好校验。发生错误后重新编辑商品价格再提交，不要直接重试。 |
| 错误码：40，子错误码：null | 缺少必要的传入参数 | |
| 错误码：41，子错误码：null | 传入参数的格式错误 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_ERROR | 宝贝销售属性出错 | |
| isv.item-update-service-error:IC_CHECKSTEP_SKU_PRICE_ERROR | 宝贝销售价格错误 | |
| isv.invalid-parameter:sku-price | 参数：sku-price无效，格式不对、非法值、越界等 | 1. 出现此错误后不要重试，请验证sku的价格是否大于等于0； 2. 应用在前端应对sku价格进行校验，超出范围便提示用户重新输入 |
| isv.invalid-permission:update-item | 该商品不属于当前用户 | 请在用户和商品之间做好匹配 |
| isv.error-trigger-fake-credit | 触发了防炒信规则警告 | 在 ignorewarning 字段中包含 “,FakeCredit_Warning,” 字样(引号内)，如果这样做，系统将认为用户确认了警告的内容并要求进行更新。 |
| isp.system-busy | 服务异常，请稍后重试 | 服务异常，请稍后重试 |
| isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT | 商品更新频率太快，请降低商家维度更新频率 | 商品更新频率太快，请降低商家维度更新频率 |
| isv.item-not-exist:invalid-numIid-or-iid | 商品不存在 | 商品不存在，请检查numIid是否填写正确 |
| isv.item-service-error:IC_CHECKSTEP_ITME_NOT_IN_SKU_PRICE | 商品价格和sku价格不匹配 | 请检查商品价格是否包含在sku价格中 |
| isv.item-service-error:AUCTION_SCHEMA_SKU_FEATURE_NO_PERMISSION | 此商品暂不支持TOP编辑，请到商家后台完成编辑 | 此商品暂不支持TOP编辑，请到商家后台完成编辑 |
| isv.item-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOSHOP | 发布、编辑上架和上架全新宝贝必须是店铺卖家 | 发布、编辑上架和上架全新宝贝必须是店铺卖家 |
| isv.item-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH | 商品价格和sku价格不匹配 | 请检查商品价格是否在sku价格中 |
| isv.item-service-error:ITEM_PROPERTIES_ERROR | 缺少类目必填属性, 类目ID:[50012043],类目名称:[板鞋/休闲鞋], 属性ID:[122276315],属性名称:[款式] | 请完善后再提交 |