收藏487
分享
阅读41563
更新时间2022-04-11
更新日志：
| 版本号 | 更新内容 | 更新时间 |
| V2.1 | 创建门店可以返回临时poiid | 2016.7.18 |
门店管理接口为商户提供门店批量导入、查询、修改、删除等主要功能，方便商户快速、高效进行门店管理和操作。
商户在使用门店管理接口时需注意以下几个问题：
门店信息全部需要经过审核方能生效，门店创建完成后，获得poi_id，但该id不一定为最终id，在审核通过后id可能发生变化，只有收到微信推送的审核结果通知中的poi_id才为最终id，并使用在微信各个业务场景中（若在审核期间使用临时poi_id造成相应影响，由开发者自身承担）；
为保证在审核通过后，获取到的poi_id 能与商户自身数据做对应，将会允许商户在创建时提交自己内部或自定义的sid(字符串格式，微信不会对唯一性进行校验，请商户自己保证)，用于后续获取poi_id 后对数据进行对应；
门店的可用状态available_state，将标记门店相应审核状态，只有审核通过状态，才能进行更新，更新字段仅限扩展字段（表1 中前11 个字段）；
扩展字段属于公共编辑信息，提交更新后将由微信进行审核采纳，但扩展字段更新并不影响门店的可用状态（即available_state 仍为审核通过），但update_status 状态变为1，更新中状态，此时不可再次对门店进行更新，直到微信审核采纳后；
在update_status 为1，更新中状态下的门店，此时调用getpoi 接口，获取到的扩展字段为更新的最新字段，但并不是最终结果，仍需等待微信编辑对扩展字段的建议进行采纳后，最终决定是否生效（有可能更新字段不被采纳）；
门店页面示例
拥有已认证的服务号可申请开通门店管理功能。
认证的订阅号拥有卡券、WI-FI、摇一摇、广告主等功能后会自动开通门店管理功能。
申请路径如下登录微信公众平台—添加功能插件—选择门店功能。
获取接口权限后，商户开发者需按照以下步骤开发和调试，请开发者务必仔细阅读以下流程！
1、创建门店前的准备
上传图片：上传商户新建门店时所使用的图片。上传的图片url必须为微信自己域名的url。
2.创建门店
调用创建门店接口，调用成功后返回errcode、errmsg，会返回临时poi_id，该id可能与最终id不同。
3.审核结果事件推送
新创建的门店在审核通过后，会以事件形式推送给商户填写的回调url（登陆公众平台进入“开发者中心”设置）审核通过获取门店唯一id：poi_id。
4.查询门店信息
在审核通过并获取poi_id 后，商户可以利用poi_id，查询具体某条门店的信息。
5.查询门店列表
商户可以通过该接口，批量查询自己名下的门店list，并获取已审核通过的poi_id以及商户自身用于对应、商户名、分店名、地址字段的sid
6.修改门店服务信息
商户可以通过该接口，修改门店的服务信息，包括：图片列表、营业时间、推荐、特色服务、简介、人均价格、电话7 个字段（名称、坐标、地址等不可修改）修改后需要人工审核。
7.删除门店
商户可以通过该接口，删除已经成功创建的门店。
注意：所有API接口POST的数据只支持UTF-8编码，否则会返回报错。
接口说明
用POI 接口新建门店时所使用的图片url 必须为微信域名的url，因此需要先用上传图片接口上传图片并获取url，再创建门店。
上传的图片限制文件大小限制1MB，支持JPG 格式。
接口调用请求说明
| 协议 | https |
| http请求方式 | POST/FORM |
| 请求Url | https://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKEN |
| POST数据格式 | buffer |
请求参数说明
| 参数 | 说明 | 是否必填 |
| access_token | 调用接口凭证 | 是 |
| buffer | 图片文件的数据流 | 是 |
返回数据说明
返回成功示例：
{
"url":"http://mmbiz.qpic.cn/XXXXX"
}
插入失败示例（errcode 不为0，errmsg 为相应错误信息）：
{
"errcode":40001,
"errmsg":"invalid credential"
}
| 字段 | 说明 |
| errcode | 错误码，0为正常 |
| errmsg | 错误信息 |
接口说明
创建门店接口是为商户提供创建自己门店数据的接口，门店数据字段越完整，商户页面展示越丰富，越能够吸引更多用户，并提高曝光度。
创建门店接口调用成功后会返回errcode 0、errmsg ok，但不会实时返回poi_id。
成功创建后，会生成poi_id，但该id不一定为最终id。门店信息会经过审核，审核通过后方可获取最终poi_id，该id为门店的唯一id，强烈建议自行存储审核通过后的最终poi_id，并为后续调用使用。
接口调用请求说明
| 协议 | https |
| http请求方式 | POST |
| 请求Url | http://api.weixin.qq.com/cgi-bin/poi/addpoi?access_token=TOKEN |
| POST数据格式 | json |
请求参数说明
| 参数 | 说明 | 是否必填 |
| access_token | 调用接口凭证 | 是 |
| buffer | json数据 | 是 |
POST数据示例
字段视图：
json 数据示例
{"business":{
"base_info":{
"sid":"33788392",
"business_name":"15个汉字或30个英文字符内",
"branch_name":"不超过10个字，不能含有括号和特殊字符",
"province":"不超过10个字",
"city":"不超过30个字",
"district":"不超过10个字",
"address":"门店所在的详细街道地址（不要填写省市信息）：不超过80个字",
"telephone":"不超53个字符（不可以出现文字）",
"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字。免费wifi，外卖服务",
"introduction":"不超过300字。麦当劳是全球大型跨国连锁餐厅，1940 年创立于美国，在世界上
大约拥有3 万间分店。主要售卖汉堡包，以及薯条、炸鸡、汽水、冰品、沙拉、 水果等
快餐食品",
"open_time":"8:00-20:00",
"avg_price":35
}
}
}
门店基础信息字段（重要）
字段 | 说明 | 是否必填 |
sid | 商户自己的id，用于后续审核通过收到poi_id 的通知时，做对应关系。请商户自己保证唯一识别性 | 否 |
business_name | 门店名称（仅为商户名，如：国美、麦当劳，不应包含地区、地址、分店名等信息，错误示例：北京国美） 不能为空，15个汉字或30个英文字符内 | 是 |
branch_name | 分店名称（不应包含地区信息，不应与门店名有重复，错误示例：北京王府井店） | 是 |
province |
相关 视频 RELATED VIDEOS 科技资讯 1 2 3 4 5 6 7 8 9 精选课程 共5课时 17.2万人学习 共49课时 77万人学习 共29课时 61.7万人学习 共25课时 39.3万人学习 共43课时 70.9万人学习 共25课时 61.6万人学习 共22课时 23万人学习 共28课时 33.9万人学习 共89课时 125万人学习 |
