微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 获取商品详细信息

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

    接口英文名：getshopproductdata

    通过该接口可获取商品详细信息。（仅历史数据，暂无当日数据）

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：175

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

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

    # 请求体 Request Payload

    参数名类型必填示例说明
    dsstring是20240520日期，格式YYYYMMDD
    product_idnumber是10000099582075商品id

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型示例说明
    errcodenumber0错误码
    errmsgstringok错误信息
    product_infoobject商品详细信息

    # Res.product_info Object Payload

    商品详细信息

    参数名类型说明
    product_idstring商品id
    head_img_urlstring商品图
    titlestring商品标题
    pricestring商品价格，单位分
    first_category_idstring商品一级类目
    second_category_idstring商品二级类目
    third_category_idstring商品三级类目
    dataobject详细数据

    # Res.product_info.data Object Payload

    详细数据

    参数名类型说明
    pay_gmvstring成交金额，单位分
    create_gmvstring下单金额，单位分
    create_cntstring下单订单数
    create_uvstring下单人数
    create_product_cntstring下单件数
    pay_cntstring成交订单数
    pay_uvstring成交人数
    pay_product_cntstring成交件数
    pure_pay_gmvstring成交金额（剔除退款）
    pay_gmv_per_uvstring成交客单价（剔除退款）
    seller_actual_settle_amountstring实际结算金额，单位分
    platform_actual_commissionstring实际服务费金额，单位分
    finderuin_actual_commissionstring实际达人佣金支出，单位分
    captain_actual_commissionstring实际团长佣金支出，单位分
    seller_predict_settle_amountstring预估结算金额，单位分
    platform_predict_commissionstring预估服务费金额，单位分
    finderuin_predict_commissionstring预估达人佣金支出，单位分
    captain_predict_commissionstring预估团长佣金支出，单位分
    product_click_uvstring商品点击人数
    product_click_cntstring商品点击次数
    pay_refund_gmvstring成交退款金额，单位分
    pay_refund_uvstring成交退款人数，单位分
    pay_refund_rationull成交退款率
    pay_refund_after_send_rationull发货后成交退款率
    pay_refund_cntstring成交退款订单数
    pay_refund_product_cntstring成交退款件数
    pay_refund_before_send_rationull发货前成交退款率
    refund_gmvnull退款金额，单位分
    refund_product_cntstring退款件数
    refund_cntstring退款订单数
    refund_uvstring退款人数

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    请求示例

    {
    "ds": "20240520",
    "product_id": 10000099582075
}

    返回示例

    {
  "errcode": 0,
  "errmsg": "ok",
  "product_info": {
    "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. 适用范围

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