# 添加地点

调试工具

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

addNearbyPoi

# 功能描述

该接口用于添加附近小程序的地点。

# 注意事项

添加请求暂不支持并发调用，建议使用时间隔1s进行串行调用

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN

# 云调用

出入参和HTTPS调用相同，调用方式可查看云调用说明文档
接口方法为: openapi.nearbyPoi.add

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：37
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token或者authorizer_access_token
kf_info	string	是	客服信息选填，可自定义服务头像与昵称，具体填写字段见下方示例kf_info pic_list是字符串，内容是一个json
pic_list	string	是	门店图片，最多9张，最少1张，上传门店图片如门店外景、环境设施、商品服务等，图片将展示在微信客户端的门店页。图片链接通过文档https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1444738729中的《上传图文消息内的图片获取URL》接口获取。必填，文件格式为bmp、png、jpeg、jpg或gif，大小不超过5M pic_list是字符串，内容是一个json
service_infos	string	是	必服务标签列表必填，需要填写 1、服务标签ID 2、服务类型tpye 3、服务名称name 详细字段格式见下方《服务标签id编号、类型与服务名称表》 4、 APPID 5、对应服务落地页的path路径：path路径页面要与对应的服务标签一致，例如选取外卖服务，path路径应该是小程序的外卖对应的那个页面，path路径获取咨询开发或者到小程序管理后台-工具-生成小程序码页面获取 6、新增服务描述desc：描述服务内容，例如满减、折扣等优惠信息或新品、爆品等商品信息，仅标准服务都可添加，10个字符以内。 service_infos是字符串，内容是一个json
store_name	string	是	门店名字必填，门店名称需按照所选地理位置自动拉取腾讯地图门店名称，不可修改，如需修改请重现选择地图地点或重新创建地点。
contract_phone	string	是	门店电话
hour	string	是	营业时间，格式11:11-12:12
company_name	string	是	主体名字
credential	string	是	资质号, 15位营业执照注册号或9位组织机构代码
address	string	是	地址
qualification_list	string	是	证明材料必填如果company_name和该小程序主体不一致，需要填qualification_list，详细规则见附近的小程序使用指南-如何证明门店的经营主体跟公众号或小程序账号主体相关http://kf.qq.com/faq/170401MbUnim17040122m2qY.html
is_comm_nearby	string	是	必填,写死为"1"
poi_id	string	是	如果创建新的门店，poi_id字段为空如果更新门店，poi_id参数则填对应门店的poi_id 选填
map_poi_id	string	是	对应《在腾讯地图中搜索门店》中的sosomap_poi_uid字段腾讯地图那边有些数据不一致，如果不填map_poi_id的话，小概率会提交失败！注： poi_id与map_poi_id关系： map_poi_id是腾讯地图对于poi的唯一标识 poi_id是门店进驻附近后的门店唯一标识

# 返回参数

属性

类型

说明

errcode

number

errmsg

string

data

object

附近小程序的数据

属性	类型	说明
audit_id	number	审核单 ID
poi_id	number	附近地点 ID
related_credential	string	经营资质证件号

# 其他说明

# 一、服务标签id编号、类型与服务名称表

ID	type	name(服务名称)
0	2	自定义服务，可自定义名称（10个字符以内）
1	1	外送
2	1	快递
3	1	充电
4	1	预约
5	1	挂号
6	1	点餐
7	1	优惠
8	1	乘车
9	1	会员
10	1	买单
11	1	排队
12	1	缴费
13	1	购票
14	1	到店自提
15	1	预订

# 二、审核状态通知格式如下：

审核结果将推送至消息服务器URL地址，如果是第三方服务商代添加，则推送至第三方平台“消息与事件URL”.

<xml>
  <ToUserName><![CDATA[gh_4346ac1514d8]]></ToUserName>
  <FromUserName><![CDATA[od1P50M-fNQI5Gcq-trm4a7apsU8]]></FromUserName>
  <CreateTime>1488856741</CreateTime>
  <MsgType><![CDATA[event]]></MsgType>
  <Event><![CDATA[add_nearby_poi_audit_info]]></Event>
  <audit_id>11111</audit_id>  //审核单id
  <status>3</status>                // 2: 审核失败 3: 审核通过
  <reason><![CDATA[xxx]]></reason>  //审核失败的理由
  <poi_id>111111</poi_id>
</xml>

# 调用示例

示例说明: HTTPS调用

# 请求数据示例


{
"is_comm_nearby":1,
"pic_list":"{\"list\":[\"http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/xdtQKcpj6RuwiafT12xxxxxxxxxibSVYicfUicy2fRqiacjriatWVZPeZsVlI0eztm5Mzjfdy4wcQVicscfapoqlzQ2g\/0\"]}",
"store_name":"xxx黄焖鸡米饭(xxxx店)",
"hour":"00:00-23:59",
"credential":"92321324MA24xxxxxxx",
"address":"江苏省宿迁市泗洪县尚城府邸xxxxxxxx",
"company_name":"xxxx县阿庆小吃部",
"service_infos":"{\"service_infos\":[{\"id\":\"1\",\"type\":\"1\",\"name\":\"外卖\",\"appid\":\"wx4e96615821xxxxxx\",\"path\":\"\/pages\/index\/store\/store?scene=148897\"}]}",
"qualification_list":"rNdNSNGaFDIGsyhucEPyANpW9_OIMa9iXSh-CdEXqL8pkqxxxxxx",
"kf_info":"{\"open_kf\":false}",
"contract_phone":"18071xxxxxx",
"map_poi_id":"30323090226254xxxxx"
}

# 返回数据示例


{ 
"errcode":0, 
"errmsg":"ok", 
"data":{ 
"audit_id":416620525, 
"poi_id": 112333 
} 
}

# 错误码

错误码	错误码取值	解决方案
40001	invalid credential access_token isinvalid or not latest	获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口