微信门店小程序接口文档

太过爱你忘了你带给我的痛 2022-06-08 11:12 265阅读 0赞

目录  
微信门店小程序接口文档  
一、简介须知  
二、权限须知  
三、门店接口概览  
四、接口开发  
1.拉取门店小程序类目  
2.创建门店小程序  
3.查询门店小程序审核结果  
4.修改门店小程序信息  
5.从腾讯地图拉取省市区信息  
6.在腾讯地图中搜索门店  
7.在腾讯地图中创建门店  
8.添加门店  
9.更新门店信息  
10.获取单个门店信息  
11.获取门店信息列表  
12.删除门店  
13.升级流程 — 从门店管理迁移到门店小程序  
14.业务接口-门店小程序卡券.

微信门店小程序接口文档  
一、简介须知  
门店小程序是公众平台向商户提供的对其线下门店相关功能的管理能力。门店小程序可设置到公众号介绍页、自定义菜单和图文消息中，通过附近关联导入出现在“附近的小程序”，也可应用在卡券、广告、WIFI等业务使用。  
门店小程序接口是为商户提供批量新增、查询、修改、删除门店等主要功能，包括创建小程序商家账号，方便商户快速高效进行门店管理和操作。  
备注：原门店管理权限可通过升级为门店小程序使用相关权限。  
示例图：

二、权限须知  
门店小程序权限开放给所有非个人公众号；拥有旧门店管理权限的公众号可通过升级获取门店小程序权限。  
曾授权第三方旧门店管理权限集的公众号，门店小程序权限集默认授权原第三方。  
三、门店接口概览

