U8C API中心

API中心

采购管理
请购单

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

请购单查询

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

详细描述:用于请购单查询

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

参数名	是否数组	必填	描述
code	否	否	单据号
corp	否	是	公司
date_begin	否	否	单据日期开始（v3.5版本前必填）
date_end	否	否	单据日期结束（v3.5版本前必填）
endTs	否	否	结束时间戳（v3.5版本支持）
forderstatus	否	否	单据状态
maker	否	否	制单人
page_now	否	否	当前页
page_size	否	否	每页数量
praydept	否	否	请购部门
praypsn	否	否	请购人
startTs	否	否	开始时间戳（v3.5版本支持）

返回类型参数:

参数名	类型	是否数组	必填	描述
praybill				请购单聚合VO_返回
childrenvo		否	否
astunit_code	string	否	否	辅计量单位编码
astunit_name	string	否	否	辅计量单位名称
biztype_code	string	否	否	业务类型编码
biztype_name	string	否	否	业务类型名称
bpublishtoec	string	否	否	是否发布到电子商务
cassistunit	string	否	否	辅计量单位ID
cbaseid	string	否	否	存货基础ID
cbiztype	string	否	否	业务类型ID
cemployeeid	string	否	否	采购员
cmangid	string	否	否	存货管理ID
cpraybill_bid	string	否	否	请购单行ID
cpraybillid	string	否	否	请购单ID
cproductbasid	string	否	否	产品基本档案ID
cproductmanid	string	否	否	产品管理档案ID
cprojectid	string	否	否	项目ID
cprojectphaseid	string	否	否	项目阶段ID
cpurorganization	string	否	否	采购组织ID
crowno	string	否	否	行号
csourcebillid	string	否	否	来源单据ID
csourcebillrowid	string	否	否	来源单据行ID
csourcebilltype	string	否	否	来源单据类型
cupsourcebillid	string	否	否	上层来源单据ID
cupsourcebillrowid	string	否	否	上层来源单据行ID
cupsourcebilltype	string	否	否	上层单据类型
cvendorbaseid	string	否	否	建议供应商基础ID
cvendormangid	string	否	否	建议供应商管理ID
cwarehouseid	string	否	否	需求仓库ID
ddemanddate	string	否	否	需求日期
dr	int	否	否	删除标志
dsuggestdate	string	否	否	建议订货日期
employee_code	string	否	否	采购员编码
employee_name	string	否	否	采购员名称
inv_code	string	否	否	存货编码
inv_name	string	否	否	存货名称
naccumulatenum	double	否	否	累计订货数量
nassistnum	double	否	否	辅计量数量
ngenct	int	否	否	生成合同次数
nmoney	double	否	否	金额
npraynum	double	否	否	需求数量
npraynum0	double	否	否	最初请购数量
npriceauditbill	int	否	否	生成价格审批单次数
nquotebill	int	否	否	生成询报价单次数
nsuggestprice	double	否	否	建议单价
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
pk_purcorp	string	否	否	采购公司
pk_reqstoorg	string	否	否	需求库存组织
project_code	string	否	否	项目编码
project_name	string	否	否	项目名称
projectphase_code	string	否	否	项目阶段编码
projectphase_name	string	否	否	项目阶段名称
puorg_code	string	否	否	采购组织编码
puorg_name	string	否	否	采购组织名称
purcorp_code	string	否	否	采购公司编码
purcorp_name	string	否	否	采购公司名称
reqcorp_code	string	否	否	需求公司编码
reqcorp_name	string	否	否	需求公司名称
ts	string	否	否	时间戳
unitcode	string	否	否	公司编码
unitname	string	否	否	公司名称
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vendor_code	string	否	否	供应商编码
vendor_name	string	否	否	供应商名称
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vproducenum	string	否	否	批次号
warehouse_code	string	否	否	需求仓库编码
warehouse_name	string	否	否	需求仓库名称
parentvo		否	否
auditpsn_code		否	否	审批人编码
auditpsn_name		否	否	审批人名称
bdirecttransit	string	否	否	是否直运
biztype_code		否	否	业务类型编码
biztype_name		否	否	业务类型名称
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人ID
cbiztype	string	否	否	业务类型ID
ccontracttextpath	string	否	否	合同文本路径
ccustomerid	string	否	否	销售客户ID
cdeptid	string	否	否	请购部门ID
cdeptid_code		否	否	部门编码
cdeptid_name		否	否	部门名称
coperator	string	否	否	制单人ID
cplannerid	string	否	否	计划员
cpraybillid	string	否	否	请购单ID
cpraypsn	string	否	否	请购人ID
creviseoperid	string	否	否	修订人
customer_code		否	否	销售客户编码
customer_name		否	否	销售客户名称
dauditdate	string	否	否	审批日期
dpraydate	string	否	否	请购日期
dr	string	否	否	删除标志
drevisedate	string	否	否	修订日期
ibillstatus	string	否	否	单据状态
ipraysource	string	否	否	请购来源
ipraytype	string	否	否	请购类型
iprintcount	string	否	否	打印次数
nversion	string	否	否	版本号
operator_code		否	否	制单人编码
operator_name		否	否	制单人名称
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
planer_code	string	否	否	计划员编码
planer_name	string	否	否	计划员名称
praypsn_code	string	否	否	请购人编码
praypsn_name	string	否	否	请购人名称
revise_code	string	否	否	修订人编码
revise_name	string	否	否	修订人名称
taudittime	string	否	否	审批时间
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
trevisiontime	string	否	否	修订时间
ts	string	否	否	时间戳
unit_code	string	否	否	公司编码
unit_name	string	否	否	公司名称
vdef1	string	否	否	自定义项1
vdef10	string	否	否	自定义项10
vdef11	string	否	否	自定义项11
vdef12	string	否	否	自定义项12
vdef13	string	否	否	自定义项13
vdef14	string	否	否	自定义项14
vdef15	string	否	否	自定义项15
vdef16	string	否	否	自定义项16
vdef17	string	否	否	自定义项17
vdef18	string	否	否	自定义项18
vdef19	string	否	否	自定义项19
vdef2	string	否	否	自定义项2
vdef20	string	否	否	自定义项20
vdef3	string	否	否	自定义项3
vdef4	string	否	否	自定义项4
vdef5	string	否	否	自定义项5
vdef6	string	否	否	自定义项6
vdef7	string	否	否	自定义项7
vdef8	string	否	否	自定义项8
vdef9	string	否	否	自定义项9
vmemo	string	否	否	备注
vpraycode	string	否	否	请购单编号

