微信门店接口

由 如此轻盈 创建， 最后一次修改 2016-09-29 微信门店接口更新日志：版本号更新内容更新时间V2.1创建门店可以返回临时poiid2016.7.18微信门店接口文档1.接口简介门店管理接口为商户提供门店批量导入、查询、修改、删除等主要功能，方便商户快速、高效进行门店管理和操作。商户在使用门店管理接口时需注意以下几个问题：门店信息全部需要经过审核方能生效，门店创建完成后，获得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 接口，获取到的扩展字段为更新的最新字段，但并不是最终结果，仍需等待微信编辑对扩展字段的建议进行采纳后，最终决定是否生效（有可能更新字段不被采纳）；门店页面示例2.开发者必读2.1申请接入拥有已认证的服务号可申请开通门店管理功能。认证的订阅号拥有卡券、WI-FI、摇一摇、广告主等功能后会自动开通门店管理功能。申请路径如下登录微信公众平台—添加功能插件—选择门店功能。2.2开发流程获取接口权限后，商户开发者需按照以下步骤开发和调试，请开发者务必仔细阅读以下流程！1、创建门店前的准备上传图片：上传商户新建门店时所使用的图片。上传的图片url必须为微信自己域名的url。2.创建门店调用创建门店接口，调用成功后返回errcode、errmsg，会返回临时poi_id，该id可能与最终id不同。3.审核结果事件推送新创建的门店在审核通过后，会以事件形式推送给商户填写的回调url（登陆公众平台进入“开发者中心”设置）审核通过获取门店唯一id：poi_id。4.查询门店信息在审核通过并获取poi_id 后，商户可以利用poi_id，查询具体某条门店的信息。5.查询门店列表商户可以通过该接口，批量查询自己名下的门店list，并获取已审核通过的poi_id以及商户自身用于对应、商户名、分店名、地址字段的sid6.修改门店服务信息商户可以通过该接口，修改门店的服务信息，包括：图片列表、营业时间、推荐、特色服务、简介、人均价格、电话7 个字段（名称、坐标、地址等不可修改）修改后需要人工审核。7.删除门店商户可以通过该接口，删除已经成功创建的门店。注意：所有API接口POST的数据只支持UTF-8编码，否则会返回报错。3.创建门店3.1上传图片接口说明用POI 接口新建门店时所使用的图片url 必须为微信域名的url，因此需要先用上传图片接口上传图片并获取url，再创建门店。上传的图片限制文件大小限制1MB，支持JPG 格式。接口调用请求说明协议httpshttp请求方式POST/FORM请求Urlhttps://api.weixin.qq.com/cgi-bin/media/uploadimg?access_token=ACCESS_TOKENPOST数据格式buffer请求参数说明参数说明是否必填access_token调用接口凭证是buffer图片文件的数据流是返回数据说明返回成功示例：{"url":"http://mmbiz.qpic.cn/XXXXX"}插入失败示例（errcode 不为0，errmsg 为相应错误信息）：{ "errcode":40001,"errmsg":"invalid credential"}字段说明errcode错误码，0为正常errmsg错误信息3.2创建门店接口说明创建门店接口是为商户提供创建自己门店数据的接口，门店数据字段越完整，商户页面展示越丰富，越能够吸引更多用户，并提高曝光度。创建门店接口调用成功后会返回errcode 0、errmsg ok，但不会实时返回poi_id。成功创建后，会生成poi_id，但该id不一定为最终id。门店信息会经过审核，审核通过后方可获取最终poi_id，该id为门店的唯一id，强烈建议自行存储审核通过后的最终poi_id，并为后续调用使用。接口调用请求说明协议httpshttp请求方式POST请求Urlhttp://api.weixin.qq.com/cgi-bin/poi/addpoi?access_token=TOKENPOST数据格式json请求参数说明参数说明是否必填access_token调用接口凭证是bufferjson数据是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分店名称（不应包含地区信息，不应与门店名有重复，错误示例：北京王府井店）10个字