微信上進(jìn)行商品創(chuàng)建

2019-03-14 11:49 更新

商品創(chuàng)建

獲取商戶信息

使用該接口,商戶可獲取賬號下的類目與號段等信息。

請求示例

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

請求參數(shù)說明

參數(shù)是否必須說明
access_token公眾號的全局憑據(jù),用于接口調(diào)用。

返回示例

正確的JSON返回結(jié)果如下:

{
 "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": "食品/茶葉/特產(chǎn)/滋補(bǔ)品"
     }
    ]
   }, 
   {
    "verified_firm_code": 123, 
    "verified_cate_list": [
     {
      "verified_cate_id": 538071212, 
      "verified_cate_name": "食品/茶葉/特產(chǎn)/滋補(bǔ)品"
     }
    ]
   }
  ] 
 }

返回參數(shù)說明

參數(shù)說明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
brand_tag_list品牌標(biāo)簽列表,創(chuàng)建商品時(shí)傳入,商戶自定義生成的品牌標(biāo)識字段。
verified_list權(quán)限列表,包含商戶號段、類目ID、類目名稱三者的對應(yīng)關(guān)系。
verified_firm_code商戶號段,表示該商戶下有資質(zhì)的條碼號段。
verified_cate_list商戶類目列表,包含類目ID與對應(yīng)的類目名稱。
verified_cate_id商戶類目ID,表示該商戶下可用于創(chuàng)建商的類目ID
verified_cate_name商戶類目名稱,對應(yīng)類目ID的名稱

注意:商戶容易忽略verified_cate_id,導(dǎo)致下一步商品創(chuàng)建失敗。

創(chuàng)建商品

使用該接口,商戶可以創(chuàng)建商品信息,設(shè)置商品主頁,支持條碼和二維碼兩種類型。目前,一個(gè)賬號最多支持創(chuàng)建10萬條商品信息。

請求示例

HTTP請求方式:POSThttps://api.weixin.qq.com/scan/product/create?access_token=tT8VqJWVX4C-WvIG41tyelMclMZsAPFbLxbECsJvIghceqQCMB83hI5bxcInUR-amUrVsKq4bcBmF9PgooNrFA POST數(shù)據(jù)格式:JSON
POST數(shù)據(jù)例子:
{
 "keystandard": "ean13",
 "keystr": "6900000000000",
 "brand_info":{
  "base_info":{
   "title": "掃一掃動態(tài)主頁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": "產(chǎn)品名稱",
     "desc": "微信相框moment"
    },
    {
     "title": "設(shè)計(jì)團(tuán)隊(duì)",
     "desc": "微信團(tuán)隊(duì)"
    },
    {
     "title": "設(shè)計(jì)初衷",
     "desc": "做一個(gè)簡單純粹的電子相框"
    },
    {
     "title": "產(chǎn)品訴求",
     "desc": "以相框?yàn)榧~帶,增加子女與父母長輩的溝通,用照片通過微信傳遞感情交流"
    }
   ]
  },
  "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": "此處可根據(jù)品牌商需要,用于簡單描述商品或活動。"
    }
   ]
  },
  "module_info":{
   "module_list":[
    {
     "type": "anti_fake",
     "native_show": "fales",
     "anti_fake_url": "weixin.qq.com"
    }
   ]
  }
 }
}

請求參數(shù)說明

POST的主要結(jié)構(gòu)為brand_info,包含商品基本信息base_info、商品詳情信息detail_info、推廣服務(wù)信息action_info和組件信息module_info四部分。

微信掃一掃請求參數(shù)


參數(shù)是否必須說明
access_token公眾號的全局憑據(jù),用于接口調(diào)用。
keystandard商品編碼標(biāo)準(zhǔn),支持ean13、ean8和qrcode標(biāo)準(zhǔn)。
keystr

商品編碼內(nèi)容。直接填寫商品條碼,

標(biāo)準(zhǔn)是ean13,則直接填寫商品條碼,如“6901939621608”。

標(biāo)準(zhǔn)是qrcode,二維碼的內(nèi)容可由商戶自定義,建議使用商品條碼,≤20個(gè)字符,由大小字母、數(shù)字、下劃線和連字符組成。

