当前位置: API文档

setting.PurchaseProvider.queryDetail(供应商查询)

¥基础   ¥增值  ¥定制 

1.接口说明

1.1 接口描:获取ERP供应商档案资料
1.2 适用版本:客户端 V1.1.8.9及以上版本
1.3 增量获取:支持
1.4 时间跨度:start_time和end_time最大跨度为30天
1.5注意事项:【权限校验】:供应商权限

2.调用场景

2.1 举例说明:

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境正式环境是动态获取的,详情点击

   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
是否计算查询结果的总页数,分页查询必传

    3.3 业务请求参数

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

查询参数

params

Map<String, Object>


查询参数

分页

pagerPager
分页

params

名称字段类型长度
必须描述
供应商编号

provider_no

String

n
供应商编号
供应商名称

provider_name

String
n
供应商名称
电话

telno

String

电话
手机mobileString

手机
采购平台供应商账户名

description


String

采购平台供应商账户名

联系人

contact

String

联系人

创建时间

created_begin

String

查询开始时间

结束时间created_endString

查询结束时间

是否禁用

is_disabled

int

1: 禁用,0未禁用

是否删除

deleted

int

0: 未删除

pager

名称字段类型长度
必须描述
分页大小

page_size

int

4

分页大小

页号page_noint4从0开始

4.响应参数

   4.1 公共响应参数

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

status

int
y

状态码,0表示调用成功

错误信息

message

String


y

无错误信息不返回

详细信息

data

List<Map<String, Object>>


y

详细信息

data

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

名称字段类型长度
必须描述
结果总数

total_count

int


结果总数

结果详情

details

List<Map<String, Object>>


结果详情

details




供应商编号

provider_no

String20

供应商编号


供应商名称

provider_name

String64

供应商名称

联系人

contact

String

64

联系人

电话

telno

String

20

电话

手机

mobile

String

20

手机

传真

fax

String

20


传真

邮编

zip

String

20


邮编

邮箱

email

String

20


邮箱

QQ

qq

String

20


QQ

旺旺

wangwang

String

64


旺旺

地址

address

String

128

地址

网址

website

String

128


网址

到货周期

ebill_api

int


到货周期

上次采购日期

is_preset_no

Date


上次采购日期

备注

remark

String

256

备注

是否禁用

is_disabled

bool


false: 正常, true:禁用

是否删除

deleted

int



0:  正常

5.请求示例

json格式请求报文
{
"start_time": "2020-01-01 00:00:00",
"end_time": "2020-01-20 00:00:00"
}
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");
 
$parMap = new stdClass();
$parMap->start_time = "2020-01-01 00:00:00";
$parMap->end_time = "2020-01-20 00:00:00";
 
$pager = new Pager(1, 0, true);
 
$response = $client->pageCall("setting.PurchaseProvider.queryDetail ", $pager, $parMap);
 
?>
JAVA

C#

6.响应示

   6.1 正常响应示例 

JSON
{
"status": 0,
"data": {
"total_count": 319,
"details": [{
"zip": "",
"qq": "",
"website": "",
"address": "",
"wangwang": "",
"is_disabled": false,
"mobile": "",
"arrive_cycle_days": 0,
"remark": "",
"telno": "",
"deleted": 176729049,
"contact": "",
"provider_name": "000001(删除)",
"fax": "",
"email": "",
"provider_no": "000001"
}]
}
}

   6.2 异常响应示例

JSON
{
"status": 100,
"message": "参数中必须包含起止时间"
}




常用工具