文档中心 > API类目 > 淘宝商品API

alibaba.item.edit.fastupdate (商品编辑增量更新)

商品编辑增量更新;
该接口编辑sku,只能更新价格、库存等信息,不能新增sku;
新增sku用全量接口alibaba.item.edit.submit,先设置销售属性;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 610191026823 商品ID
cat_id Number 可选 50021288 商品类目ID。若不需要修改商品类目,则不用填写
spu_id Number 可选 32323 产品ID,若不需要修改关联的产品信息,则不需要填写
schema String 必须 <?xml version="1.0" encoding="utf-8"?> <itemRule> <field id="title" name="商品标题" type="input"> <value>这是一个示例商品而已</value> </field> <field id="update_fields" name="更新字段列表" type="multiCheck"> <values> <value>title</value> </values> </field> </itemRule> 编辑后的schema信息(增量更新,只填写需要更新的字段)

响应参数

名称 类型 示例值 描述
update_time String 2020-12-12 00:00:00 商品更新时间
item_id Number 634830531619 商品ID
market String taobao 商品所属市场
additional_data String <itemSchema></itemSchema> 提交接口返回的额外数据,xml结构 例如: 给商家的建议 尺码表OCR回填

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaItemEditFastupdateRequest req = new AlibabaItemEditFastupdateRequest();
req.setItemId(610191026823L);
req.setCatId(50021288L);
req.setSpuId(32323L);
req.setSchema("<?xml version=\"1.0\" encoding=\"utf-8\"?> <itemRule>    <field id=\"title\" name=\"商品标题\" type=\"input\">      <value>这是一个示例商品而已</value>    </field>     <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">      <values>        <value>title</value>      </values>    </field>  </itemRule>");
AlibabaItemEditFastupdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_item_edit_fastupdate_response>
    <update_time>2020-12-12 00:00:00</update_time>
    <item_id>634830531619</item_id>
    <market>taobao</market>
    <additional_data>&lt;itemSchema&gt;&lt;/itemSchema&gt;</additional_data>
</alibaba_item_edit_fastupdate_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-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR
isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT
isv.parameter-parse-error:title
isv.parameter-parse-error:images
isv.missing-parameter:images
isp.system-service-error:IFD_CHECK_BLOCK
isv.parameter-parse-error:quantity
isv.parameter-parse-error:desc
isp.system-service-error:API_CONFIG_NOT_FOUND_ERROR
isp.system-service-error:IC_IC_OPTIMISTIC_LOCKING_CONFLICT
isp.system-service-error:PUB_BIZCHECK_CAT_DATA_NOTEXIST
isp.system-service-error:API_SYSTEM_ERROR
isp.item.edit-error
isp.system-service-error:taobaoFoodProduceDate
isv.item.invalid-itemId
isv.invalid-parameter:wireless_desc
isp.system-service-error:IC_ERR_RULE_TMALL_YANGCHE_FUWU_LIMIT_TAOBAO
isp.system-service-error:PUB_BIZCHECK_PRAMARY_ITEM_DELETE
isv.invalid-parameter:vertical_image
isv.item-service-error:IC_ITEM_TITLE_IS_TOO_LONG
isv.item-service-error:RULE_TMALL_HUAZHUANGPIN118338_TOP_NOT_PERMIT_TO_EDIT
isp.system-service-error:IC_no_writing_check
isp.tmallitem-service-error:empty
isv.missing-parameter:vertical_image
isp.system-service-error:images
isv.invalid-parameter:main_video
isv.invalid-parameter:item_images
isp.system-service-error:IC_F_EXTENDS_11_15_015
isv.parameter-parse-error:partSku
isv.parameter-parse-error:title;isv.parameter-parse-error:quantity
isv.item-service-error:HALO_RULE_FORCE_CAR_MODEL_CATEGORY_LIMIT
isv.invalid-parameter:title
isv.invalid-parameter:description
isp.system-service-error:FB_FOOD_QS_INVALID
API_SCHEMA_XML_PARSE_ERROR
API_SYSTEM_ERROR
isp.system-service-error:SYS_ERROR
isv.item-service-error:IC_QS_NOT_VALID
isv.invalid-parameter:update_fields
isp.system-service-error:IC_IC_CHECKSTEP_NO_PERMISSION
isp.system-service-error:main_video
isv.parameter-parse-error:price
isp.system-service-error:IC_IC_CHECKSTEP_BEYOND_HIGHT_PRICE_LIMIT
isv.parameter-parse-error:recommendReason
isv.invalid-parameter:seller_cids
isv.item-service-error:EROOR_NEW_SECKILL_2
isv.item-service-error:F_EXTENDS_11_15_015
isp.system-service-error:CHK_TITLE_PRE_SALE_LIMIT_ERROR
isp.system-service-error:IC_IC_CHECKSTEP_BEYOND_LOW_PRICE_LIMIT
isp.system-service-error:PUB_BIZCHECK_CAT_ID_NOTEXIST
isp.system-service-error:IC_IC_CHECKSTEP_INPUT_PROPERTY_ERROR
isv.item-service-error:ERR_RULE_TMALL_YANGCHE_FUWU_LIMIT
isv.parameter-parse-error:video
isp.call-limited
isp.system-service-error:IC_IC_CHECKSTEP_ITME_NOT_IN_SKU_PRICE
isv.invalid-parameter:item_wireless_images
isv.invalid-parameter:white_bg_image
isv.parameter-parse-error:quantity;isv.missing-parameter:images
isp.system-service-error:IC_ERROR_IC_RULE_CHEMICAL_TOP_LIMIT
PUB_MARKET_NOT_SUPPORT
isp.system-service-error:UER_MARGIN_NOT_ALLOW
isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty
PUB_BIZCHECK_USER_MARKET_NOT_SUPPORT
isp.system-service-error:IC_IC_LIMIT_FOR_DPC++
isv.invalid-parameter:item_images;isv.invalid-parameter:item_wireless_images
isv.item-service-error:SYSTEM_ERROR
isv.parameter-parse-error:sku
isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images
isp.remote-service-error:
isp.system-service-error:THD_IC_ERROR_MSG
isv.missing-parameter:three_to_four_item_images
isv.missing-parameter:description
isp.system-service-error:CHK_BIDDING_STATUS_LIMIT;isp.system-service-error:CHK_AUCTION_LIMIT_CATEGORY_ERROR
isv.missing-parameter:quantity
isv.item-service-error:IC_CHECKSTEP_MUST_HAVE_INVOICE
isp.system-service-error:IC_IC_SHIPIN_SELLER_NOT_BEIAN_4
isv.invalid-parameter:sell_points
isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images
isv.missing-parameter:p-20000
isp.system-service-error:FB_FACTORY_MIX_REQUIRED_ERROR
isv.parameter-parse-error:images;isv.parameter-parse-error:images;isv.parameter-parse-error:images
isv.invalid-parameter:three_to_four_item_images
isp.system-service-error:IC_SYSTEM_ERROR
isp.system-service-error:CHK_AUCTION_LIMIT_CATEGORY_ERROR
isv.item-service-error:post-template-error
isv.item-service-error:ERR_RULE_2018_1111_TMALL_UXIAN_11
isp.system-service-error:IC_IC_CHECKSTEP_NO_LOGIN_PERMISSION
isv.invalid-parameter:postage_id_increment
isv.parameter-parse-error:images;isv.parameter-parse-error:images
isp.system-service-error:IC_ERR_RULE_1688_FENGXIAO_SKU_FEATURE_LIMIT
isv.parameter-parse-error:tbDeliveryTime
isp.system-service-error:MAIN_INDUSTRY_CATEGORY_OUT_OF_RANGE
isp.system-service-error:CHK_BIDDING_STATUS_LIMIT
isv.parameter-parse-error:title;isv.missing-parameter:images
isv.missing-parameter:p-122276315
isv.parameter-parse-error:sku;isv.parameter-parse-error:sku
isv.parameter-parse-error:sku;isv.parameter-parse-error:sku;isv.parameter-parse-error:sku;isv.parameter-parse-error:sku;isv.parameter-parse-error:sku
isv.item-service-error:price-in-sku-price
PUB_BIZCHECK_USER_DATA_NOTEXIST
isp.system-service-error:IC_ERR_RULE_1688_FENGXIAO_SKU_INVENTORY_LIMIT
isp.system-service-error:IC_ERROR_PUBLISH_PERMISSION_INVALID_FOR_FRANCHISE
isv.missing-parameter:title
isv.item-service-error:ERROR_RULE_TAOBAO_LIMIT_MODIFY_202114
isv.invalid-parameter:short_title
isp.system-service-error:IC_IC_USER_MUST_AUTH
isv.item-service-error:item-not-found
isp.system-service-error:AUDITING_ITEM_NOT_ALLOWED_UPSHELF_AND_EDIT
isp.system-service-error:IC_ERR_RULE_TITLE_SECURITY_CHAR_LIMITATION
isp.system-service-error:FB_FACTORY_ADDITIVE_REQUIRED_ERROR
isv.parameter-parse-error:API_FIELD_VALUE_PARSER_ERROR
isp.system-service-error:IC_EROOR_NEW_SECKILL_2
isp.system-service-error:IC_IC_CHECKSTEP_USER_FROZEN
isp.system-service-error:postage_id_increment
isv.item-service-error:ERR_RULE_PRICE_COUPON_TOP_PUBLISH_LOCK
isv.parameter-parse-error:marketPrice
isp.system-service-error:FB_FACTORY_RPODUCT_DATE_REQUIRED_ERROR
isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty
isv.missing-parameter:sku;isv.missing-parameter:sku
isp.system-service-error:IC_ERR_RULE_1688_FENGXIAO_PRICE_RANGE_LIMIT
isp.system-service-error:IC_HSF_TIME_OUT_EXCEPTION
isv.publish-limit:permission-limit
isv.parameter-parse-error:barcode
isp.system-service-error:imageVideo
isv.missing-parameter:sku
isp.system-service-error:IC_IC_PERMISSION_FOR_TB_SHUANGSHIER_TITLE
isp.system-service-error:foodProduceDate

API工具

如何获得此API

FAQ

返回
顶部