微信門店接口

2018-10-14 11:42 更新

微信門店接口

微信門店

更新日志：

版本號更新內(nèi)容更新時間
V2.1創(chuàng)建門店可以返回臨時poiid2016.7.18

微信門店接口文檔

1.接口簡介

門店管理接口為商戶提供門店批量導(dǎo)入、查詢、修改、刪除等主要功能，方便商戶快速、高效進(jìn)行門店管理和操作。

商戶在使用門店管理接口時需注意以下幾個問題：

門店信息全部需要經(jīng)過審核方能生效，門店創(chuàng)建完成后，獲得poi_id，但該id不一定為最終id，在審核通過后id可能發(fā)生變化，只有收到微信推送的審核結(jié)果通知中的poi_id才為最終id，并使用在微信各個業(yè)務(wù)場景中（若在審核期間使用臨時poi_id造成相應(yīng)影響，由開發(fā)者自身承擔(dān)）；

為保證在審核通過后，獲取到的poi_id 能與商戶自身數(shù)據(jù)做對應(yīng)，將會允許商戶在創(chuàng)建時提交自己內(nèi)部或自定義的sid(字符串格式，微信不會對唯一性進(jìn)行校驗(yàn)，請商戶自己保證)，用于后續(xù)獲取poi_id 后對數(shù)據(jù)進(jìn)行對應(yīng)；

門店的可用狀態(tài)available_state，將標(biāo)記門店相應(yīng)審核狀態(tài)，只有審核通過狀態(tài)，才能進(jìn)行更新，更新字段僅限擴(kuò)展字段（表1 中前11 個字段）；

擴(kuò)展字段屬于公共編輯信息，提交更新后將由微信進(jìn)行審核采納，但擴(kuò)展字段更新并不影響門店的可用狀態(tài)（即available_state 仍為審核通過），但update_status 狀態(tài)變?yōu)?，更新中狀態(tài)，此時不可再次對門店進(jìn)行更新，直到微信審核采納后；

在update_status 為1，更新中狀態(tài)下的門店，此時調(diào)用getpoi 接口，獲取到的擴(kuò)展字段為更新的最新字段，但并不是最終結(jié)果，仍需等待微信編輯對擴(kuò)展字段的建議進(jìn)行采納后，最終決定是否生效（有可能更新字段不被采納）；

門店頁面示例

門店頁面示例

2.開發(fā)者必讀

2.1申請接入

擁有已認(rèn)證的服務(wù)號可申請開通門店管理功能。

認(rèn)證的訂閱號擁有卡券、WI-FI、搖一搖、廣告主等功能后會自動開通門店管理功能。

申請路徑如下登錄微信公眾平臺—添加功能插件—選擇門店功能。

選擇門店功能

2.2開發(fā)流程

獲取接口權(quán)限后，商戶開發(fā)者需按照以下步驟開發(fā)和調(diào)試，請開發(fā)者務(wù)必仔細(xì)閱讀以下流程！

1、創(chuàng)建門店前的準(zhǔn)備

上傳圖片：上傳商戶新建門店時所使用的圖片。上傳的圖片url必須為微信自己域名的url。

2.創(chuàng)建門店

調(diào)用創(chuàng)建門店接口，調(diào)用成功后返回errcode、errmsg，會返回臨時poi_id，該id可能與最終id不同。

3.審核結(jié)果事件推送

新創(chuàng)建的門店在審核通過后，會以事件形式推送給商戶填寫的回調(diào)url（登陸公眾平臺進(jìn)入“開發(fā)者中心”設(shè)置）審核通過獲取門店唯一id：poi_id。

審核結(jié)果事件推送

4.查詢門店信息

在審核通過并獲取poi_id 后，商戶可以利用poi_id，查詢具體某條門店的信息。

5.查詢門店列表

商戶可以通過該接口，批量查詢自己名下的門店list，并獲取已審核通過的poi_id以及商戶自身用于對應(yīng)、商戶名、分店名、地址字段的sid

6.修改門店服務(wù)信息

商戶可以通過該接口，修改門店的服務(wù)信息，包括：圖片列表、營業(yè)時間、推薦、特色服務(wù)、簡介、人均價(jià)格、電話7 個字段（名稱、坐標(biāo)、地址等不可修改）修改后需要人工審核。