代码示例:

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

请求参数示例:

复制代码

{"date_end":"2018-06-26","maker":"14444444045","date_begin":"2018-06-26","praypsn":"HI1709050005","forderstatus":"3","code":"QGTH1806260001","corp":"1000","praydept":"100","startTs":"2021-08-09 14:32:00","endTs":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

{"status":"success","data":"{\"allcount\":1,\"retcount\":1,\"datas\":[{\"parentvo\":{\"caccountyear\":\"2018\",\"cauditpsn\":\"000114100000000027H5\",\"auditpsn_code\":\"18511260712\",\"auditpsn_name\":\"于洋\",\"cdeptid\":\"100111100000000000OS\",\"cdeptid_code\":\"100\",\"cdeptid_name\":\"总裁办公室\",\"coperator\":\"000111100000000000RV\",\"operator_code\":\"14444444045\",\"operator_name\":\"体验45\",\"cpraybillid\":\"10011410000000000FFV\",\"cpraypsn\":\"00011110000000000A4X\",\"praypsn_code\":\"HI1709050005\",\"praypsn_name\":\"李夕\",\"dauditdate\":\"2018-06-26\",\"dpraydate\":\"2018-06-26\",\"dr\":\"0\",\"ibillstatus\":\"3\",\"ipraysource\":\"5\",\"ipraytype\":\"2\",\"pk_corp\":\"1001\",\"unit_code\":\"1000\",\"unit_name\":\"天海总公司\",\"taudittime\":\"2018-06-26 16:42:54\",\"tlastmaketime\":\"2018-06-26 16:33:59\",\"tmaketime\":\"2018-06-26 16:30:36\",\"ts\":\"2018-06-26 16:42:54\",\"vmemo\":\"\",\"vpraycode\":\"QGTH1806260001\"},\"childrenvo\":[{\"bpublishtoec\":false,\"cbaseid\":\"00011110000000000DX8\",\"cmangid\":\"00011110000000000ETE\",\"inv_code\":\"010109\",\"inv_name\":\"婴儿奶粉245\",\"cpraybill_bid\":\"10011410000000000FFW\",\"cpraybillid\":\"10011410000000000FFV\",\"crowno\":\"10\",\"ddemanddate\":\"2018-06-26\",\"dr\":\"0\",\"dsuggestdate\":\"2018-06-26\",\"naccumulatenum\":2.33,\"ngenct\":\"0\",\"npraynum\":2.33,\"npraynum0\":2.33,\"npriceauditbill\":\"0\",\"pk_corp\":\"1001\",\"unitcode\":\"1000\",\"unitname\":\"天海总公司\",\"pk_purcorp\":\"1001\",\"purcorp_code\":\"1000\",\"purcorp_name\":\"天海总公司\",\"pk_reqcorp\":\"1001\",\"reqcorp_code\":\"1000\",\"reqcorp_name\":\"天海总公司\",\"ts\":\"2018-06-26 16:44:02\"}]}]}"}

错误返回示例:

复制代码

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