当前位置: API文档

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

¥标准

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/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
分页编号,分页查询必传,标准接口page_no从0开始
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数


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

查询参数

params

Map<String, Object>


查询参数

分页

pagerPager
分页

params

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

供应商编号

provider_no

String

20

供应商编号

货品编号

goods_no

String

40

货品编号

商家编码

spec_no

String

40

商家编码

供应商货号

provider_goods_no

String

64

供应商货号

货品名称

goods_name

String

255

货品名称

条码barcodeString50
条码

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

String20供应商编号
商家编码spec_noString40
商家编码
单品名称spec_nameString100单品名称
货品名称goods_nameString255货品名称
最后采购时间last_purchase_timeString40
最后采购时间
货品产地originString64货品产地
货品简称short_nameString255货品简称
货品编号goods_noString40
货品编号
规格码spec_codeString40规格码
分类名称class_nameString255分类名称
品牌名称brand_nameString64
品牌名称
是否主供应商is_masterboolean11: 是主供应商
基本单位名称base_unit_nameString20基本单位名称
供应商货号provider_goods_noString64供应商货号
库存数量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

String 

255图片地址
采购在途量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_nameString20采购单位名称
系数unit_ratio

Decimal(19,4)


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

Decimal(19,4)


最小采购量
税率tax_rate

Decimal(19,4)


税率
是否停用

is_disabled

boolean1

1: 停用

零售价retail_price

Decimal(19,4)


零售价
单品自定义属性1

prop1

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

prop2

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

prop3

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

prop4

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

prop5

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

prop6

String255单品自定义属性6
备注remarkString255供应商货品的备注

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": "参数中必须包含起止时间"
}



常用工具