U8C API中心

API中心

采购管理
请购单

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

请购单新增

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

详细描述:用于请购单新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式: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	否	否	请购单编号

返回类型参数:

参数名	类型	是否数组	必填	描述
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#模板示例下载

请求参数示例:

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

复制代码

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

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"coperator\":\"0001A2100000000000Y8\",\"operator_code\":\"apilym\",\"operator_name\":\"lym\",\"cpraybillid\":\"1010F410000000001B2L\",\"dpraydate\":\"2023-09-01\",\"dr\":\"0\",\"ibillstatus\":\"0\",\"ipraysource\":\"5\",\"ipraytype\":\"2\",\"nversion\":\"1\",\"pk_corp\":\"1010\",\"unit_code\":\"2901\",\"unit_name\":\"lym投资控股有限公司\",\"tlastmaketime\":\"2023-09-01 11:16:37\",\"tmaketime\":\"2023-09-01 11:16:37\",\"vpraycode\":\"QG****2309010001\"},\"childrenvo\":[{\"cbaseid\":\"0001ZZ10000000000DX1\",\"cmangid\":\"0001A210000000001FYU\",\"inv_code\":\"IN0007\",\"inv_name\":\"TEST11111\",\"invspec\":\"123\",\"invtype\":\"4\",\"cpraybill_bid\":\"1010F410000000001B2M\",\"cpraybillid\":\"1010F410000000001B2L\",\"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": "202309010008"
}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
errormsg: "传入数据有的字段为空！第1条数据：表头：[公司, 制单人]第1行表体：[存货管理id, 需求数量]"
}

Spend Time: 5031 ms