taobao.fenxiao.products.get (查询产品列表)

查询供应商的产品数据。 * 入参传入pids将优先查询,即只按这个条件查询。 *入参传入sku_number将优先查询(没有传入pids),即只按这个条件查询(最多显示50条) * 入参fields传skus将查询sku的数据,不传该参数默认不查询,返回产品的其它信息。 * 入参fields传入images将查询多图数据,不传只返回主图数据。 * 入参fields仅对传入pids生效(只有按ID查询时,才能查询额外的数据) * 查询结果按照产品发布时间倒序,即时间近的数据在前。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
outer_id String 可选 a154552 商家编码
productcat_id Number 可选 3232312 产品线ID
pids Number 可选 1001,1002,1003,1004,1005 产品ID列表(最大限制30),用逗号分割,例如:“1001,1002,1003,1004,1005”
fields String 可选 skus,images 指定查询额外的信息,可选值:skus(sku数据)、images(多图),多个可选值用逗号分割。
start_modified Date 可选 2000-01-01 00:00:00 开始修改时间
end_modified Date 可选 2000-01-01 00:00:00 结束修改时间
page_no Number 可选 1 页码(大于0的整数,默认1)
page_size Number 可选 20 每页记录数(默认20,最大50)
sku_number String 可选 sku商家编码 sku商家编码
is_authz String 可选 yes 查询产品列表时,查询入参“是否需要授权” yes:需要授权 no:不需要授权
item_ids Number 可选 1001,1002,1003,1004,1005 可根据导入的商品ID列表查询,优先级次于产品ID、sku_numbers,高于其他分页查询条件。最大限制20,用逗号分割,例如:“1001,1002,1003,1004,1005”

响应参数

名称 类型 示例值 描述
total_results Number 10 查询结果记录数
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
  • 产品库存
  • └ reserved_quantity
  • Number
  • 100
  • 预扣库存
  • └ quota_quantity
  • Number
  • 100
  • 配额可用库存
  • └ 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(新增参数)
  • └ item_id
  • Number
  • 1001
  • 导入的商品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
  • 库存
  • └ reserved_quantity
  • Number
  • 100
  • 预扣库存
  • └ quota_quantity
  • Number
  • 100
  • 配额可用库存
  • └ outer_id
  • String
  • 1
  • 商家编码
  • └ properties
  • String
  • 1243:1215;5626:5125
  • sku的销售属性组合字符串。格式:pid:vid;pid:vid,如:1627207:3232483;1630696:3284570,表示:机身颜色:军绿色;手机套餐:一电一充。
  • └ scitem_id
  • Number
  • 10001
  • 关联的后端商品id
  • 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);
FenxiaoProductsGetRequest req = new FenxiaoProductsGetRequest();
req.setOuterId("a154552");
req.setProductcatId(3232312L);
req.setPids(1001,1002,1003,1004,1005L);
req.setFields("skus,images");
req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setPageNo(1L);
req.setPageSize(20L);
req.setSkuNumber("sku商家编码");
req.setIsAuthz("yes");
req.setItemIds(1001,1002,1003,1004,1005L);
FenxiaoProductsGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_products_get_response>
    <total_results>10</total_results>
    <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>
            <reserved_quantity>100</reserved_quantity>
            <quota_quantity>100</quota_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>
            <item_id>1001</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>
                    <reserved_quantity>100</reserved_quantity>
                    <quota_quantity>100</quota_quantity>
                    <outer_id>1</outer_id>
                    <properties>1243:1215;5626:5125</properties>
                    <scitem_id>10001</scitem_id>
                </sku_list>
            </skus>
            <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_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

返回
顶部