当前位置: API文档

purchase.PurchaseOrder.queryWithDetail(采购单及明细查询)

¥标准

1.接口说明

1.1 接口描:获取ERP内采购单信息
1.2 适用版本:客户端 V1.2.2.8及以上版本
1.3 增量获取:支持
1.4 时间跨度:start_time和end_time最大跨度为30天。
1.5注意事项:【权限校验】:仓库权限,供应商权限

2.调用场景

2.1 举例说明:财务系统、SAP、线下ERP、数据分析等系统的对接

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


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

采购单号

purchase_no

String


N

采购单号

供应商编号

provider_no

String


N

供应商编号

预计入库仓编号

expect_warehouse_no

String


N

预计入库仓

收货仓编号

receive_warehouse_no

String


N

收货仓

开始时间

start_time

String


N

采购单修改时间

结束时间

end_time

String


N

采购单修改时间

入库状态

stockin_status

int


N

入库状态,0 未入库 1部分入库 2已入库 3停止入库

采购单状态

status

String



N

10 已取消

20 编辑中

30 待审核

40 已审核

50 部分到货

60 已到货

70 待结算

80 部分结算

90 已完成

多个状态间使用英文逗号隔开


pager

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

page_size

int

4

分页大小

页号page_noint4从0开始

4.响应参数

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

状态码,0表示调用成功

错误信息message

String


无错误信息不返回
返回信息dataList<Map<String, Object>>
返回信息

data

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

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

order

List<Map<String, Object>>


单据数据

总条数

total_count

int


总条数

order

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

采购单号

purchase_no

String


Y

采购单号

供应商名称

provider_name

String


Y

供应商名称

采购单状态

status

int


Y

采购单状态:10 已取消,20 编辑中,30 待审核,40 已审核,50 部分到货,60 已到货,70 待结算,80 部分结算,90 已完成 多个状态间使用英文逗号隔开

入库状态

stockin_status

int


Y

0 未入库 1部分入库 2已入库 3停止入库

结算状态

settle_status

int


Y

0不可结算 1待结算 2部分结算 3已结算

仓库名称

warehouse_name

String


Y

仓库名称

制单员

creator_name

String


Y

制单员

采购员

purchaser_name

String


Y

采购员

审核人

check_operator_name

String


Y

审核人

财审人

facheck_operator_name

String


Y

财审人

标记名称

flag_name

String


Y

标记名称

物流公司名称

logistics_name

String


Y

物流公司名称

付款方式

pay_type

int


Y

付款方式

运费付款方式

postfee_pay_type

int


Y

运费付款方式

货品总价

goods_fee

Decimal


Y

货品总价

运费

post_fee

Decimal


Y

运费

其他费用

other_fee

Decimal


Y

其他费用

总费用

total_fee

Decimal


Y

总费用

税后总价

tax_fee

Decimal


Y

税后总价

货品种类数

goods_type_count

int


Y

货品种类数

货品数量

goods_count

Decimal


Y

货品数量

到货数量

goods_arrive_count

Decimal


Y

到货数量

入库数量

goods_stockin_count

Decimal


Y

入库数量

采购单备注

remark

String


Y

采购单备注

预期到货时间

expect_arrive_time

String


Y

预期到货时间

建单时间

created

Date


Y

建单时间

审核时间

check_time

String


Y

审核时间

修改时间

modified

Date


Y

修改时间

采购单详情

detail_list

List<Map<String, Object>>


Y

采购单详情

detail_list




商家编码

spec_no

String

40

Y

商家编码

零售价

retail_price

Decimal(19,4)


Y

零售价

供应商货号

provider_goods_no

String

64

Y

供应商货号

货品编号

goods_no

String

40

Y

货品编号

货品名称

goods_name

String

255

Y

货品名称

货品简称

short_name

String

255

Y

货品简称

单品备注

spec_remark

String

512

Y

单品备注

规格码

spec_code

String

40

Y

规格码

单品名称

spec_name

String

100

Y

单品名称

单品条码

barcode

String

50

Y

单品条码

品牌名称

brand_name

String


Y

品牌名称

图片地址

img_url

String


Y

图片地址

货品数量

num

Decimal(19,4)


Y

货品数量

辅助数量

num2

Decimal(19,4)


Y

辅助数量

到货数量

arrive_num

Decimal(19,4)


Y

到货数量

结算数量

settle_num

Decimal(19,4)


Y

结算数量

多到货量

arrive_more_num

Decimal(19,4)


Y

多到货量

