概述

好物圈是微信提供的服务信息管理和物品推荐工具。用户可以在这里浏览朋友推荐的物品,与朋友交流心得,还可以为朋友进行推荐。

请仔细阅读《好物圈功能服务条款》,开始接入即表示你同意《好物圈功能服务条款》。

好物圈开发文档

接入条件

符合以下条件的小程序可以申请接入好物圈:

  1. 小程序已开通微信支付;
  2. 小程序不属于金融、游戏、医疗等类目。

接入方式

开发者可通过以下API接入好物圈:

  1. 订单接口:将用户的订单信息同步至好物圈;
  2. 收藏接口:将用户的购物车信息导入好物圈;
  3. 物品信息:更新物品相关信息,如上下架状态、是否售罄、价格变化、可配送范围等。

同时,开发者还可以在小程序中使用推荐接口,方便用户直接将物品推荐到好物圈。

开发者调用微信公众平台接口需获取access_token。第三方平台代小程序接入好物圈接入指引

 

接入须知

运营规范

请仔细阅读《好物圈功能运营规范》,严格遵守相关规定,包括但不限于:

  1. 申请接入好物圈功能的小程序须属于平台已开放类目,且小程序已获得微信认证。
  2. 申请接入好物圈功能时,你应按照本文档中的要求提供真实有效的联系方式,并保证在使用好物圈功能服务过程中的及时响应和沟通。
  3. 你根据本文档接入好物圈功能时,需遵守文档中的规则和约定。
  4. 你在使用好物圈功能调用相关接口时,向“好物圈”同步的与订单相关的数据和信息应为真实、准确、有效,不得同步任何虚假或违法违规的数据、信息或伪造用户行为。否则,腾讯有权视情况对你采取相应的处理措施,包括但不限于限制使用好物圈、搜索等功能。
  5. 你应当确保你具有合法资质、完整能力以接入好物圈功能,你通过小程序运营和提供的服务及/或内容均符合相关法律法规要求,包括但不限于具备相关经营资质、提供退换货、实时在线客服、争议处理机制服务、采取安全保障措施确保交易安全可靠等。
  6. 你接入好物圈功能的小程序不得存在违反《微信小程序平台运营规范》或其他腾讯协议、规则的内容或情形。

如果发现违反《好物圈功能运营规范》的行为,我们将按照《好物圈功能运营规范》里的规定采取相应处理措施,并将违规信息通过模板消息通知小程序开发者。

 

行为规范及处罚规则

接入好物圈的商家不得有以下违规行为,一经发现,将立刻限制小程序接入好物圈、限制物品可见范围,并根据违规程度对该小程序采取相应的处理措施。
违规信息将以报告的形式通知商家。商家可使用接入好物圈的主体账号登录微信公众平台公众号后台,进入“微信搜索”- “好物圈”,查看《好物圈商家质量报告》。

一、商家行为规范

1.1 导入虚假数据

违规内容

导入用户未发生实际购买行为的订单信息,或用户未主动收藏过的收藏信息。

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

1.2 诱导分享

违规内容

在小程序物品详情页中诱导用户分享、传播,或用夸张语言胁迫、引诱用户分享。

好物圈开发文档

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

1.3 未实时同步订单

违规内容

商家未实时同步订单至好物圈。

处罚规则

限制物品的可见范围直至问题修复。

二、信息内容规范

2.1 物品属于违禁类目

违规行为

接入好物圈的物品属于金融、医疗药品、保健品等未开放类目。

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

2.2 物品信息包含违反国家法律法规禁止的内容

违规行为

接入好物圈的物品信息中不得包含如下国家法律法规禁止的信息内容:
2.2.1 反对宪法所确定基本原则,危害国家安全、泄露国家秘密、颠覆国家政权、破坏国家统一 、损害国家荣誉和利益。
2.2.2 反政府、反社会,或存在煽动性的涉政言论、散布谣言,扰乱社会秩序,破坏社会稳定。
2.2.3 煽动民族仇恨、民族歧视、破坏民族团结、破坏国家宗教政策、宣扬邪教和封建迷信。
2.2.4 展示人或动物被杀戮、致残、枪击、针刺或其他伤害的真实图片,描述暴力或虐待儿童的,或包含宣扬暴力血腥内容。
2.2.5 包含赌博、竞猜和抽奖信息的。
2.2.6 含有虚假、欺诈或冒充类内容,包括但不限于虚假红包、虚假活动、虚假宣传,仿冒腾讯官方或他人业务,可能造成微信用户混淆。
2.2.7 公然侮辱或者诽谤他人,揭露他人隐私,侵害他人合法权益的。
2.2.8 未经授权,擅自使用他人商标、版权内容等,以及其他侵犯他人合法知识产权的。
2.2.9 任何召集、鼓动犯罪或有明显违背社会善良风俗行为的。
2.2.10 其他任何违反法律法规的内容。

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

2.3 物品信息包含色情低俗内容

违规行为

接入好物圈的物品信息中不得包含淫秽、色情或低俗内容,包括但不限于暴露图片、挑逗内容等,或包含非法色情交易的内容。

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

2.4 物品信息包含垃圾广告内容

违规行为

接入好物圈的物品信息中不得存在过度营销、展示或传播骚扰信息或垃圾信息等内容,包括但不限于如下内容:

2.4.1 精仿高仿产品类垃圾广告。

好物圈开发文档

2.4.2 丰胸、减肥、增高、壮阳、性保健类垃圾广告。
2.4.3 包含虚假夸大类推广信息,存在违反现行广告法等情形。
2.4.4 病症类、性器官保养类垃圾广告。

处罚规则

永久禁止接入好物圈,并删除已导入的数据。

三、数据质量规范

3.1 物品信息不完整

违规行为

