开发指南
API
官网
API 2.0
API 2.0 > 1.1 门店 > 1.1.3 创建门店

1.1.3 创建门店

开启令牌和权限后可调用。签名方式请查看开发指南
场景描述：新增当前店铺下的门店信息
零售 餐饮

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 multi-store.multi-store-add 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
name string 是 门店名称
province_id int 是 省份ID(参考高德城市编码表 http://lbs.amap.com/api/webservice/download)
city_id int 是 城市ID(参考高德城市编码表 http://lbs.amap.com/api/webservice/download)
linkman string 是 联系人
id_card string 否 身份证号
district_id int 是 区ID
address string 是 详细地址，不包含省市区信息
images array 否
 ├0 array 是 门店图片，至少包含一张图片
desc string 是 商家推荐
is_work int 是 营业状态，1:营业，0:休息
phone string 否 手机号码
lat string 是 地理位置纬度
lng string 是 地理位置经度
is_city_express int 否 是否支持同城配送，1:支持，0:不支持
is_express int 否 是否支持快递配送，1:支持，0:不支持
is_self_fetch int 否 是否支持到店自提，1:支持，0:不支持
org_id int 否 机构ID
phone_body string 否 固定电话 - 前缀，如0551
phone_pre string 否 固定电话 - 正文。固定电话和手机号码至少填写一项
share_content string 否 分享描述
share_img string 否 分享图片
multi_mark string 是 门店编码
businerss_hours_setting array 否 times:时间区间：开始时间 ,结束时间 ["00:00","23:00"] weeks：1 ～ 7 分别代表 星期一到星期天；不是区间！！["1","3"] ，示例： "businerss_hours_setting": { "weekly_business_hours": [ { "times": [ "00:00", "23:00" ], "weeks": [ "1", "2" ] } ] }

响应参数

参数 参数类型 描述
status bool 请求成功或者失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├id int 商品id
 ├reta_multi_mark string 门店编码

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "multi-store.multi-store-add",
    "Params": {
        "name": "",
        "province_id": "",
        "city_id": "",
        "linkman": "",
        "id_card": "",
        "district_id": "",
        "address": "",
        "images": [
            ""
        ],
        "desc": "",
        "is_work": "",
        "phone": "",
        "lat": "",
        "lng": "",
        "is_city_express": "",
        "is_express": "",
        "is_self_fetch": "",
        "org_id": "",
        "phone_body": "",
        "phone_pre": "",
        "share_content": "",
        "share_img": "",
        "multi_mark": "",
        "businerss_hours_setting": "{                 \"weekly_business_hours\": [                     {                         \"times\": [                             \"00:00\",                             \"23:00\"                         ],                         \"weeks\": [                             \"1\",                             \"2\"                         ]                     }                 ]          }"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "id": "",
        "reta_multi_mark": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

请求地址

请求方式 版本信息 请求地址
POST V2 http://openapi.zvcms.com/api/v2

公共参数

参数 参数类型 是否必填 默认值 描述
OpenId string 是 密钥Id
GrantCode string 是 授权code
Token string 是 签名，参考《数字签名sign》
Timestamp string 是 当前时间戳
Nonce string 是 随机正整数
Action string 是 multi-store.multi-store-add 接口方法
Params array 是 业务参数

请求参数

参数 参数类型 是否必填 默认值 描述
name string 是 门店名称
province_id int 否 省份ID(参考高德城市编码表 http://lbs.amap.com/api/webservice/download)
city_id int 否 城市ID(参考高德城市编码表 http://lbs.amap.com/api/webservice/download)
area_id int 是 区域ID(参考高德城市编码表 http://lbs.amap.com/api/webservice/download)
linkman string 是 联系人
id_card string 是 身份证号
photo array 是 店铺logo的url，数组
street string 是 街道地址
longitude float 是 经度
latitude float 是 纬度
per_price float 是 人均消费
notice string 否 店铺公告
mobile string 是 手机号
tel string 否 座机
status int 是 门店状态。1营业2休息
is_eat int 是 堂食开启状态。0关闭1开启
is_takeout int 是 外卖开启状态。0关闭1开启
is_appoint int 是 预约开启状态。0关闭1开启
multi_mark string 是 门店编码
lable array 是 门店标签,数组形式
service array 是 门店服务,数组形式停车场1,wifi2,露天位3,儿童游乐区4,可吸烟5,刷卡6,包间7,无烟区8,沙发位9
saletimes array 是 门店营业时间，数组形式

响应参数

参数 参数类型 描述
status bool 请求成功或者失败
code int 成功/错误编码
message string 成功/错误描述
data array
 ├multi_store_id int 门店id
 ├multi_mark string 门店编码

请求示例

{
    "OpenId": "6dc05b4ac175cf316d226252b05cf685",
    "GrantCode": "782c281f62",
    "Timestamp": "1547186244",
    "Nonce": "658965",
    "Token": "0%2B%2B3c6hthjwAml4ABAXOYF4Q6UY%3D",
    "Action": "multi-store.multi-store-add",
    "Params": {
        "name": "",
        "province_id": "",
        "city_id": "",
        "area_id": "",
        "linkman": "",
        "id_card": "",
        "photo": "",
        "street": "",
        "longitude": "",
        "latitude": "",
        "per_price": "",
        "notice": "",
        "mobile": "",
        "tel": "",
        "status": "",
        "is_eat": "",
        "is_takeout": "",
        "is_appoint": "",
        "multi_mark": "",
        "lable": "[1,2]",
        "service": "[18,12]",
        "saletimes": "[{\"workweek\":[\"5\"],\"worktime\":[{\"time\":[\"00:00\",\"23:59\"]}]},{\"workweek\":[\"3\"],\"worktime\":[{\"time\":[\"00:00\",\"23:59\"]}]},{\"workweek\":[\"1\",\"2\",\"4\",\"6\",\"7\"],\"worktime\":[{\"time\":[\"00:00\",\"23:59\"]}]}]"
    }
}

响应示例

{
    "status": "true",
    "code": "0",
    "message": "说明",
    "data": {
        "multi_store_id": "",
        "multi_mark": ""
    }
}

异常示例

{
    "status": true,
    "code": "异常编码，根据不同的业务返回编码",
    "message": "异常说明：查询的信息不存在"
}

错误码

{
    "status": false,
    "code": "系统错误编码：详见全局返回编码",
    "message": "系统错误说明"
}

免费升级

营销功能、插件持续每月更新开发升级

免费专业培训

每月建站、微信营销、电商等互联网增值培训

7×24小时服务支持

400电话、QQ、微信、在线等多渠道售后支持

 

安徽智迈科技股份有限公司 版权所有 Copyright 2009-2018 皖公网安备 34019202000074号 增值电信业务经营许可证：皖B2-20170075