注意:編碼標(biāo)準(zhǔn)是ean13時(shí),編碼內(nèi)容必須在商戶的號段之下,否則會報(bào)錯(cuò)。

base_info商品的基本信息。
detail_info商品的詳細(xì)描述信息。
action_info商品的推廣服務(wù)區(qū)信息。
module_info商品的組件信息。

base_info部分

參數(shù)是否必須說明
title商品名稱,建議不超過15個(gè)字,超過部分在客戶端上以省略號顯示。
thumb_url商品縮略圖,推薦尺寸為180px*180px,大小不超過50k,支持jpg、png、gif、jpeg格式。
brand_tag品牌字段,如“寶潔海飛絲”、“寶潔飄柔”。
category_id商品類目ID,通過“獲取商戶信息”接口獲取。
store_mgr_type是否展示有該商品的電商渠道,識別條件是編碼內(nèi)容。auto為自動,由微信識別展示渠道;custom為自定義,商戶可指定store_vendorid_list內(nèi)的渠道出現(xiàn)。
store_vendorid_list電商渠道,如果store_mgr_type為custom,則可從以下電商渠道進(jìn)行選擇:2為亞馬遜,3為當(dāng)當(dāng)網(wǎng),4為京東,9為一號店,11為聚美優(yōu)品,19為酒仙網(wǎng)
color主頁頭部背景色。設(shè)置“auto”或不填則自動取色;也支持傳入十六進(jìn)制顏色碼自定義背景色。比如,“FFFFFF”代表純白色。注意:顏色碼不識別大小寫,也不需要傳入“#”

detail_info部分

參數(shù)是否必須說明
banner_list商品詳情頁中圖文詳情可設(shè)置多張圖片。
link商品詳情頁中圖文詳情的圖片,640px*320px,單張≤200k,支持jpg、png、gif、jpeg格式,最多可上傳6張。
desc商品詳情頁中圖文詳情的描述,≤80個(gè)漢字。
detail_list商品詳情頁中可設(shè)置多組商品屬性。
title商品詳情頁中商品屬性名稱,≤6個(gè)漢字。
desc商品詳情頁中商品屬性內(nèi)容,≤80個(gè)漢字。

action_info部分

參數(shù)是否必須說明
action_list商品主頁中可設(shè)置多個(gè)服務(wù)欄。
type服務(wù)欄的類型,Media,視頻播放;Text,文字介紹;Link,圖片跳轉(zhuǎn);Link,普通鏈接;User,公眾號;Card,微信卡券;Price,建議零售價(jià);Product,微信小店;Store,電商鏈接;recommend,商品推薦。

類型:視頻播放

參數(shù)是否必須說明
type服務(wù)欄類型,視頻類型的參數(shù)值為"media"。
link對應(yīng)的視頻鏈接,僅支持在v.qq.com上傳的視頻內(nèi)容,格式請按JSON示例拼接。
image對應(yīng)視頻的封面,推薦尺寸690px*320px,大小不超過200k,支持jpg、png、gif、jpeg格式。

類型:文字介紹

參數(shù)是否必須示例值說明
typetext服務(wù)欄類型。
name商品介紹對應(yīng)文字介紹的標(biāo)題。
text此處可根據(jù)品牌商需要,用于簡單描述商品或活動。對應(yīng)文字介紹的內(nèi)容。

類型:圖片跳轉(zhuǎn)

參數(shù)是否必須說明
type服務(wù)欄類型,圖片跳轉(zhuǎn)類型的參數(shù)值為"link"。
link對應(yīng)圖片跳轉(zhuǎn)后的網(wǎng)頁鏈接。
image對應(yīng)跳轉(zhuǎn)入口的圖片鏈接,請參考JSON示例。
showtype值為banner,設(shè)置圖片跳轉(zhuǎn)類型的服務(wù)欄時(shí)必填。

類型:普通鏈接

參數(shù)是否必須示例值說明
typelink服務(wù)欄類型。
name查看官網(wǎng)鏈接入口的名稱,不超過12個(gè)漢字。
linkhttp://www.qq.com對應(yīng)跳轉(zhuǎn)后的網(wǎng)頁鏈接。
digest點(diǎn)擊查看服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。

類型:公眾號

參數(shù)是否必須示例值說明
typeuser服務(wù)欄類型。