7.刪除門店

商戶可以通過該接口，刪除已經(jīng)成功創(chuàng)建的門店。

注意：所有API接口POST的數(shù)據(jù)只支持UTF-8編碼，否則會返回報(bào)錯。

3.創(chuàng)建門店

3.1上傳圖片

接口說明

用POI 接口新建門店時所使用的圖片url 必須為微信域名的url，因此需要先用上傳圖片接口上傳圖片并獲取url，再創(chuàng)建門店。

上傳的圖片限制文件大小限制1MB，支持JPG 格式。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST/FORM
請求Urlhttps://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN
POST數(shù)據(jù)格式buffer

請求參數(shù)說明

參數(shù)說明是否必填
access_token調(diào)用接口憑證是
buffer圖片文件的數(shù)據(jù)流是

返回?cái)?shù)據(jù)說明

返回成功示例：

{

"url":"http://mmbiz.qpic.cn/XXXXX"

}

插入失敗示例（errcode 不為0，errmsg 為相應(yīng)錯誤信息）：

{ 

"errcode":40001,

"errmsg":"invalid credential"

}

字段說明
errcode錯誤碼，0為正常
errmsg錯誤信息

3.2創(chuàng)建門店

接口說明

創(chuàng)建門店接口是為商戶提供創(chuàng)建自己門店數(shù)據(jù)的接口，門店數(shù)據(jù)字段越完整，商戶頁面展示越豐富，越能夠吸引更多用戶，并提高曝光度。

創(chuàng)建門店接口調(diào)用成功后會返回errcode 0、errmsg ok，但不會實(shí)時返回poi_id。

成功創(chuàng)建后，會生成poi_id，但該id不一定為最終id。門店信息會經(jīng)過審核，審核通過后方可獲取最終poi_id，該id為門店的唯一id，強(qiáng)烈建議自行存儲審核通過后的最終poi_id，并為后續(xù)調(diào)用使用。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST
請求Urlhttp://api.weixin.qq.com/cgi-bin/poi/addpoi?access_token=TOKEN
POST數(shù)據(jù)格式json

請求參數(shù)說明

參數(shù)說明是否必填
access_token調(diào)用接口憑證是
bufferjson數(shù)據(jù)是

POST數(shù)據(jù)示例

字段視圖：

字段視圖

json 數(shù)據(jù)示例

{"business":{

   "base_info":{

                   "sid":"33788392",

                   "business_name":"15個漢字或30個英文字符內(nèi)",

                   "branch_name":"不超過10個字，不能含有括號和特殊字符",

                   "province":"不超過10個字",

                   "city":"不超過30個字",

                   "district":"不超過10個字",

                   "address":"門店所在的詳細(xì)街道地址（不要填寫省市信息）：不超過80個字",

                   "telephone":"不超53個字符（不可以出現(xiàn)文字）",

                   "categories":["美食,小吃快餐"], 

                   "offset_type":1,

                   "longitude":115.32375,

                   "latitude":25.097486,

                   "photo_list":[{"photo_url":"https:// 不超過20張.com"}，{"photo_url":"https://XXX.com"}],

                   "recommend":"不超過200字。麥辣雞腿堡套餐，麥樂雞，全家桶",

                   "special":"不超過200字。免費(fèi)wifi，外賣服務(wù)",

                   "introduction":"不超過300字。麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上

             大約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、 水果等

             快餐食品",

                   "open_time":"8:00-20:00",

                   "avg_price":35

             }

    }

}

門店基礎(chǔ)信息字段（重要）

字段

說明

是否必填

sid

商戶自己的id，用于后續(xù)審核通過收到poi_id 的通知時，做對應(yīng)關(guān)系。請商戶自己保證唯一識別性

否

business_name

門店名稱（僅為商戶名，如：國美、麥當(dāng)勞，不應(yīng)包含地區(qū)、地址、分店名等信息，錯誤示例：北京國美）

不能為空，15個漢字或30個英文字符內(nèi)

是

branch_name

分店名稱（不應(yīng)包含地區(qū)信息，不應(yīng)與門店名有重復(fù)，錯誤示例：北京王府井店）
10個字以內(nèi)

是

province

門店所在的省份（直轄市填城市名,如：北京市）

10個字以內(nèi)