接入好物圈的物品信息不完整,包括但不限于物品图片、标题、价格、所属类目缺失等问题。

处罚规则

限制物品的可见范围直至问题修复。

3.2 物品展示信息不一致

违规行为

接入好物圈的物品信息与小程序内物品详情页信息不一致,包括但不限于物品图片、标题、价格信息不一致,或物品的标题与图片信息不相符等。

好物圈开发文档 好物圈开发文档

处罚规则

限制物品的可见范围直至问题修复。

3.3 物品详情页质量较差

违规行为

接入好物圈的物品详情页质量较差,页面包含垃圾广告或不相关信息等。

好物圈开发文档

处罚规则

限制物品的可见范围直至问题修复。

3.4 物品详情页无效

违规行为

接入好物圈的物品详情页无法打开或页面不存在等。

好物圈开发文档

处罚规则

限制物品的可见范围直至问题修复。

 

订单接口

导入订单

开发者可以在用户支付完成后,同步小程序/H5/APP订单数据至好物圈(H5/APP订单需保证调用支付接口的H5/APP与导入数据的小程序绑定在同一个微信开放平台帐号下)。

历史订单导入:在首次接入时,开发者需导入最近三个月的”历史订单“数据,导入数据有助于物品在搜索中获得更好的曝光,帮助新接入的商家在搜索中实现冷启动。

接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importorder?action=add-order&is_history=0/1&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 导入订单数据
接口调用时机 用户完成支付
其他说明 如果订单中的物品为首次导入,订单中的物品信息会该物品的初始化信息;如果为历史订单,请求URL的is_history参数值为1。

请求数据样例

示例代码

{
  "order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "create_time": 1527584231,
      "pay_finish_time": 1527584244,
      "desc": "xx微主页",
      "fee": 1,
      "trans_id": "4200000144201807116521229xxx",
      "status": 3,
      "ext_info": {
        "product_info": {
          "item_list": [
            {
              "item_code": "00003563372839_00000010001xxx",
              "sku_id": "00003563372839_10000010014xxx",
              "amount": 1,
              "total_fee": 1,
              "thumb_url": "https://shp.qpic.cn/wechat_bs/0/4eb3dcee0edcd34939b87f232e9fxxxx",
              "title": "肯德基XX",
              "desc": "xxxx",
              "unit_price": 1,
              "original_price": 2,
              "poi_list": [
                {
                  "longitude": 116.32676,
                  "latitude": 40.003305,
                  "radius": 4,
                  "business_name": "肯德基",
                  "branch_name": "珠江新城店",
                  "address": "新港中路123号"
                },
                {
                  "longitude": 117.32676,
                  "latitude": 41.003305,
                  "radius": 5,
                  "business_name": "肯德基",
                  "branch_name": "客村店",
                  "address": "新港中路123号"
                }
              ],
              "stock_attr_info": [
                {
                  "attr_name": {
                    "name": "尺码"
                  },
                  "attr_value": {
                    "name": "L"
                  }
                }
              ],
              "category_list": [
                "衣服",
                "T-shirt"
              ],
              "item_detail_page": {
                "path": "/portal/xxxx/detail?code=00003563372839_00000010001xxx"
              },
              "bar_code_info": {
                "barcode_type": "ean8",
                "barcode": "12345678"
              },
              "platform_category_list": [
                {
                  "category_id": 4342,
                  "category_name": "运动裤"
                }
              ]
            }
          ]
        },
        "express_info": {
          "name": "测试用户",
          "phone": "158xxxxxx",
          "address": "广东省广州市tit创意园品牌街腾讯微信总部",
          "price": 0,
          "national_code": "440105",
          "country": "中国",
          "province": "广东省",
          "city": "广州市",
          "district": "海珠区",
          "express_package_info_list": [
            {
              "express_company_id": 2001,
              "express_company_name": "圆通",
              "express_code": "88627337387xxx",
              "ship_time": 1517713509,
              "express_page": {
                "path": "/libs/xxxxx/portal/express-detail/xxxxx"
              },
              "express_goods_info_list": [
                {
                  "item_code": "00003563372839_00000010001xxx",
                  "sku_id": "00003563372839_10000010014xxx"
                }
              ]
            }
          ]
        },
        "promotion_info": {
          "discount_fee": 1
        },
        "brand_info": {
          "phone": "12345678",
          "contact_detail_page": {
            "path": "/libs/xxxxx/portal/contact_detail/xxxx"
          }
        },
        "invoice_info": {
          "type": 0,
          "title": "xxxxxx",
          "tax_number": "xxxxxx",
          "company_address": "xxxxxx",
          "telephone": "020-xxxxxx",
          "bank_name": "招商银行",
          "bank_account": "xxxxxxxx",
          "invoice_detail_page": {
            "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
          }
        },
        "payment_method": 1,
        "user_open_id": "xxxxxxx",
        "order_detail_page": {
          "path": "/libs/xxxxx/portal/order-detail/xxxxx",
          "kf_type":3
        }
      }
    }
  ]
}

 

添加订单参数列表