類型:微信卡券

參數(shù)是否必須示例值說明
typecard服務(wù)欄類型。
cardidpbLatjlZyVY2XCKfIDULuD_J_PKI卡券必須為非自定義code(概念說明見微信卡券接口文檔)。
digest全場通用服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。

類型:建議零售價(jià)

參數(shù)是否必須示例值說明
typeprice服務(wù)欄類型。
retail_price12.00表示商品的建議零售價(jià),以“元”為單位。

類型:微信小店

參數(shù)是否必須示例值說明
typeproduct服務(wù)欄類型。
name官網(wǎng)商城微信小店入口的名稱。
productidpLHCTjvXB6vIqUYUn51AWsK-sKA8對應(yīng)小店商品的id,需保證有效。
digest限時(shí)折扣服務(wù)欄右側(cè)的引導(dǎo)語,不超過5個(gè)漢字。

類型:電商鏈接

參數(shù)是否必須示例值說明
typestore服務(wù)欄類型。
name京東商城電商入口的名稱。
linkhttp://m.jd.com/product/14091549.html對應(yīng)電商的鏈接,建議是可以直接購買該商品的頁面。
sale_price12.50對應(yīng)商品的價(jià)格,單位元。

類型:商品推薦

參數(shù)是否必須說明
type服務(wù)欄類型,商品推薦的值為recommende。
recommend_type表示商品推薦的方式,目前只支持指定,值為appointed。
recommend_list表示指定要推薦的商品列表
keystandard表示被推薦的商品編碼格式。
keystr表示被推薦商品的編碼內(nèi)容。

“商品推薦”的JSON示例:

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

module_info部分

參數(shù)是否必須說明
module_list未來可設(shè)置多個(gè)組件,目前僅支持防偽組件。
type組件的類型,目前僅包括防偽組件anti_fake。
native_show設(shè)置為true時(shí),防偽結(jié)果使用微信提供的彈窗頁面展示,商戶僅需調(diào)用“商品管理”部分的組件消息接口回傳產(chǎn)品真假信息。設(shè)置為false時(shí),無防偽彈窗效果。
anti_fake_url商戶提供的防偽查詢鏈接,當(dāng)native_show設(shè)置為false時(shí)必填。

注意:

1、推廣服務(wù)區(qū)action_info部分,入口數(shù)量規(guī)則如下:

1)至少設(shè)置一個(gè)推廣類型;

2)文字介紹、公眾號和微信卡券三種推廣類型,每種類型最多只能分別設(shè)置1個(gè);

3)普通鏈接、公眾號、微信卡券三種類型合計(jì)最多設(shè)置3個(gè);

4)圖片跳轉(zhuǎn)鏈接和視頻播放只能二選一展示;

2、商品主頁中必須存在至少一個(gè)價(jià)格信息,價(jià)格的展示渠道有四種:

1)在base_info中定義store_mgr_type和store_vendorid_list字段。如果商品在設(shè)置的電商渠道有銷售,則會有售賣入口在【購買區(qū)】展示。例如:“洋河-天之藍(lán) 480ml”在“京東商城”有銷售,假設(shè)京東商城又在該商品設(shè)置的電商渠道列表中,則會有“京東商城”的售賣入口出現(xiàn)。

2)在微信小店(Product)類型中設(shè)置productid,購買區(qū)將出現(xiàn)對應(yīng)商品的微信小店售賣入口。

3)在電商鏈接(Store)類型中設(shè)置目標(biāo)地址鏈接(link),購買區(qū)將出現(xiàn)所配置的外部商城售賣入口。

4)在建議零售價(jià)(Price)類型中設(shè)置retail_price字段。如果商品沒有設(shè)置前文所述的任何一種購買渠道,也會有該商品建議零售價(jià)展示。

返回示例

正確的JSON返回結(jié)果如下:

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

返回參數(shù)說明

參數(shù)說明
errcode0為調(diào)用成功,否則返回相關(guān)錯(cuò)誤碼。
errmsgok為調(diào)用成功,否則返回錯(cuò)誤提示。
pid轉(zhuǎn)譯后的商品id,將直接編入“獲取商品二維碼接口”返回的二維碼內(nèi)容。
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號