微信上進行商品創建


商品建立

#

取得商家資訊

使用該接口，商家可取得帳號下的類目與號段等資訊。

請求範例

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

請求參數說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。

傳回範例

正確的JSON回傳結果如下：

{
 "errcode": 0,
 "errmsg": "ok",
 "brand_tag_list":[
  "小耿哥8",
  "testtag"
 ],
 "verified_list": [
  {
   "verified_firm_code": 69300570, 
   "verified_cate_list": [
    {
     "verified_cate_id": 538071212, 
     "verified_cate_name": "食品/茶叶/特产/滋补品"
     }
    ]
   }, 
   {
    "verified_firm_code": 123, 
    "verified_cate_list": [
     {
      "verified_cate_id": 538071212, 
      "verified_cate_name": "食品/茶叶/特产/滋补品"
     }
    ]
   }
  ] 
 }

傳回參數說明

verified_cate_id商家類別目名稱，對應類別目ID的名稱
參數說明
#errcode0為呼叫成功，否則傳回相關錯誤碼。
errmsgok為呼叫成功，否則回傳錯誤提示。
brand_tag_list品牌標籤列表，建立商品時傳入，商家自訂產生的品牌識別欄位。
verified_list權限列表，包含商家號段、類別目ID、類別目名稱三者的對應關係。
verified_firm_code#商家編號段，表示該商家下有資質的條碼號段。
verified_cate_list商戶類別目列表，包含類別目ID與對應的類別目名稱。
verified_cate_id
#verified_cate_name
######

注意：商家容易忽略verified_cate_id，導致下一步商品建立失敗。

建立商品

使用該接口，商家可以建立商品訊息，設定商品首頁，支援條碼和二維碼兩種類型。目前，一個帳號最多支援創建10萬個商品資訊。

請求範例

HTTP请求方式：POSThttps://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",
"desc": "微信相框"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNbTfwJmlVXp9k1A80UCFL1a9icwdthmSLh0RuJ5iaKcZBwdXbOicktkwPQ/0",
"desc": "微信相框"},
{"link":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNW4FD74oXjEyqHicE9U3H0nTCdLHibo7rRia2TFBQ6tx2Pvic92ica8Wns4Q/0",
"desc": "微信相框"}
   ],
   "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四部分。

微信扫一扫请求参数


#
參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
keystandard是商品編碼標準，支援ean13、ean8和qrcode標準。
keystr是

商品編碼內容。直接填寫商品條碼，

標準為ean13，則直接填寫商品條碼，如「6901939621608」。

標準是qrcode，二維碼的內容可由商家自定義，建議使用商品條碼，≤20個字符，由大小字母、數字、底線和連字符組成。

注意：編碼標準是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為酒仙網
否
##################################################### #首頁頭部背景色。設定「auto」或不填則自動取色；也支援傳入十六進位顏色碼自訂背景色。例如，「FFFFFF」代表純白色。 ###注意：顏色碼不辨識大小寫，也不需要傳入「#」###############

detail_info部分

#
參數是否必須說明
#banner_list是商品詳情頁中圖文詳情可設定多張圖片。
link是商品詳情頁中圖文詳情的圖片，640px*320px，單張≤200k，支援jpg、png、 gif、jpeg格式，最多可上傳6張。
desc否商品詳情頁中圖文詳情的描述，≤80個漢字。
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格式。

類型：文字介紹

參數是否必須範例值 #說明
type是text服務列類型。
name否商品介紹對應文字介紹的標題。
text是此處可依品牌商需要，用於簡單描述商品或活動。 對應文字介紹的內容。

類型：圖片跳轉

參數是否必須
#type是服務列類型，圖片跳躍類型的參數值為"link"。
link是對應圖片跳轉後的網頁連結。
image是對應跳轉入口的圖片鏈接，請參考JSON範例。
showtype是值為banner，設定圖片跳轉類型的服務列時必填。

類型：普通連結

#
參數是否必須範例值說明
type是link服務列類型。
name是查看官網連結入口的名稱，不超過12個漢字。
link是http://www.qq.com對應跳轉後的網頁連結。
digest否點擊查看服務列右邊的引導語，不超過5個漢字。

類型：公眾號碼

#參數是否必須範例值說明
type#是user服務列類型。

類型：微信卡券

參數是否必須範例值說明
type是card服務列類型。
cardid是pbLatjlZyVY2XCKfIDULuD_J_PKI卡券必須為非自訂code（概念說明請參閱微信卡券介面文件）。
digest否全場通用服務列右邊的引導語，不超過5個漢字。

類型：建議零售價

#說明type是price服務列類型。 retail_price是12.00#表示商品的建議零售價，以「元」為單位。
參數是否必須範例值
#########

類型：微信小店

參數是否必須範例值說明
type是product服務列類型。
name是官網商城微信小店入口的名稱。
productid是pLHCTjvXB6vIqUYUn51AWsK-sKA8#對應小店商品的id，需保證有效。
digest否限時折扣服務列右邊的引導語，不超過5個漢字。

類型：電商連結

#
參數是否必須範例值說明
type是store服務列類型。
name是京東商城電商入口的名稱。
link是http://m.jd.com/product/14091549.html對應電商的鏈接，建議是可以直接購買該商品的頁面。
sale_price是12.50#對應商品的價格，單位元。

類型：商品推薦

###keystandard#是表示被推薦的商品編碼格式。 keystr是表示被推薦商品的編碼內容。

「商品推薦」的JSON範例：

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

module_info部分

參數是否必須說明
type是服務列類型，商品建議的值為recommende。
recommend_type是表示商品推薦的方式，目前只支援指定，值為appointed。
recommend_list是表示指定要推薦的商品清單
##未來可設定多個元件，目前僅支援防偽組件。 type否元件的類型，目前僅包含防偽元件anti_fake。 native_show否設定為true時，防偽結果使用微信提供的彈窗頁面展示，商家只需呼叫“商品管理”部分的組件訊息介面回傳產品真假訊息。設定為false時，無防偽彈窗效果。
參數是否必須說明
#module_list
#########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，將直接編入「取得商品二維碼介面」回傳的二維碼內容。