订单基本字段 必填 字段类型 说明
order_list array 单次请求订单数量不可超过10单
order_list字段 必填 字段类型 说明
order_id string 订单id,需要保证唯一性
create_time uint32 订单创建时间,unix时间戳
pay_finish_time uint32 支付完成时间,unix时间戳
desc string 订单备注
fee uint32 订单金额,单位:分
trans_id string 微信支付订单id,对于使用微信支付的订单,该字段必填
status uint32 订单状态,3:支付完成 4:已发货 5:已退款 100: 已完成
ext_info object 订单扩展信息
ext_info字段 必填 字段类型 说明
product_info object 物品相关信息
express_info object 快递信息
promotion_info object 订单优惠信息
brand_info object 商家信息
invoice_info object 发票信息,对于开发票订单,该字段必填
payment_method uint32 订单支付方式,0:未知方式 1:微信支付 2:其他支付方式
user_open_id string 用户的openid,参见openid说明
order_detail_page object 订单详情页(小程序页面)
total_fee uint32 订单物品合计金额(优惠前金额,不填写的话,平台默认用物品的total fee累加)
product_info字段 必填 字段类型 说明
item_list array 包含订单中所有物品的信息
item_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
sku_id string sku_id
amount uint32 物品数量
total_fee uint32 物品总价,单位:分
thumb_url string 物品图片,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
title string 物品名称
desc string 物品详细描述
unit_price uint32 物品单价(实际售价),单位:分
original_price uint32 物品原价,单位:分
stock_attr_info array 物品属性列表
category_list array 物品类目列表
item_detail_page object 物品详情页(小程序页面)
can_be_search bool 物品能否被搜索(默认true可以被搜索)
bar_code_info object 物品的条形码信息
platform_category_list array 物品平台类目列表,填写的每个类目必须在好物圈物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address string 门店地址(不包含省市区信息,如:新港中路123号)
stock_attr_info字段 必填 字段类型 说明
attr_name object 属性名
attr_value object 属性值
attr_name字段 必填 字段类型 说明
name string 属性名称
attr_value字段 必填 字段类型 说明
name string 属性值
item_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序物品详情页跳转链接
src_h5_path string h5物品详情页跳转链接
platform_category_list字段 必填 字段类型 说明
category_id uint32 平台类目ID
category_name string 平台类目名称
express_info字段 必填 字段类型 说明
name string 收件人姓名
phone string 收件人联系电话
address string 收件人地址
price uint32 运费,单位:分
national_code string 行政区划代码
country string 国家
province string 省份
city string 城市
district string
express_package_info_list array 包裹中的物品信息
express_package_info_list字段 必填 字段类型 说明
express_company_id uint32 快递公司id
express_company_name string 快递公司名
express_code string 快递单号
ship_time uint32 发货时间,unix时间戳
express_page object 快递详情页(小程序页面)
express_goods_info_list array 包裹物品信息
express_page字段(以下二选一) 必填 字段类型 说明
path string 小程序快递详情页跳转链接
src_h5_path string h5快递详情页跳转链接
express_goods_info_list字段 必填 字段类型 说明
item_code string 物品id
sku_id string sku_id
promotion_info字段 必填 字段类型 说明
discount_fee uint32 优惠金额
invoice_info字段 必填 字段类型 说明
type uint32 抬头类型,0:单位,1:个人
title string 发票抬头
tax_number string 发票税号
company_address string 单位地址
telephone string 手机号码
bank_name string 银行名称
bank_account string 银行账号
invoice_detail_page object 发票详情页(小程序页面)
brand_info字段 必填 字段类型 说明
phone string 用于售后场景的商家联系电话,便于用户咨询和问题解决
contact_detail_page object 联系商家页面
logo string 商家logo,不填的话,默认取小程序头像
name string 商家名称,不填的话,默认取小程序名字
invoice_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序发票详情页跳转链接
src_h5_path string h5发票详情页跳转链接
order_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序订单详情页跳转链接
src_h5_path string h5订单详情页跳转链接
contact_detail_page字段 必填 字段类型 说明
kf_type int 在线客服类型 1 没有在线客服; 2 微信客服消息; 3 小程序自有客服; 4 公众号h5自有客服
path string 小程序自有客服页面路径,kf_type为3时必填
src_h5_path string 公众号h5自有客服页面路径,kf_type为4时必填
bar_code_info字段 必填 字段类型 说明
barcode_type string 条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcode string 条形码数字字符串

回包数据样例

接口调用成功回包

{ "errcode":0, "errmsg":"success" }

接口调用失败回包

{ "errcode": 9019101, "errmsg":"订单数量超过限制" }

回包字段 类型 说明
errcode int32 错误码
errmsg string 错误信息
fail_order_list object 失败订单信息
fail_order_list字段 类型 说明
order_id string 失败订单ID
error_code int32 订单错误码
msg string 错误提示

接口错误码

回包错误码 说明
0 成功
9009099 系统错误
9009098 请求参数错误,详细错误提示请参考json回包中的errmsg字段。
9009400 订单数量超过限制
其他常见错误码 点击查看
订单错误码 说明
-1 系统错误
-2 订单参数错误

 

更新订单信息

开发者对订单信息进行更新,如订单状态改变等;接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importorder?action=update-order&is_history=0/1&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 更新订单数据
接口调用时机 商户发货、用户退款完成、订单已完成
其他说明 如果为历史订单,请求URL的is_history参数值为1。

请求数据样例

{
  "order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "trans_id": "4200000144201807116521229xxx",
      "status": 4,
      "desc": "xx微主页",
      "ext_info": {
        "express_info": {
          "name": "测试用户",
          "phone": "158xxxxxx",
          "address": "广东省广州市tit创意园品牌街腾讯微信总部",
          "price": 0,
          "national_code": "440105",
          "country": "中国",
          "province": "广东省",
          "city": "广州市",
          "district": "海珠区",
          "express_package_info_list": [
            {
              "express_company_id": 2001,
              "express_company_name": "圆通",
              "express_code": "88627337387xxx",
              "ship_time": 1517713509,
              "express_page": {
                "path": "/libs/xxxxx/portal/express-detail/xxxxx"
              },
              "express_goods_info_list": [
                {
                  "item_code": "00003563372839_00000010001xxx",
                  "sku_id": "00003563372839_10000010014xxx"
                }
              ]
            }
          ]
        },
        "invoice_info": {
          "type": 0,
          "title": "xxxxxx",
          "tax_number": "xxxxxx",
          "company_address": "xxxxxx",
          "telephone": "020-xxxxxx",
          "bank_name": "招商银行",
          "bank_account": "xxxxxxxx",
          "invoice_detail_page": {
            "path": "/libs/xxxxx/portal/invoice-detail/xxxxx"
          }
        },
        "user_open_id": "xxxxxxx",
        "order_detail_page": {
          "path": "/libs/xxxxx/portal/order-detail/xxxxx"
        }
      }
    }
  ]
}

