当前位置: API文档

setting.Shop.updateShop(店铺更新)

¥标准

1.接口说明

1.1 接口描:更新ERP的店铺档案资料
1.2 适用版本:客户端 V1.2.5.6及以上版本
1.3 增量获取:
1.4 时间跨度:
1.5注意事项:

2.调用场景

2.1 举例说明:

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数

名称字段类型长度
必须描述
请求参数

params

Map<String, Object>


请求参数

params

名称字段类型长度
必须描述
店铺编号

shop_no

String

20

店铺编号

联系人

contact

String

32

联系人

province

Int

11

代码表参考https://open.wangdian.cn/qjb/open/guide?path=qjbguide_ccdmb

city

Int

11

代码表参考https://open.wangdian.cn/qjb/open/guide?path=qjbguide_ccdmb

district

Int

11

代码表参考https://open.wangdian.cn/qjb/open/guide?path=qjbguide_ccdmb

地址

address

String

255

地址

电话

telno

String

40

电话

手机

mobile

String

40

手机

邮编

zip

String

16

邮编

邮箱

email

String

64

邮箱

备注

remark

String

255

备注

网址

website

String

1024

网址

4.响应参数

名称字段类型长度
必须描述
状态码statusInt
状态码:0表示成功,其他表示失败
错误信息messageString
无错误信息不返回
返回信息
data

List<Map<String, Object>>


返回信息

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据淘系平台不返回,其他平台正常返回

名称字段类型长度
必须描述
状态码

status

Int


更新成功返回0

查询结果

message

String


更新成功返回OK

5.请求示例

Json格式请求报文

[
{"shop_no":"test","website":"website update"}
]


PHP
<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret"); 

$shop = new StdClass();
$shop->shop_no = "test";
$shop->website = "website update";

$data = $client->call("setting.Shop.updateShop", $shop);

?>
JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON
{
"status":0,"data":
{
"message":"OK","status":0
}
}

   6.2 异常响应示例

JSON
{
"status":100,"message":"店铺编号为 testxxxxx 的店铺不存在"
}









常用工具