tmall.product.spec.add (添加产品规格)

增加产品规格

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 必须 95674528 产品ID
certified_pic_str String 可选 1:i4/T14sKVXkxnXXc07YsZ_031440.jpg;2:i4/T14sKVXkxnXXc07YsZ_079540.jpg 存放产品规格认证类型-认证图片url映射信息,格式为k:v;k:v;,其中key为认证类型数字id,value为调用tmall.product.spec.pic.upload返回的认证图片url文本
label_price Number 可选 1213
  • 最小值:0
  • 最大值:999999999
  • 产品规格吊牌价,以分为单位,无默认值,上限999999999
    certified_txt_str String 可选 3:123445;6:000000; 存放产品规格认证类型-认证文本映射信息,格式为k:v;k:v;,其中key为认证类型数字id,value为认证文本值
    spec_props String 可选 pid:vid;pid:vid 产品的规格属性
    spec_props_alias String 可选 pid:vid:valueAlia;pid:vid:valueAlia;
  • 最大长度:60
  • 规格属性别名,只允许传颜色别名
    customer_spec_props String 可选 7810096:30ml; 用户自定义销售属性,结构:pid1:value1;pid2:value2。在
    change_prop String 可选 162707:28335:28335,28338 产品基础色,数据格式为:pid:vid:rvid1,rvid2,rvid3;pid:vid:rvid1
    image byte[] 可选 我是被上传的文件内容 产品图片,与产品图片链接必填其中之一
    支持的文件类型:
    image_url String 可选 我是图片url 产品图片url,与产品图片必填其中之一
    barcode String 可选 6922868281053 产品二维码
    product_code String 可选 YFJRU-786234 产品货号
    market_time Date 可选 2000-01-01 00:00:00 产品上市时间

    响应参数

    名称 类型 示例值 描述
    product_spec ProductSpec 产品规格对象
    • └ spec_id
    • Number
    • 1000000000866721
    • 产品规格ID。

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallProductSpecAddRequest req = new TmallProductSpecAddRequest();
    req.setProductId(95674528L);
    req.setCertifiedPicStr("1:i4/T14sKVXkxnXXc07YsZ_031440.jpg;2:i4/T14sKVXkxnXXc07YsZ_079540.jpg");
    req.setLabelPrice(1213L);
    req.setCertifiedTxtStr("3:123445;6:000000;");
    req.setSpecProps("pid:vid;pid:vid");
    req.setSpecPropsAlias("pid:vid:valueAlia;pid:vid:valueAlia;");
    req.setCustomerSpecProps("7810096:30ml;");
    req.setChangeProp("162707:28335:28335,28338");
    req.setImage(new FileItem("/tmp/file.txt"));
    req.setImageUrl("我是图片url");
    req.setBarcode("6922868281053");
    req.setProductCode("YFJRU-786234");
    req.setMarketTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    TmallProductSpecAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_product_spec_add_response>
        <product_spec>
            <spec_id>1000000000866721</spec_id>
        </product_spec>
    </tmall_product_spec_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.only-support-tmall-seller 本接口只支持天猫商家 登陆天猫商家账号调用该接口
    isv.spect-not-saleproperty-publish-bypage 沒有销售属性的产品规格只能在页面中发布 登陆天猫www.tmall.com进行发布
    isp.service-unavailable 系统存在异常 稍后重试
    isv.product-service-error 产品信息有误 核对产品信息后发布正确的产品ID
    isv.user-not-grant:category 没有该产品对应的类目授权 申请该类目的授权后重新发布
    isv.user-not-grant:brand 没有该产品对应的品牌授权 申请产品对应的品牌的授权后重新发布
    isv.invalid-parameter:spec-barcode 产品规格条形码不能为空 输入正确的条形码
    isv.invalid-parameter:spec-props 产品规格销售属性组合字符串不正确 输入正确格式的产品规格销售属性组合字符串
    isv.invalid-parameter:spec-props-existed 已有商家申请该产品规格 该产品规格已经存在,可发布该规格的商品。
    isv.invalid-parameter:spec-props-alias 销售属性别名输入格式不正确 输入正确格式的销售属性别名
    isv.invalid-parameter:spec-image 产品规格图片格式错误 上传jpg或gif格式的图片,大小不超过500k
    isp.product-image-upload-service-unavailable 上传产品规格图片失败 请稍后重试
    isv.invalid-parameter:spec-certified-pic 产品规格资质认证图片格式或大小不正确 上传正确的产品规格资质认证图片
    isv.invalid-parameter:product-id 产品id格式不正确 输入正确格式的产品i
    isv.only-support-tmall-seller 本接口只支持天猫商家 登陆天猫商家账号调用该接口
    isv.spect-not-saleproperty-publish-bypage 沒有销售属性的产品规格只能在页面中发布 登陆天猫www.tmall.com进行发布
    isp.service-unavailable 系统存在异常 稍后重试
    isv.product-service-error 产品信息有误 核对产品信息后发布正确的产品ID
    isv.user-not-grant:category 没有该产品对应的类目授权 申请该类目的授权后重新发布
    isv.user-not-grant:brand 没有该产品对应的品牌授权 申请产品对应的品牌的授权后重新发布
    isv.invalid-parameter:spec-barcode 产品规格条形码不能为空 输入正确的条形码
    isv.invalid-parameter:spec-props 产品规格销售属性组合字符串不正确 输入正确格式的产品规格销售属性组合字符串
    isv.invalid-parameter:spec-props-existed 已有商家申请该产品规格 该产品规格已经存在,可发布该规格的商品。
    isv.invalid-parameter:spec-props-alias 销售属性别名输入格式不正确 输入正确格式的销售属性别名
    isv.invalid-parameter:spec-image 产品规格图片格式错误 上传jpg或gif格式的图片,大小不超过500k
    isp.product-image-upload-service-unavailable 上传产品规格图片失败 请稍后重试
    isv.invalid-parameter:spec-certified-pic 产品规格资质认证图片格式或大小不正确 上传正确的产品规格资质认证图片
    isv.invalid-parameter:product-id 产品id格式不正确 输入正确格式的产品i

    API工具

    如何获得此API

    FAQ

    返回
    顶部