文档中心 > API类目 > 天猫服务商品API

tmall.servicecenter.servicestore.createservicestore (服务网点创建)

创建网点信息。对于同一个服务商，通过 service_store_code 保证网点唯一性。需要保证网点不存在才能创建。地址信息：中文和编码二选一，都填则以编码address_code为准。错误码 1, 服务商昵称无效 2, 缺少省份 3, 缺少城市 4, 缺少区域 5, 缺少详细地址 6, 传入地址不在标准地址库中，无法解析 7, 缺少网点编码 8, 缺少网点名称 9, 缺少网点电话 10, 网点已存在 11, 网点不存在 12, 系统错误

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
service_store	ServiceStoreDTO	必须			网点
└ address_city String 可选杭州市城市 └ address_code Number 可选 331100 标准地址编码。如果传入了这个字段，则地址信息以这个字段为准 └ address_detail String 必须浙江省杭州市余杭区文一西路969号4号楼小邮局标准详细地址 └ address_district String 可选余杭区标准地址-区 └ address_province String 可选浙江省标准地址-省 └ address_town String 可选五常街道标准地址-街道 └ manager_name String 可选张三网点经理人姓名 └ manager_phone String 可选 12345678900 网点经理人电话 └ phone String 必须 12345678 网点电话，例如座机 └ service_store_code String 必须 xxx 网点编码，创建后不可修改 └ service_store_name String 必须网点名称网点名称

响应参数

名称	类型	示例值	描述
result	ResultBase	.	result
└ error_code Number 123 错误码 └ error_msg String demo 错误信息 └ gmt_create Date 2017-12-22 11:23:00 gmtCreate └ gmt_modified Date 2017-12-22 11:23:00 gmtModified └ success Boolean false 方法调用是否成功 └ value Number 123 返回值

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallServicecenterServicestoreCreateservicestoreRequest req = new TmallServicecenterServicestoreCreateservicestoreRequest();
TmallServicecenterServicestoreCreateservicestoreRequest.ServiceStoreDTO obj1 = new TmallServicecenterServicestoreCreateservicestoreRequest.ServiceStoreDTO();
obj1.setAddressCity("杭州市");
obj1.setAddressCode(331100L);
obj1.setAddressDetail("浙江省杭州市余杭区文一西路969号4号楼小邮局");
obj1.setAddressDistrict("余杭区");
obj1.setAddressProvince("浙江省");
obj1.setAddressTown("五常街道");
obj1.setManagerName("张三");
obj1.setManagerPhone("12345678900");
obj1.setPhone("12345678");
obj1.setServiceStoreCode("xxx");
obj1.setServiceStoreName("网点名称");
req.setServiceStore(obj1);
TmallServicecenterServicestoreCreateservicestoreResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallServicecenterServicestoreCreateservicestoreRequest req = new TmallServicecenterServicestoreCreateservicestoreRequest();
TmallServicecenterServicestoreCreateservicestoreRequest.ServiceStoreDTODomain obj1 = new TmallServicecenterServicestoreCreateservicestoreRequest.ServiceStoreDTODomain();
obj1.AddressCity = "杭州市";
obj1.AddressCode = 331100L;
obj1.AddressDetail = "浙江省杭州市余杭区文一西路969号4号楼小邮局";
obj1.AddressDistrict = "余杭区";
obj1.AddressProvince = "浙江省";
obj1.AddressTown = "五常街道";
obj1.ManagerName = "张三";
obj1.ManagerPhone = "12345678900";
obj1.Phone = "12345678";
obj1.ServiceStoreCode = "xxx";
obj1.ServiceStoreName = "网点名称";
req.ServiceStore_ = obj1;
TmallServicecenterServicestoreCreateservicestoreResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallServicecenterServicestoreCreateservicestoreRequest;
$service_store = new ServiceStoreDTO;
$service_store->address_city="杭州市";
$service_store->address_code="331100";
$service_store->address_detail="浙江省杭州市余杭区文一西路969号4号楼小邮局";
$service_store->address_district="余杭区";
$service_store->address_province="浙江省";
$service_store->address_town="五常街道";
$service_store->manager_name="张三";
$service_store->manager_phone="12345678900";
$service_store->phone="12345678";
$service_store->service_store_code="xxx";
$service_store->service_store_name="网点名称";
$req->setServiceStore(json_encode($service_store));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.servicecenter.servicestore.createservicestore' \
-d 'partner_id=apidoc' \
-d 'session=fc112fd3-c25a-440a-9435-e220ff66f80b' \
-d 'sign=9924C53B5232E4BDE3DDF4BB2160E28E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-19+15%3A26%3A55' \
-d 'v=2.0' \
-d 'service_store=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TmallServicecenterServicestoreCreateservicestoreRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.service_store=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"tmall.servicecenter.servicestore.createservicestore");
add_param(pRequest,"service_store","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.servicecenter.servicestore.createservicestore', {
	'service_store':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<tmall_servicecenter_servicestore_createservicestore_response>
    <result>
        <error_code>123</error_code>
        <error_msg>demo</error_msg>
        <gmt_create>2017-12-22 11:23:00</gmt_create>
        <gmt_modified>2017-12-22 11:23:00</gmt_modified>
        <success>false</success>
        <value>123</value>
    </result>
</tmall_servicecenter_servicestore_createservicestore_response>

{
    "tmall_servicecenter_servicestore_createservicestore_response":{
        "result":{
            "error_code":123,
            "error_msg":"demo",
            "gmt_create":"2017-12-22 11:23:00",
            "gmt_modified":"2017-12-22 11:23:00",
            "success":false,
            "value":123
        }
    }
}

异常示例

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

天猫服务商品API