# New stores

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface name: addentityshop

This interface is used for new stores

# 1. How to call

# HTTPS calls

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

# Cloud Calls

This interface does not support cloud calls

# Third party invocation

This interface supports Third Party Platform generation business call.
This interface belongs to the permission set id: 8-10,13
When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parameters`Query String parameters`

Parameter Name	type	Required to fill in	Introductions
access_token	string	yes	Interface invocation credentials, using access_token , authorizer_access_token

# Request Body`Request Payload`

Parameter Name	type	Required to fill in	Introductions
map_poi_id	string	yes	The location point id exchanged from the Tencent map, that is, the sosomap poi uid field returned by the search_map_poi interface
pic_list	string	yes	Store image, can pass multiple images, the field is a json character string
contract_phone	string	yes	Contact telephone
hour	string	yes	Hours of operation, format 11: 11 - 12: 12
credential	string	yes	Business certification certificate number
company_name	string	no	Principal name, company_name is empty if the principal is multiplexed Official Account, or specific principal name if the principal is not multiplexed from the Official Account message template
card_id	string	yes	Coupon ID, if you don't need to add coupons, this parameter can be empty. Currently, it's only open to support loyalty cards, purchases, and swipe payment coupons. No custom code is supported. You need to go to the public platform coupons backend to create a cardid
qualification_list	array	no	When you do not reuse the Official Account main body, you need to fill in support of 0 to 5 mediaids, such as mediaid1 or mediaid2
poi_id	string	no	If you are migrating from Store Management to Weixin Mini Program, you need to fill in this field

# 3. Return Parameters

# `Response Payload`

Parameter Name	type	Introductions
errcode	number	Error code
errmsg	string	Error Description
data	object	New information

# Res.data`Object Payload`

New information

Parameter Name	type	Introductions
audit_id	number	Audit id

# 4. Note

There are no special considerations for this interface

# 5. Code examples

Example Requests

{
  "poi_id": "",
  "map_poi_id": "2880741500279549033",
  "pic_list":"{\"list\":[\"http://mmbiz.qpic.cn/mmbiz_jpg/tW66AWvE2K4EJxIYOVpiaGOkfg0iayibiaP2xHOChvbmKQD5uh8ymibbEKlTTPmjTdQ8ia43sULLeG1pT2psOfPic4kTw/0?wx_fmt=jpeg\"]}",
  "contract_phone": "1111222222",
  "credential": "22883878-0",
  "qualification_list": "RTZgKZ386yFn5kQSWLTxe4bqxwgzGBjs3OE02cg9CVQk1wRVE3c8fjUFX7jvpi-P"
}

Return an example

{
  "errcode" : 0,
  "errmsg" : "ok",
  "data" : {
    "audit_id":111
  }
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

Error code	Error Description	Solutions
40001	invalid credential access_token isinvalid or not latest	AppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account
85038	store has added	Do not add duplicate stores
85039	store has added by others	This store status cannot be obtained.
85040	store has added by yourseld	This store has been bound, there is no need to repeat binding
85041	credential has used	This business qualification has been added. Do not add it repeatedly
85042	nearby reach limit	The number of nearby location additions reached online and could not continue to be added.
85054	poi_id is null	Since the store Weixin Mini Program has not been upgraded successfully, you need to add poi_id for the store migration
85055	map_poi_id is invalid	Map_poi_id is invalid
85056	mediaid is invalid	Temporary mediaid is invalid

# 7. Scope of application

How this interface can be invoked under different account types:

Official Account	Service Account
✔	✔

✔: The account can call this interface
Other account types that are not expressly stated may not be called on this interface without special instructions;