跳到主要内容

门店仓库添加/变更[多店]


前置条件

请在 DataNexus -<数据接入>-<数据源>中新建数据源，参考新建数据源。并在数据源中选择或新建数据集，参考新建数据集。


请求地址​

https://api.e.qq.com/v1.1/store/add


请求方法​

POST


请求参数​

参数名描述
access_token授权令牌，完成 OAuth 2.0 授权后获得，参考开发者账号及环境
timestamp当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59
nonce随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性

请求体类型​

application/json


请求体参数​

名称类型必填描述
dataSourceIdstringY数据源id（create方法返回的data.dataSource.id）
storesarrayY仓库列表 数组最大长度 50
external_store_idstringY您为仓库分配的唯一ID。 一般而言，是您在商品库为该仓库分配的id。 字段长度最小 1 字节，长度最大 32 字节
typeintegerY门店类型；1：门店仓（可进行线下购物的门店）；2：前置仓（支持同城配/落地配的仓库；3：电商仓（支持快递配送的仓库）
business_typeintegerY门店经营类型 可固定填写 99：其他
operation_statusintegerY营业状态 1：开业；2：关店；3：暂停营业
statusinteger经营状态 1：正常经营；2：歇业关闭
sha256_phone_numbersstring[]店仓电话列表，sha256加密
location_infoobjectY地址信息
country_codestring国家编码，CN 字段长度最小 1 字节，长度最大 64 字节
country_namestringY国家名称，中国 字段长度最小 1 字节，长度最大 64 字节
province_codeinteger省份编码，使用《民政部行政区划代码》，440000
province_namestringY省份名称，XX省 字段长度最小 1 字节，长度最大 64 字节
city_codeinteger城市编码，使用《民政部行政区划代码》
city_namestringY城市名称，XX市 字段长度最小 1 字节，长度最大 64 字节
district_codeinteger区/县编码，使用《民政部行政区划代码》
district_namestring区/县名称，字段长度最小 1 字节，长度最大 64 字节
addressstringY店仓详细地址
geo_infoarray坐标信息
typeintegerC若填写了longitude和latitude则必填 1：腾讯/高德地图；2：百度地图：3：国际标准
latitudefloat店仓纬度，如：22.5200
longitudefloat店仓经度，如：113.9400
basic_propsobjectY基础信息
namestringY店仓名称建议格式：品牌名称（XX店） 字段长度最小 1 字节，长度最大 32 字节
logostring店铺图片地址，1张，字段长度最小 1 字节，长度最大 2048 字节
opening_timestring店仓开业时间 时间戳 毫秒 字段长度为长度为 13 字节
operating_timearray为空默认周一至周日，10:00-22:00
date_zonestringC日期区间，例：周一至周日，若填写了`time_zone`则必填；字段长度最小 1 字节，长度最大 64 字节
time_zonestringC时间区间，例：10:00-22:00，若填写了`date_zone`则必填；字段长度最小 1 字节，长度最大 64 字节
delivery_infoobject配送信息
minimum_delivery_order_amountfloat起送价，单位元，保留 2 位小数
minimum_freight_amountfloat最低运费，供门店展示配送服务使用，单位元，保留 2 位小数
range_typeintegerC配送范围类型 1：圆形；3：多边形；store支持到家配送时必填
radiusstringC配送半径 range_type = 1 时必填 字段长度最小 1 字节，长度最大 128 字节
geo_grouparrayC坐标信息组合，坐标点的二维数组，表示多个形状，range_type=3时必填
geosarrayC坐标点信息，range_type=3时必填
typeintegerC坐标类型，若填写了longitude和latitude则必填；1：腾讯/高德地图；2：百度地图：3：国际标准
latitudefloatC电子围栏纬度，如：22.5200，range_type=3时必填
longitudefloatC电子围栏经度，如：113.9400，range_type=3时必填
target_urlobject店铺落地页信息
url_store_h5string店铺 h5 首页url，字段长度最小 1 字节，长度最大 2048 字节
url_store_miniprogramstring店铺微信小程序首页url，字段长度最小 1 字节，长度最大 2048 字节
miniprogram_appidstringC微信小程序 appid，当落地页为微信小程序时必填 字段长度最小 1 字节，长度最大 100 字节
usage_infoarray当某一门店的商品应用于特定场景时输入商品应用场景ID
inner_appidinteger商品应用场景 ID。16：直跳；19：广告CPS；20：搜一搜品牌专区；21：云选联盟；22：商品广告；23：腾讯惠聚
is_deletedinteger商家标记门店仓库信息已删除，0：未删除；1：已删除，为空默认为 0

请求示例​

{
  "account_id": 1111111111,
  "data_source_id": 1111111111,
  "data_set_id": 1111111111,
  "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
              }
            ]
          }
        ]
      }
    }
  ]
}

应答字段​

名称类型是否一定返回描述
codeintegerY返回码，等于0表示成功，不等于0表示错误，具体见文档附录
messagestringY错误描述，code不等于0时，message为错误描述
message_cnstring中文错误描述，code不等于0时，message_cn为错误情况的中文描述
dataobject资源数据，具体返回内容见各接口定义，只在code等于0时可能返回
errorsobject详细错误信息，只在code不等于0时可能返回

应答示例​

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