微信开发(微信扫一扫)商品创建

微信公众平台开放“扫一扫”功能,同时开放相关接口供有权限的品牌所有者调用。接口支持创建、管理并发布品牌所有者的商品信息,品牌所有者可选择商品条码发布。微信同时提供多种事件推送,帮助品牌所有者实现精准运营、数据分析等能力。

扫一扫接口主要调用流程如下: 

 扫一扫主要流程1.png

权限获取

扫一扫功能申请只能在公众平台上完成,功能申请开通后将直接获得接口权限。权限包括:商品经营类目权限、商品条码号段权限。创建商品时只能使用拥有权限的类目。

术语含义说明

术语概念含义
品牌所有者也称商户、商家,是指合法拥有品牌的企业。可以申请“扫一扫”功能。
扫码使用微信“扫一扫”扫描条码。
条码扫一扫支持录入的条码类型为EAN13和EAN8,国内常见的EAN13条码是以69开头的13位条码,前7~9位数字标记该条码的生产企业,被称为号段;最后一位为校验位,由前面的12位位数字计算得出,码方式可参考国标GB-12094-1998。
号段条码号段为EAN13码的前7~9位,用于确认厂商信息,保护品牌的相关权益。申请“扫一扫”权限时需提供对应资质。特别地,ENA8码的号段为其本身。
商品主页通过微信“扫一扫”,在微信客户端内打开,由品牌商定义的商品信息页。
商品详情通过点击“商品主页”头部区域,在跳转后的页面展示,由品牌商设置的商品详细信息。包括多组商品图片,多组文字描述。
购买区入口位于商品主页上部,点击后集中展示品牌商设置的“建议零售价”、“微信小店”、“电商链接”以及匹配到的“电商渠道”等入口和其对应价格。
推广服务区位于商品主页中部,提供多媒体展示、文本介绍、跳转外部链接、关注公众号、领取微信卡券等多种自定义能力。
组件区包括在“商品主页”打开前展示的弹窗页,以及位于“商品主页”下部的区域。用于快速突出展示该主页的核心信息,如防伪信息等。
相关商品推荐位于商品主页底部,展示由品牌商设置推荐的其他商品主页。
“商品主页”术语概念对照图:

商品主页示例.jpg

商品创建

获取商户信息

使用该接口,商户可获取账号下的类目与号段等信息。

请求示例

HTTP请求方式:GET
https://api.weixin.qq.com/scan/merchantinfo/get?access_token=TOKEN

请求参数说明

参数是否必须说明
access_token公众号的全局凭据,用于接口调用。

返回示例

正确的JSON返回结果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "verified_cate_list":[
  {
   "verified_cate_id": 200531967,
   "verified_cate_name": "调味品"
  }
 ],
 "verified_firm_code_list":[8888],
 "brand_tag_list":[
  "小耿哥8",
  "testtag"
 ]
}

返回参数说明

参数是否必须
errcode0为调用成功,否则返回相关错误码。
errmsgok为调用成功,否则返回错误提示。
verified_cate_id_list商户类目列表,包含类目ID与对应的类目名称。
verified_cate_id商户类目ID,表示该账户下可用于创建商品的类目ID。
verified_cate_name商户类目名称,对应类目ID的名称。
verified_firm_code_list商户号段列表,包含该账户下有资质的条码号段。
brand_tag_list品牌标签列表,创建商品时传入,商户自定义生成的品牌标识字段。

注意:商户容易忽略verified_cate_id,导致下一步商品创建失败。

创建商品

使用该接口,商户可以创建商品信息,设置商品主页。目前,一个账号最多支持创建10万条商品信息。

请求示例