是

city

門店所在的城市

10個字以內(nèi)

是

district

門店所在地區(qū)

10個字以內(nèi)

是

address

門店所在的詳細(xì)街道地址（不要填寫省市信息）

是

（東莞等沒有“區(qū)”行政區(qū)劃的城市，該字段可不必填寫。其余城市必填。）

telephone

門店的電話（純數(shù)字，區(qū)號、分機(jī)號均由“-”隔開）

是

categories

門店的類型（不同級分類用“,”隔開，如：美食，川菜，火鍋。詳細(xì)分類參見附件：微信門店類目表）

是

offset_type

坐標(biāo)類型，1 為火星坐標(biāo)（目前只能選1）

是

longitude

門店所在地理位置的經(jīng)度

是

latitude

門店所在地理位置的緯度（經(jīng)緯度均為火星坐標(biāo)，最好選用騰訊地圖標(biāo)記的坐標(biāo)）

是

門店服務(wù)信息字段

字段

說明

是否必填

photo_list

圖片列表，url 形式，可以有多張圖片，尺寸為

640*340px。必須為上一接口生成的url。圖片內(nèi)容不允許與門店不相關(guān)，不允許為二維碼、員工合照（或模特肖像）、營業(yè)執(zhí)照、無門店正門的街景、地圖截圖、公交地鐵站牌、菜單截圖等

否

recommend

推薦品，餐廳可為推薦菜；酒店為推薦套房；景點(diǎn)為推薦游玩景點(diǎn)等，針對自己行業(yè)的推薦內(nèi)容

200字以內(nèi)

否

special

特色服務(wù)，如免費(fèi)wifi，免費(fèi)停車，送貨上門等商戶能提供的特色功能或服務(wù)

否

introduction

商戶簡介，主要介紹商戶信息等

300字以內(nèi)

否

open_time

營業(yè)時間，24 小時制表示，用“-”連接，如

8:00-20:00

否

avg_price

人均價(jià)格，大于0 的整數(shù)

否

返回?cái)?shù)據(jù)

返回成功示例：

{

"errcode":0,

"errmsg":"ok"

}

插入失敗示例（errcode 不為0，errmsg 為相應(yīng)錯誤信息）：

{

"errcode":40001,

"errmsg":"invalid credential"

}

字段說明
errcode錯誤碼，0為正常
errmsg錯誤信息

常見出錯字段規(guī)范

1）門店名稱

門店名：不能為空，15個漢字或30個英文字符內(nèi)，不能含有括號和特殊字符，僅為商戶（品牌）名稱，如海底撈，蘇寧電器，華景國旅，茂業(yè)百貨；不應(yīng)包含地區(qū)、地址、分店名等信息。錯誤及正確示例見下。

分店名：不超過10個字，不能含有括號和特殊字符，用于在同一商戶（品牌）有多家分店時區(qū)分不同門店，如國貿(mào)店，春熙路店，萬象城店；不應(yīng)包含地區(qū)信息，不應(yīng)與門店名有重復(fù)。錯誤及正確示例見下。

錯誤示例1：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"廣州東興堂大藥房連鎖有限公司永新分店",

                    "branch_name":"",

出錯原因：把分店名寫在了門店名中；包含了地區(qū)信息；包含了“連鎖有限公司”字樣

正確示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                "business_name":"東興堂大藥房",

                "branch_name":"永新分店",

錯誤示例2：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"山西國美",

                 "branch_name":"太原長治路店",

出錯原因：包含了地區(qū)信息

正確示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"國美",

                 "branch_name":"長治路店",

錯誤示例3：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"屈臣氏（北京路店）",

                   "branch_name":""

出錯原因：包含了括號；分店名寫在了門店名中

正確示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"屈臣氏",

                 "branch_name":"北京路店",

錯誤示例4：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"黃記煌",

                 "branch_name":"黃記煌成都春熙路店",

出錯原因：門店名和分店名重復(fù)

正確示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"黃記煌",

                 "branch_name":"春熙路店",

錯誤示例5：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"麗影廣場",

                 "branch_name":"麥當(dāng)勞",

出錯原因：理解有誤，將門店名和分店名填反

正確示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                 "business_name":"麥當(dāng)勞",

                 "branch_name":"麗影廣場店",