四、接口开发  
1.拉取门店小程序类目  
请求方式：GET（请使用https协议）  
[https://api.weixin.qq.com/wxa/get\_merchant\_category?access\_token=TOKEN][https_api.weixin.qq.com_wxa_get_merchant_category_access_token_TOKEN]  
请求参数：  
参数  
说明  
access\_token  
调用接口凭证  
返回json示例（门店小程序类目分一级和二级类目）：  
\{  
“errcode”: 0,  
“errmsg”: “ok”,  
“data”: \{  
“all\_category\_info”: \{  
“categories”: \[  
\{  
“id”: 0,  
“name”: “root”,  
“level”: 0, //根节点，对应子节点是一级类目的id  
“children”: \[ //子节点列表  
269,  
278  
\]  
\},  
\{  
“id”: 278,  
“name”: “购物”,  
“level”: 1,//一级类目  
“father”: 0,  
“children”: \[  
279,  
280  
\]  
\},  
\{  
“id”: 280,  
“name”: “便利店”,  
“level”: 2, //二级类目  
“father”: 278,  
“children”: \[\],  
“qualify”: \{  
“exter\_list”: \[  
\{  
“inner\_list”: \[  
\{  
“name”: “若涉及食品，请提供《食品经营许可证》或《卫生许可证》” //需要提交的证件名字  
\}  
\]  
\}  
\]  
\},  
“scene”: 3,  
“sensitive\_type”: 1 //如果sensitive\_type=1，在创建门店小程序时，需要添加相关证件  
\},  
…  
\]  
\}  
\}  
\}  
返回参数说明：  
参数  
说明  
备注  
id  
类目id  
必填  
level  
类目的级别，一级或者二级类目  
必填  
sensitive\_type  
0或者1，  
0表示不用特殊处理  
1表示创建该类目的门店小程序时，需要添加相关证件  
必填  
qualify.exter\_list.inner\_list.name  
相关证件的名字  
必填

可参考：门店小程序类目对应表

2.创建门店小程序  
说明：创建门店小程序提交后需要公众号管理员确认通过后才可进行审核。如果主管理员24小时超时未确认，才能再次提交。  
请求方式: POST（请使用https协议）  
[https://api.weixin.qq.com/wxa/apply\_merchant?access\_token=TOKEN][https_api.weixin.qq.com_wxa_apply_merchant_access_token_TOKEN]  
POST数据示例：  
\{  
“first\_catid”: 476, //get\_store\_category接口获取的一级类目id  
　　　“second\_catid”: 477, //get\_store\_category接口获取的二级类目id  
　　　“qualification\_list”: “RTZgKZ386yFn5kQSWLTxe4bqxwgzGBjs3OE02cg9CVQk1wRVE3c8fjUFX7jvpi-P”,  
“headimg\_mediaid”: “RTZgKZ386yFn5kQSWLTxe4bqxwgzGBjs3OE02cg9CVQk1wRVE3c8fjUFX7jvpi-P”,  
“nickname”: “hardenzhang308”,  
“intro”: “hardenzhangtest”,  
“org\_code”: “”,  
“other\_files”: “”  
\}  
请求参数说明：  
参数  
说明  
备注  
first\_catid  
一级类目id  
必填  
second\_catid  
二级类目id  
必填  
qualification\_list  
类目相关证件的临时素材mediaid  
如果second\_catid对应的sensitive\_type为1，则qualification\_list字段需要填  
支持0~5个mediaid，例如mediaid1|mediaid2  
选填  
headimg\_mediaid  
头像 — 临时素材mediaid  
mediaid用现有的media/upload接口得到的,获取链接：  
[https://mp.weixin.qq.com/wiki?t=t=resource/res\_main&id=mp1444738726][https_mp.weixin.qq.com_wiki_t_t_resource_res_main_id_mp1444738726]  
(支持jpg和png格式的图片，后续加上其他格式)  
必填  
nickname  
门店小程序的昵称  
名称长度为4-30个字符（中文算两个字符）  
必填  
intro  
门店小程序的介绍  
必填  
org\_code  
营业执照或组织代码证 — 临时素材mediaid  
如果返回错误码85024，则该字段必填，否则不用填  
选填  
other\_files  
补充材料 — 临时素材mediaid  
如果返回错误码85024，则可以选填  
支持0~5个mediaid，例如mediaid1|mediaid2  
选填  
access\_token  
调用接口凭证  
必填  
返回json示例：  
\{  
“errcode” : 0,  
“errmsg” : “ok”  
\}  
错误码说明：  
返回码  
说明  
85024  
你申请的名称需要补充相应资料进行审核，此时请求参数org\_code和other\_files需要填写  
85025  
管理员手机登记数量已超过上限，不能使用该主体开通门店  
85026  
该微信号已绑定5个管理员，请使用另一个微信号完成信息登记  
85027  
管理员身份证已登记过5次，请使用另一个身份证完成用户信息登记  
85028  
该主体登记数量已超过上限，不能使用该主体开通门店  
85029  
商家名称已被占用，请换一个重试  
85030  
名称长度为4-30个字符（一个中文占两个字符），不能含有特殊字符及“微信”等保留字”  
85031  
不能使用该名称  
85032  
该名称在侵权投诉保护期，暂不支持申请，请重新提交一个新的名称  
85033  
名称不能包含违反公众平台协议、相关法律法规和政策的内容，不得使用“微信”等保留字  
85034  
商家名称在改名15天保护期内，请换一个重试。  
85035  
需与该帐号相同主体才可申请  
85036  
介绍中不得含有虚假的、冒充、利用他人名义的、容易构成混淆、误认的、法律、法规和政策禁止的内容  
85049  
头像或者简介修改达到每个月上限  
43104  
没有权限  
85050  
正在审核中，请勿重复提交  
85053  
请先成功创建门店后再调用  
85056  
临时mediaid无效

事件推送 - 创建门店小程序的审核结果

[https_api.weixin.qq.com_wxa_get_merchant_category_access_token_TOKEN]: https://api.weixin.qq.com/wxa/get_merchant_category?access_token=TOKEN
[https_api.weixin.qq.com_wxa_apply_merchant_access_token_TOKEN]: https://api.weixin.qq.com/wxa/apply_merchant?access_token=TOKEN
[https_mp.weixin.qq.com_wiki_t_t_resource_res_main_id_mp1444738726]: https://mp.weixin.qq.com/wiki?t=t=resource/res_main&id=mp1444738726