门店仓库添加/变更（多店版）

开发之前请创建有数数据仓库 （dataSourceId），可将 dataSourceId 理解为数据的集合。创建一个数据仓库后，所有接口传输数据时都可重复使用。

请求地址

域名/data-api/v1/store/add

请求方法

POST

请求参数

参数名	样例	描述
app_id	abc	分配的app_id
nonce	61794670f155b	随机字符串
sign	sha256	签名算法
timestamp	1569232087	请求时间戳（秒级）
signature	aee30792812d7b09ba7d3aa67c24e16c6a7ea81282ac728ad5966dd1b3eef6d5	签名结果

请求体参数

名称	类型	必填	描述
dataSourceId	string	Y	数据源id（create方法返回的data.dataSource.id）
stores	array	Y	仓库列表 数组最大长度 50
external_store_id	string	Y	您为仓库分配的唯一ID。 一般而言，是您在商品库为该仓库分配的id。 字段长度最小 1 字节，长度最大 32 字节
type	integer	Y	门店类型；1：门店仓（可进行线下购物的门店）；2：前置仓（支持同城配/落地配的仓库；3：电商仓（支持快递配送的仓库）
business_type	integer	Y	门店经营类型 可固定填写 99：其他
operation_status	integer	Y	营业状态 1：开业；2：关店；3：暂停营业
status	integer		经营状态 1：正常经营；2：歇业关闭
sha256_phone_numbers	string[]		店仓电话列表，数组，sha256加密
location_info	object	Y	地址信息
country_code	string		国家编码，CN 字段长度最小 1 字节，长度最大 64 字节
country_name	string	Y	国家名称，中国 字段长度最小 1 字节，长度最大 64 字节
province_code	integer		省份编码，使用《民政部行政区划代码》，440000
province_name	string	Y	省份名称，XX省 字段长度最小 1 字节，长度最大 64 字节
city_code	integer		城市编码，使用《民政部行政区划代码》
city_name	string	Y	城市名称，XX市 字段长度最小 1 字节，长度最大 64 字节
district_code	integer		区/县编码，使用《民政部行政区划代码》
district_name	string		区/县名称，字段长度最小 1 字节，长度最大 64 字节
address	string	Y	店仓详细地址
geo_info	array		坐标信息
type	integer	C	若填写了longitude和latitude则必填 1：腾讯/高德地图；2：百度地图：3：国际标准
latitude	float		店仓纬度，如：22.5200
longitude	float		店仓经度，如：113.9400
basic_props	object	Y	基础信息
name	string	Y	店仓名称建议格式：品牌名称（XX店） 字段长度最小 1 字节，长度最大 32 字节
logo	string		店铺图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
opening_time	string		店仓开业时间 时间戳 毫秒 字段长度为长度为 13 字节
operating_time	array		为空默认周一至周日，10:00-22:00
date_zone	string	C	日期区间，例：周一至周日，若填写了`time_zone`则必填；字段长度最小 1 字节，长度最大 64 字节
time_zone	string	C	时间区间，例：10:00-22:00，若填写了`date_zone`则必填；字段长度最小 1 字节，长度最大 64 字节
delivery_info	object		配送信息
minimum_delivery_order_amount	float		起送价，单位元，保留 2 位小数
minimum_freight_amount	float		最低运费，供门店展示配送服务使用，单位元，保留 2 位小数
range_type	integer	C	配送范围类型 1：圆形；3：多边形；store支持到家配送时必填
radius	string	C	配送半径，单位米，range_type = 1 时必填 字段长度最小 1 字节，长度最大 128 字节
geo_group	array	C	坐标信息组合，坐标点的二维数组，表示多个形状，range_type=3时必填
geos	array	C	坐标点信息，range_type=3时必填
type	integer	C	坐标类型，若填写了longitude和latitude则必填；1：腾讯/高德地图；2：百度地图：3：国际标准
latitude	float	C	电子围栏纬度，如：22.5200，range_type=3时必填
longitude	float	C	电子围栏经度，如：113.9400，range_type=3时必填
target_url	object		店铺落地页信息
url_store_h5	string		店铺 h5 首页url，字段长度最小 1 字节，长度最大 2048 字节
url_store_miniprogram	string		店铺微信小程序首页url，字段长度最小 1 字节，长度最大 2048 字节
miniprogram_appid	string	C	微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
usage_info	array		当某一门店的商品应用于特定场景时输入商品应用场景ID
inner_appid	integer		商品应用场景 ID。16：直跳；19：广告CPS；20：搜一搜品牌专区；21：云选联盟；22：商品广告；23：腾讯惠聚
is_deleted	integer		商家标记门店仓库信息已删除，0：未删除；1：已删除，为空默认为 0

请求体类型

application/json

请求示例

{
    "dataSourceId": "105",
    "stores": [
        {
            "external_store_id": "9L11",
            "type": 1,
            "business_type": 99,
            "operation_status": 1,
            "sha256_phone_numbers": [
                "9c0376063270573736d48ebd6a9e99230c0d8892671d5a79ef94e8c4eeccaf09"
            ],
            "location_info": {
                "country_code": "CN",
                "country_name": "中国",
                "province_code": 440000,
                "province_name": "广东省",
                "city_code": 440300,
                "city_name": "深圳市",
                "district_code": 440305,
                "district_name": "南山区",
                "address": "文心五路保利文化广场B区二楼",
                "geo_info": [
                    {
                        "latitude": 45.73622,
                        "longitude": 126.54209,
                        "type": 3
                    }
                ]
            },
            "basic_props": {
                "name": "品牌名称（海岸城店）",
                "opening_time": "1515118117111",
                "operating_time": [
                    {
                        "date_zone": "周一至周日",
                        "time_zone": "10:00-22:00"
                    }
                ]
            },
            "delivery_info": {
                "range_type": 3,
                "geo_group": [
                    {
                        "geos": [
                            {
                                "type": 1,
                                "latitude": 26.075368,
                                "longitude": 119.329487
                            },
                            {
                                "type": 1,
                                "latitude": 26.075701,
                                "longitude": 119.330897
                            },
                            {
                                "type": 1,
                                "latitude": 26.076569,
                                "longitude": 119.341892
                            }
                        ]
                    },
                    {
                        "geos": [
                            {
                                "type": 1,
                                "latitude": 26.075368,
                                "longitude": 119.329487
                            },
                            {
                                "type": 1,
                                "latitude": 26.075701,
                                "longitude": 119.330897
                            },
                            {
                                "type": 1,
                                "latitude": 26.076569,
                                "longitude": 119.341892
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

应答字段

名称	类型	描述
retcode	integer	返回码
errmsg	string	错误信息
data	json object	响应内容

应答示例

{
    "retcode": 0,
    "errmsg": "",
    "data": {}
}