注意：最終門店名和分店名將以“business_name（branch_name）”的形式拼合顯示，請?jiān)谔顚憰r考慮展示效果（其中括號為統(tǒng)一自動添加，請不要自行添加）；不同字段搜索和存儲規(guī)則不同，請嚴(yán)格按照規(guī)范填寫門店信息，以保證用戶順利搜索、找到您的門店；隨后填寫的地址信息中將包含區(qū)域信息，一同展示給用戶，不必在名稱中重復(fù)填寫地區(qū)信息。

2）詳細(xì)地址

準(zhǔn)確填寫門店所在地址和門牌號，務(wù)必至少包括“XX路XX號”這一基本信息；因?yàn)闊o法檢索和定位，請不要只填寫“XX樓下”、“XX左側(cè)100米”、“XX商廈首層”、“XX地鐵站D出口向北100米”這類的信息，如要保留，請先保證門牌號準(zhǔn)確填寫。

請不要在“詳細(xì)地址”字段中重復(fù)填寫省市區(qū)信息，直轄市除外（province、city均要填寫）

錯誤示例：

                   "province":"浙江省",

                   "city":"杭州市",

                   "district":"下城區(qū)",

                   "address":"杭州市下城區(qū)慶春路86號世紀(jì)聯(lián)華超市5樓",

出錯原因：在詳細(xì)地址中重復(fù)填寫了省市區(qū)信息，造成拼合后重復(fù)顯示。錯誤展示效果：浙江省杭州市下城區(qū)杭州市下城區(qū)慶春路86號世紀(jì)聯(lián)華超市5樓。

正確示例：

                   "province":"浙江省",

                   "city":"杭州市",

                   "district":"下城區(qū)",

                   "address":"慶春路86號世紀(jì)聯(lián)華超市5樓",

正確展示效果：浙江省杭州市下城區(qū)慶春路86號世紀(jì)聯(lián)華超市5樓。

直轄市信息填寫示例：

                   "province":"上海市",

                   "city":"上海市",

                   "district":"徐匯區(qū)",

                   "address":"田林路397號中環(huán)國際廣場A樓",

3）類目信息

商戶按照類目列表選擇實(shí)際門店對應(yīng)的類目。

錯誤示例：

