U8C API中心

API中心

采购管理
采购订单

指导视频
对接方案模板
工具
游客

采购订单查询

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:用于采购订单查询

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/pu/order/query

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
system	是	系统参数

请求参数(body):

参数名	是否数组	必填	描述	默认值
biztype	否	否	业务流程
code	否	否	单据号
containcloserow	否	否	是否包含已关闭行（传值Y/N）（5.1版本开始支持）	默认不包含
corderid	否	否	采购订单主键（5.2及以后版本）
corp	否	否	公司
cpurorganization	否	否	采购组织
cwarehouseid	否	否	收货仓库
date_begin	否	否	单据日期开始
date_end	否	否	单据日期结束
dauditdate	否	否	审批日期
dauditdate_begin	否	否	审批日期开始
dauditdate_end	否	否	审批日期结束
dept	否	否	采购部门
forderstatus	否	否	订单状态
inventory	否	否	存货
maker	否	否	制单人
page_now	否	否	当前页
page_size	否	否	每页数量
taudittime	否	否	审批时间
taudittime_begin	否	否	审批时间开始
taudittime_end	否	否	审批时间结束
ts_begin	否	否	起始ts
ts_end	否	否	结束ts
vendor	否	否	供应商

返回类型参数:

参数名	类型	是否数组	必填	描述
errormsg				服务执行失败后返回的错误信息
puordervo				采购订单聚合返回实体
childrenvo		是	是	采购订单查询结果子实体
arrvcorp_name	string	否	否	收货公司名称
arrvstoorg_name	string	否	否	收货库存组织名称
blargess	string	否	否	是否赠品
bodycode	string	否	否	组织编码
breceiveplan	string	否	否	存在到货计划
btransclosed	string	否	否	是否运输关闭
cassistunit	string	否	否	辅计量单位
cassistunit_name	string	否	否	辅计量单位名称
cbaseid	string	否	否	存货基础ID
ccloseuser_name	string	否	否	关闭人名称
ccloseuserid	string	否	否	关闭人
ccontractid	string	否	否	合同头ID
ccontractrowid	string	否	否	合同行ID
ccorrectrowid	string	否	否	修正行ID
ccurrencytype_name	string	否	否	原币币种名称
ccurrencytypeid	string	否	否	原币币种ID
cdevaddrid	string	否	否	收发货地点
cdevareaid	string	否	否	收发货地区
cmang_name	string	否	否	存货管理名称
cmangid	string	否	否	存货管理ID
coperate_name	string	否	否	操作员名称
coperator	string	否	否	操作员ID
corder_bid	string	否	否	采购订单行ID
corderid	string	否	否	采购订单表头_主键
corp_name	string	否	否	公司名称
cpriceaudit_bb1id	string	否	否	价格审批单存货子子表ID
cpriceaudit_bid	string	否	否	价格审批单存货子表ID
cpriceauditid	string	否	否	价格审批单ID
cproject_name	string	否	否	项目名称
cprojectid	string	否	否	项目ID
cprojectphase_name	string	否	否	项目阶段名称
cprojectphaseid	string	否	否	项目阶段ID
cqpbaseschemeid	string	否	否	优质优价主体方案ID
creqwareid_name	string	否	否	收货库存组织名称
crowno	string	否	否	行号
csourcebillid	string	否	否	来源单据ID
csourcebilltype	string	否	否	来源单据类型
csourcerowid	string	否	否	来源单据行ID
cupsourcebillid	string	否	否	上层来源单据ID
cupsourcebillrowid	string	否	否	上层来源单据行ID
cupsourcebilltype	string	否	否	上层来源单据类型
cusedept_name	string	否	否	使用部门名称
cusedeptid	string	否	否	使用部门ID
cvenddevaddrid	string	否	否	供应商收发货地点
cvenddevareaid	string	否	否	供应商收发货地区
cwarehouse_name	string	否	否	收货仓库名称
cwarehouseid	string	否	否	收货仓库ID
dclosedate	string	否	否	关闭日期
dconfirmdate	string	否	否	确认日期
dcorrectdate	string	否	否	修正日期
deptcode	string	否	否	使用部门编码
dplanarrvdate	string	否	否	计划到货日期
forderrowstatus	string	否	否	订单行状态
idiscounttaxtype	string	否	否	扣税类别
iisactive	string	否	否	是否激活
iisreplenish	string	否	否	补货标志
invoicecorp_name	string	否	否	收票公司名称
jobcode	string	否	否	项目编码
jobphasecode	string	否	否	项目阶段编码
naccumarrvnum	string	否	否	累计到货数量
naccumdevnum	string	否	否	累计运输数量
naccuminvoicenum	string	否	否	累计发票数量
naccumrpnum	string	否	否	累计到货计划数量
naccumstorenum	string	否	否	累计入库数量
naccumwastnum	string	否	否	累计途耗数量
nassistnum	string	否	否	辅计量数量
nbackarrvnum	string	否	否	累计退货数量
nbackstorenum	string	否	否	累计退库数量
nconfirmnum	string	否	否	确认数量
ndiscountrate	string	否	否	扣率
nexchangeotobrate	string	否	否	扣率
nmoney	string	否	否	本币金额
nordernum	string	否	否	订货数量
norgnettaxprice	string	否	否	原币净含税单价
norgtaxprice	string	否	否	原币含税单价
noriginalcurmny	string	否	否	原币净无税金额
noriginalcurprice	string	否	否	原币无税单价
noriginalnetprice	string	否	否	原币净无税单价
noriginaltaxmny	string	否	否	原币税额
noriginaltaxpricemny	string	否	否	原币价税合计
ntaxmny	string	否	否	本币税额
ntaxpricemny	string	否	否	本币价税合计
ntaxrate	string	否	否	税率
pk_arrvcorp	string	否	否	收货公司
pk_arrvstoorg	string	否	否	收货库存组织
pk_corp	string	否	否	公司主键
pk_creqwareid	string	否	否	收货库存组织
pk_defdoc1	string	否	否	自定义项1
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
pk_invoicecorp	string	否	否	收票公司
pk_reqcorp	string	否	否	需求公司
pk_reqstoorg	string	否	否	需求库存组织
psncode	string	否	否	关闭人编码
reqcorp_name	string	否	否	需求公司名称
reqstoorg_name	string	否	否	需求库存组织名称
shortname	string	否	否	辅计量单位编码
storcode	string	否	否	收货仓库编码
termid	string	否	否	原币币种编码
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
user_code	string	否	否	操作员编码
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vpriceauditcode	string	否	否	价格审批单号
vproducenum	string	否	否	批次号
vreceiveaddress	string	否	否	收发货地址
vvenddevaddr	string	否	否	供应商收发货地址
vvendinventorycode	string	否	否	对应存货编码
vvendinventoryname	string	否	否	对应存货名称
vvendorordercode	string	否	否	对方订单号
vvendororderrow	string	否	否	对方订单行号
parentvo		否	是	采购订单查询结果主实体
bankdoccode	string	否	否	开户银行编码
bislatest	string	否	否	是否最新版本
breturn	string	否	否	是否退货
bsocooptome	string	否	否	是否由销售订单协同生成
busicode	string	否	否	业务类型编码
caccountbank_name	string	否	否	开户银行名称
caccountbankid	string	否	否	开户银行
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人ID
cauditpsn_name	string	否	否	审批人名称
cbiztype	string	否	否	业务类型
cbiztype_name	string	否	否	业务类型名称
ccurrencytypeid	string	否	否	整单币种
cdept_name	string	否	否	采购部门名称
cdeptid	string	否	否	采购部门
cemployee_name	string	否	否	采购员名称
cemployeeid	string	否	否	采购员
cgiveinvoicevendor	string	否	否	发票方
cgiveinvoicevendor_name	string	否	否	发票方名称
code	string	否	否	采购组织编码
coperator	string	否	否	制单人ID
coperator_name	string	否	否	制单人名称
corderid	string	否	否	采购订单ID
corp_name	string	否	否	公司名称
cproject_name	string	否	否	项目名称
cprojectid	string	否	否	项目
cpurorganization	string	否	否	采购组织
cpurorganization_name	string	否	否	采购组织名称
creciever	string	否	否	收货方
creciever_name	string	否	否	收货方名称
crevisepsn	string	否	否	修订人
crevisepsn_name	string	否	否	修订人名称
ctermprotocol_name	string	否	否	付款协议名称
ctermprotocolid	string	否	否	付款协议
ctransmode_name	string	否	否	运输方式名称
ctransmodeid	string	否	否	运输方式
cunfreeze	string	否	否	解冻人ID
cunfreeze_name	string	否	否	解冻人名称
currtype_code	string	否	否	整单编码
currtype_name	string	否	否	整单名称
custcode	string	否	否	收货方编码
cvendormangid	string	否	否	供应商管理档案ID
dauditdate	string	否	否	审批日期
deptcode	string	否	否	采购部门编码
dorderdate	string	否	否	订单日期
drevisiondate	string	否	否	修订日期
forderstatus	string	否	否	订单状态
iprintcount	string	否	否	打印次数
jobcode	string	否	否	项目编码
nexchangeotobrate	string	否	否	整单折本汇率
nprepaymaxmny	string	否	否	本币预付款限额
nprepaymny	string	否	否	本币预付款
nversion	string	否	否	版本信息
pk_corp	string	否	否	公司
pk_defdoc1	string	否	否	自定义项1
pk_defdoc10	string	否	否	自定义项10
pk_defdoc11	string	否	否	自定义项11
pk_defdoc12	string	否	否	自定义项12
pk_defdoc13	string	否	否	自定义项13
pk_defdoc14	string	否	否	自定义项14
pk_defdoc15	string	否	否	自定义项15
pk_defdoc16	string	否	否	自定义项16
pk_defdoc17	string	否	否	自定义项17
pk_defdoc18	string	否	否	自定义项18
pk_defdoc19	string	否	否	自定义项19
pk_defdoc2	string	否	否	自定义项2
pk_defdoc20	string	否	否	自定义项20
pk_defdoc3	string	否	否	自定义项3
pk_defdoc4	string	否	否	自定义项4
pk_defdoc5	string	否	否	自定义项5
pk_defdoc6	string	否	否	自定义项6
pk_defdoc7	string	否	否	自定义项7
pk_defdoc8	string	否	否	自定义项8
pk_defdoc9	string	否	否	自定义项9
psncode	string	否	否	采购员编码
sendcode	string	否	否	运输方式编码
taudittime	string	否	否	审批时间
termid	string	否	否	付款协议编码
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
trevisiontime	string	否	否	修订时间
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
user_code	string	否	否	审批人编码
vcoopordercode	string	否	否	对方订单号
vmemo	string	否	否	备注
vordercode	string	否	否	订单编号
errorcode				服务执行失败后返回的错误码
retcount				服务执行查询到的当前返回的记录数
allcount				服务执行查询到的总记录数
status				服务执行成功状态
data				服务执行返回的数据