请求数据字段说明

订单基本字段 必填 字段类型 说明
order_list array 单次请求订单数量不可超过10单
order_list字段 必填 字段类型 说明
order_id string 订单ID,需要保证唯一性
trans_id string 微信支付订单ID,对于使用微信支付的订单,该字段必填
status uint32 订单状态,4:已发货 5:已退款 12:已取消 100: 已完成
desc string 订单备注
ext_info object 订单扩展信息
ext_info字段 必填 字段类型 说明
express_info object 快递信息,对于已发货订单,该字段必填
invoice_info object 发票信息,对于已开发票订单,该字段必填
user_open_id string 用户的openid,参见openid说明
order_detail_page object 订单详情页(小程序页面)
total_fee uint32 订单物品合计金额(优惠前金额,不填写的话,平台默认用物品的total fee累加)
express_info字段 必填 字段类型 说明
name string 收件人姓名
phone string 收件人联系电话
address string 收件人地址
price uint32 运费,单位:分
national_code string 行政区划代码
country string 国家
province string 省份
city string 城市
district string
express_package_info_list array 包裹信息
express_package_info_list字段 必填 字段类型 说明
express_company_id uint32 快递公司id
express_company_name string 快递公司名
express_code string 快递单号
ship_time uint32 发货时间,unix时间戳
express_page object 快递详情页(小程序)
express_goods_info_list array 包裹中的物品信息
express_page字段(以下二选一) 必填 字段类型 说明
path string 小程序快递详情页跳转链接
src_h5_path string h5快递详情页跳转链接
express_goods_info_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
sku_id string sku_id
invoice_info字段 必填 字段类型 说明
type uint32 抬头类型,0:单位,1:个人
title string 发票抬头
tax_number string 发票税号
company_address string 单位地址
telephone string 手机号码
bank_name string 银行名称
bank_account string 银行账号
invoice_detail_page object 发票详情页(小程序页面)
invoice_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序发票详情页跳转链接
src_h5_path string h5发票详情页跳转链接
order_detail_page字段(以下二选一) 必填 字段类型 说明
path string 小程序订单详情页跳转链接
src_h5_path string h5订单详情页跳转链接

快递公司信息

目前支持的快递公司及其对应的编号如下:

快递公司编号字段 快速公司名字字段
2000 EMS
2001 圆通
2002 DHL
2004 中通
2005 韵达
2006 畅灵
2008 百世汇通
2009 德邦
2010 申通
2011 顺丰速运
2012 顺兴
2014 如风达
2015 优速
9999 其他快递公司名字(例如:京东物流)

回包数据样例

接口调用成功回包

{ "errcode":0, "errmsg":"success" }

接口调用失败回包

{
  "errcode": 9019102,
  "errmsg": "部分订单更新失败",
  "fail_order_list": [
    {
      "order_id": "AQAATGagQ7KQCxMJEj7kHuUjTxxx",
      "error_code": 10001,
      "msg": "订单不存在,无法更新"
    }
  ]
}
回包字段 类型 说明
errcode int32 错误码
errmsg string 错误信息
fail_order_list object 失败订单信息
fail_order_list字段 类型 说明
order_id string 失败订单id
error_code int32 订单错误码
msg string 错误提示

接口错误码

回包错误码 说明
0 成功
9009099 系统错误
9009098 请求参数错误,详细错误提示请参考json回包中的errmsg字段。
9009300 订单数量超过限制
9009301 部分订单更新失败
其他常见错误码 点击查看
订单错误码 说明
-1 系统错误
-2 订单参数错误
10001 订单不存在,无法更新
10002 订单字段冲突

 

删除订单

用户可以对订单进行删除;接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/deleteorder?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 删除订单数据
接口调用时机 用户删除订单

请求数据样例

{ "user_open_id": "xxxxxxxxxxxxxxxxxxxxxxxxx", "order_id": "xxxxxxxxxxxxxxxxxxxxxxxxxxx" }

请求数据字段说明

基本字段 必填 字段类型 说明
user_open_id string 用户微信openid
order_id string 订单号

回包数据样例

接口调用成功回包

{ "errcode":0, "errmsg":"success" }

接口调用失败回包

{ "errcode": 9009098, "errmsg": "req required field order_id" }

回包字段 类型 说明
errcode int32 错误码
errmsg string 错误信息

接口错误码

回包错误码 说明
0 成功
9009099 系统错误
9009098 请求参数错误,详细错误提示请参考json回包中的errmsg字段。
其他常见错误码 点击查看

 

收藏接口

导入收藏

开发者可以在用户添加物品到购物车时,同步物品数据至好物圈的收藏列表。在首次接入时,开发者需导入用户购物车中的所有物品。导入数据有助于物品在搜索中获得更好的曝光,同时也保障用户侧获得一致的体验。 接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/addshoppinglist?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 同步用户添加物品到好物圈
接口调用时机 用户添加物品到购物车

请求数据样例

