# 获取机构选品广场商品列表

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：listselectionproducts

1.带货机构如果要做带货达人和商家的撮合业务，可以通过本接口拉取属于机构的联盟公开商品池。

2.定向计划，指的是商家/供货机构，定向推给你的商品，只有被定向的机构能够拉取到商品；公开计划，指的是商家/供货机构设置给所有机构都能拉取到的商品。

3.商家供货，指的是商家为你提供的商品；机构供货，指的是机构为你提供的商品。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/league/headsupplier/selectionproducts/list/get?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口不支持第三方平台调用。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token

# 请求体 `Request Payload`

参数名	类型	必填	说明
plan_type	number	是	商品的计划类型 1：定向计划 2：公开计划
spu_item_condition	object	否	商品查询条件
category	object	否	商品类目查询条件，定向计划不支持。
keyword	string	否	搜索关键词
spu_source	number	否	1-商家供货；2-机构供货，默认值1
page_size	number	否	一页获取多少个商品，最大 20
next_key	string	否	分页参数，第一页为空，后面返回前面一页返回的数据

# Body.spu_item_condition `Object Payload`

商品查询条件

参数名	类型	必填	说明
selling_price_range	object	否	售卖价区间，单位是分。
monthly_sales_range	object	否	月销量区间
flags	array	否	保障标，0-7天无理由；1-运费险；2-品牌（已废弃）；3-放心买；4-损坏包退；5-假一赔三；6-先用后付；7-包邮；
service_fee_rate_range	object	否	服务费率区间，单位是10万分之。
commission_rate_range	object	否	佣金率区间，单位是10万分之。
promote_time_range	object	否	推广时间范围
create_time_range	object	否	创建时间范围（与 keyword 不能共用）

# Body.category `Object Payload`

商品类目查询条件，定向计划不支持。

参数名	类型	必填	说明
category_id	number	否	商品类目
category_name	string	否	商品类目名称，可填空
category_ids_1	numarray	否	一级类目列表
category_ids_2	numarray	否	二级类目列表
category_ids_3	numarray	否	三级类目列表

# Body.spu_item_condition.selling_price_range `Object Payload`

售卖价区间，单位是分。

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# Body.spu_item_condition.monthly_sales_range `Object Payload`

月销量区间

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# Body.spu_item_condition.service_fee_rate_range `Object Payload`

服务费率区间，单位是10万分之。

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# Body.spu_item_condition.commission_rate_range `Object Payload`

佣金率区间，单位是10万分之。

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# Body.spu_item_condition.promote_time_range `Object Payload`

推广时间范围

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# Body.spu_item_condition.create_time_range `Object Payload`

创建时间范围（与 keyword 不能共用）

参数名	类型	必填	说明
min	number	否	区间最小值
max	number	否	区间最大值

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	0	错误码
errmsg	string	ok	错误信息
product_list	objarray		商品列表
next_key	string		分页参数

# Res.product_list(Array) `Object Payload`

商品列表

参数名	类型	说明
product_id	number	商品 id
shop_appid	string	商品所属店铺 appid
head_supplier_item_link	string	机构商品链接

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

# 5.1 商品类目查询参考

请求示例

请求时只需将列数组中的一个元素填入category即可。

{
    "categorys": [
        {
            "category_id": 11099070301657575487,
            "category_ids_1": [7339,502043,7419,6625],
            "category_name": "食品生鲜"
        },
        {
            "category_id": 16579416177373560313,
            "category_ids_1": [6033,1653,6831,7378,6932],
            "category_name": "服饰鞋包"
        },
        {
            "category_id": 17007902228422672609,
            "category_ids_1": [1001,6870],
            "category_name": "个护美妆"
        },
        {
            "category_id": 12377324634086192020,
            "category_ids_1": [135835],
            "category_name": "图书"
        },
        {
            "category_id": 8261345894708739273,
            "category_ids_1": [1142,1421,1453,1208,6153,6472,1069,1247],
            "category_name": "家清日用"
        },
        {
            "category_id": 12379480883574690382,
            "category_ids_1": [530004,376707,1804,442005,1701,381003,128209,6263,377078,378228,530032,7363,378136,429008,6706],
            "category_name": "其他"
        }
    ]
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "product_list": {
        "product_id": 0,
        "shop_appid": "",
        "head_supplier_item_link": ""
    },
    "next_key": ""
}

# 5.2 请求参数示例

请求示例

// 原请求同样适用，不填则默认不设置任何条件查询所有商品列表

{
    "next_key": "",
    "page_size": 10,
    "plan_type":1
}

// 搜索示例
{
    "next_key": "",
    "page_size": 10,
    "plan_type":1,
    "category": {
        "category_id": 8261345894708739273,
        "category_ids_1": [1142,1421,1453,1208,6153,6472,1069,1247],
        "category_name": "家清日用"
    },
    "keyword": "纸巾",
    "spu_item_condition": {
        "commission_rate_range": {
            "max": 100000,
            "min": 0
        }
    }
}

返回示例

{
  "errcode": "0",
  "errmsg": "ok",
  "product_list":[
    {
        "product_id": 1,
        "shop_appid": "SHOPAPPID",
        "head_supplier_item_link": "weixinstorehs/14460423854052"
    }
  ],
  "next_key": "PAGECONTEXT"
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码

错误码	错误描述	解决方案
10024000	参数错误

# 7. 适用范围

本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。

# 获取机构选品广场商品列表

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# Body.spu_item_condition Object Payload

# Body.category Object Payload

# Body.spu_item_condition.selling_price_range Object Payload

# Body.spu_item_condition.monthly_sales_range Object Payload

# Body.spu_item_condition.service_fee_rate_range Object Payload

# Body.spu_item_condition.commission_rate_range Object Payload

# Body.spu_item_condition.promote_time_range Object Payload

# Body.spu_item_condition.create_time_range Object Payload