附近小程序 /添加地点
# 添加地点
> 接口应在服务器端调用，详细说明参见[服务端API](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/backend-api.html)。
> 本接口支持[云调用](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/openapi/openapi.html)。需开发者工具版本 >= `1.02.1904090`（最新[稳定版下载](https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html)），`wx-server-sdk` >= `0.4.0`
## 接口说明
### 接口英文名
addNearbyPoi
### 功能描述
该接口用于添加附近小程序的地点。
### 注意事项
- 添加请求暂不支持并发调用，建议使用时间隔1s进行串行调用
## 调用方式
### HTTPS 调用
```text
POST https://api.weixin.qq.com/wxa/addnearbypoi?access_token=ACCESS_TOKEN
```
### 云调用
- 出入参和 HTTPS 调用相同，调用方式可查看[云调用说明文档](https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/openapi/openapi.html)
- 接口方法为: openapi.nearbyPoi.add
### 第三方调用
- 调用方式以及出入参和 HTTPS 相同，仅是调用的 token 不同
- 该接口所属的权限集 id 为：37
- 服务商获得其中之一权限集授权后，可通过使用[authorizer_access_token](https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/api_authorizer_token.html)代商家进行调用
### 请求参数
| 属性 | 类型 | 必填 | 说明 |
| :------------------------------------ | :----- | :--- | :----------------------------------------------------------- |
| access_token / cloudbase_access_token | string | 是 | 接口调用凭证，该参数为 URL 参数，非 Body 参数。access_token和cloudbase_access_token二选一 其中access_token可通过[getAccessToken](https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html)接口获得； 如果是第三方代调用请传入[authorizer_access_token](https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/ThirdParty/token/api_authorizer_token.html)； cloudbase_access_token可通过[getOpenData](https://developers.weixin.qq.com/miniprogram/dev/wxcloudrun/src/guide/weixin/token.html)接口获得 |
| 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_idnumber审核单 IDpoi_idnumber附近地点 IDrelated_credentialstring经营资质证件号 | | |
## 其他说明
### 一、服务标签 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”.
```text
<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调用
### 请求数据示例
```json
{
"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"
}
```
### 返回数据示例
```json
{
"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 的正确性，或查看是否正在为恰当的公众号调用接口 |
| | | |
| :--- | :--- | :--- |
| | | |
| | | |
| | | |