当前位置: API文档

purchase.ProviderGoods.queryDetail(供应商货品查询)

¥标准

1.接口说明

1.1 接口描述:获取ERP中供应商货品界面的供应商货品资料
1.2 适用版本:客户端 V1.2.2.8及以上版本
1.3 增量获取:(查询接口必须)
1.4 时间跨度:start_time和end_time最大跨度为30天。(查询接口必须)
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>


查询参数

分页

pagerPager
分页

params



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

供应商编号

provider_no

String

2

供应商编号

货品编号

goods_no

String


货品编号

商家编码

spec_no

String


商家编码

供应商货号

provider_goods_no

String


供应商货号

货品名称

goods_name

String


货品名称

条码barcodeString
条码

pager


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

page_size

int

4

分页大小

页号page_noint4从0开始

4.响应参数

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

状态码,0表示正常

错误信息messageString

无错误信息不返回

查询出的详细信息data

List<Map<String, Object>>


详细信息

data

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

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

结果总数

total_count

int


结果总数

结果详情

details

List<Map<String, Object>>



结果详情

details

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

provider_no

String
供应商编号
商家编码spec_noString
商家编码
单品名称spec_nameString
单品名称
货品名称goods_nameString
货品名称
最后采购时间last_purchase_timeDate
最后采购时间
货品产地originString
货品产地
货品简称short_nameString
货品简称
货品编号goods_noString
货品编号
规格码spec_codeString
规格码
分类名称class_nameString
分类名称
品牌名称brand_nameString
品牌名称
是否主供应商is_masterboolean
1: 是主供应商
基本单位名称base_unit_nameString
基本单位名称
供应商货号provider_goods_noString
供应商货号
库存数量stock_num

Decimal(19,4)


库存数量
待采购量

to_purchase_num

Decimal(19,4)


待采购量
预订单量subscribe_num

Decimal(19,4)


预订单量
待审核量order_num

Decimal(19,4)


待审核量
待发货量sending_num

Decimal(19,4)


待发货量
可发库存avaliable_num

Decimal(19,4)


可发库存
图片地址img_url

Decimal(19,4)


图片地址
采购在途量purchase_num

Decimal(19,4)


采购在途量
采购到货量purchase_arrive_numDecimal(19,4)
采购到货量
采购价price

Decimal(19,4)


采购价
最后采购价last_price

Decimal(19,4)


最后采购价
上一次采购价last_second_price

Decimal(19,4)


上一次采购价
最低采购价lowest_price

Decimal(19,4)


最低采购价
今日销量today_num

Decimal(19,4)


今日销量
七天销量num_7days

Decimal(19,4)


七天销量

14天销量

num_14days

Decimal(19,4)


14天销量

月销量num_month

Decimal(19,4)


月销量
总销量num_all

Decimal(19,4)


销量
采购单位名称unit_nameString
采购单位名称
系数unit_ratio

Decimal(19,4)


辅助单位和单位的换算系数
最小采购量min_purchase_num

Decimal(19,4)


最小采购量
税率tax_rate

Decimal(19,4)


税率
是否停用

is_disabled

boolean

1: 停用

零售价retail_price

Decimal(19,4)


零售价
单品自定义属性1

prop1

String
单品自定义属性1
单品自定义属性2

prop2

String
单品自定义属性2
单品自定义属性3

prop3

String
单品自定义属性3
单品自定义属性4

prop4

String
单品自定义属性4
单品自定义属性5

prop5

String
单品自定义属性5
单品自定义属性6

prop6

String
单品自定义属性6
备注remarkString
供应商货品的备注

5.请求示例

JASON格式请求报文

[{
"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("purchase.ProviderGoods.queryDetail ", $pager, $parMap);
 
?>
JAVA

C#

6.响应示

   6.1 正常响应示例 

JSON
{
"status": 0,
"data": {
"total_count": 7538,
"details": [{
"spec_code": "blue",
"discount": 1.0000,
"min_purchase_num": 1.0000,
"spec_no": "blue",
"tax_rate": 0.0000,
"retail_price": 2.0000,
"price": 0.0000,
"num_14days": 0.0000,
"goods_name": "手机贴纸",
"follower_id": 0,
"is_master": true,
"last_second_price": 0.0000,
"last_purchase_time": 1568100980000,
"unit_ratio": 10.0000,
"is_disabled": false,
"subscribe_num": 8.0000,
"num_all": 84.0000,
"brand_name": "无",
"sending_num": 12.0000,
"num_month": 0.0000,
"unit_name": "枚",
"img_url": "",
"short_name": "",
"order_num": 7.0000,
"last_price": 0.0000,
"num_7days": 0.0000,
"to_purchase_num": 0.0000,
"purchase_cycle_day": 0,
"origin": "",
"goods_no": "sjtz",
"stock_num": 90189.0000,
"purchase_arrive_num": 0.0000,
"lowest_price": 0.0000,
"remark": "",
"purchase_num": 18.0000,
"yesterday_num": 0.0000,
"avaliable_num": 90188.0000,
"base_unit_name": "枚",
"class_name": "无",
"provider_no": "LCJtest",
"today_num": 0.0000,
"prop6": "",
"prop5": "",
"prop4": "",
"prop3": "",
"prop2": "",
"prop1": "",
"spec_name": "blue",
"provider_goods_no": "1117771"
}]
}
}

   6.2 异常响应示例

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



常用工具