淘宝开放平台

登录
文档中心 > API类目 > 奇门仓储API

奇门仓储API

taobao.qimen.store.create (门店新增接口)

isv调用接口来讲线下门店同步到线上

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
store_name String 必须 文一西路淘宝店 门店名称
main_category Number 必须 170403 门店主营类目
company_name String 必须 甘其食 商户名称
end_time String 必须 18:00 关闭营业时间(只填时，分；只支持半点和整点)
start_time String 必须 10:00 开始营业时间(只填时，分；只支持半点和整点)
store_status String 可选 NORMAL 门店状态
store_description String 可选 商户介绍 商户介绍
address Address 可选 地址信息
  • └ region
  • String
  • 可选
  • 华南区
  • 区域
  • └ area
  • String
  • 必须
  • 余杭区
  • 区域
  • └ country_code
  • String
  • 可选
  • CN
  • 国家二字码
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ town
  • String
  • 可选
  • 无
  • 村镇
  • └ detail_address
  • String
  • 必须
  • 浙江省杭州市余杭区xxx号
  • 详细地址
  • └ city
  • String
  • 必须
  • 杭州市
  • 城市
shop_id Number 可选 146111889769 需要关联的线上店铺ID
store_keeper StoreKeeper 可选 门店所有者信息
  • └ fax
  • String
  • 可选
  • 5287567
  • 传真
  • └ tel
  • String
  • 必须
  • 8567786
  • 固定电话
  • └ name
  • String
  • 可选
  • 姓名
  • 姓名
  • └ zip_code
  • String
  • 可选
  • 043300
  • 邮编
  • └ mobile
  • String
  • 必须
  • 13415967899
  • 移动电话
store_type String 必须 NORMAL 门店的类型
store_code String 必须 1234 ERP系统中门店的编码
remark String 可选 备注 备注

响应参数

名称 类型 示例值 描述
message String 成功创建门店 响应信息
flag String success 响应标示
qimen_code String 200 响应code
store_id Number 1000263146 返回的门店id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
QimenStoreCreateRequest req = new QimenStoreCreateRequest();
req.setStoreName("文一西路淘宝店");
req.setMainCategory(170403L);
req.setCompanyName("甘其食");
req.setEndTime("18:00");
req.setStartTime("10:00");
req.setStoreStatus("NORMAL");
req.setStoreDescription("商户介绍");
QimenStoreCreateRequest.Address obj1 = new QimenStoreCreateRequest.Address();
obj1.setRegion("华南区");
obj1.setArea("余杭区");
obj1.setCountryCode("CN");
obj1.setProvince("浙江省");
obj1.setTown("无");
obj1.setDetailAddress("浙江省杭州市余杭区xxx号");
obj1.setCity("杭州市");
req.setAddress(obj1);
req.setShopId(146111889769L);
QimenStoreCreateRequest.StoreKeeper obj2 = new QimenStoreCreateRequest.StoreKeeper();
obj2.setFax("5287567");
obj2.setTel("8567786");
obj2.setName("姓名");
obj2.setZipCode("043300");
obj2.setMobile("13415967899");
req.setStoreKeeper(obj2);
req.setStoreType("NORMAL");
req.setStoreCode("1234");
req.setRemark("备注");
QimenStoreCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<qimen_store_create_response>
    <message>成功创建门店</message>
    <flag>success</flag>
    <qimen_code>200</qimen_code>
    <store_id>1000263146</store_id>
</qimen_store_create_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部