新增一个sku到num_iid指定的商品中 传入的iid所对应的商品必须属于当前会话的用户
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
num_iid | Number | 必须 | 123456 | Sku所属商品数字id。必选 | |
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, | 忽略警告提示. |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
sku | Sku | sku | |
|
1 2 3 4 5 6 7 8 9 10 11 12 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); ItemSkuAddRequest req = new ItemSkuAddRequest(); 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," ); ItemSkuAddResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 | < item_sku_add_response > < sku > < iid >asdf12323adfaa</ iid > < num_iid >12345</ num_iid > < created >2009-11-04 15:24:43</ created > < sku_id >123</ sku_id > </ sku > </ item_sku_add_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 | 宝贝销售属性出错(非销售属性),请重新编辑 | |
isv.item-update-service-error:GENERIC_FAILURE | 系统错误,请稍后再试 | |
isv.item-update-service-error:QUANTITY_ITEM_CAT_TOO_LARGE | 您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额(卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate},允许宝贝个数:${onlineLimitMax}),请您及时调整您的宝贝数量,再上传宝贝 | |
isv.invalid-parameter:iid | 参数:iid无效,格式不对、非法值、越界等 | |
isv.item-update-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY | 宝贝描述不能为空 | |
isv.item-update-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR | 上架的数量必须大于0 | |
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}属性出错 | |
错误码: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,” 字样(引号内),如果这样做,系统将认为用户确认了警告的内容并要求进行更新。 |