文档中心 > API类目 > 天猫新品平台API

tmall.brand.item.upload (天猫品牌新品同步API)

支撑天猫品牌将各渠道新品信息同步至平台

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_list TmallBrandChannelNewItem [] 必须
  • 最大列表长度:1000
  • 需要同步的商品列表
    • └ channel_quantity
    • Number
    • 可选
    • 10000
    • 商品sku在渠道的库存
    • └ channel_item_id
    • Number
    • 可选
    • 1001
    • 渠道商品id
    • └ brand_name
    • String
    • 必须
    • 天猫品牌名称
    • 天猫品牌名称
    • └ channel
    • String
    • 必须
    • OFFICIAL_WEBSITE
    • 发售渠道名称
    • └ channel_sku_id
    • Number
    • 可选
    • 11001
    • 渠道商品skuId
    • └ channel_publish_time
    • Date
    • 必须
    • 2020-10-20 00:00:00
    • 在渠道的发售时间
    • └ tmall_same
    • Boolean
    • 必须
    • true
    • 是否天猫同款
    • └ item_id
    • Number
    • 必须
    • 1000001
    • 天猫商品id
    • └ item_name
    • String
    • 必须
    • 天猫商品名称
    • 天猫商品名称
    • └ channel_item_name
    • String
    • 可选
    • 渠道商品名称
    • 渠道商品名称
    • └ channel_item_picts
    • String []
    • 可选
    • http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png,http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png,http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png
    • 商品sku在渠道的图片
    • └ channel_properties
    • String
    • 可选
    • 颜色:红色;材质:棉麻
    • 商品sku在渠道对应的属性对,格式为k1:v1;k2:v2
    • └ brand_id
    • Number
    • 必须
    • 888888
    • 天猫品牌id
    • └ channel_item_price
    • String
    • 可选
    • 89.3
    • 商品sku在渠道的发售价格
    • └ barcode
    • String
    • 可选
    • ABC-abc-1234
    • barcode码
    • └ sku_id
    • Number
    • 可选
    • 1100001
    • 天猫商品skuId
    • └ channel_publish_area
    • String
    • 必须
    • ALL
    • 渠道的发售区域

    响应参数

    名称 类型 示例值 描述
    resp_success Boolean false 是否成功
    resp_error_code Number 1002 请求参数错误
    value String 渠道新品信息同步任务完成 返回结果
    error_msg String 渠道新品信息同步异常 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallBrandItemUploadRequest req = new TmallBrandItemUploadRequest();
    List<TmallBrandItemUploadRequest.TmallBrandChannelNewItem> list2 = new ArrayList<TmallBrandItemUploadRequest.TmallBrandChannelNewItem>();
    TmallBrandItemUploadRequest.TmallBrandChannelNewItem obj3 = new TmallBrandItemUploadRequest.TmallBrandChannelNewItem();
    list2.add(obj3);
    obj3.setChannelQuantity(10000L);
    obj3.setChannelItemId(1001L);
    obj3.setBrandName("天猫品牌名称");
    obj3.setChannel("OFFICIAL_WEBSITE");
    obj3.setChannelSkuId(11001L);
    obj3.setChannelPublishTime(StringUtils.parseDateTime("2020-10-20 00:00:00"));
    obj3.setTmallSame(true);
    obj3.setItemId(1000001L);
    obj3.setItemName("天猫商品名称");
    obj3.setChannelItemName("渠道商品名称");
    obj3.setChannelItemPicts("http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png,http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png,http://img.alicdn.com/tfs/TB1MaLKRXXXXXaWXFXXXXXXXXXX-480-260.png");
    obj3.setChannelProperties("颜色:红色;材质:棉麻");
    obj3.setBrandId(888888L);
    obj3.setChannelItemPrice("89.3");
    obj3.setBarcode("ABC-abc-1234");
    obj3.setSkuId(1100001L);
    obj3.setChannelPublishArea("ALL");
    req.setItemList(list2);
    TmallBrandItemUploadResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_brand_item_upload_response>
        <resp_success>false</resp_success>
        <resp_error_code>1002</resp_error_code>
        <value>渠道新品信息同步任务完成</value>
        <error_msg>渠道新品信息同步异常</error_msg>
    </tmall_brand_item_upload_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部