{
  "user_open_id": "user_open_id",
  "sku_product_list": [
    {
      "item_code": "here_is_spu_id",
      "title": "product_name",
      "desc": "product_description",
      "category_list": [
        "服装",
        "上衣",
        "短袖衬衫"
      ],
      "image_list": [
        "image_url1",
        "image_url2"
      ],
      "src_wxapp_path": "/detail?item_code=xxxx",
      "attr_list": [
        {
          "name": "材质",
          "value": "纯棉"
        },
        {
          "name": "款式",
          "value": "短袖"
        },
        {
          "name": "季度",
          "value": "2018年秋"
        }
      ],
      "version": 100,
      "update_time": 1542868721,
      "platform_category_list": [
        {
          "category_id": 4342,
          "category_name": "运动裤"
        }
      ],
      "sku_info": {
        "sku_id": "sku_id2",
        "price": 10010,
        "original_price": 20010,
        "bar_code_info": {
          "barcode_type": "ean8",
          "barcode": "12345678"
        },
        "status": 1,
        "poi_list": [
          {
            "longitude": 116.32676,
            "latitude": 40.003305,
            "radius": 4,
            "business_name": "外婆家",
            "branch_name": "珠江新城店",
            "address": "新港中路123号"
          },
          {
            "longitude": 117.32676,
            "latitude": 41.003305,
            "radius": 5,
            "business_name": "外婆家",
            "branch_name": "客村店",
            "address": "新港中路123号"
          }
        ],
        "sku_attr_list": [
          {
            "name": "颜色",
            "value": "黑色"
          },
          {
            "name": "码数",
            "value": "XXL"
          }
        ],
        "version": 1200
      },
      "can_be_search": true,
      "brand_info": {
        "logo": "http://xxx.jpg",
        "name": "外婆家"
      }
    }
  ]
}
物品基本字段 必填 字段类型 说明
user_open_id string 用户的openid,参见openid说明
sku_product_list array 单次请求物品数量不可超过10个
sku_product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
title string 物品名称
desc string 物品描述
category_list string array 物品类目列表,用于搜索排序
image_list string array 物品图片链接列表,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
src_wxapp_path string 物品来源小程序路径
attr_list object array 物品SPU属性
sku_info object 物品SKU信息,微信后台会合并多次导入的SKU
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
update_time int 加入购物车的时间,unix 秒级时间戳,不填默认为当前时间
can_be_search bool 物品能否被搜索(默认true可以被搜索)
brand_info object 商家信息
platform_category_list array 物品平台类目列表,填写的每个类目必须在好物圈物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
attr_list字段 必填 字段类型 说明
name string 属性名称
value string 属性内容
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address string 门店地址(不包含省市区信息,如:新港中路123号)
sku_info字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
status int 物品状态,1:在售,2:停售
sku_attr_list object array sku属性列表,参考attr_list
bar_code_info object 物品的条形码信息
platform_category_list字段 必填 字段类型 说明
category_id uint32 平台类目ID
category_name string 平台类目名称
brand_info字段 必填 字段类型 说明
logo string 商家logo
name string 商家名称
bar_code_info字段 必填 字段类型 说明
barcode_type string 条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcode string 条形码数字字符串

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}
错误码 说明
9009099 系统失败
9009202 物品数量超过限制
其他常见错误码 点击查看

 

查询用户收藏信息

开发者可以查询用户在好物圈中指定商家的收藏物品,接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/queryshoppinglist?access_token=ACCESS_TOKEN&type=[batchquery|getbypage]
POST数据格式 UTF-8 json
接口能力 获取用户在好物圈指定商家的收藏物品
接口调用时机 获取用户在好物圈指定商家的收藏物品
type batchquery代表指定item_code批量查询,getbypage代表按页查询

请求数据样例

  • type=batchquery:
    {
    "user_open_id": "user_open_id",
    "key_list":[
      {
        "item_code":"00003563372839_0000xxxxxxxx"
      }, {
        "item_code":"00003563372839_0000xxxxxxxx"
      }
    ]
    }
    
  • type=getbypage:
    {
    "user_open_id": "user_open_id",
    "offset": 0,
    "count": 20
    }
    
物品基本字段 必填 字段类型 说明
user_open_id string 用户的openid
key_list batchquery模式下必填 array 单次请求物品数量不可超过20个
offset string 按页查询时起始位置偏移,默认0
count string 按页查询时单次最大返回数量,默认20
key_list基本字段 必填 字段类型 说明
item_code string 物品的item_code

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
    "goods_list": [{
        "biz_uin": 3506967354,
        "item_code": "00010101010010101010101010alinchiiiii",
        "sku_id": "sku_id2",
        "quantity": 1,
        "create_time": 1557924591,
        "update_time": 1557924591,
        "source": 2,
        "status": 0,
        "title": "product_name_for_test_alinchalinch",
        "from_scene": 1
    }
    ],
}
错误码 说明
0 成功
其他常见错误码 点击查看

 

删除收藏

开发者可以在用户从购物车删除物品时,同步将物品数据从好物圈的收藏中删除,接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/deleteshoppinglist?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 删除好物圈物品
接口调用时机 用户从购物车删除物品

请求数据样例

{
  "user_open_id": "user_open_id",
  "sku_product_list": [
    {
      "item_code": "here_is_spu_id",
      "sku_id": "here_is_sku_id"
    }
  ]
}
物品基本字段 必填 字段类型 说明
user_open_id string 用户的openid,用来指定删除具体用户的好物圈
sku_product_list array 单次请求物品数量不可超过100个
sku_product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}
错误码 说明
9009099 系统失败
9009202 物品数量超过限制
9009203 非法的user_open_id,请检查该openid是否归属该appid
其他常见错误码 点击查看

 

删除用户的所有收藏

开发者可以删除用户在好物圈中指定商家的所有收藏物品,接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/deletebizallshoppinglist?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 删除用户好物圈指定商家的所有收藏物品
接口调用时机 删除用户好物圈指定商家的所有收藏物品

请求数据样例

{
  "user_open_id": "user_open_id",
}
物品基本字段 必填 字段类型 说明
user_open_id string 用户的openid,用来指定删除具体用户的好物圈商家物品

