微信商品管理


商品管理

#

#商品管理

查詢商品資訊

呼叫該接口，商家可以查詢建立成功的商品訊息，以檢查商品狀態或資訊設定。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/product/get?access_token=access_token
POST数据格式：JSON
POST数据例子：
{
 "keystandard": "ean13",
 "keystr": "6900873042720"
}

請求參數說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
keystandard是商品編碼標準。
keystr是商品編碼內容。

傳回範例

正確的JSON回傳結果如下：

{
 "errcode": 0,
 "errmsg": "ok",
 "brand_info":{
  "base_info":{
   "title": "扫一扫动态主页demo",
"thumb_url":"http://mmbiz.qpic.cn/mmbiz/AhrnkhhK7rWevHib2pmq1phtply6JicADNrX6Yrvd7LzKERyic3kn3VdSsmFr5F5ibXzj9Al65yWFudmjqcWic1Qe9g/0",
   "brand_tag": "小耿哥8",
   "category_id": 0,
   "retail_price": "0.00",
   "store_mgr_type": "auto",
   "store_vendorid_list":[],
   "color": "auto",
   "status": "on"
  },
  "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": "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",
     "appid": "wx307e399609946068"
    },
    {
     "type": "text",
     "text": "此处可根据品牌商需要，用于简单描述商品或活动。"
    }
   ]
  },
  "module_info":{
   "module_list":[
    {
     "type": "anti_fake",
     "native_show": "true"
    }
   ]
  }
 }
}

傳回參數說明

##參數說明errcode#0為呼叫成功，否則傳回相關錯誤碼。 errmsgok為呼叫成功，否則回傳錯誤提示。 status商品首頁的狀態，on為發布狀態，off為未發布狀態，check為審核中狀態，reject為審核未通過狀態。

其他參數說明，請參考「建立商品」介面。

注意：商品狀態（status）處於「審核中（check）」的商品，不可呼叫介面進行更新或取消發布，否則會報錯。

批次查詢商品資訊

呼叫該接口，商家可以批次查詢建立成功的商品訊息，查詢維度有商品狀態和編碼內容。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/product/getlist?access_token=access_toke
POST数据格式：JSON
POST数据例子：
{
 "offset": "1",
 "limit": "10",
 "status":"on",
}

請求參數說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
offset是批次查詢的起始位置，從0開始，包含該起始位置。
limit是批次查詢的數量。
status否支援按狀態拉取。 on為發布狀態，off為未發布狀態，check為審核中狀態，reject為審核未通過狀態，all為所有狀態。
keystr否支援以部分編碼內容拉取。填寫此參數後，可將編碼內容中包含所傳參數的商品資訊拉出。類似關鍵字搜尋。

傳回範例

正確的JSON回傳結果如下：

{
 "errcode": 0,
 "errmsg": "ok",
 "total": 2,
 "key_list": [
  {
   "keystandard": "ean13",
   "keystr": "6390000000000",
   "category_id": 537117576,
   "category_name": "果泥/菜泥/肉泥",
   "update_time": 1413181580,
   "status": "on"
  },
  {
   "keystandard": "ean13",
   "keystr": "6390000000002",
   "category_id": 537117576,
   "category_name": "果泥/菜泥/肉泥",
   "update_time": 1412834605,
   "status": "on"
  }
 ]
}

傳回參數說明

參數說明
#errcode0為呼叫成功，否則傳回相關錯誤碼。
errmsgok為呼叫成功，否則回傳錯誤提示。
total命中篩選條件的總商品數。
key_list商品資訊清單。
keystandard商品編碼標準。
keystr商品編碼內容。
category_id商品類別目ID。
category_name商品類別目名稱。
update_time商品資訊的最後更新時間（整數）。
status商品首頁的狀態，on為發布狀態，off為未發布狀態，check為審核中狀態，reject為審核未通過狀態。

更新商品資訊

呼叫該接口，可對商品的基本資訊（base_info）、詳情資訊（detail_info）、推廣服務區（action_info）和元件區（modul_info）四個部分進行獨立或整體的更新。

