淘宝开放平台

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

淘宝商品API

tmall.item.schema.add (天猫根据规则发布商品)

天猫TopSchema发布商品。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
category_id Number 必须 1512 商品发布的目标类目，必须是叶子类目
product_id Number 必须 1234 发布商品的productId，如果tmall.product.match.schema.get获取到得字段为空，这个参数传入0，否则需要通过tmall.product.schema.match查询到得可用productId
xml_data String 必须 <rules><field id="prop_20000" isInput="true">Apple</field></rules> 根据tmall.item.add.schema.get生成的商品发布规则入参数据

响应参数

名称 类型 示例值 描述
add_item_result String 12345 返回商品发布结果
gmt_create Date 2015-11-11 00:00:00 发布商品操作成功时间

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemSchemaAddRequest req = new TmallItemSchemaAddRequest();
req.setCategoryId(1512L);
req.setProductId(1234L);
req.setXmlData("<rules><field id=\"prop_20000\" isInput=\"true\">Apple</field></rules>");
TmallItemSchemaAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
<tmall_item_schema_add_response>
    <add_item_result>12345</add_item_result>
    <gmt_create>2015-11-11 00:00:00</gmt_create>
</tmall_item_schema_add_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.item-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU 已发布过同类宝贝，不允许重复发布；已发布的商品ID列表为： 取消发布该类目和属性的商品
isv.invalid-parameter:title 属性title格式不正确 请检查title属性，修改后再提交
isv.parameter-parase-error:xml_data schema格式不正确 schema格式不正确，请修改为正确的xml格式
isv.invalid-parameter:desc 请检查desc属性，修改后再提交 请检查desc属性，修改后再提交
isv.invalid-parameter:wireless_desc;isv.invalid-parameter:wireless_desc 属性wireless_desc格式不正确 请检查wireless_desc属性，修改后再提交
isv.invalid-parameter:desc;isv.invalid-parameter:wireless_desc;isv.invalid-parameter:wireless_desc 属性wireless_desc格式不正确 请检查wireless_desc属性，修改后再提交
isv.item-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR 您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额 您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额:${tmallquality_limited}，请您及时调整您的商品数量，再上传商品，详见：https://service.tmall.com/support/tmall/knowledge-13115881.htm
isv.invalid-parameter:wireless_desc 属性wireless_desc格式不正确 请检查wireless_desc属性，修改后再提交
isv.invalid-parameter:category-not-found 当前待发布宝贝类目信息不存在 请检查类目信息参数，修改后再提交
isv.item-service-error:ERR_RULE_BASIC_DATA_CHECK_DESC_LENGTH 商品的描述不能超出200000个字符 商品的描述不能超出200000个字符
isp.service-unavailable 服务应用，请稍后重试 服务应用，请稍后重试
isv.item-service-error:IC_ITEM_TITLE_IS_TOO_LONG 商品标题太长 商品标题太长，请不要超过50个字符
isv.item-service-error:IC_CHECKSTEP_ALREADY_EXISTS_SAME_SPU;isv.item-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR 您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额 您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额:${tmallquality_limited}，请您及时调整您的商品数量，再上传商品，详见：https://service.tmall.com/support/tmall/knowledge-13115881.htm
invalid-parameter:product_id 入参product_id格式不正确 请检查入参product_id，必须为正确的产品ID
isv.invalid-parameter:description 入参description格式不正确 请检查参数description，修改后再提交
isv.invalid-parameter:category-frozen 类目已冻结，无法发布商品 类目已冻结，无法发布商品
isv.item-service-error:title-specail-char 标题中含特殊字符 标题中含特殊字符，请修改后提交
isv.missing-parameter:prop_122216545 必填属性未填写 请检查schema属性参数，确保所有必需属性已填写
isv.invalid-parameter:cid;isp.tmallitem-service-error:empty 服务异常，请稍后重试 服务异常，请稍后重试
isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty 服务异常，请稍后重试 服务异常，请稍后重试
isp.tmallitem-service-error:empty 服务异常，请稍后重试 服务异常，请稍后重试
isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty 服务异常，请稍后重试 服务异常，请稍后重试
isv.invalid-parameter:sku sku属性格式不正确 请检查sku属性格式，修改后再提交
isv.invalid-parameter:white_bg_image 参数不正确，请检查参数是否填写正确 参数不正确，请检查参数是否填写正确
isv.invalid-parameter:item_images;isv.invalid-parameter:item_wireless_images 参数不正确，请检查参数是否填写正确 参数不正确，请检查参数是否填写正确
isv.parameter-parse-error:xml_data 参数不正确，请检查参数是否填写正确 参数不正确，请检查参数是否填写正确
isv.invalid-parameter:food_security.prd_license_no 参数不正确，请检查参数是否填写正确 参数不正确，请检查参数是否填写正确
isv.invalid-parameter:is_xinpin 参数不正确，请检查参数是否填写正确 参数不正确，请检查参数是否填写正确
SYS_REQUEST_TOO_FAST 请求太快，请降低调用频率 请求太快，请降低调用频率
isv.invalid-parameter:item_images 商品图片只支持 png/jpg/jpeg/ss2 格式! 请修改以下图片：白线.檀香木后排长条1张（100%纯.自然香） 商品图片只支持 png/jpg/jpeg/ss2 格式! 请修改以下图片：白线.檀香木后排长条1张（100%纯.自然香）
isv.invalid-parameter:item_attach_images 资质图片必填，请填写 资质图片必填，请填写
isv.missing-parameter:food_security.prd_license_no 生产许可证编号为必填项，不能为空 生产许可证编号为必填项，不能为空
invalid-parameter:sku_properties “适用年龄”为必填项，不能为空;该类目下，颜色分类+尺码请全选或全不选，不能只设置一部分 “适用年龄”为必填项，不能为空;该类目下，颜色分类+尺码请全选或全不选，不能只设置一部分
isv.missing-parameter:white_bg_image 透明素材图为必填项，不能为空 透明素材图为必填项，不能为空
isv.invalid-parameter:price 价格必须在SKU的价格区间内[22.44 ~ 81.84]，请修改 价格必须在SKU的价格区间内[22.44 ~ 81.84]，请修改

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部