淘宝开放平台

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

淘宝商品API

alibaba.item.edit.submit (商品编辑提交schema信息)

商品编辑提交schema信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 610191026823 商品ID
biz_type String 可选 taobao/1.0.0/brandAsyncRenderEnable 业务扩展参数，需与平台约定好
cat_id Number 可选 50021288 商品类目ID。若不需要修改商品类目，则不用填写
spu_id Number 可选 32323 产品ID，若不需要修改关联的产品信息，则不需要填写
schema String 必须 <itemSchema> <field id="title" name="宝贝标题" type="input"> <rules> <rule name="tipRule" value="标题和描述关键词是否违规自检工具：&lt;a href='//ss.taobao.com/compliance#/main' target='_blank'&gt;商品合规工具&lt;/a&gt;"/> <rule name="requiredRule" value="true"/> <rule exProperty="include" name="maxLengthRule" unit="byte" value="60"/> <rule name="tipRule" value="最多允许输入30个汉字（60字符）"/> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="supplierInfo" name="供应商信息" type="input"> <rules> <rule name="requiredRule" value="true"/> <rule exProperty="include" name="maxLengthRule" unit="byte" value="40"/> <rule name="valueTypeRule" value="text"/> </rules> </field> <field id="outerId" name="商家编码" type="input"> <rules> <rule exProperty="include" name="maxLengthRule" unit="byte" value="64"/> <rule name="valueTypeRule" value="text"/> </rules> </field> </itemSchema> 编辑后的schema信息，通过alibaba.item.edit.schema.get获取
market String 可选 taobao,tmall,litetao 商品市场，正常不用填写
spu_ids Number 可选 32323 产品ID集合，等同于产品ID

响应参数

名称 类型 示例值 描述
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
1
2
3
4
5
6
7
8
9
10
11
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaItemEditSubmitRequest req = new AlibabaItemEditSubmitRequest();
req.setItemId(610191026823L);
req.setBizType("taobao/1.0.0/brandAsyncRenderEnable");
req.setCatId(50021288L);
req.setSpuId(32323L);
req.setSchema("<itemSchema> <field id=\"title\" name=\"宝贝标题\" type=\"input\"> <rules> <rule name=\"tipRule\" value=\"标题和描述关键词是否违规自检工具：&lt;a href='//ss.taobao.com/compliance#/main' target='_blank'&gt;商品合规工具&lt;/a&gt;\"/> <rule name=\"requiredRule\" value=\"true\"/> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"60\"/> <rule name=\"tipRule\" value=\"最多允许输入30个汉字（60字符）\"/> <rule name=\"valueTypeRule\" value=\"text\"/> </rules> </field> <field id=\"supplierInfo\" name=\"供应商信息\" type=\"input\"> <rules> <rule name=\"requiredRule\" value=\"true\"/> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"40\"/> <rule name=\"valueTypeRule\" value=\"text\"/> </rules> </field> <field id=\"outerId\" name=\"商家编码\" type=\"input\"> <rules> <rule exProperty=\"include\" name=\"maxLengthRule\" unit=\"byte\" value=\"64\"/> <rule name=\"valueTypeRule\" value=\"text\"/> </rules> </field> </itemSchema>");
req.setMarket("taobao,tmall,litetao");
req.setSpuIds(32323L);
AlibabaItemEditSubmitResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<alibaba_item_edit_submit_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_submit_response>