代码示例:

Java模板示例下载 C#模板示例下载

请求参数示例:

复制代码

{"date_end":"2018-09-01","page_size":10,"page_now":1,"date_begin":"2010-01-01","code":"CDTH1804020003","corp":"1000","ts_begin":"2021-08-09 14:32:00","ts_end":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

{"status":"success","data":"{\"allcount\":0,\"retcount\":0}"}
或
{"status":"success","data":"{"allcount":1,"retcount":1,"datas":[{"parentvo":{"pk_corp":"总公司","unitcode":"1000","cbiztype":"普通采购（自制）","busicode":"c009","cpurorganization":"总公司采购组织","code":"1000","cdeptid":"采购部","deptcode":"106","cgiveinvoicevendor":"北京有限公司","custcode":"S2003","coperator":"Tom","user_code":"18712345678","dorderdate":"2018-04-02","forderstatus":"0","vordercode":"CDTH1804020003","ts":"2018-04-02 15:57:50","nversion":"1","tlastmaketime":"2018-04-02 15:57:50","tmaketime":"2018-04-02 15:57:50","breturn":false,"bsocooptome":false,"bislatest":true,"cvendormangid":"北京康普乳品有限公司","bcooptoso":false,"bisreplenish":false,"cvendorbaseid":"000111100000000006KK"},"childrenvo":[{"ccurrencytypeid":"人民币","termid":"CNY","cmangid":"奶粉","invcode":"0101","unitcode":"1000","pk_arrvcorp":"总公司","pk_reqcorp":"总公司","coperator":"Tom","user_code":"18712345678","pk_corp":"总公司","crowno":"10","naccumstorenum":1,"nexchangeotobrate":1,"nmoney":2,"nordernum":1,"norgnettaxprice":2.34,"norgtaxprice":2.34,"noriginalcurmny":2,"noriginalcurprice":2,"noriginalnetprice":2,"noriginaltaxmny":0.34,"noriginaltaxpricemny":2.34,"ntaxmny":0.34,"ntaxpricemny":2.34,"ntaxrate":17,"ts":"2018-04-03 10:47:29","ndiscountrate":100,"iisreplenish":"0","iisactive":"0","idiscounttaxtype":"1","forderrowstatus":"0","cbaseid":"00011110000000000DX8","breceiveplan":false}]}]}"}

错误返回示例:

复制代码

error status : 500, {'status':'-1', 'msg':'errcode:300017, errormsg: Requied parameter can not be null: date_end'}
Spend Time: 3 ms