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

¥标准

1.接口说明1.1 接口描述：获取ERP中供应商货品界面的供应商货品资料

1.2 适用版本：客户端 V1.2.5.6及以上版本

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 业务请求参数

名称字段类型长度必须描述查询参数paramsMap是查询参数

分页pagerPager是分页

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

货品编号goods_noString40否货品编号

商家编码spec_noString40否商家编码

供应商货号provider_goods_noString64否供应商货号

货品名称goods_nameString255否货品名称

条码barcodeString50否条码

pager

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

页号page_noInt4否从0开始

4.响应参数名称字段类型长度必须描述状态码statusInt是状态码,0表示正常

错误信息messageString是无错误信息不返回

查询出的详细信息dataList>是详细信息

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据淘系平台不返回，其他平台正常返回)名称字段类型长度必须描述结果总数total_countInt是结果总数

结果详情detailsList>是结果详情

details

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

商家编码spec_noString40是商家编码

单品名称spec_nameString100是单品名称

货品名称goods_nameString255是货品名称

最后采购时间last_purchase_timeString40否最后采购时间

货品产地originString64是货品产地

货品简称short_nameString255是货品简称

货品编号goods_noString40是货品编号

规格码spec_codeString40是规格码

分类名称class_nameString255是分类名称

品牌名称brand_nameString64是品牌名称

是否主供应商is_masterboolean1是1: 是主供应商

基本单位名称base_unit_nameString20是基本单位名称

供应商货号provider_goods_noString64是供应商货号

库存数量stock_numDecimal(19,4)是库存数量

待采购量to_purchase_numDecimal(19,4)是待采购量

预订单量subscribe_numDecimal(19,4)是预订单量

待审核量order_numDecimal(19,4)是待审核量

待发货量sending_numDecimal(19,4)是待发货量

可发库存avaliable_numDecimal(19,4)是可发库存

图片地址img_urlString255是图片地址

采购在途量purchase_numDecimal(19,4)是采购在途量

采购到货量purchase_arrive_numDecimal(19,4)是采购到货量

采购价priceDecimal(19,4)是采购价

最后采购价last_priceDecimal(19,4)是最后采购价

上一次采购价last_second_priceDecimal(19,4)是上一次采购价

最低采购价lowest_priceDecimal(19,4)是最低采购价

今日销量today_numDecimal(19,4)是今日销量

七天销量num_7daysDecimal(19,4)是七天销量

14天销量num_14daysDecimal(19,4)是14天销量

月销量num_monthDecimal(19,4)是月销量

总销量num_allDecimal(19,4)是月销量

采购单位名称unit_nameString20是采购单位名称

系数unit_ratioDecimal(19,4)是辅助单位和单位的换算系数

最小采购量min_purchase_numDecimal(19,4)是最小采购量

税率tax_rateDecimal(19,4)是税率

是否停用is_disabledboolean1是1: 停用

零售价retail_priceDecimal(19,4)是零售价

单品自定义属性1prop1String255是单品自定义属性1

单品自定义属性2prop2String255是单品自定义属性2

单品自定义属性3prop3String255是单品自定义属性3

单品自定义属性4prop4String255是单品自定义属性4

单品自定义属性5prop5String255是单品自定义属性5

单品自定义属性6prop6String255是单品自定义属性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": "参数中必须包含起止时间"

}