{"business":{

   "base_info":{

                   "sid":"33788392",

                   "business_name":"麥當(dāng)勞",

                   "branch_name":"藝苑路店",

                   "province":"廣東省",

                   "city":"廣州市",

                   "district":"海珠區(qū)",

                   "address":"藝苑路11 號",

                   "telephone":"020-12345678",

                   "categories":["美食,茶餐廳"], 

出錯原因：將麥當(dāng)勞的類目信息寫成“美食,茶餐廳”。

4）電話

填寫的電話信息需要真實(shí)有效，審核過程會進(jìn)行電話抽審，無人接聽或電話無效會影響審核結(jié)果。

只能含有數(shù)字和“-”字符；固定電話須填寫區(qū)號；區(qū)號、分機(jī)號均用“-”連接；現(xiàn)階段請不要填寫多個電話。

錯誤示例1：

"telephone":"（010）87632851",

錯誤原因：區(qū)號未用“-”連接。

錯誤示例2：

"telephone":"34435764",

錯誤原因：固定電話未加區(qū)號。

錯誤示例3：

"telephone":"13880934557、0351-34435764",

錯誤原因：填寫了多個電話。

錯誤示例4：

"telephone":"138-8093-4557",

錯誤原因：手機(jī)號碼內(nèi)部不應(yīng)用“-”間隔。

錯誤示例5：

"telephone":"8003800轉(zhuǎn)4010",

錯誤原因：分機(jī)號未用“-”連接。

錯誤示例6：

"telephone":"8003800#4010",

錯誤原因：分機(jī)號未用“-”連接

 

正確示例：

"telephone":"021-81445873",
"telephone":"021-81445873-1003",

"telephone":"13867428497",
"telephone":"4008002835",


5）經(jīng)緯度：

可利用以下工具找到各門店對應(yīng)的經(jīng)緯度坐標(biāo)，導(dǎo)出相應(yīng)坐標(biāo)值。

詳見鏈接：坐標(biāo)拾取器地址。

http://lbs.qq.com/tool/getpoint/index.html  

注意：經(jīng)緯度坐標(biāo)需要轉(zhuǎn)換為騰訊地圖坐標(biāo)。

詳見鏈接：

http://lbs.qq.com/webservice_v1/guide-convert.html

3.3審核事件推送

新創(chuàng)建的門店在審核通過后，會以事件形式推送給商戶填寫的回調(diào)URL（登陸公眾平臺進(jìn)入“開發(fā)者中心”設(shè)置）

微信服務(wù)器在五秒內(nèi)收不到響應(yīng)會斷掉連接，并且重新發(fā)起請求，總共重試三次。 關(guān)于重試的消息排重，推薦使用FromUserName + CreateTime 排重。

假如服務(wù)器無法保證在五秒內(nèi)處理并回復(fù)，可以直接回復(fù)空串，微信服務(wù)器不會對此作任何處理，并且不會發(fā)起重試。

推送XML數(shù)據(jù)包示例：

<xml>

<ToUserName><![CDATA[toUser]]></ToUserName>

<FromUserName><![CDATA[fromUser]]></FromUserName>

<CreateTime>1408622107</CreateTime>

<MsgType><![CDATA[event]]></MsgType>

<Event><![CDATA[poi_check_notify]]></Event>

<UniqId><![CDATA[123adb]]></UniqId>

<PoiId><![CDATA[123123]]></PoiId>

<Result><![CDATA[fail]]></Result>

<msg><![CDATA[xxxxxx]]></msg>

</xml>

參數(shù)說明：

字段說明
ToUserName發(fā)送方帳號（一個OpenID）
FromUserName錯誤信息
CreateTime消息創(chuàng)建時間（整型）
MsgType消息類型，event
Event事件類型，poi_check_notify
UniqId 商戶自己內(nèi)部ID，即字段中的sid
PoiId微信的門店ID，微信內(nèi)門店唯一標(biāo)示ID
Result審核結(jié)果，成功succ 或失敗fail
msg成功的通知信息，或?qū)徍耸〉鸟g回理由

3.4查詢門店信息

接口說明

創(chuàng)建門店后獲取poi_id 后，商戶可以利用poi_id，查詢具體某條門店的信息。 若在查詢時，update_status 字段為1，表明在5 個工作日內(nèi)曾用update 接口修改過門店擴(kuò)展字段，該擴(kuò)展字段為最新的修改字段，尚未經(jīng)過審核采納，因此不是最終結(jié)果。最終結(jié)果會在5 個工作日內(nèi)，最終確認(rèn)是否采納，并前端生效（但該擴(kuò)展字段的采納過程不影響門店的可用性，即available_state仍為審核通過狀態(tài)）

注：擴(kuò)展字段為公共編輯信息（大家都可修改），修改將會審核，并決定是否對修改建議進(jìn)行采納，但不會影響該門店的生效可用狀態(tài)。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST
請求Urlhttp://api.weixin.qq.com/cgi-bin/poi/getpoi?access_token=TOKEN
POST數(shù)據(jù)格式json

請求參數(shù)說明

參數(shù)說明是否必填
access_token調(diào)用接口憑證是
bufferjson數(shù)據(jù)是

POST數(shù)據(jù)示例

{

"poi_id":"271262077"

}

返回?cái)?shù)據(jù)說明

數(shù)據(jù)示例

{

    "errcode":0,

    "errmsg":"ok",

    "business ":{

    "base_info":{

                 "sid":"001",

                 "business_name":"麥當(dāng)勞",

                 "branch_name":"藝苑路店",

                 "province":"廣東省",

                 "city":"廣州市",

                 "address":"海珠區(qū)藝苑路11 號",

                 "telephone":"020-12345678",

                 "categories":["美食,小吃快餐"],

                 "offset_type":1,

                 "longitude":115.32375,

                 "latitude":25.097486,

                 "photo_list":[{"photo_url":"https:// XXX.com"} ， {"photo_url":"https://XXX.com"}],

                 "recommend":"麥辣雞腿堡套餐，麥樂雞，全家桶",

                 "special":"免費(fèi)wifi，外賣服務(wù)",

                 "introduction":"麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上大

     約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                 "open_time":"8:00-20:00",

                 "avg_price":35

                 "available_state":3

                 "update_status":0

                }

        }

 }

