alibaba.xsd.store.create (小时达远转近建店接口)

小时达远转近建店接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
xsd_store_create_request XsdStoreCreateRequest 必须 门店创建参数
  • └ area
  • String
  • 可选
  • 330110
  • 区编码,菜鸟编码,无区的市此字段不传
  • └ prov_name
  • String
  • 必须
  • 浙江省
  • 省名称
  • └ address
  • String
  • 必须
  • 文一西路969号
  • 详细地址
  • └ city
  • String
  • 可选
  • 330100
  • 市编码,菜鸟编码,省直辖县此字段不传
  • └ latitude
  • String
  • 必须
  • 30.278915
  • 纬度
  • └ sub_user_ids
  • String []
  • 可选
  • ["23","239"]
  • 门店关联的子账号id列表
  • └ return_to_store
  • Number
  • 必须
  • 1
  • 是否开启退货到门店 1 开启,0 不开启
  • └ principal
  • String
  • 必须
  • 张三
  • 负责人
  • └ city_name
  • String
  • 可选
  • 杭州市
  • 市名称,省直辖县此字段不传
  • └ area_name
  • String
  • 可选
  • 余杭区
  • 区名称。无区的市此字段不传
  • └ phone
  • String
  • 必须
  • 0571-89039232
  • 门店联系电话
  • └ image_url
  • String
  • 可选
  • https://img.alicdn.com/***.jpg
  • 门店logo,必须是alicdn图片
  • └ store_name
  • String
  • 必须
  • 测试示例店
  • 门店名称
  • └ prov
  • String
  • 必须
  • 330000
  • 省编码,菜鸟编码
  • xsd_store_business_time
  • XsdStoreBusinessTime
  • 必须
  • 门店营业时间
  • └ weeks
  • String []
  • 必须
  • [1,2,3]
  • 每周的营业日,可选1-7分别表示周一到周天
  • └ range
  • String
  • 必须
  • "07:00-12:00"
  • 营业时间,不支持多段及跨天
  • └ category_id
  • Number
  • 必须
  • 2399023
  • 门店经营类目id,从经营类目查询接口获取
  • └ store_code
  • String
  • 可选
  • test_store_code
  • 门店编码,全平台唯一,非必填,不填则系统生成,不可更新
  • └ longitude
  • String
  • 必须
  • 120.025512
  • 经度
  • └ street
  • String
  • 必须
  • 330110005
  • 街道编码,菜鸟编码
  • └ street_name
  • String
  • 必须
  • 五常街道
  • 街道名称

响应参数

名称 类型 示例值 描述
result ApiResult 返回结果
  • └ success
  • Boolean
  • true
  • 是否成功,false表示建店失败
  • └ err_code
  • String
  • system_error
  • 错误码
  • response
  • ShopCreateResponse
  • 建店结果
  • └ store_code
  • String
  • test_store_code
  • 门店编码
  • └ store_id
  • String
  • 123456
  • 门店id
  • └ err_msg
  • String
  • 系统错误
  • 错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaXsdStoreCreateRequest req = new AlibabaXsdStoreCreateRequest();
AlibabaXsdStoreCreateRequest.XsdStoreCreateRequest obj1 = new AlibabaXsdStoreCreateRequest.XsdStoreCreateRequest();
obj1.setArea("330110");
obj1.setProvName("浙江省");
obj1.setAddress("文一西路969号");
obj1.setCity("330100");
obj1.setLatitude("30.278915");
obj1.setSubUserIds(""23","239"");
obj1.setReturnToStore(1L);
obj1.setPrincipal("张三");
obj1.setCityName("杭州市");
obj1.setAreaName("余杭区");
obj1.setPhone("0571-89039232");
obj1.setImageUrl("https://img.alicdn.com/***.jpg");
obj1.setStoreName("测试示例店");
obj1.setProv("330000");
AlibabaXsdStoreCreateRequest.XsdStoreBusinessTime obj2 = new AlibabaXsdStoreCreateRequest.XsdStoreBusinessTime();
obj2.setWeeks("1,2,3");
obj2.setRange("\"07:00-12:00\"");
obj1.setXsdStoreBusinessTime(obj2);
obj1.setCategoryId(2399023L);
obj1.setStoreCode("test_store_code");
obj1.setLongitude("120.025512");
obj1.setStreet("330110005");
obj1.setStreetName("五常街道");
req.setXsdStoreCreateRequest(obj1);
AlibabaXsdStoreCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_xsd_store_create_response>
    <result>
        <success>true</success>
        <err_code>system_error</err_code>
        <response>
            <store_code>test_store_code</store_code>
            <store_id>123456</store_id>
        </response>
        <err_msg>系统错误</err_msg>
    </result>
</alibaba_xsd_store_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部