# 获取商品列表

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

接口英文名：getshopproductlist

通过该接口可获取商品列表。（仅历史数据，暂无当日数据）

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/compass/shop/product/list/get?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：175
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

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

# 请求体 `Request Payload`

参数名	类型	必填	说明
ds	string	是	日期，格式YYYYMMDD

# 3. 返回参数

# 返回体 `Response Payload`

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

# Res.product_list(Array) `Object Payload`

商品列表

参数名	类型	说明
product_id	string	商品id
head_img_url	string	商品图
title	string	商品标题
price	string	商品价格，单位分
first_category_id	string	商品一级类目
second_category_id	string	商品二级类目
third_category_id	string	商品三级类目
data	object	详细数据

# Res.product_list(Array).data `Object Payload`

详细数据

参数名	类型	说明
pay_gmv	string	成交金额，单位分
create_gmv	string	下单金额，单位分
create_cnt	string	下单订单数
create_uv	string	下单人数
create_product_cnt	string	下单件数
pay_cnt	string	成交订单数
pay_uv	string	成交人数
pay_product_cnt	string	成交件数
pure_pay_gmv	string	成交金额（剔除退款）
pay_gmv_per_uv	string	成交客单价（剔除退款）
seller_actual_settle_amount	string	实际结算金额，单位分
platform_actual_commission	string	实际服务费金额，单位分
finderuin_actual_commission	string	实际达人佣金支出，单位分
captain_actual_commission	string	实际团长佣金支出，单位分
seller_predict_settle_amount	string	预估结算金额，单位分
platform_predict_commission	string	预估服务费金额，单位分
finderuin_predict_commission	string	预估达人佣金支出，单位分
captain_predict_commission	string	预估团长佣金支出，单位分
product_click_uv	string	商品点击人数
product_click_cnt	string	商品点击次数
pay_refund_gmv	string	成交退款金额，单位分
pay_refund_uv	string	成交退款人数，单位分
pay_refund_ratio	null	成交退款率
pay_refund_after_send_ratio	null	发货后成交退款率
pay_refund_cnt	string	成交退款订单数
pay_refund_product_cnt	string	成交退款件数
pay_refund_before_send_ratio	null	发货前成交退款率
refund_gmv	string	退款件数
refund_product_cnt	string	退款件数
refund_cnt	string	退款订单数
refund_uv	string	退款人数

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
    "ds": "20240520"

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "product_list": [
    {
      "product_id": "10000054370820",
      "head_img_url": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/64ad0d7000005f161ed22d3e51618809000000a000004f50?imageView2/1/w/800/h/800/q/50",
      "title": "榴莲yyds",
      "price": "1",
      "first_category_id": "6625",
      "second_category_id": "6631",
      "third_category_id": "545264",
      "data": {
        "pay_gmv": "0",
        "create_gmv": "0",
        "create_cnt": "0",
        "create_uv": "0",
        "create_product_cnt": "0",
        "pay_cnt": "0",
        "pay_uv": "0",
        "pay_product_cnt": "0",
        "pure_pay_gmv": "0",
        "pay_gmv_per_uv": "0",
        "seller_actual_settle_amount": "1",
        "platform_actual_commission": "0",
        "finderuin_actual_commission": "0",
        "captain_actual_commission": "0",
        "seller_predict_settle_amount": "0",
        "platform_predict_commission": "0",
        "finderuin_predict_commission": "0",
        "captain_predict_commission": "0",
        "product_click_uv": "0",
        "product_click_cnt": "0",
        "pay_refund_gmv": "0",
        "pay_refund_uv": "0",
        "pay_refund_ratio": 0.0,
        "pay_refund_after_send_ratio": 0.0,
        "pay_refund_cnt": "0",
        "pay_refund_product_cnt": "0",
        "pay_refund_before_send_ratio": 0.0,
        "refund_gmv": "0",
        "refund_product_cnt": "0",
        "refund_cnt": "0",
        "refund_uv": "0"
      }
    },
    {
      "product_id": "10000056024001",
      "head_img_url": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/64b6896f000c5282208dfa8953618809000000a000004f50?imageView2/1/w/800/h/800/q/50",
      "title": "坏了包赔的多汁甜柚子20 斤整箱",
      "price": "1",
      "first_category_id": "6625",
      "second_category_id": "6631",
      "third_category_id": "6632",
      "data": {
        "pay_gmv": "0",
        "create_gmv": "0",
        "create_cnt": "0",
        "create_uv": "0",
        "create_product_cnt": "0",
        "pay_cnt": "0",
        "pay_uv": "0",
        "pay_product_cnt": "0",
        "pure_pay_gmv": "0",
        "pay_gmv_per_uv": "0",
        "seller_actual_settle_amount": "10",
        "platform_actual_commission": "0",
        "finderuin_actual_commission": "0",
        "captain_actual_commission": "0",
        "seller_predict_settle_amount": "0",
        "platform_predict_commission": "0",
        "finderuin_predict_commission": "0",
        "captain_predict_commission": "0",
        "product_click_uv": "0",
        "product_click_cnt": "0",
        "pay_refund_gmv": "0",
        "pay_refund_uv": "0",
        "pay_refund_ratio": 0.0,
        "pay_refund_after_send_ratio": 0.0,
        "pay_refund_cnt": "0",
        "pay_refund_product_cnt": "0",
        "pay_refund_before_send_ratio": 0.0,
        "refund_gmv": "0",
        "refund_product_cnt": "0",
        "refund_cnt": "0",
        "refund_uv": "0"
      }
    },
    {
      "product_id": "10000071952389",
      "head_img_url": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/650d2feb00051b0a1846e7b41c918e0b000000a000004f50?imageView2/1/w/800/h/800/q/50",
      "title": "生鲜-方便菜，开了坏损包退，没开7天无理由",
      "price": "1",
      "first_category_id": "6625",
      "second_category_id": "527038",
      "third_category_id": "527050",
      "data": {
        "pay_gmv": "6",
        "create_gmv": "6",
        "create_cnt": "5",
        "create_uv": "4",
        "create_product_cnt": "6",
        "pay_cnt": "5",
        "pay_uv": "4",
        "pay_product_cnt": "6",
        "pure_pay_gmv": "6",
        "pay_gmv_per_uv": "2",
        "seller_actual_settle_amount": "1",
        "platform_actual_commission": "0",
        "finderuin_actual_commission": "0",
        "captain_actual_commission": "0",
        "seller_predict_settle_amount": "5",
        "platform_predict_commission": "0",
        "finderuin_predict_commission": "0",
        "captain_predict_commission": "0",
        "product_click_uv": "0",
        "product_click_cnt": "0",
        "pay_refund_gmv": "0",
        "pay_refund_uv": "0",
        "pay_refund_ratio": 0.0,
        "pay_refund_after_send_ratio": 0.0,
        "pay_refund_cnt": "0",
        "pay_refund_product_cnt": "0",
        "pay_refund_before_send_ratio": 0.0,
        "refund_gmv": "1",
        "refund_product_cnt": "1",
        "refund_cnt": "1",
        "refund_uv": "1"
      }
    },
    {
      "product_id": "10000093045061",
      "head_img_url": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/6406a072000c0f04251624a2bd368e0b000000a100004f50?imageView2/1/w/800/h/800/q/50",
      "title": "手提包-很多很多属性的商品for推广，请勿乱动",
      "price": "1000",
      "first_category_id": "6033",
      "second_category_id": "6122",
      "third_category_id": "6124",
      "data": {
        "pay_gmv": "0",
        "create_gmv": "0",
        "create_cnt": "0",
        "create_uv": "0",
        "create_product_cnt": "0",
        "pay_cnt": "0",
        "pay_uv": "0",
        "pay_product_cnt": "0",
        "pure_pay_gmv": "0",
        "pay_gmv_per_uv": "0",
        "seller_actual_settle_amount": "950",
        "platform_actual_commission": "50",
        "finderuin_actual_commission": "0",
        "captain_actual_commission": "0",
        "seller_predict_settle_amount": "0",
        "platform_predict_commission": "0",
        "finderuin_predict_commission": "0",
        "captain_predict_commission": "0",
        "product_click_uv": "0",
        "product_click_cnt": "0",
        "pay_refund_gmv": "0",
        "pay_refund_uv": "0",
        "pay_refund_ratio": 0.0,
        "pay_refund_after_send_ratio": 0.0,
        "pay_refund_cnt": "0",
        "pay_refund_product_cnt": "0",
        "pay_refund_before_send_ratio": 0.0,
        "refund_gmv": "0",
        "refund_product_cnt": "0",
        "refund_cnt": "0",
        "refund_uv": "0"
      }
    },
    {
      "product_id": "10000099582075",
      "head_img_url": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/65f56a990000dbce19b08e5ade908e0b000000a000004f50?imageView2/1/w/800/h/800/q/50",
      "title": "支持细分资质copy",
      "price": "1",
      "first_category_id": "1001",
      "second_category_id": "1002",
      "third_category_id": "1010",
      "data": {
        "pay_gmv": "6",
        "create_gmv": "6",
        "create_cnt": "3",
        "create_uv": "3",
        "create_product_cnt": "6",
        "pay_cnt": "3",
        "pay_uv": "3",
        "pay_product_cnt": "6",
        "pure_pay_gmv": "5",
        "pay_gmv_per_uv": "2",
        "seller_actual_settle_amount": "1",
        "platform_actual_commission": "0",
        "finderuin_actual_commission": "0",
        "captain_actual_commission": "0",
        "seller_predict_settle_amount": "1",
        "platform_predict_commission": "0",
        "finderuin_predict_commission": "0",
        "captain_predict_commission": "0",
        "product_click_uv": "0",
        "product_click_cnt": "0",
        "pay_refund_gmv": "1",
        "pay_refund_uv": "1",
        "pay_refund_ratio": 0.3333333333333333,
        "pay_refund_after_send_ratio": 0.3333333333333333,
        "pay_refund_cnt": "1",
        "pay_refund_product_cnt": "1",
        "pay_refund_before_send_ratio": 0.0,
        "refund_gmv": "1",
        "refund_product_cnt": "1",
        "refund_cnt": "1",
        "refund_uv": "1"
      }
    }
  ]
}

# 6. 错误码

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

错误码	错误描述	解决方案
10021069	请求参数日期格式有误

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

# 获取商品列表

# 1. 调用方式

# HTTPS 调用

# 云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# 3. 返回参数

# 返回体 Response Payload

# Res.product_list(Array) Object Payload

# Res.product_list(Array).data Object Payload

# 4. 注意事项

# 5. 代码示例

# 6. 错误码

# 7. 适用范围

# 查询参数 `Query String parameters`

# 请求体 `Request Payload`

# 返回体 `Response Payload`

# Res.product_list(Array) `Object Payload`

# Res.product_list(Array).data `Object Payload`