U8C API中心

API中心

采购管理
请购单

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

请购单保存即审批

接口所在U8C版本:U8 cloud3.1以及更高版本

详细描述:用于请购单保存即审批

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
trantype	否	翻译类型，按编码为code，不需要翻译为pk	code
system	是	系统参数
uniquekey	否	幂等唯一key

请求参数(body):

全量参数自制最简带统计型自定义项带备注型自定义项

参数名	类型	是否数组	必填	描述
praybill		否	是	请购单聚合VO
childrenvo		是	否	请购单表体实体VO
bpublishtoec	string	否	否	是否发布到电子商务
cassistunit	string	否	否	辅计量单位
cbaseid	string	否	否	存货基础
cbiztype	string	否	否	业务类型
cemployeeid	string	否	否	采购员
cmangid	string	否	是	存货管理
cpraybill_bid	string	否	否	请购单行id（调用修改接口时必填）
cpraybillid	string	否	否	请购单ID
cproductbasid	string	否	否	产品基本档案ID
cproductmanid	string	否	否	产品管理档案ID
cprojectid	string	否	否	项目
cprojectphaseid	string	否	否	项目阶段
cpurorganization	string	否	否	采购组织
crowno	string	否	否	行号
cvendorbaseid	string	否	否	建议供应商基础
cvendormangid	string	否	否	建议供应商管理
cwarehouseid	string	否	否	需求仓库
ddemanddate	string	否	否	需求日期
dr	int	否	否	删除标志
dsuggestdate	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	否	否	需求库存组织
ts	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
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
vproducenum	string	否	否	批次号
parentvo		否	否	请购单表头实体VO
bdirecttransit	string	否	否	是否直运
caccountyear	string	否	否	会计年度
cauditpsn	string	否	否	审批人
cbiztype	string	否	否	业务类型
ccontracttextpath	string	否	否	合同文本路径
ccustomerid	string	否	否	销售客户
cdeptid	string	否	否	请购部门
coperator	string	否	是	制单人
cplannerid	string	否	否	计划员
cpraybillid	string	否	否	请购单表头主键（调用修改接口时必填））
cpraypsn	string	否	否	请购人
creviseoperid	string	否	否	修订人
dauditdate	string	否	否	审批日期
dpraydate	string	否	否	请购日期
dr	string	否	否	删除标志
drevisedate	string	否	否	修订日期
ibillstatus	string	否	否	单据状态
ipraysource	string	否	否	请购来源
ipraytype	string	否	否	请购类型
iprintcount	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
taudittime	string	否	否	审批时间
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
trevisiontime	string	否	否	修订时间
ts	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	否	否	请购单编号

返回类型参数:

参数名	类型	是否数组	必填	描述	默认值

No Data

代码示例:

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

请求参数示例:

自制最简带统计型自定义项带备注型自定义项

复制代码

{"praybill":[{"childrenvo":[{"cmangid":"IN0007","npraynum":"10000000","pk_corp":"2901"}],"parentvo":{"coperator":"apilym","pk_corp":"2901"}}]}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"cauditpsn\":\"0001A2100000000000Y8\",\"auditpsn_code\":\"apilym\",\"auditpsn_name\":\"lym\",\"coperator\":\"0001A2100000000000Y8\",\"operator_code\":\"apilym\",\"operator_name\":\"lym\",\"cpraybillid\":\"1010F410000000001B38\",\"dauditdate\":\"2023-09-01\",\"dpraydate\":\"2023-09-01\",\"dr\":\"0\",\"ibillstatus\":\"3\",\"ipraysource\":\"5\",\"ipraytype\":\"2\",\"nversion\":\"1\",\"pk_corp\":\"1010\",\"unit_code\":\"2901\",\"unit_name\":\"lym投资控股有限公司\",\"tlastmaketime\":\"2023-09-01 14:00:13\",\"tmaketime\":\"2023-09-01 14:00:13\",\"vpraycode\":\"QG****2309010006\"},\"childrenvo\":[{\"cbaseid\":\"0001ZZ10000000000DX1\",\"cmangid\":\"0001A210000000001FYU\",\"inv_code\":\"IN0007\",\"inv_name\":\"TEST11111\",\"invspec\":\"123\",\"invtype\":\"4\",\"cpraybill_bid\":\"1010F410000000001B39\",\"cpraybillid\":\"1010F410000000001B38\",\"crowno\":\"10\",\"ddemanddate\":\"2023-09-01\",\"dr\":\"0\",\"dsuggestdate\":\"2023-09-01\",\"npraynum\":\"10000000\",\"npraynum0\":\"10000000\",\"pk_corp\":\"1010\",\"unitcode\":\"2901\",\"unitname\":\"lym投资控股有限公司\",\"pk_purcorp\":\"1010\",\"purcorp_code\":\"2901\",\"purcorp_name\":\"lym投资控股有限公司\",\"pk_reqcorp\":\"1010\",\"reqcorp_code\":\"2901\",\"reqcorp_name\":\"lym投资控股有限公司\"}]}]",
    "taskNumber": "202309010015"
}

错误返回示例:

复制代码

{
  "status": "falied",
  "errorcode": "-32000",
  "errormsg": "下面的档案无法翻译：档案类型：存货档案,档案编码：010493,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！",
  "stacktrace": "nc.vo.pub.BusinessException: 下面的档案无法翻译：档案类型：存货档案,档案编码：010493,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！\r\nu8c.bs.translate.bp.AbstractTranBP.buildErrMessage(AbstractTranBP.java:128)\r\nu8c.bs.translate.bp.AbstractTranBP.translate(AbstractTranBP.java:74)\r\nu8c.bs.translate.bp.AggVOTranBP.tr…………………………,
  "taskNumber": "202009010034"
}