注意：對處於「發布狀態（on）」的商品進行更新，呼叫介面成功後，新的商品資訊會自動進入掃一掃審核系統。對「審核中（check）」的商品，不可再更新或取消發布，否則會報錯。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/product/update?access_token=access_token 
POST数据格式：JSON
POST数据例子：
{
 "keystandard": "ean13",
 "keystr": "6390000000000",
 "brand_info": {
  "action_info": {
   "action_list": [
    {
     "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",
     "appid": "wx307e399609946068"
    },
    {
     "type": "text",
     "text": "此处可根据品牌商需要，用于简单描述商品或活动。"
    }
   ]
  }
 }
}

#請求參數說明

#
參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
keystandard是商品編碼標準。
keystr是商品編碼內容。
action_info否商品的推廣服務區資訊。

详细参数说明，请参考“创建商品”接口。

傳回範例

正確的JSON回傳結果如下：

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

傳回參數說明

参数说明
errcode0为调用成功，否则返回相关错误码。
errmsgok为调用成功，否则返回错误提示。
pid转译后的商品id，将直接编入“获取商品二维码接口”返回的二维码内容。

清除商品資訊

呼叫該接口，商家可以清除建立成功的商品資訊。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/product/clear?access_token=access_token 
POST数据格式：JSON
POST数据例子：
{
 "keystandard": "ean13",
 "keystr": "6900873042720"
}

請求範例說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
keystandard是商品編碼標準。
keystr是商品編碼內容。

傳回範例

正確的JSON回傳結果如下：

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

傳回參數說明

参数说明
errcode0为调用成功，否则返回相关错误码。
errmsgok为调用成功，否则返回错误提示。

跳轉URL參數說明

#場景說明：

##使用者點選商品推廣服務區Link類型的連結後，外跳的URL會帶著wxkeystand、wxkeystr、wxticket、wxextinfo這四個參數。透過檢查wxticket可以確認存取用戶的來源和識別訊息，已實現精準營運。 

URL示例：http://p.url.cn/wxscandemo/yangbanjian/fangweilanding?91eddae46161ae26a3e6e928f3c07147=scan&wxkeystandard=qrcode&wxkeystr=cosmetics1&wxticket=azlsdGljdXo4Ymow&wxextinfo=123

參數說明

參數說明
#wxkeystand商品編碼標準。
wxkeystr商品編碼內容。
wxticket標識來源的憑證參數。可透過「檢查wxticket參數介面」換取對應的商品資訊和存取使用者資訊。 特別地，當使用者分享連結時，為確保安全，微信會將wxticket參數清空。
wxextinfo呼叫「取得商品二維碼介面」時傳入的extinfo，為識別參數。

檢查wxticket參數

#呼叫該接口，可檢查目前存取使用者來源的商品主頁，以及在網頁前端取得該使用者的身份資訊。為確保場景的正確性，wxticket參數作為臨時簽名僅在20分鐘內有效，超過有效時長會檢查失敗。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/scanticket/check?access_token=access_token
POST数据格式：JSON
POST数据例子：
{
 "ticket": " Ym1haDlvNXJqY3Ru1",
}

請求參數說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
ticket是請求URL中帶上的wxticket參數。

傳回範例

正確的JSON回傳結果如下：

{	
 "errcode":0,
 "errmsg":"ok",
 "keystandard":"ean13",
 "keystr":"6901481811083",
 "openid":"otAzGjrS4AYCmeJM1GhEOcHXXTAo"，
 "scene":"scan"，
 "is_check": false，
 "is_contact": false
}

傳回參數說明

參數說明
#errcode0為呼叫成功，否則傳回相關錯誤碼。
errmsgok為呼叫成功，否則回傳錯誤提示。
keystandard商品編碼標準。
keystr商品編碼內容。
openid目前訪客的openid，可唯一標識使用者。
scene開啟商品首頁的場景，scan為掃碼，others為其他場景，可能是會話、收藏或朋友圈。
is_check該條碼（二維碼）是否已掃描，true為是，false為否。
is_contact是否關注公眾號，true為已關注，false為未關注。

