taobao.fenxiao.distributor.products.get (分销商查询产品信息)

分销商查询供应商产品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
pids Number [] 可选 1001,1002,1003,1004,1005
  • 最大列表长度:30
  • 产品ID列表(最大限制30),用逗号分割,例如:“1001,1002,1003,1004,1005”
    item_ids Number [] 可选 1001,1002,1003,1004,1005
  • 最大列表长度:20
  • 根据商品ID列表查询,优先级次于产品ID列表,高于其他分页查询条件。如果商品不是分销商品,自动过滤。最大限制20,用逗号分割,例如:“1001,1002,1003,1004,1005”
    supplier_nick String 可选 test 供应商nick,分页查询时,必传
    trade_type String 可选 trade_type 分销方式;可选择:AGENT : 代销;DEALER:经销;DIRECT:直营
    download_status String 可选 download_status 下载状态,默认是未下载;可选值:UNDOWNLOAD:未下载 ;DOWNLOADED:已下载;下载:指将供应商授权的产品发布为店铺新宝贝的过程,下载成功后,分销商需要将新生成的宝贝重新编辑并上架后售卖。
    productcat_id Number 可选 3232312 产品线ID
    fields String [] 可选 skus
  • 最大列表长度:20
  • 指定查询额外的信息,可选值:skus(sku数据)、images(多图),多个可选值用逗号分割。
    start_time Date 可选 2000-01-01 00:00:00 开始修改时间
    end_time Date 可选 2000-01-01 00:00:00 结束时间
    time_type String 可选 time_type time_type
    page_no Number 可选 1 页码(大于0的整数,默认1)
    page_size Number 可选 20 每页记录数(默认20,最大50)
    order_by String 可选 order_by order_by

    响应参数

    名称 类型 示例值 描述
    has_next Boolean true 是否存在下一页
    products FenxiaoProduct [] 产品对象记录集。返回 FenxiaoProduct 包含的字段信息。
    • └ pid
    • Number
    • 1255
    • 产品ID
    • └ name
    • String
    • jayzhou
    • 产品名称
    • └ productcat_id
    • Number
    • 444
    • 产品线ID
    • └ standard_price
    • String
    • 5
    • 采购基准价,单位:元。
    • └ standard_retail_price
    • String
    • 10.56
    • 零售基准价,单位:元
    • └ retail_price_low
    • String
    • 10.56
    • 最低零售价,单位:分。
    • └ retail_price_high
    • String
    • 10.56
    • 最高零售价,单位:分。
    • └ cost_price
    • String
    • 5
    • 采购价格,单位:元。
    • └ dealer_cost_price
    • String
    • 20.33
    • 经销采购价
    • └ outer_id
    • String
    • 4444
    • 商家编码
    • └ quantity
    • Number
    • 444
    • 产品库存
    • └ pictures
    • String
    • http://img01.taobaocdn.com/xxx.jpg,http://img01.taobaocdn.com/xxx.jpg
    • 产品图片路径
    • └ desc_path
    • String
    • http://img03.taobaocdn.com/xxx.dpc
    • 产品描述路径,通过http请求获取
    • └ category_id
    • String
    • 12
    • 类目id
    • └ description
    • String
    • 这是产品的描述内容
    • 产品描述的内容
    • └ properties
    • String
    • 1631357:21846512;20000:21918302
    • 产品属性,格式为pid:vid;pid:vid
    • └ property_alias
    • String
    • 1627207:28335:绿荫色
    • 属性别名,格式为pid:vid:alias;pid:vid:alias
    • └ input_properties
    • String
    • 20000:品牌名
    • 自定义属性,格式为pid:value;pid:value
    • └ prov
    • String
    • 浙江
    • 所在地:省
    • └ city
    • String
    • 杭州
    • 所在地:市
    • └ postage_type
    • String
    • 12
    • 运费类型,可选值:seller(供应商承担运费)、buyer(分销商承担运费)
    • └ postage_id
    • Number
    • 5545
    • 运费模板ID
    • └ postage_ordinary
    • String
    • 10.56
    • 平邮费用,单位:元
    • └ postage_fast
    • String
    • 10.56
    • 快递费用,单位:元
    • └ postage_ems
    • String
    • 12.2
    • ems费用,单位:元
    • └ discount_id
    • Number
    • 100001
    • 折扣ID(新增参数)
    • └ query_item_id
    • Number
    • 1001
    • 根据商品ID查询时,返回这个产品对应的商品ID,只对分销商查询接口有效
    • └ have_invoice
    • Boolean
    • true
    • 是否有发票,可选值:false(否)、true(是)
    • └ have_quarantee
    • Boolean
    • true
    • 是否有保修,可选值:false(否)、true(是)
    • └ items_count
    • Number
    • 5
    • 下载人数
    • └ orders_count
    • Number
    • 5
    • 累计采购次数
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 更新时间
    • └ upshelf_time
    • Date
    • 2000-01-01 00:00:00
    • 铺货时间
    • └ status
    • String
    • up
    • 发布状态,可选值:up(上架)、down(下架)
    • └ trade_type
    • String
    • AGENT
    • 分销方式:AGENT(只做代销,默认值)、DEALER(只做经销)、ALL(代销和经销都做)
    • skus
    • SkuList []
    • 1
    • sku列表
    • └ id
    • Number
    • 100001
    • SkuID
    • └ name
    • String
    • 如鞋子的sku:“红色,35”
    • 名称
    • └ standard_price
    • String
    • 20.23
    • 市场价
    • └ cost_price
    • String
    • 1
    • 代销采购价,单位:元
    • └ dealer_cost_price
    • String
    • 123
    • 经销采购价
    • └ quantity
    • Number
    • 1
    • 库存
    • └ outer_id
    • String
    • 1
    • 商家编码
    • └ properties
    • String
    • 1243:1215;5626:5125
    • sku的销售属性组合字符串。格式:pid:vid;pid:vid,如:1627207:3232483;1630696:3284570,表示:机身颜色:军绿色;手机套餐:一电一充。
    • └ scitem_id
    • Number
    • 10001
    • 关联的后端商品id
    • images
    • ProductImageList []
    • 产品图片
    • └ image_id
    • Number
    • 10001
    • 图片id
    • └ image_url
    • String
    • http://img01.taobaocdn.com/xxx.jpg,http://img01.taobaocdn.com/xxx.jpg
    • 图片对应的url
    • └ image_position
    • Number
    • 2
    • 图片顺序
    • └ properties
    • String
    • 1000:23;2000:25
    • 当图片类型为属性图片时,表示图片对应的属性pv对。
    • └ type
    • String
    • PROPERTIES
    • 图片类型(PRODUCT:产品图片 EXTPRODUCT:产品辅图 PROPERTIES:产品属性图片 )
    • pdus
    • PduList []
    • 产品分销商信息
    • └ product_id
    • Number
    • 1001
    • 产品ID
    • └ distributor_id
    • Number
    • 1001
    • 分销商ID
    • └ distributor_name
    • String
    • 分销商1
    • 分销商用户名
    • └ sku_properties
    • String
    • 1627207:90554,1627207:3232484
    • 产品销售属性值
    • └ quantity_agent
    • Number
    • 1
    • 产品代销配额库存
    • └ is_authz
    • String
    • yes
    • 查询产品列表时,查询入参增加is_authz:yes|no yes:需要授权 no:不需要授权
    • └ scitem_id
    • Number
    • 10001
    • 关联的后端商品id
    • └ spu_id
    • Number
    • 100
    • 产品spu id

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FenxiaoDistributorProductsGetRequest req = new FenxiaoDistributorProductsGetRequest();
    req.setPids("1001,1002,1003,1004,1005");
    req.setItemIds("1001,1002,1003,1004,1005");
    req.setSupplierNick("test");
    req.setTradeType("trade_type");
    req.setDownloadStatus("download_status");
    req.setProductcatId(3232312L);
    req.setFields("skus");
    req.setStartTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setTimeType("time_type");
    req.setPageNo(1L);
    req.setPageSize(20L);
    req.setOrderBy("order_by");
    FenxiaoDistributorProductsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <fenxiao_distributor_products_get_response>
        <has_next>true</has_next>
        <products>
            <fenxiao_product>
                <pid>1255</pid>
                <name>jayzhou</name>
                <productcat_id>444</productcat_id>
                <standard_price>5</standard_price>
                <standard_retail_price>10.56</standard_retail_price>
                <retail_price_low>10.56</retail_price_low>
                <retail_price_high>10.56</retail_price_high>
                <cost_price>5</cost_price>
                <dealer_cost_price>20.33</dealer_cost_price>
                <outer_id>4444</outer_id>
                <quantity>444</quantity>
                <pictures>http://img01.taobaocdn.com/xxx.jpg,http://img01.taobaocdn.com/xxx.jpg</pictures>
                <desc_path>http://img03.taobaocdn.com/xxx.dpc</desc_path>
                <category_id>12</category_id>
                <description>这是产品的描述内容</description>
                <properties>1631357:21846512;20000:21918302</properties>
                <property_alias>1627207:28335:绿荫色</property_alias>
                <input_properties>20000:品牌名</input_properties>
                <prov>浙江</prov>
                <city>杭州</city>
                <postage_type>12</postage_type>
                <postage_id>5545</postage_id>
                <postage_ordinary>10.56</postage_ordinary>
                <postage_fast>10.56</postage_fast>
                <postage_ems>12.2</postage_ems>
                <discount_id>100001</discount_id>
                <query_item_id>1001</query_item_id>
                <have_invoice>true</have_invoice>
                <have_quarantee>true</have_quarantee>
                <items_count>5</items_count>
                <orders_count>5</orders_count>
                <created>2000-01-01 00:00:00</created>
                <modified>2000-01-01 00:00:00</modified>
                <upshelf_time>2000-01-01 00:00:00</upshelf_time>
                <status>up</status>
                <trade_type>AGENT</trade_type>
                <skus>
                    <sku_list>
                        <id>100001</id>
                        <name>如鞋子的sku:“红色,35”</name>
                        <standard_price>20.23</standard_price>
                        <cost_price>1</cost_price>
                        <dealer_cost_price>123</dealer_cost_price>
                        <quantity>1</quantity>
                        <outer_id>1</outer_id>
                        <properties>1243:1215;5626:5125</properties>
                        <scitem_id>10001</scitem_id>
                    </sku_list>
                </skus>
                <images>
                    <product_image_list>
                        <image_id>10001</image_id>
                        <image_url>http://img01.taobaocdn.com/xxx.jpg,http://img01.taobaocdn.com/xxx.jpg</image_url>
                        <image_position>2</image_position>
                        <properties>1000:23;2000:25</properties>
                        <type>PROPERTIES</type>
                    </product_image_list>
                </images>
                <pdus>
                    <pdu_list>
                        <product_id>1001</product_id>
                        <distributor_id>1001</distributor_id>
                        <distributor_name>分销商1</distributor_name>
                        <sku_properties>1627207:90554,1627207:3232484</sku_properties>
                        <quantity_agent>1</quantity_agent>
                    </pdu_list>
                </pdus>
                <is_authz>yes</is_authz>
                <scitem_id>10001</scitem_id>
                <spu_id>100</spu_id>
            </fenxiao_product>
        </products>
    </fenxiao_distributor_products_get_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

    返回
    顶部