回包数据样例

接口调用成功回包
{
    "del_num":2,
    "errcode":0,
    "errmsg":"success"
}
错误码 说明
9009099 系统失败
9009203 非法的user_open_id,请检查该openid是否归属该appid
其他常见错误码 点击查看

 

物品信息

更新或导入物品信息

开发者可以对好物圈收藏/搜索场景下物品信息进行导入或更新,如上架状态改变、物品售罄、价格更新等。如果物品仅支持到店提货或到家送货,poi_list必填;如果物品同时支持线上物流配送,该字段应为空。

接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importproduct?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 更新或导入物品数据
接口调用时机 新物品、物品信息更新、状态更新

请求数据样例

{
  "product_list": [
    {
      "item_code": "here_is_spu_id",
      "title": "product_name",
      "desc": "product_description",
      "category_list": [
        "服装",
        "上衣",
        "短袖衬衫"
      ],
      "image_list": [
        "image_url1",
        "image_url2"
      ],
      "src_wxapp_path": "/detail?item_code=xxxx",
      "attr_list": [
        {
          "name": "材质",
          "value": "纯棉"
        },
        {
          "name": "款式",
          "value": "短袖"
        },
        {
          "name": "季度",
          "value": "2018年秋"
        }
      ],
      "version": 200,
      "sku_list": [
        {
          "sku_id": "sku_id1",
          "price": 10000,
          "original_price": 20010,
          "status": 1,
          "sku_attr_list": [
            {
              "name": "颜色",
              "value": "白色"
            },
            {
              "name": "码数",
              "value": "L"
            }
          ],
          "version": 1200,
          "poi_list": [
            {
              "longitude": 116.32676,
              "latitude": 40.003305,
              "radius": 4,
              "business_name": "肯德基",
              "branch_name": "珠江新城店",
              "address": "新港中路123号"
            },
            {
              "longitude": 117.32676,
              "latitude": 41.003305,
              "radius": 5,
              "business_name": "肯德基",
              "branch_name": "客村店",
              "address": "新港中路123号"
            }
          ],
          "bar_code_info": {
            "barcode_type": "ean8",
            "barcode": "12345678"
          }
        },
        {
          "sku_id": "sku_id2",
          "price": 10010,
          "status": 1,
          "sku_attr_list": [
            {
              "name": "颜色",
              "value": "黑色"
            },
            {
              "name": "码数",
              "value": "XXL"
            }
          ],
          "poi_list": [
            {
              "longitude": 116.32676,
              "latitude": 40.003305,
              "radius": 4,
              "business_name": "肯德基",
              "branch_name": "珠江新城店",
              "address": "新港中路123号"
            },
            {
              "longitude": 117.32676,
              "latitude": 41.003305,
              "radius": 5,
              "business_name": "肯德基",
              "branch_name": "客村店",
              "address": "新港中路123号"
            }
          ],
          "bar_code_info": {
            "barcode_type": "ean13",
            "barcode": "0123456789123"
          }
        }
      ],
      "platform_category_list": [
        {
          "category_id": 4342,
          "category_name": "运动裤"
        }
      ]
    }
  ]
}
物品基本字段 必填 字段类型 说明
product_list array 单次请求物品数量不可超过10个
product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
title string 物品名称
desc string 物品描述
category_list string array 物品类目列表,用于搜索排序
image_list string array 物品图片链接列表,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
src_wxapp_path string 物品来源小程序路径
attr_list object array 物品SPU属性
sku_list object array 物品SKU列表,单次导入不超过16个SKU,微信后台会合并多次导入的SKU
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
can_be_search bool 物品能否被搜索(默认true可以被搜索)
brand_info object 商家信息
platform_category_list array 物品平台类目列表,填写的每个类目必须在好物圈物品类目表列出,多级类目只填最后一级(如完整类目为"运动户外-运动服饰-运动裤",只需要填"运动裤"的类目ID与类目名)
attr_list字段 必填 字段类型 说明
name string 属性名称
value string 属性内容
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
address string 门店地址(不包含省市区信息,如:新港中路123号)
sku_list字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
status int 物品状态,1:在售,2:停售,3:售罄
sku_attr_list object array sku属性列表,参考attr_list
poi_list object array 物品所在门店的列表。如果物品仅支持到店提货或到家送货,该字段必填;如果物品同时支持线上物流配送,该字段应为空。
bar_code_info object 物品的条形码信息
platform_category_list字段 必填 字段类型 说明
category_id uint32 平台类目ID
category_name string 平台类目名称
brand_info字段 必填 字段类型 说明
logo string 商家logo,不填的话,默认取小程序头像
name string 商家名称,不填的话,默认取小程序名字
bar_code_info字段 必填 字段类型 说明
barcode_type string 条形码类型, 目前支持"ean8", "ean13", 前者对应的barcode为8位纯数字字符串,后者为13位纯数字字符串
barcode string 条形码数字字符串

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看

 

查询物品信息

开发者可以对导入到好物圈中的物品信息进行查询,接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/queryproduct?access_token=ACCESS_TOKEN&type=batchquery
POST数据格式 UTF-8 json
接口能力 查询物品数据
接口调用时机 需要查询已导入好物圈的物品数据时
type batchquery代表批量查询

请求数据样例