元件訊息

      呼叫該接口，需先在「創建商品」時設定組件內容，之後可透過此介面對組件區的展示結果進行控制。

      目前，商家透過微信推送的“事件”，可取得被掃碼查詢的商品資訊以及商家之#前所設定的“extinfo”內容。透過和本地資訊進行校驗，可判斷使用者所查詢的商品真偽，並將結果透過該介面傳回微信，最終由微信在客戶端自訂頁面上展示真偽的查詢結果。

      商家設定元件內容後，【使用者—微信—商家】的訊息互動模式如下：

#推送XML範例

 <xml> 
<ToUserName><![CDATA[gh_fbe8a958756e]]></ToUserName> 
<FromUserName><![CDATA[otAzGjrJVN21mpDF4ZWQiYZwdK0Y]]></FromUserName>
<CreateTime>1447848568</CreateTime> 
<MsgType><![CDATA[event]]></MsgType> 
<Event><![CDATA[scan_product_callback]]></Event> 
<KeyStandard><![CDATA[qrcode]]></KeyStandard> 
<KeyStr><![CDATA[weixin_antifake]]></KeyStr> 
<ExtInfo><![CDATA[hyhy]]></ExtInfo> 
<NeedAntiFake>true</NeedAntiFake> 
</xml>

推送參數說明

參數說明
#ToUserName商戶的公眾號碼原始id。
FromUserName使用者的openid。
CreateTime訊息建立時間（整數）。
MsgType訊息類型，event。
Event事件類型，scan_product_callback為元件訊息事件。
KeyStandard商品編碼標準。
KeyStr商品編碼內容。
ExtInfo呼叫「取得商品二維碼介面」時傳入的extinfo，為識別參數。
NeedAntiFake請是否使用微信提供的彈窗頁面展示防偽結果，true為使用，false為未使用。

傳回XML範例

 <xml> 
<ToUserName><![CDATA[otAzGjrJVN21mpDF4ZWQiYZwdK0Y]]></ToUserName> 
<FromUserName><![CDATA[gh_fbe8a958756e]]></FromUserName>
<CreateTime>1447848568</CreateTime> 
<MsgType><![CDATA[scanproduct]]></MsgType> 
<ScanProduct> 
<KeyStandard><![CDATA[qrcode]]></KeyStandard> 
<KeyStr><![CDATA[weixin_antifake]]></KeyStr> 
<ExtInfo><![CDATA[hyhy]]></ExtInfo> 
<AntiFake> 
<CodeResult><![CDATA[real]]></CodeResult> 
</AntiFake> 
</ScanProduct>
</xml>

#回傳參數說明

#
參數說明
#ToUserName#使用者的openid。
FromUserName商家的公眾號碼原始id。
CreateTime訊息建立時間（整數）。
MsgType訊息類型，scanproduct。
KeyStandard商品編碼標準。
KeyStr商品編碼內容。
ExtInfo呼叫「取得商品二維碼介面」時傳入的extinfo，為識別參數。
AntiFake防偽訊息的內容。
CodeResult商品防偽查詢的結果，real表示碼為真，fake表示碼為假，not_active表示該防偽碼未啟動。

清除掃碼記錄

#當商品首頁設定了「原生防偽元件」（詳情請查看【創建商品】），用戶每一次掃碼查看主頁，均會被計數，進而展示在「防偽查詢詳情」中。如果商家希望某個碼的掃碼記錄“歸零”，可呼叫該接口，清除該碼的被掃碼記錄。

請求範例

HTTP请求方式：POST
https://api.weixin.qq.com/scan/scanticket/check?access_token=access_token
POST数据格式：JSON
POST数据例子：
{
 "keystandard": "ean13",
 "keystr": "6900000000000"，
 "extinfo":"extinfo"
}

請求參數說明

參數是否必須說明
access_token是公眾號的全域憑證，用於介面呼叫。
keystandard是商品編碼標準。
keystr是商品編碼內容。
extinfo是「取得商品二維碼介面」時傳入的extinfo，為識別參數。

傳回範例

正確的JSON回傳結果如下：

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

傳回參數說明

参数说明
errcode0为调用成功，否则返回相关错误码。
errmsgok为调用成功，否则返回错误提示。