HTTP请求方式:POST
https://api.weixin.qq.com/scan/product/create?access_token=tT8VqJWVX4C-WvIG41tyelMclMZsAPFbLxbECsJvIghceqQCMB83hI5bxcInUR-amUrVsKq4bcBmF9PgooNrFA 
POST数据格式:JSON
POST数据例子:
{
 "keystandard": "ean13",
 "keystr": "6900000000000",
 "brand_info":{
  "base_info":{
   "title": "扫一扫动态主页demo",
"thumb_url":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNrX6Yrvd7LzKERyic3kn3VdSsmFr5F5ibXzj9Al65yWFudmjqcWic1Qe9g/0",
   "brand_tag": "小耿哥8",
   "category_id": 0,
   "store_mgr_type": "auto",
   "store_vendorid_list":[],
   "color": "auto",
  },
  "detail_info":{
   "banner_list":[
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNic0LvlkCw7s6mZpicib7ict5MhoiaL3gPrYXpibnibOpViaYJFpic12nx4bNZcQ/0"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0"}
   ],
   "detail_list":[
    {
     "title": "产品名称",
     "desc": "微信相框moment"
    },
    {
     "title": "设计团队",
     "desc": "微信团队"
    },
    {
     "title": "设计初衷",
     "desc": "做一个简单纯粹的电子相框"
    },
    {
     "title": "产品诉求",
     "desc": "以相框为纽带,增加子女与父母长辈的沟通,用照片通过微信传递感情交流"
    }
   ]
  },
  "action_info":{
   "action_list":[
    {
     "type": "price",
     "retail_price":"12.00"
    },
    {
     "type": "link",
     "name": "banner",
     "link": "http://mp.weixin.qq.com",
"image":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNgjXTKn0j4TlfXjUOPYBDicVOmG0sdNfUOg9Lzia2g9cbjyTXmOiaB6L1g/0",
     "showtype": "banner"
    },
    {
     "type": "link",
     "name": "自定义活动1",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "link",
     "name": "自定义活动2",
     "link": "http://p.url.cn/wxscan.php",
    },
    {
     "type": "user"
    },
    {
     "type": "text",
     "text": "此处可根据品牌商需要,用于简单描述商品或活动。"
    }
   ]
  },
  "module_info":{
   "module_list":[
    {
     "type": "anti_fake",
     "native_show": "fales",
     "anti_fake_url": "weixin.qq.com"
    }
   ]
  }
 }
}

请求参数说明

POST的主要结构为brand_info,包含商品基本信息base_info、商品详情信息detail_info、推广服务信息action_info和组件信息module_info四部分

商品主页示例2.png
参数是否必须说明
access_token公众号的全局凭据,用于接口调用。
keystandard商品编码标准,暂时只支持ean13和ean8两种标准。
keystr商品编码内容。直接填写商品条码,如“6900000000000”;注意:编码标准是ean13时,编码内容必须在商户的号段之下,否则会报错。
base_info商品的基本信息。
detail_info商品的详细描述信息。
action_info商品的推广服务区信息。
module_info商品的组件信息。

base_info部分

参数是否必须说明
title商品名称,建议不超过15个字,超过部分在客户端上以省略号显示。
thumb_url商品缩略图,推荐尺寸为180px*180px,大小不超过50k,支持jpg、png、gif、jpeg格式。
brand_tag品牌字段,如“宝洁海飞丝”、“宝洁飘柔”。
category_id商品类目ID,通过“获取商户信息”接口获取。
store_mgr_type是否展示有该商品的电商渠道,识别条件是编码内容。auto为自动,由微信识别展示渠道;custom为自定义,商户可指定store_vendorid_list内的渠道出现。
store_vendorid_list电商渠道,如果store_mgr_type为custom,则可从以下电商渠道进行选择:2为亚马逊,3为当当网,4为京东,9为一号店,11为聚美优品,19为酒仙网
color主页头部背景色。设置“auto”或不填则自动取色;也支持传入十六进制颜色码自定义背景色。比如,“FFFFFF”代表纯白色。注意:颜色码不识别大小写,也不需要传入“#”

detail_info部分

参数是否必须说明
banner_list商品详情页中可设置多张图片。
link商品详情页顶端横幅图片,640px*320px,单张≤200k,支持jpg、png、gif、jpeg格式,最多可上传6张。
detail_list商品详情页中可设置多组商品属性。
title商品详情页中商品属性名称,≤6个汉字。
desc商品详情页中商品属性内容,≤80个汉字。

action_info部分

参数是否必须说明
action_list商品主页中可设置多个服务栏。
type服务栏的类型,Media,视频播放;Text,文字介绍;Link,图片跳转;Link,普通链接;User,公众号;Card,微信卡券;Price,建议零售价;Product,微信小店;Store,电商链接;recommend,商品推荐。

类型:视频播放

参数是否必须说明
type服务栏类型,视频类型的参数值为"media"。
link对应的视频链接,仅支持在v.qq.com上传的视频内容,格式请按JSON示例拼接。
image对应视频的封面,推荐尺寸690px*320px,大小不超过200k,支持jpg、png、gif、jpeg格式。

类型:文字介绍

参数是否必须示例值说明
typetext服务栏类型。
name商品介绍对应文字介绍的标题。
text此处可根据品牌商需要,用于简单描述商品或活动。对应文字介绍的内容。