异常示例

  • XML示例
  • JSON示例
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.parameter-parse-error:darwin_sku 您发布商品的SKU必须填写合法的产品规格 您发布商品的SKU必须填写合法的产品规格
isv.invalid-parameter:sku-quantity sku数量必须大于等于0 sku数量必须大于等于0
isv.error-spu-tmall-disabled 产品不存在 产品不存在
isv.error-sku-no-have-spec-id 请选择产品规则后才能发布 请选择产品规则后才能发布
isp.system-service-error:CHK_SHENBI_ITEM_NOT_ALLOW_TOP
isv.item-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR
isv.invalid-parameter:diaopai_pic
isp.system-service-error:IFD_CHECK_BLOCK
isv.parameter-parse-error:images
isp.system-service-error:IC_IC_STUFF_STATUS_NEW_LIMITED_WITH_NOSHOP
isp.system-service-error:IC_ITEM_PROPERTIES_ERROR
isv.missing-parameter:size_mapping
isp.system-service-error:IC_IC_SPU_DISCOUNT_PRICE_LIMIT
isp.system-service-error:IC_IC_OPTIMISTIC_LOCKING_CONFLICT
isv.item-service-error:props-error
isv.invalid-parameter:item_wireless_images
isv.parameter-parse-error:CHK_DELIVERY_POSTAGE_ID_NOT_EXIST
isv.parameter-parse-error:quantity
isv.invalid-parameter:darwin_sku
isv.missing-parameter:food_security.mix;isv.missing-parameter:food_security.food_additive
isv.parameter-parse-error:sku
isv.invalid-parameter:sku
invalid-parameter:product_id
isv.parameter-parse-error:title
isp.system-service-error:CHK_SC_ITEM_NOT_ALLOW_TOP
isv.invalid-parameter:food_security.prd_license_no
isp.system-service-error:IC_QUANTITY_ITEM_CAT_TOO_LARGE
isv.missing-parameter:sku
isp.system-service-error:FAKE_CREDIT_WARNING
isv.invalid-parameter:wireless_desc
isv.invalid-parameter:item_images;isv.invalid-parameter:white_bg_image;isv.missing-parameter:delivery_way
isv.item.invalid-itemId
isp.system-service-error:PUB_BIZCHECK_PRAMARY_ITEM_DELETE
isv.invalid-parameter:empty
isp.item.edit-error
isv.item-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU
isv.missing-parameter:size_measure_image
isp.tmallitem-service-error:empty
isv.invalid-parameter:item_images
isv.invalid-parameter:price
isv.parameter-parse-error:deliverVolumn
isv.parameter-parse-error:desc
isv.parameter-parse-error:p-24477
isv.invalid-parameter:prop_1627207
invalid-parameter:sku_properties
isp.system-service-error:IC_IC_CHECKSTEP_NO_PERMISSION
isv.invalid-parameter:food_security.prd_license_no;isv.invalid-parameter:food_security.prd_license_no
isv.item-service-error:HALO_RULE_FORCE_CAR_MODEL_CATEGORY_LIMIT
isp.system-service-error:FAKE_CREDIT_WARNING;isp.system-service-error:IFD_CHECK_BLOCK
isv.item-service-error:IC_CHECKSTEP_PROP_VTEXT_NOT_ALLOW_INPUT
isv.invalid-parameter:item_wireless_images;isv.invalid-parameter:description
isv.missing-parameter:sku;isv.missing-parameter:sku;isv.missing-parameter:sku;isv.missing-parameter:sku
isv.missing-parameter:subStock
isv.invalid-parameter:description
isv.missing-parameter:prop_122216345
isv.parameter-parse-error:p-1627207
isp.system-service-error:CHK_NOT_BUYNOW_ITEM_NOT_ALLOW_TOP
isv.missing-parameter:prop_223080219
isp.system-service-error:IC_ERR_RULE_TMALL_YANGCHE_FUWU_LIMIT_TAOBAO
isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT
isv.invalid-parameter:prop_147956252
isv.parameter-parse-error:deliverWeight
isv.missing-parameter:prop_20017
isv.parameter-parse-error:p-2043189
isp.system-service-error:IC_IC_CHECKSTEP_INPUT_PROPERTY_ERROR_1
isp.system-service-error:IC_IC_CHECKSTEP_ITME_NOT_IN_SKU_PRICE
isv.invalid-parameter:item_images;isv.invalid-parameter:item_wireless_images;isv.invalid-parameter:description
isp.system-service-error:FB_INLAND_POSTAGE_INVALID
isv.item-service-error:RULE_TMALL_HUAZHUANGPIN118338_TOP_NOT_PERMIT_TO_EDIT
isv.missing-parameter:p-122216347
isv.missing-parameter:prop_9167449
isv.missing-parameter:p-122216348
isv.invalid-parameter:prop_246261147
isv.parameter-parse-error:title;isv.parameter-parse-error:quantity
isv.invalid-parameter:title
isp.system-service-error:taobaoFoodProduceDate
isp.system-service-error:IC_inventory_edit_version_not_match;isp.system-service-error:IC_F_INVENTORY_05_16_010
isv.missing-parameter:sku;isv.missing-parameter:sku;isv.missing-parameter:sku
isv.invalid-parameter:item_images;isv.invalid-parameter:item_wireless_images
isv.invalid-parameter:prop_1627207;isv.invalid-parameter:prop_1627207
isv.item-service-error:IC_CATEGORY_NOT_GRANT_FOR_B
isv.parameter-parse-error:p-20019
isv.invalid-parameter:item_images;isv.missing-parameter:delivery_way
isv.item-service-error:IC_FOREST_12_16_007
isv.missing-parameter:prop_147956252
isv.invalid-parameter:ccc_certificate_no
isv.missing-parameter:p-20663
isv.missing-parameter:prop_20017;isv.invalid-parameter:darwin_sku
isv.missing-parameter:p-231100582
isv.invalid-parameter:prop_169502691
isv.missing-parameter:p-122216345
isv.missing-parameter:p-20000
isv.item-service-error:IC_BRAND_NOT_GRANT_FOR_B
isv.missing-parameter:p-186856283
isv.invalid-parameter:vertical_image
isv.item-service-error:ERR_RULE_TMALL_YANGCHE_FUWU_LIMIT
isv.invalid-parameter:prop_1627207;isv.missing-parameter:size_mapping
isv.missing-parameter:food_security.mix;isv.missing-parameter:food_security.food_additive;isv.invalid-parameter:food_security.prd_license_no
isp.system-service-error:images
isv.item-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR
isv.missing-parameter:prop_122276212
isv.invalid-parameter:prop_1627207;isv.invalid-parameter:prop_1627207;isv.invalid-parameter:prop_1627207
isv.missing-parameter:prop_6939376
isv.item-service-error:IC_PERMISSION_FOR_TM_GZZSERVICE_UPSHELF
isv.missing-parameter:p-20021
isv.missing-parameter:prop_150834041
isv.parameter-parse-error:p-34272
isp.system-service-error:IC_sellable_quantity_not_enough;isp.system-service-error:IC_F_INVENTORY_05_16_010
isp.remote-service-error:
isv.missing-parameter:p-122216515
isv.parameter-parse-error:p-20017
isv.parameter-parse-error:p-128132720
isv.parameter-parse-error:p-148060595
isv.missing-parameter:prop_140400482
isv.missing-parameter:qualification
isv.missing-parameter:size_measure_image;isv.missing-parameter:size_mapping
isp.system-service-error:IC_inventory_edit_version_not_match;isp.system-service-error:IC_IC_OPTIMISTIC_LOCKING_CONFLICT;isp.system-service-error:IC_F_INVENTORY_05_16_011
isv.missing-parameter:vertical_image;isv.missing-parameter:description;isv.missing-parameter:three_to_four_item_images
isv.missing-parameter:p-240053545
isv.missing-parameter:prop_12060095
isv.parameter-parse-error:title;isv.missing-parameter:p-2043189
isp.system-service-error:IC_sellable_quantity_not_enough;isp.system-service-error:IC_IC_OPTIMISTIC_LOCKING_CONFLICT;isp.system-service-error:IC_F_INVENTORY_05_16_011
isv.missing-parameter:white_bg_image
isv.item-service-error:IC_CHECKSTEP_SKU_DUPLICATE
isv.missing-parameter:p-2043189
isv.missing-parameter:prop_20663;isv.missing-parameter:size_mapping
isv.missing-parameter:p-122276139
isv.missing-parameter:prop_19329649;isv.missing-parameter:prop_7307;isv.missing-parameter:prop_7995
isv.parameter-parse-error:p-20000
isv.invalid-parameter:size_measure_image
isv.invalid-parameter:food_security.product_date_start,food_security.product_date_end
isv.invalid-parameter:sell_points
isv.missing-parameter:prop_20021
API_SYSTEM_ERROR
isv.item-service-error:RULE_TMALLCAMPAIGN_100034437_5_SKU_LOCK
isv.invalid-parameter:prop_148060595
isv.item-service-error:IC_ITEM_TITLE_IS_TOO_LONG
isv.missing-parameter:p-122216620
isp.system-service-error:IC_POST_TEMPLATE_VALUEATION_ERROR
isv.invalid-parameter:prop_186826808
isv.invalid-parameter:prop_151018199
isv.missing-parameter:prop_147956252;isv.invalid-parameter:sku
isv.missing-parameter:p-122276315
isv.missing-parameter:p-129498239
isv.missing-parameter:prop_20663
isv.missing-parameter:p-147956252
isv.parameter-parse-error:p-1989854
isv.item-service-error:IC_PERMISSION_FOR_TM_JIANCAI_UPSHELF_05_ERROR
isv.parameter-parse-error:p-46412378
isv.missing-parameter:prop_13021751
isv.item-service-error:ITEM_PROPERTIES_ERROR
isv.parameter-parse-error:recommendReason
isv.missing-parameter:images
isv.missing-parameter:prop_20608
isp.system-service-error:IC_FORBIDDEN_QUANTITY_ZERO_ERROR
isv.parameter-parse-error:tbDeliveryTime
isv.missing-parameter:prop_2043189;isv.missing-parameter:prop_122216620
isp.system-service-error:FB_FOOD_QS_INVALID
isv.missing-parameter:prop_154362399
isv.invalid-parameter:food_security.factory_site
isv.parameter-parse-error:p-147956252
isv.missing-parameter:p-232561237
isp.system-service-error:org_auth_tri_c_code
isp.system-service-error:IC_IC_CHECKSTEP_NO_LOGIN_PERMISSION
isv.missing-parameter:prop_1626691
isv.parameter-parse-error:p-149422948
isv.missing-parameter:p-20000;isv.missing-parameter:p-12060095
isv.item-service-error:price-in-sku-price
isv.missing-parameter:prop_20663;isv.missing-parameter:prop_122216348;isv.missing-parameter:prop_122216345
invalid-parameter:sku_properties;isv.invalid-parameter:sku
isv.missing-parameter:food_security.mix;isv.missing-parameter:food_security.food_additive;isv.invalid-parameter:food_security.product_date_start,food_security.product_date_end
isv.missing-parameter:p-9167449
isv.missing-parameter:prop_240053545
isp.system-service-error:IC_IC_SHIPIN_SELLER_NOT_BEIAN_4
isv.missing-parameter:p-6939376
isv.missing-parameter:prop_34272
isv.invalid-parameter:white_bg_image
isp.system-service-error:IC_IC_NOT_CONTAIN_SPU_TITLE
isv.missing-parameter:food_security.mix;isv.missing-parameter:food_security.food_additive;isv.invalid-parameter:title
isv.missing-parameter:delivery_way
isv.missing-parameter:prop_20021;isv.missing-parameter:prop_259478959;isv.missing-parameter:prop_260962794;isv.missing-parameter:prop_260972522;isv.missing-parameter:prop_4587847
isv.missing-parameter:p-122216562
isp.system-service-error:IC_IC_CATEGORY_CPV_FREEZE
isv.missing-parameter:description
isv.parameter-parse-error:p-7487204
isv.missing-parameter:p-122276139;isv.missing-parameter:p-20021;isv.missing-parameter:p-20608
isv.missing-parameter:p-20608
isv.missing-parameter:prop_186856283
isv.parameter-parse-error:p-148048600
isv.missing-parameter:size_mapping;isv.invalid-parameter:sku
isv.invalid-parameter:prop_1627207;isv.invalid-parameter:prop_1627207;isv.invalid-parameter:prop_1627207;isv.missing-parameter:size_mapping
isp.system-service-error:FB_FACTORY_NAME_REQUIRED_ERROR
isv.missing-parameter:darwin_sku
isv.parameter-parse-error:p-20549
isv.invalid-parameter:food_security.prd_license_no;isv.invalid-parameter:food_security.factory_site
isv.missing-parameter:prop_192256048;isv.missing-parameter:prop_251346001;isv.missing-parameter:prop_147956252
isv.parameter-parse-error:p-122216936
isv.missing-parameter:p-21299
isv.missing-parameter:p-20663;isv.missing-parameter:p-122216348
isv.missing-parameter:threeToFourImages
isv.missing-parameter:food_security.mix;isv.missing-parameter:food_security.food_additive;isv.missing-parameter:prop_147956252

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部