{
  "key_list":[
    {
      "item_code":"00003563372839_0000xxxxxxxx"
    }, {
      "item_code":"00003563372839_0000xxxxxxxx"
    }
  ]
}
接口基本字段 必填 字段类型 说明
key_list array 单次请求物品数量不可超过100个
key_list基本字段 必填 字段类型 说明
item_code string 物品item_code
物品基本字段 必填 字段类型 说明
product_list array 单次请求物品数量不可超过10个
product_list字段 必填 字段类型 说明
item_code string 物品ID(SPU ID),要求appid下全局唯一
title string 物品名称
desc string 物品描述
category_list string array 物品类目列表,用于搜索排序
image_list string array 物品图片链接列表
src_wxapp_path string 物品来源小程序路径
attr_list object array 物品SPU属性
sku_list object array 物品SKU列表,单次导入不超过16个SKU,微信后台会合并多次导入的SKU
version int 数据版本号,需按照更新递增,用在并发更新场景
version int 非高并发更新数据的场景不建议填写此字段。数据版本号,需按照更新递增
can_be_search bool 物品能否被搜索(默认true可以被搜索)
brand_info object 商家信息
attr_list字段 必填 字段类型 说明
name string 属性名称
value string 属性内容
poi_list字段 选填 字段类型 说明
longitude double 门店的经度,WGS84标准
latitude double 门店的纬度,WGS84标准
radius double 门店可送达半径,单位km
business_name string 门店名称(仅为商户名,如:国美、麦当劳,不应包含地区、地址、分店名等信息,错误示例:北京国美),20个字符以内
branch_name string 分店名称(不应包含地区信息,不应与门店名有重复,错误示例:北京王府井店),20个字符以内
sku_list字段 必填 字段类型 说明
sku_id string 物品sku_id,特殊情况下可以填入与item_code一致
price int 物品价格,分为单位
original_price int 物品原价,分为单位
version int 数据版本号,需按照更新递增,用在并发更新场景
status int 物品状态,1:在售,2:停售
sku_attr_list object array sku属性列表,参考attr_list
poi_list object array 物品所在门店的列表。如果物品仅支持到店提货或到家送货,该字段必填;如果物品同时支持线上物流配送,该字段应为空。
brand_info字段 必填 字段类型 说明
logo string 商家logo
name string 商家名称

回包数据样例