入库数量

stockin_num

Decimal(19,4)


Y

入库数量

到货入库总额

stockin_amount

Decimal(19,4)


Y

到货入库总额

停止等待数量

stopwait_num

Decimal(19,4)


Y

停止等待数量

未到货量

lack_num

Decimal(19,4)


Y

未到货量

采购单位

purchase_unit_name

String


Y

采购单位

换算系数

unit_ratio

Decimal(19,4)


Y

换算系数

基本单位

base_unit_name

String


Y

基本单位

税前单价

price

Decimal(19,4)


Y

税前单价

采购价格

purchase_price

Decimal(19,4)


Y

采购价格

辅助价格

aux_price

Decimal(19,4)


Y

辅助价格

折扣

discount

Decimal(19,4)


Y

折扣

税率

tax_rate

Decimal(19,4)


Y

税率

税后单价

tax_price

Decimal(19,4)


Y

税后单价

税后金额

tax_amount

Decimal(19,4)


Y

税后金额

税前折扣价

dis_price

Decimal(19,4)


Y

税前折扣价

总金额

amount

Decimal(19,4)


Y

总金额

总重量

weight

Decimal(19,4)


Y

总重量

辅助重量

aux_amount

Decimal(19,4)


Y

辅助重量

采购单详情备注

remark

String


Y

采购单详情备注

自定义属性1

prop1

String

255

Y

自定义属性1

自定义属性2

prop2

String

255

Y

自定义属性

单品自定义属性1

gs_prop1

String

255

Y

单品自定义属性1

单品自定义属性2

gs_prop2

String

255

Y

单品自定义属性2

单品自定义属性3

gs_prop3

String

255

Y

单品自定义属性3

单品自定义属性4

gs_prop4

String

255

Y

单品自定义属性4

单品自定义属性5

gs_prop5

String

255

Y

单品自定义属性5

单品自定义属性6

gs_prop6

String

255

Y

单品自定义属性6

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("purchase.PurchaseOrder.queryWithDetail ", $pager, $parMap);
 
?>

JAVA
C#

6.响应示

   6.1 正常响应示例 

JSON

{
"status": 0,
"data": {
"total_count": 4,
"order": [{
"logistics_name": "未知",
"purchase_no": "CGD-A-034459",
"goods_stockin_count": 0.0000,
"post_fee": 0.0000,
"detail_list": [{
"spec_no": "WJ0010023",
"retail_price": 0.0000,
"provider_goods_no": "",
"goods_no": "010001",
"goods_name": "外套WJ001",
"short_name": "外套WJ001",
"spec_remark": "",
"spec_code": "M",
"spec_name": "白色002*M",
"barcode": "WJ0010023",
"img_url": "",
"num": 1.0000,
"num2": 1.0000,
"arrive_num": 1.0000,
"settle_num": 0.0000,
"arrive_more_num": 0,
"stockin_num": 0.0000,
"stockin_amount": 0.0000,
"stopwait_num": 0.0000,
"lack_num": 0,
"unit_ratio": 1.0000,
"price": 0.0000,
"purchase_price": "0.0000",
"aux_price": 0.0000,
"discount": 1.0000,
"tax_rate": 0.0000,
"tax_price": 0.0000,
"tax_amount": 0.0000,
"dis_price": 0.0000,
"amount": 0.0000,
"weight": 0E-8,
"aux_amount": 0.0000,
"remark": "",
"prop1": "",
"prop2": "",
"gs_prop1": "",
"gs_prop2": "",
"gs_prop3": "",
"gs_prop4": "",
"gs_prop5": "",
"gs_prop6": "",
"base_unit_name": "无",
"purchase_unit_name": "无",
"brand_name": "无"
}],
"goods_type_count": 1,
"remark": "",
"goods_count": 1.0000,
"stockin_status": 0,
"flag_name": "无",
"tax_fee": 0.0000,
"total_fee": 0.0000,
"purchaser_name": "李杰",
"modified": 1582773486000,
"pay_type": 0,
"provider_name": "本厂",
"other_fee": 0.0000,
"check_operator_name": "katetu2",
"facheck_operator_name": "系统",
"created": 1582723799000,
"settle_status": 0,
"postfee_pay_type": 0,
"goods_arrive_count": 2.0000,
"warehouse_name": "华南测试专用",
"expect_arrive_time": "",
"goods_fee": 0.0000,
"creator_name": "YEU测试",
"status": 40
}]
}
}

  6.2 异常响应示例

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





常用工具