类型:图片跳转

参数是否必须说明
type服务栏类型,图片跳转类型的参数值为"link"。
link对应图片跳转后的网页链接。
image对应跳转入口的图片链接,请参考JSON示例。
showtype值为banner,设置图片跳转类型的服务栏时必填。

类型:普通链接

参数是否必须示例值说明
typelink服务栏类型。
name查看官网链接入口的名称,不超过12个汉字。
linkhttp://www.qq.com对应跳转后的网页链接。
digest点击查看服务栏右侧的引导语,不超过5个汉字。

类型:公众号

参数是否必须示例值说明
typeuser服务栏类型。

类型:微信卡券

参数是否必须示例值说明
typecard服务栏类型。
cardidpbLatjlZyVY2XCKfIDULuD_J_PKI卡券必须为非自定义code(概念说明见微信卡券接口文档)。
digest全场通用服务栏右侧的引导语,不超过5个汉字。

类型:建议零售价

参数是否必须示例值说明
typeprice服务栏类型。
retail_price12.00表示商品的建议零售价,以“元”为单位。

类型:微信小店

参数是否必须示例值说明
typeproduct服务栏类型。
name官网商城微信小店入口的名称。
productidpLHCTjvXB6vIqUYUn51AWsK-sKA8对应小店商品的id,需保证有效。
digest限时折扣服务栏右侧的引导语,不超过5个汉字。

类型:电商链接

参数是否必须示例值说明
typestore服务栏类型。
name京东商城电商入口的名称。
linkhttp://m.jd.com/product/14091549.html对应电商的链接,建议是可以直接购买该商品的页面。
sale_price12.50对应商品的价格,单位元。

类型:商品推荐

参数是否必须说明
type服务栏类型,商品推荐的值为recommende。
recommend_type表示商品推荐的方式,目前只支持指定,值为appointed。
recommend_list表示指定要推荐的商品列表
keystandard表示被推荐的商品编码格式。
keystr表示被推荐商品的编码内容。

“商品推荐”的JSON示例:

{
 "type": "recommend",
 "recommend": {
  "recommend_type": "appointed",
  "recommend_list": [
   {
    "keystandard": "ean13",
    "keystr": "6900000000001"
   },
   {
    "keystandard": "ean13",
    "keystr": "6900873042720"
   }
  ]
 }
}

module_info部分

参数是否必须说明
module_list未来可设置多个组件,目前仅支持防伪组件。
type组件的类型,目前仅包括防伪组件anti_fake。
native_show设置为true时,防伪结果使用微信提供的弹窗页面展示,商户仅需调用“商品管理”部分的组件消息接口回传产品真假信息。设置为false时,无防伪弹窗效果。
anti_fake_url商户提供的防伪查询链接,当native_show设置为false时必填。

注意:

1、推广服务区action_info部分,入口数量规则如下:

1)至少设置一个推广类型;

2)文字介绍、公众号和微信卡券三种推广类型,每种类型最多只能分别设置1个;

3)普通链接、公众号、微信卡券三种类型合计最多设置3个;

4)图片跳转链接和视频播放只能二选一展示;

2、商品主页中必须存在至少一个价格信息,价格的展示渠道有四种:

1)在base_info中定义store_mgr_type和store_vendorid_list字段。如果商品在设置的电商渠道有销售,则会有售卖入口在【购买区】展示。例如:“洋河-天之蓝 480ml”在“京东商城”有销售,假设京东商城又在该商品设置的电商渠道列表中,则会有“京东商城”的售卖入口出现。

2)在微信小店(Product)类型中设置productid,购买区将出现对应商品的微信小店售卖入口。

3)在电商链接(Store)类型中设置目标地址链接(link),购买区将出现所配置的外部商城售卖入口。

4)在建议零售价(Price)类型中设置retail_price字段。如果商品没有设置前文所述的任何一种购买渠道,也会有该商品建议零售价展示。

返回示例

正确的JSON返回结果如下:

{
 "errcode": 0,
 "errmsg": "ok",
 "pid": "5g0B4A90aqc"
}

返回参数说明

参数说明
errcode0为调用成功,否则返回相关错误码。
errmsgok为调用成功,否则返回错误提示。
pid转译后的商品id,在微信系统内唯一区分一个商品。





©️2020 CSDN 皮肤主题: 书香水墨 设计师:CSDN官方博客 返回首页