字段說明
errcode錯誤碼，0為正常
errmsg錯誤信息
available_state門店是否可用狀態(tài)。1 表示系統(tǒng)錯誤、2 表示審核中、3 審核通過、4 審核駁回。當(dāng)該字段為1、2、4 狀態(tài)時，poi_id 為空
update_status擴(kuò)展字段是否正在更新中。1 表示擴(kuò)展字段正在更新中，尚未生效，不允許再次更新； 0 表示擴(kuò)展字段沒有在更新中或更新已生效，可以再次更新
business門店信息，字段內(nèi)容同前

*注其他字段同前

3.5查詢門店列表

接口說明

商戶可以通過該接口，批量查詢自己名下的門店list，并獲取已審核通過的poi_id（所有狀態(tài)均會返回poi_id，但該poi_id不一定為最終id）、商戶自身sid 用于對應(yīng)、商戶名、分店名、地址字段。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST
請求Urlhttps://api.weixin.qq.com/cgi-bin/poi/getpoilist?access_token=TOKEN
POST數(shù)據(jù)格式json

請求參數(shù)說明

參數(shù)說明是否必填
access_token調(diào)用接口憑證是
bufferjson數(shù)據(jù)是

POST數(shù)據(jù)示例

{

"begin":0,

"limit":10

}

字段說明

字段說明是否必填
begin開始位置，0 即為從第一條開始查詢是
limit返回?cái)?shù)據(jù)條數(shù)，最大允許50，默認(rèn)為20是

返回?cái)?shù)據(jù)說明

數(shù)據(jù)示例：

為審核通過，有poi_id，全部字段；第二條為審核不通過，僅有基礎(chǔ)字段；第三條為審核中，僅有基礎(chǔ)字段。

{

 "errcode":0,

 "errmsg":"ok"

 "business_list":[

{"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"藝苑路店",

                "address":"藝苑路11號",

                "telephone":"020-12345678",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.32375,

                "latitude":25.097486,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上大約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐，麥樂雞，全家桶",

                "special":"免費(fèi)wifi，外賣服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633617",

                "available_state":3,

                "district":"海珠區(qū)",

                "update_status":0

              }},

{"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"北京路店",

                "address":"北京路12號",

                "telephone":"020-12345689",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.3235,

                "latitude":25.092386,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上大約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐，麥樂雞，全家桶",

                "special":"免費(fèi)wifi，外賣服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633618",

                "available_state":4,

                "district":"越秀區(qū)",

                "update_status":0

              }},

 {"base_info":{

                "sid":"101",

                "business_name":"麥當(dāng)勞",

                "branch_name":"龍洞店",

                "address":"迎龍路122號",

                "telephone":"020-12345659",

                "categories":["美食,快餐小吃"],

                "city":"廣州市",

                "province":"廣東省",

                "offset_type":1,

                "longitude":115.32345,

                "latitude":25.056686,

                "photo_list":[{"photo_url":"http: ...."}],

                "introduction":"麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上大約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                "recommend":"麥辣雞腿堡套餐，麥樂雞，全家桶",

                "special":"免費(fèi)wifi，外賣服務(wù)",

                "open_time":"8:00-20:00",

                "avg_price":35,

                "poi_id":"285633619",

                "available_state":2,

                "district":"天河區(qū)",

                "update_status":0

              }},

],

       "total_count":"3",

}

參數(shù)說明
access_token調(diào)用接口憑證
bufferjson數(shù)據(jù)
total_count門店總數(shù)量

3.6修改門店服務(wù)信息

接口說明

商戶可以通過該接口，修改門店的服務(wù)信息，包括：sid、圖片列表、營業(yè)時間、推薦、特色服務(wù)、簡介、人均價(jià)格、電話8個字段（名稱、坐標(biāo)、地址等不可修改）修改后需要人工審核。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST/FROM
請求Urlhttps://api.weixin.qq.com/cgi-bin/poi/updatepoi?access_token=TOKEN
POST數(shù)據(jù)格式buffer

請求參數(shù)說明

參數(shù)說明是否必填
access_token調(diào)用接口憑證是
bufferjson數(shù)據(jù)是

POST數(shù)據(jù)示例

