添加门店仓库

请求地址

stores/add

请求方法

POST

请求参数

名称	类型	描述
account_id 必填	integer	推广帐号 id ，有操作权限的帐号 id，包括代理商和广告主帐号id
data_warehouse_id 必填	integer	数据仓库ID
stores 必填	struct[]	仓库列表数组最大长度 50
external_store_id 必填	string	您为仓库分配的唯一ID。一般而言，是您在商品库为该仓库分配的id。字段长度最小 1 字节，长度最大 32 字节
name 必填	string	店仓名称建议格式：品牌名称（XX店）字段长度最小 1 字节，长度最大 32 字节
type 必填	enum	门店类型 shop：门店仓（可进行线下购物的门店）；warehouse：前置仓（支持同城配/落地配的仓库；ec_warehouse：电商仓（支持快递配送的仓库）枚举列表：{ SHOP、WAREHOUSE、EC_WAREHOUSE }
operation_status	enum	运营状态 open：开业;close：关店；suspend：暂停营业与daojia_operation_status两者必填其一枚举列表：{ OPEN、CLOSE、SUSPEND }
daojia_operation_status	enum	运营状态 open：开业;close：关店；suspend：暂停营业与operation_status两者必填其一枚举列表：{ OPEN、CLOSE、SUSPEND }
phone_numbers	string[]	店仓电话列表格式075588888888
location_info	struct	地址信息
country_code	string	国家编码与country_name两者必填其一 CNN 字段长度最小 1 字节，长度最大 64 字节
country_name	string	国家名称与country_code两者必填其一中国字段长度最小 1 字节，长度最大 64 字节
province_code	integer	省份编码，使用《统计用区划代码和城乡分代码编制规则与province_name两者必填其一 440000
province_name	string	省份名称与province_code两者必填其一 XX省字段长度最小 1 字节，长度最大 64 字节
city_code	integer	城市编码，使用《统计用区划代码和城乡分代码编制规则与city_name两者必填其一
city_name	string	城市名称与city_code两者必填其一 XX市字段长度最小 1 字节，长度最大 64 字节
district_code	integer	行政区编码，使用《统计用区划代码和城乡分代码编制规则与district_name两者必填其一
district_name	string	行政区名称与district_code两者必填其一 XX区字段长度最小 1 字节，长度最大 64 字节
address 必填	string	除国家省市区之外的地址信息，如：文心五路保利文化广场B区二楼字段长度最小 1 字节，长度最大 64 字节
geo_info	struct[]	坐标信息
geo_type 必填	enum	填写了longitude和latitude则必填 gaode：腾讯/高德地图；baidu：百度地图：standard：国际标准枚举列表：{ BAIDU、GAODE、STANDARD }
latitude 必填	float	店仓纬度如：22.5200
longitude 必填	float	店仓经度如：113.9400
basic_props	struct	基础信息
operating_time_zones	struct[]	为空默认周一至周日，10:00-22:00
date_zone 必填	string	日期区间字段长度最小 1 字节，长度最大 64 字节
time_zone 必填	string	时间区间字段长度最小 1 字节，长度最大 64 字节
daojia_operating_time_zones	struct[]	为空默认周一至周日，10:00-22:00
date_zone 必填	string	日期区间字段长度最小 1 字节，长度最大 64 字节
time_zone 必填	string	时间区间字段长度最小 1 字节，长度最大 64 字节
logo	struct	单个图片信息，包含URL，宽，高，说明等
img_url	string	url类型，长度不超过2048 字段长度最小 1 字节，长度最大 2048 字节
width	integer	图片宽度，整型值
height	integer	图片高度，整型值
img_desc	string	图片描述字段长度最小 1 字节，长度最大 100 字节
delivery_info	struct	配送信息
delivery_range_type	enum	配送范围类型 circle：圆形；vertexes_group：多边形 type=warehouse时，必填枚举列表：{ CIRCLE、VERTEXES、VERTEXES_GROUP }
radius	string	配送半径 delivery_range_type=circle时，必填字段长度最小 1 字节，长度最大 128 字节
geo_group	array[]	坐标信息组合，坐标点的二维数组，表示多个形状 delivery_range_type=vertexes_group时，必填

请求示例

curl 'https://api.e.qq.com/v1.1/stores/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d 'account_id="<ACCOUNT_ID>"' \
-d 'data_warehouse_id=101' \
-d 'stores=[
    {
        "external_store_id": "大小写字母数字下划线100000001",
        "name": "银科1店",
        "type": "SHOP",
        "operation_status": "OPEN",
        "daojia_operation_status": "OPEN",
        "phone_numbers": [
            "13677778888"
        ],
        "location_info": {
            "country_code": "CNN",
            "country_name": "中国",
            "province_code": 110000,
            "province_name": "北京",
            "city_code": 110100,
            "city_name": "北京市",
            "district_code": 110101,
            "district_name": "西城区",
            "address": "银科大厦111",
            "geo_info": [
                {
                    "geo_type": "BAIDU",
                    "latitude": 23.31,
                    "longitude": 108.22
                }
            ]
        },
        "basic_props": {
            "operating_time_zones": [
                {
                    "date_zone": "周一至周五",
                    "time_zone": "8:00-17:00"
                },
                {
                    "date_zone": "法定节假日",
                    "time_zone": "8:00-19:00"
                }
            ],
            "daojia_operating_time_zones": [
                {
                    "date_zone": "周一至周五",
                    "time_zone": "8:00-17:00"
                },
                {
                    "date_zone": "法定节假日",
                    "time_zone": "8:00-19:00"
                }
            ]
        },
        "delivery_info": {
            "delivery_range_type": "VERTEXES",
            "radius": "3km"
        }
    }
]'

应答字段

应答示例

{
    "code": 0,
    "message": "",
    "data": {}
}