微信公眾平臺開放“掃一掃”功能，同時開放相關介面供有許可權的品牌所有者呼叫。介面支援建立、管理併發布品牌所有者的商品資訊，品牌所有者可選擇商品條碼釋出。微信同時提供多種事件推送，幫助品牌所有者實現精準運營、資料分析等能力。

掃一掃介面主要呼叫流程如下： 

許可權獲取

掃一掃功能申請只能在公眾平臺上完成，功能申請開通後將直接獲得介面許可權。許可權包括：商品經營類目許可權、商品條碼號段許可權。建立商品時只能使用擁有許可權的類目。

術語含義說明

商品建立

獲取商戶資訊

使用該介面，商戶可獲取賬號下的類目與號段等資訊。

請求示例

HTTP請求方式：GET
https://api.weixin.qq.com/scan/merchantinfo/get?access_token=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"
 ]
}

返回引數說明

注意：商戶容易忽略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四部分。

base_info部分

detail_info部分

action_info部分

型別：視訊播放

型別：文字介紹

型別：圖片跳轉

型別：普通連結

型別：公眾號

型別：微信卡券

型別：建議零售價

型別：微信小店

型別：電商連結

型別：商品推薦

“商品推薦”的JSON示例：

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

module_info部分

注意：

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"
}

返回引數說明