接口调用成功回包
{
    "errcode": 0,
    "errmsg": "success",
    "product_list": [
        {
            "item_code": "00003563372839_00000xxxxxx",
            "sku_list": [
                {
                    "sku_id": "00003563372839_100xxxxxxx",
                    "sku_attr_list": [],
                    "price": 1,
                    "status": 1,
                    "poi_list": []
                }
            ],
            "title": "xxxxxxx",
            "desc": "",
            "image_list": [
                "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
            ],
            "attr_list": [],
            "category_list": [
                "面部护理套装"
            ],
            "src_wxapp_path": ""
        },
        {
            "item_code": "00003563xxxxxxxxxxxxxxxxxxxxxx",
            "sku_list": [
                {
                    "sku_id": "00003563372839_xxxxxxxxxxxxxxxxx",
                    "sku_attr_list": [
                        {
                            "name": "颜色",
                            "value": "红色"
                        },
                        {
                            "name": "手机型号",
                            "value": "iPhoneX"
                        }
                    ],
                    "price": 1,
                    "status": 1,
                    "poi_list": []
                }
            ],
            "title": "红包拿来手机壳套装",
            "desc": "红色 | iPhoneX",
            "image_list": [
                "https://xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
            ],
            "attr_list": [
                {
                    "name": "手机型号",
                    "value": "iPhoneX"
                },
                {
                    "name": "颜色",
                    "value": "红色"
                }
            ],
            "category_list": [
                "面部护理套装"
            ],
            "src_wxapp_path": ""
        }
    ]
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看

 

小程序的物品是否可被搜索

接入好物圈的小程序默认打开物品搜索,开发者可通过此接口进行调整。当“小程序打开物品搜索”且“物品的状态为可以被搜索”的情况下,小程序的物品可被搜索。

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/brandmanage?action=set_biz_can_be_search&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 设置小程序是否打开物品搜索
接口调用时机 小程序打开或关闭物品搜索时

请求数据样例

{
    "can_be_search": "true"
}
基本字段 必填 字段类型 说明
can_be_search bool 是否打开物品搜索,默认为true(即打开)

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看

 

更新或导入媒体信息

开发者可以对好物圈收藏/搜索场景下媒体(音频、视频)信息进行导入或更新。

接口说明如下:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importmedia?access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 导入或更新媒体数据
接口调用时机 导入新媒体、媒体信息更新

请求数据样例

{
  "media_list": [
    {
      "item_code": "here_is_spu_id",
      "title": "media_name",
      "desc": "media_description",
      "image_list": [
        "image_url1",
        "image_url2"
      ],
      "src_wxapp_path": "/detail?item_code=xxxx",
      "media_info":{"type": 1, "play_url":"www.qq.music.com/test.mp3"}
    }
  ]
}
物品基本字段 必填 字段类型 说明
media_list array 单次请求媒体数量不可超过10个
media_list字段 必填 字段类型 说明
item_code string 媒体ID,需要保证唯一性
title string 媒体名称,如歌曲名、视频标题
desc string 媒体描述,如歌手名、视频描述
image_list string array 物品图片链接列表,图片宽度必须大于750px,宽高比建议4:3 - 1:1之间
src_wxapp_path string 媒体来源小程序路径
media_info object 媒体的播放信息
media_info字段 必填 字段类型 说明
type int 区分视频还是音乐, 1代表音频类, 2代表视频类
play_url string 媒体的播放url

回包数据样例

接口调用成功回包
{
    "errcode":0,
    "errmsg":"success"
}

接口错误码

回包错误码 说明
0 成功
其他常见错误码 点击查看

 

推荐接口

开发者可以在订单详情页、商品详情页或其他合适的场景使用推荐接口,用户可以直接将物品推荐到好物圈。

小程序接入可参考《好物推荐插件开发文档》《好物推荐API开发文档》

H5接入可参考《好物推荐JSSDK开发文档》

好物圈开发文档

 

测试流程

导入订单测试数据

接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/importorder?action=add-order&is_test=1&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 导入订单数据
接口调用时机 用户完成支付
其他说明 如果订单中的物品为首次导入,订单中的物品信息会该物品的初始化信息

具体请求参数和输入输出参考导入订单

测试接口说明

  • 接口导入成功后,可以让openid对应微信用户进入好物圈入口,查看订单数据,验证导入结果。
  • 导入之后,仅有该订单openid对应的用户可以搜索到对应的物品数据。
  • 同时该订单对应的物品会被标记为测试数据,不会被其他用户搜索发现。
  • 如果需要让物品数据能被所有人搜索发现,可以调用更新或导入物品信息接口,将can_be_search字段更新为true。

 

导入收藏测试数据

接口说明:

接口调用基本信息 说明
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/addshoppinglist?is_test=1&access_token=ACCESS_TOKEN
POST数据格式 UTF-8 json
接口能力 同步用户添加物品到好物圈
接口调用时机 用户添加物品到购物车

具体请求参数和输入输出参考导入收藏

测试接口说明

  • 接口导入成功后,可以让openid对应微信用户进入好物圈入口,查看收藏数据,验证导入结果。
  • 同时该收藏对应的物品会被标记为测试数据,不会被其他用户搜索发现。
  • 如果需要让物品数据能被所有人搜索发现,可以调用更新或导入物品信息接口,将can_be_search字段更新为true。

 

搜索测试数据

通过导入订单测试数据导入收藏测试数据的相应接口,可以把测试数据导入用户的好物圈。

然后测试数据对应的用户可以在小程序搜索的入口,通过输入物品词,搜索到对应的物品。(目前导入之后到搜索会有几分钟的延时。)

目前搜索仅支持带有微信支付订单(含transid,正式环境会校验,乱填会面临惩罚)导入的物品。

 

附录

新用户教育示例

为了方便用户找到好物圈并管理自己的订单和购物车物品,开发者须在小程序中增加用户教育指引。

1. 用户教育示例

开发者可以在购物车列表页、订单列表页及订单详情页增加好物圈标识及用户教育页,包括好物圈名称、logo及说明文案,如下图: 好物圈开发文档

2. 素材规范

为了统一用户对好物圈的认知,方便开发者接入,请使用以下标准素材:

a. 文案:已同步至好物圈

b. 好物圈logo:点击下载

c. 教育页路径:使用小程序<wx.navigateToMiniProgram>组件进行跳转。

appid:wx56c8f077de74b07c
path:/open/function-introduction/function-introduction

注:开发者需要在代码中将"wx56c8f077de74b07c"添加到跳转小程序名单。详情

 

场景值

从好物圈相关场景打开第三方小程序落地页,我们会在页面参数中加上wxShoppingListScene参数,其定义如下:

场景值ID 说明
10001 好物圈-收藏列表
10002 好物圈-朋友的推荐列表
10003 好物圈-订单列表
10004 好物圈-物品搜索
10005 好物圈-大家买过
10006 好物圈-圈组
20001 微信搜索-好物圈物品
20002 微信搜索-品牌官方区物品区域
20003 微信搜索-品牌官方区更多物品列表
20004 微信搜索-品牌官方主页物品区域
20005 微信搜索-品牌官方主页更多物品列表

获取方式

落地页的page页面onLoad回调函数,通过 options.wxShoppingListScene可获取到

 

常见错误码

好物圈相关接口都可能出现的常见返回码。

回包错误码 说明
0 成功
48001 api未授权,需要已认证的小程序帐号才有相应接口权限。
61007 通过第三方平台接入时,需要先授权第三方平台相关权限集合
9009099 系统错误
9009098 请求参数错误,详细错误提示请参考json回包中的errmsg字段。
9009203 非法的user_open_id,请检查该openid是否归属该appid
9009204 小程序类目不符合要求。详情查看
9009205 调用帐号需为已上线、已认证小程序帐号。
9009206 非法的请求帐号,有疑问请联系客服。

 

openid说明

openid是微信用户在公众帐号(包括小程序)、H5、APP下的唯一标识。每个应用都有一个appid,不同的appid,对应的openid不同。

对于好物圈的user_open_id字段,跟导入数据的小程序绑定在同一个微信开放平台帐号的公众帐号(包括小程序)、H5、APP对应的openid均可传入。

 

好物圈物品类目表

点此下载

说明:

  • 每一行表示一个完整的多级类目,行首列为该完整类目的ID。
  • 每个物品可以属于多个完整类目。
  • 调用接口传入物品类目信息时,只需要传叶节点类目(最后一级)名称与该行完整类目的ID。例如,一个物品所属的完整类目为“运动户外-运动服饰-运动裤”,则该物品的类目字段需填写为:
    {
      // ...
      "platform_category_list": [
      {
          "category_id": 4342,
          "category_name": "运动裤"
      },
      // 物品所属的其他完整类目
      ]
      // ...
    }
    

注意:

  • 请严格按照类目表及接口规范填写物品类目,如发现错填、漏填等情况,将根据《好物圈行为规范及处罚规则》进行相应处理。
  • 如需申请新增类目,请发送小程序名称及AppID、商品名称及商品详情页截图、商标注册证(R标)发送至 WeChatBrandMall@tencent.com。申请前请确保现有类目表中没有相同或相似类目,申请信息和资质真实有效,一旦发现重复申请或信息虚假,将影响小程序接入好物圈。

 

快递公司信息

目前支持的快递公司及其对应的编号如下:

快递公司编号字段 快速公司名字字段
2000 EMS
2001 圆通
2002 DHL
2004 中通
2005 韵达
2006 畅灵
2008 百世汇通
2009 德邦
2010 申通
2011 顺丰速运
2012 顺兴
2014 如风达
2015 优速
9999 其他快递公司名字(例如:京东物流)