当前位置: API文档

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

¥标准

1.接口说明

1.1 接口描:获取ERP内采购单信息
1.2 适用版本:客户端 V1.2.6.5及以上版本
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

20

N

采购单号

供应商编号

provider_no

String

20

N

供应商编号

预计入库仓编号

expect_warehouse_no

String

40

N

预计入库仓

收货仓编号

receive_warehouse_no

String

40

N

收货仓

开始时间

start_time

String

40

N

采购单修改时间

结束时间

end_time

String

40

N

采购单修改时间

入库状态

stockin_status

Int

4

N

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

采购单状态

status

String


64

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

20

Y

采购单号

供应商编号

provider_no

String

20

Y

供应商编号

供应商名称

provider_name

String

40

Y

供应商名称

采购单状态

status

Int

4

Y

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

入库状态

stockin_status

Int

4

Y

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

结算状态

settle_status

Int

4

Y

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

仓库名称

warehouse_name

String

64

Y

仓库名称

仓库编码
warehouse_noString40
Y
仓库编码

制单员

creator_name

String

40

Y

制单员

采购员

purchaser_name

String

40

Y

采购员

审核人

check_operator_name

String

40

Y

审核人

财审人

facheck_operator_name

String

40

Y