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

taobao.item.sku.delete (删除SKU)

删除一个sku的数据 需要删除的sku通过属性properties进行匹配查找

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
num_iid Number 必须 1489161932 Sku所属商品数字id,可通过 taobao.item.get 获取。必选
properties String 必须 1627207:28341 Sku属性串。格式:pid:vid;pid:vid,如: 1627207:3232483;1630696:3284570,表示机身颜色:军绿色;手机套餐:一电一充
lang String 可选 zh_HK
  • 默认值:zh_CN
  • Sku文字的版本。可选值:zh_HK(繁体),zh_CN(简体);默认值:zh_CN
    item_price Price 可选 10.05 sku所属商品的价格。当用户删除sku,使商品价格不属于sku价格之间的时候,用于修改商品的价格,使sku能够删除成功
    item_num Number 可选 12 sku所属商品的数量,大于0的整数。当用户删除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
    • └ modified
    • String
    • 2009-11-04 15:24:43
    • sku最后修改日期 时间格式:yyyy-MM-dd HH:mm:ss

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemSkuDeleteRequest req = new ItemSkuDeleteRequest();
    req.setNumIid(1489161932L);
    req.setProperties("1627207:28341");
    req.setLang("zh_HK");
    req.setItemPrice("10.05");
    req.setItemNum(12L);
    req.setIgnorewarning(",ifd_warning,FakeCredit_Warning,");
    ItemSkuDeleteResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <item_sku_delete_response>
        <sku>
            <iid>asdf12323adfaa</iid>
            <num_iid>12345</num_iid>
            <modified>2009-11-04 15:24:43</modified>
        </sku>
    </item_sku_delete_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_SKU_MUST_IN_SPU_RANGE 商品所选择销售属性超出产品许可范围,请联系小二确认
    isv.item-update-service-error:ITEM_INPUT_PROPERTIES_ERROR 输入属性错误
    isv.item-update-service-error:ITEM_PROPERTIES_ERROR ${lostPropText}属性出错
    isv.item-update-service-error:IC_CHECKSTEP_SKU_PROP_NOT_FOUND_IN_ITEM 宝贝销售属性出错(销售属性和商品属性不一致),请重新编辑
    isv.item-update-service-error:IC_CHECKSTEP_SKU_DUPLICATE 宝贝销售属性出错(重复),请重新编辑
    isv.item-update-service-error:IC_BRAND_NOT_GRANT_FOR_B 未授权发布此品牌的商品
    isv.item-update-service-error:IC_CHECKSTEP_ITME_SKU_PRICE_UNMATCH 宝贝价格必须介于销售属性组合价格区间之内
    isv.item-update-service-error:GENERIC_FAILURE 系统错误,请稍后再试
    isv.item-update-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY 宝贝描述不能为空
    isv.item-update-service-error:QUANTITY_ITEM_CAT_TOO_LARGE 您出售中的“${mainCategoryName}”类目下宝贝总数已超过此类目宝贝数量限额(卖家评分:${onlineLimitBeginRate}-${onlineLimitEndRate},允许宝贝个数:${onlineLimitMax}),请您及时调整您的宝贝数量,再上传宝贝
    isv.item-update-service-error:IC_CATEGORY_NOT_GRANT_FOR_B 未授权发布此类目的商品
    isv.invalid-parameter:sku-properties 您所传入的属性找不到对应的sku记录 确认传入的是正确的SKU属性串:pid:vid;pid:vid,可在删除之前通过taobao.item.get获取相应的SKU属性串
    错误码:40,子错误码:null 缺少必要的传入参数 请根据返回的错误信息,将必传参数都填写好
    isv.item-get-service-error:ITEM_NOT_FOUND 没有找到宝贝 1. 确认num_iid是否正确,请通过taobao.items.get/taobao.items.search等查询接口获取正确的宝贝num_iid,再通过taobao.item.get接口查询宝贝详情; 2. 如果num_iid无误,则对应的宝贝可能已违规或进入历史库,在本地增加逻辑:发现报商品不存在的错误(ITEM_NOT_FOUND)就将本地的商品记录删除掉,防止卖家或者系统自动重试再次发生这个问题。3. 这个是业务不可避免的错误。当商品被删除一定时间、或者商品长达3个月都没有被编辑过以后,商品会被移到历史库中再也找不到。解决该问题,可以使用增量api监控商品被删除的消息,及时把发生这个错误的商品从本地数据库中删除掉,随时保持数据的同步性。发生这个错误时不要重试。
    isv.item-is-delete:invalid-numIid-or-iid 该商品已被删除 通过增量接口taobao.increment.items.get获取被删除的商品,在本地数据库更新,出现此错误不要重试
    isv.item-update-service-error:ERROR_SHOP_CATEGORY_HAS_SUB_CATEGORIES 自定义店铺分类不存在或者店铺分类错误 更新自定义店铺类目的时候要先搜一下店铺该类目下是否有商品,如果有商品,要同时更新商品的seller_cids,但如果是用户在淘宝后台更改自定义类目,则出现错误后不要重试,然后用户到淘宝后台修改
    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_NO_PERMISSION 您未通过认证或已被处罚,请核实 发生该错误时不要重试,将这个用户做上标记后让用户检查自己的权限问题,等用户处理好了再让用户来手动取消禁止标记。否则就不允许用户发布或者编辑商品
    isv.item-update-service-error:IC_CHECKSTEP_SPU_NOT_EXIST 您发布的商品无对应产品 请登录“淘宝网”先行发布产品
    isv.error-trigger-fake-credit 触发了防炒信规则警告 在 ignorewarning 字段中包含 “,FakeCredit_Warning,” 字样(引号内),如果这样做,系统将认为用户确认了警告的内容并要求进行更新。
    isv.item-update-service-error:IC_CHECKSTEP_PRICE_ERROR 不符合类目价格限制,此类目下最高价格为${CATEGORY_PRICE_LIMITED_HIGHT},最低价格为${CATEGORY_PRICE_LIMITED_LOW} 不符合类目价格限制,此类目下最高价格为${CATEGORY_PRICE_LIMITED_HIGHT},最低价格为${CATEGORY_PRICE_LIMITED_LOW}
    isv.item-update-service-error:IC_LIMIT_FOR_DPC 供应商限制该分销商品修改:${detailLimits}如有疑问请咨询供应商的分销销售控制 供应商限制该分销商品修改:${detailLimits}如有疑问请咨询供应商的分销销售控制
    isv.item-update-service-error:IC_STUFF_STATUS_NEW_LIMITED_WITH_NOSHOP 发布、编辑和上架全新宝贝必须是店铺卖家 发布、编辑和上架全新宝贝必须是店铺卖家
    isv.item-update-service-error:IC_CATEGORY_FREEZE 因类目调整当前类目已被淘宝网关闭,请您将商品发布在其他相应类目下 因类目调整当前类目已被淘宝网关闭,请您将商品发布在其他相应类目下

    API工具

    如何获得此API

    FAQ

    返回
    顶部