* 单个商品上架 * 输入的num_iid必须属于当前会话用户
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| num_iid | Number | 必须 | 1000231 | 商品数字ID，该参数必须 | |
| num | Number | 必须 | 2 | 需要上架的商品的数量。取值范围:大于零的整数。如果商品有sku，则上架数量默认为所有sku数量总和，不可修改。否则商品数量根据设置数量调整为num |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| item | Item | 上架后返回的商品信息：返回的结果就是:num_iid和modified | |
|
|||
1 2 3 4 5 6 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);ItemUpdateListingTmallRequest req = new ItemUpdateListingTmallRequest();req.setNumIid(1000231L);req.setNum(2L);ItemUpdateListingTmallResponse rsp = client.execute(req, sessionKey);System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 | <item_update_listing_tmall_response> <item> <iid>569a64fce2e98bce187bcbbb4a4d262a</iid> <num_iid>1489161932</num_iid> <modified>2000-01-01 00:00:00</modified> </item></item_update_listing_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-listing-service-error:QUANTITY_ITEM_CAT_TOO_LARGE_OF_ONLINE | ${mainCategoryName}类目下，非特种经营认证卖家发布宝贝数量不能超过${onlineLimitMax}件 | |
| isv.item-listing-service-error:ERROR_PUBLISH_DUPLICATE | 宝贝重复发布 | 正常错误提醒，不允许重试。如果报错是商品量的两倍以上，系统会自动报警。 |
| isv.item-listing-service-error:IC_CHECKSTEP_BEYOND_LOW_PRICE_LIMIT | 本类目下 价格不得低于${CATEGORY_PRICE_LIMITED_LOW} | 正常错误提醒，请用户按照提醒更改商品价格，不要重试 |
| isv.item-listing-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH | 宝贝价格必须介于销售属性组合价格区间之内 | |
| isv.item-listing-service-error:QUANTITY_TOO_LARGE | 本类目发布的宝贝数量超出限制，不允许再发布 | 正常错误提醒，不要重试 |
| isv.item-listing-service-error:REST_TOTAL_QUANTITY_GREAT_10 | 闲置宝贝累计发布数量不得大于10件 | |
| isv.item-listing-service-error:CATEGORY_IS_NOT_LEAF_OR_NOT_EXIST | 选择的类目不存在或者类目路径不完整 | |
| isv.item-listing-service-error:ERROR_PUBLISH_PERMISSION_INVALID_FOR_FRANCHISE | 您没有特种类目的经营权限，请核实 | |
| isv.item-listing-service-error:ERROR_AUTO_SAME | 卡密信息出错，请确认卡密格式等无误 | |
| isv.missing-parameter:iid-or-numIid | 参数：iid或numIid没有传入 | 必须传入num_iid |
| isv.item-listing-service-error:IC_BRAND_NOT_GRANT_FOR_B | 未授权发布此品牌的商品 | 用taobao.itemcats.authorize.get接口确认被授权发布的品牌，再发布该品牌的商品 |
| isv.item-listing-service-error:IC_CHECKSTEP_NO_PERMISSION | 您未通过认证或已被处罚，请核实 | 一旦发生该错误，就要将该用户做上标记，让用户去检查自己的权限问题，等用户处理好了让用户来手动取消禁止标记，发生该错误不要重试 |
| isv.item-listing-service-error:REST_QUANTITY_GREAT_1 | 闲置宝贝每次只能发布1件 | |
| isv.item-listing-service-error:IC_ITEM_MUST_IMAGE | 请添加 宝贝图片 | |
| isv.item-listing-service-error:QUANTITY_TOO_LARGE_FOR_SECOND_HAND | 该类目下二手宝贝只能发布1件 | |
| isv.item-listing-service-error:ERROR_PUBLISH_PERMISSION_INVALID | 您没有发布此类宝贝的权限 | |
| isv.item-listing-service-error:IC_CHECKSTEP_SPU_STATUS_ERROR | 宝贝对应的产品已被屏蔽，请勿发布 | |
| isv.item-listing-service-error:IC_CHECKSTEP_SPU_NOT_EXIST | 您发布的商品无对应产品，请登录“淘宝网”先行发布产品 | |
| isv.item-listing-service-error:ERROR_AUTO_CC_IS_NULL | 请输入卡密 | |
| isv.item-listing-service-error:IC_ITEM_3C_RULE_INVOICE | 淘宝电器城商品必须有发票/有保修/卖家包邮 | |
| isv.item-listing-service-error:ERROR_AUCTION_NOT_CLOSED | 已经出价的且在线的拍卖宝贝不能上架 | |
| isv.item-listing-service-error:IC_INVALID_SPU_FOR_VERTICAL | 产品不在产品库内，请联系我们的小二！ | |
| isv.item-listing-service-error:AUTO_CCURL_COULD_NOT_EMPTY | 在线卡密充值地址不能为空 | |
| isv.item-listing-service-error:REST_SALING_AUCTION | 有相同的闲置宝贝正在出售中 | |
| isv.item-listing-service-error:ERROR_ATTACH_PERMISSION_INVALID | 此类目不允许上传附件 | |
| isv.item-listing-service-error:IC_CATEGORY_NOT_GRANT_FOR_B | 未授权发布此类目的商品 | |
| isv.item-listing-service-error:IC_CHECKSTEP_PRICE_ERROR | 不符合类目价格限制，此类目下最高价格为${CATEGORY_PRICE_LIMITED_HIGHT}，最低价格为${CATEGORY_PRICE_LIMITED_LOW} | |
| isv.item-listing-service-error:RATE_SUM_TOO_LITTLE_TO_PUBLISH_MULTIAUCTION | 发布荷兰拍信用等级不够 | |
| isv.item-listing-service-error:IC_CHECKSTEP_PROPERTY_TOO_LONG | 您提供的属性最多不能超过35个 | |
| isv.item-listing-service-error:ERROR_PUBLISH_PERMISSION_INVALID_FOR_ECARD | 您没有发布“自动充值”类型宝贝的权限，请核实 | |
| isv.item-listing-service-error:ITEM_IS_NOT_BELONG_TO_SELLER | 获取商品列表错误，请隔3小时后再试 | |
| isv.item-listing-service-error:ITEM_PROPERTIES_ERROR | 属性出错 | 商品所属类目的属性更新过了，重新上架的时候校验失败，靖重新编辑商品再上架 |
| isv.item-listing-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR | 上架的数量必须大于0 | 在前端做好判断，上架数量小于或等于0则不调用此接口 |
| isv.item-listing-service-error:QUANTITY_ITEM_CAT_TOO_LARGE | 您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额（卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate}，允许宝贝个数:${onlineLimitMax}），请您及时调整您的宝贝数量，再上传宝贝 | 出现此错误表示该类目下上架的宝贝数量已经超过限额，请不要重试 |
| isv.item-listing-service-error:ITEM_INPUT_PROPERTIES_ERROR | 输入属性错误 | 重新编辑商品输入属性再上架 |
| 错误码：40，子错误码：null | 缺少必要的传入参数 | |
| 错误码：41，子错误码：null | 传入参数的格式错误 | |
| isv.invalid-parameter:cid | 参数：cid无效，可能为格式不对、非法值、越界或者用户指定商品所属的cid找不到对应的信息等情况 | 1.每天定期更新本地的类目属性缓存（早上5点以后），将已经不存在的或者已修改的类目属性从本地缓存中清除掉，保持本地数据和淘宝数据的一致性 2.发生错误不要重试，将不存在的类目属性从本地移除，或者重新刷新本地的缓存记录。（后台每天只会更新一次缓存，所以要注意本地数据的维护） |