文档中心 > API类目 > 商品编辑

taobao.item.sku.add (添加SKU)

新增一个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
  • 默认值: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
    • └ iid
    • String
    • asdf12323adfaa
    • sku所属商品id(注意:iid近期即将废弃,请用num_iid参数)
    • └ num_iid
    • Number
    • 12345
    • sku所属商品数字id
    • └ created
    • String
    • 2009-11-04 15:24:43
    • sku创建日期 时间格式:yyyy-MM-dd HH:mm:ss
    • └ sku_id
    • Number
    • 123
    • sku的id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    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());

    响应示例

    • XML示例
    • JSON示例
    <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>

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案
    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,” 字样(引号内),如果这样做,系统将认为用户确认了警告的内容并要求进行更新。

    API工具

    如何获得此API

    FAQ

    返回
    顶部