{"business ":{

   "base_info":{

                  "poi_id ":"271864249"

                  "sid":"A00001"

                  "telephone ":"020-12345678"

                  "photo_list":[{"photo_url":"https:// XXX.com"}，{"photo_url":"https://XXX.com"}],

                  "recommend":"麥辣雞腿堡套餐，麥樂雞，全家桶",

                  "special":"免費(fèi)wifi，外賣服務(wù)",

                  "introduction":"麥當(dāng)勞是全球大型跨國連鎖餐廳，1940 年創(chuàng)立于美國，在世界上大約擁有3 萬間分店。主要售賣漢堡包，以及薯?xiàng)l、炸雞、汽水、冰品、沙拉、水果等快餐食品",

                  "open_time":"8:00-20:00",

                  "avg_price":35

              }

      }

}

字段說明：

全部字段內(nèi)容同前。

特別注意：

以上8個字段，若有填寫內(nèi)容則為覆蓋更新，若無內(nèi)容則視為不修改，維持原有內(nèi)容。 photo_list 字段為全列表覆蓋，若需要增加圖片，需將之前圖片同樣放入list 中，在其后增加新增圖片。如：已有A、B、C 三張圖片，又要增加D、E 兩張圖，則需要調(diào)用該接口，photo_list 傳入A、B、C、D、E 五張圖片的鏈接。

返回?cái)?shù)據(jù)說明

數(shù)據(jù)示例：

{

"errcode":0,

"errmsg":"ok"

}

字段說明
errcode錯誤碼，0為正常
errmsg錯誤信息

3.7刪除門店

接口說明

商戶可以通過該接口，刪除已經(jīng)成功創(chuàng)建的門店。請商戶慎重調(diào)用該接口。

接口調(diào)用請求說明

協(xié)議https
http請求方式POST/FROM
請求Urlhttps://api.weixin.qq.com/cgi-bin/poi/delpoi?access_token=TOKEN
POST數(shù)據(jù)格式buffer

請求參數(shù)說明

參數(shù)說明
access_token調(diào)用接口憑證
POSTjson數(shù)據(jù)

POST數(shù)據(jù)示例

{

"poi_id": "271262077"

}

字段說明：

字段說明
poi_id 門店ID

返回?cái)?shù)據(jù)說明

數(shù)據(jù)示例：

{

"errcode":0,

"errmsg":"ok"

}

字段說明
errcode錯誤碼，0為正常
errmsg錯誤信息

4.門店類目表

接口說明

類目名稱接口是為商戶提供自己門店類型信息的接口。門店類目定位的越規(guī)范，能夠精準(zhǔn)的吸引更多用戶，提高曝光率。

接口調(diào)用的請求說明

協(xié)議https
http請求方式GET
請求Url

http://api.weixin.qq.com/cgi-bin/poi/getwxcategory?access_token=TOKEN

返回?cái)?shù)據(jù)說明

{

  "category_list":

            ["美食,江浙菜,上海菜","美食,江浙菜,淮揚(yáng)菜","美食,江浙菜,浙江菜","美食,江浙菜,南京菜 ","美食,江浙菜,蘇幫菜…"]

}

5.常見錯誤碼

錯誤碼errmsg說明
-1system error系統(tǒng)錯誤，請稍后重試
40009Invalid image size圖片大小為0或者超過1M
40097invalid args參數(shù)不正確，請參考字段要求檢查json 字段
65104invalid category門店的類型不合法，必須嚴(yán)格按照附表的分類填寫
65105invalid photo url圖片url 不合法，必須使用接口1 的圖片上傳接口所獲取的url
65106poi audit state must be approved門店?duì)顟B(tài)必須未審核通過
65107not allow modify擴(kuò)展字段為不允許修改的狀態(tài)
65109invalid business門店名為空
65110invalid address門店所在詳細(xì)街道地址為空
65111invalid telephone門店的電話為空
65112invalid city門店所在的城市為空
65113invalid province門店所在的省份為空
65114empty photo list圖片列表為空
65115invalid poi idpoi_id 不正確

更多錯誤碼請參考“基礎(chǔ)支持-全局返回碼說明”

7.聯(lián)系我們

遇到問題，可以加入開發(fā)者交流群 463320265聯(lián)系我們，驗(yàn)證請說明所屬商家和業(yè)務(wù)。

以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號