U8C API中心

API中心

采购管理
物资需求申请

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

物资需求申请单新增

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

详细描述:默认所有档案按编码翻译<br /> 需求类型：0（毛需求）1（净需求）<br /> 单据状态：8（自由）

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

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

参数名	类型	是否数组	必填	描述
appBillVO		是	是	物资需求申请聚合VO
childrenvo		是	是	物资需求申请表体
capplydeptid	string	否	否	申请部门
capplypsnid	string	否	否	申请人
castunitid	string	否	否	辅计量单位
cdestaddressid	string	否	否	收货地址
cdestareaid	string	否	否	收货地区
cdestsiteid	string	否	否	收货地点
cinventoryid	string	否	是	存货
cnextbalancecalid	string	否	否	下次平衡库存组织
cnextbalancecorp	string	否	否	下次平衡公司
corigcalid	string	否	否	原始需求库存组织
cprojectid	string	否	否	项目
cprojectphaseid	string	否	否	项目阶段
creqcalbodyid	string	否	是	需求库存组织
crequireapp_bid	string	否	否	表体主键（调用修改接口时必填）
crequiredeptid	string	否	否	需求部门
creqwarehouseid	string	否	否	需求仓库
dreqdate	string	否	否	需求日期
naccuoutnum	double	否	否	累计出库数量
naccuoutreqnum	double	否	否	累计出库申请数量
naccupurnum	double	否	否	累计转采购数量
naccustornum	double	否	否	库存满足数量
ninassistnum	double	否	否	辅数量
nmny	double	否	否	金额
nnum	double	否	是	数量
nprice	double	否	否	单价
pk_bdefdoc1	string	否	否	自定义项1
pk_bdefdoc10	string	否	否	自定义项10
pk_bdefdoc11	string	否	否	自定义项11
pk_bdefdoc12	string	否	否	自定义项12
pk_bdefdoc13	string	否	否	自定义项13
pk_bdefdoc14	string	否	否	自定义项14
pk_bdefdoc15	string	否	否	自定义项15
pk_bdefdoc16	string	否	否	自定义项16
pk_bdefdoc17	string	否	否	自定义项17
pk_bdefdoc18	string	否	否	自定义项18
pk_bdefdoc19	string	否	否	自定义项19
pk_bdefdoc2	string	否	否	自定义项2
pk_bdefdoc20	string	否	否	自定义项20
pk_bdefdoc3	string	否	否	自定义项3
pk_bdefdoc4	string	否	否	自定义项4
pk_bdefdoc5	string	否	否	自定义项5
pk_bdefdoc6	string	否	否	自定义项6
pk_bdefdoc7	string	否	否	自定义项7
pk_bdefdoc8	string	否	否	自定义项8
pk_bdefdoc9	string	否	否	自定义项9
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
parentvo		否	否	物资需求申请表头
burgency	string	否	否	是否紧急
clastoperatorid	string	否	否	最后修改人
coperator	string	否	是	制单人
crequireappid	string	否	否	表头主键（调用修改接口时必填）
dapplydate	string	否	否	申请日期
freqtypeflag	int	否	是	需求类型
fstatusflag	int	否	否	单据状态
iprintcount	int	否	否	打印次数
pk_corp	string	否	是	公司
pk_hdefdoc1	string	否	否	自定义项1（统计型）
pk_hdefdoc10	string	否	否	自定义项10（统计型）
pk_hdefdoc11	string	否	否	自定义项11（统计型）
pk_hdefdoc12	string	否	否	自定义项12（统计型）
pk_hdefdoc13	string	否	否	自定义项13（统计型）
pk_hdefdoc14	string	否	否	自定义项14（统计型）
pk_hdefdoc15	string	否	否	自定义项15（统计型）
pk_hdefdoc16	string	否	否	自定义项16（统计型）
pk_hdefdoc17	string	否	否	自定义项17（统计型）
pk_hdefdoc18	string	否	否	自定义项18（统计型）
pk_hdefdoc19	string	否	否	自定义项19（统计型）
pk_hdefdoc2	string	否	否	自定义项2（统计型）
pk_hdefdoc20	string	否	否	自定义项20（统计型）
pk_hdefdoc3	string	否	否	自定义项3（统计型）
pk_hdefdoc4	string	否	否	自定义项4（统计型）
pk_hdefdoc5	string	否	否	自定义项5（统计型）
pk_hdefdoc6	string	否	否	自定义项6（统计型）
pk_hdefdoc7	string	否	否	自定义项7（统计型）
pk_hdefdoc8	string	否	否	自定义项8（统计型）
pk_hdefdoc9	string	否	否	自定义项9（统计型）
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
vbillcode	string	否	否	申请单号
vhdef1	string	否	否	自定义项1（备注型）
vhdef10	string	否	否	自定义项10（备注型）
vhdef11	string	否	否	自定义项11（备注型）
vhdef12	string	否	否	自定义项12（备注型）
vhdef13	string	否	否	自定义项13（备注型）
vhdef14	string	否	否	自定义项14（备注型）
vhdef15	string	否	否	自定义项15（备注型）
vhdef16	string	否	否	自定义项16（备注型）
vhdef17	string	否	否	自定义项17（备注型）
vhdef18	string	否	否	自定义项18（备注型）
vhdef19	string	否	否	自定义项19（备注型）
vhdef2	string	否	否	自定义项2（备注型）
vhdef20	string	否	否	自定义项20（备注型）
vhdef3	string	否	否	自定义项3（备注型）
vhdef4	string	否	否	自定义项4（备注型）
vhdef5	string	否	否	自定义项5（备注型）
vhdef6	string	否	否	自定义项6（备注型）
vhdef7	string	否	否	自定义项7（备注型）
vhdef8	string	否	否	自定义项8（备注型）
vhdef9	string	否	否	自定义项9（备注型）
vmemo	string	否	否	备注

返回类型参数:

参数名	类型	是否数组	必填	描述
AppBillVO_Query				物资需求申请单保存后返回VO
childrenvo		是	否	物资需求申请返回值表体VO
applypsnid_code	string	否	否	申请人编码
applypsnid_name	string	否	否	申请人名称
astunit_code	string	否	否	辅计量单位编码
astunit_name	string	否	否	辅计量单位名称
bclose	string	否	否	是否关闭
bendgather	string	否	否	需求平衡是否完成
bodycode	string	否	否	需求库存组织编码
bodyname	string	否	否	需求库存组织名称
capplydeptid	string	否	否	申请部门
capplypsnid	string	否	否	申请人
castunitid	string	否	否	辅计量单位
cdestaddressid	string	否	否	收货地址
cdestareaid	string	否	否	收货地区
cdestsiteid	string	否	否	收货地点
cdestsiteid_name	string	否	否	收货地点名称
cgatherid	string	否	否	汇总ID
cgatherpsnid	string	否	否	汇总人
cgatherpsnid_code	string	否	否	汇总人编码
cgatherpsnid_name	string	否	否	汇总人名称
cinventoryid	string	否	否	存货
cnextbacalid_code	string	否	否	下次平衡库存组织编码
cnextbacalid_name	string	否	否	下次平衡库存组织名称
cnextbalancecalid	string	否	否	下次平衡库存组织
cnextbalancecorp	string	否	否	下次平衡公司
corigcalid	string	否	否	原始需求库存组织
corigcalid_code	string	否	否	原始需求库存组织编码
corigcalid_name	string	否	否	原始需求库存组织名称
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
cprojectid	string	否	否	项目
cprojectphaseid	string	否	否	项目阶段
creqcalbodyid	string	否	否	需求库存组织
crequiredeptid	string	否	否	需求部门
creqwarehouseid	string	否	否	需求仓库
crowno	string	否	否	行号
dept_code	string	否	否	申请部门编码
dept_name	string	否	否	申请部门名称
destareaid_code	string	否	否	收货地区编码
destareaid_name	string	否	否	收货地区名称
destsiteid_code	string	否	否	收货地点编码
dr	int	否	否	删除标志
dreqdate	string	否	否	需求日期
hsl	double	否	否	换算率
invcode	string	否	否	存货基本档案编码
inventory_code	string	否	否	存货编码
inventory_name	string	否	否	存货名称
invname	string	否	否	存货基本档案名称
naccuoutnum	double	否	否	累计出库数量
naccuoutreqnum	double	否	否	累计出库申请数量
naccupurnum	double	否	否	累计转采购数量
naccustornum	double	否	否	库存满足数量
nextbalcorp_code	string	否	否	下次平衡公司编码
nextbalcorp_name	string	否	否	下次平衡公司名称
ninassistnum	double	否	否	辅数量
nmny	double	否	否	金额
nnetnum	double	否	否	转净需求数量
nnum	double	否	是	数量
nprice	double	否	否	单价
pk_bdefdoc1	string	否	否	自定义项1PK
pk_bdefdoc10	string	否	否	自定义项10PK
pk_bdefdoc11	string	否	否	自定义项11PK
pk_bdefdoc12	string	否	否	自定义项12PK
pk_bdefdoc13	string	否	否	自定义项13PK
pk_bdefdoc14	string	否	否	自定义项14PK
pk_bdefdoc15	string	否	否	自定义项15PK
pk_bdefdoc16	string	否	否	自定义项16PK
pk_bdefdoc17	string	否	否	自定义项17PK
pk_bdefdoc18	string	否	否	自定义项18PK
pk_bdefdoc19	string	否	否	自定义项19PK
pk_bdefdoc2	string	否	否	自定义项2PK
pk_bdefdoc20	string	否	否	自定义项20PK
pk_bdefdoc3	string	否	否	自定义项3PK
pk_bdefdoc4	string	否	否	自定义项4PK
pk_bdefdoc5	string	否	否	自定义项5PK
pk_bdefdoc6	string	否	否	自定义项6PK
pk_bdefdoc7	string	否	否	自定义项7PK
pk_bdefdoc8	string	否	否	自定义项8PK
pk_bdefdoc9	string	否	否	自定义项9PK
pk_corp	string	否	否	公司
pk_invbasdoc	string	否	否	存货基本档案
project_code	string	否	否	项目编码
project_name	string	否	否	项目名称
projectphase_code	string	否	否	项目阶段编码
projectphase_name	string	否	否	项目阶段名称
reqware_code	string	否	否	需求仓库编码
reqware_name	string	否	否	需求仓库名称
tgathertime	string	否	否	汇总时间
ts	string	否	否	时间戳
vbatchcode	string	否	否	批次号
vbdef1	string	否	否	自定义项1名称
vbdef10	string	否	否	自定义项10名称
vbdef11	string	否	否	自定义项11名称
vbdef12	string	否	否	自定义项12名称
vbdef13	string	否	否	自定义项13名称
vbdef14	string	否	否	自定义项14名称
vbdef15	string	否	否	自定义项15名称
vbdef16	string	否	否	自定义项16名称
vbdef17	string	否	否	自定义项17名称
vbdef18	string	否	否	自定义项18名称
vbdef19	string	否	否	自定义项19名称
vbdef2	string	否	否	自定义项2名称
vbdef20	string	否	否	自定义项20名称
vbdef3	string	否	否	自定义项3名称
vbdef4	string	否	否	自定义项4名称
vbdef5	string	否	否	自定义项5名称
vbdef6	string	否	否	自定义项6名称
vbdef7	string	否	否	自定义项7名称
vbdef8	string	否	否	自定义项8名称
vbdef9	string	否	否	自定义项9名称
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vmemo	string	否	否	备注
parentvo		否	否	物资需求申请返回值表头VO
approverid_code	string	否	否	审核人编码
approverid_name	string	否	否	审核人名称
burgency	string	否	否	是否紧急
capproverid	string	否	否	审核人
cbilltypecode	string	否	否	单据类型
clastoperatorid	string	否	否	最后修改人
coperator	string	否	否	制单人
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
dapplydate	string	否	否	申请日期
dauditdate	string	否	否	审批日期
dr	int	否	否	删除标志
freqtypeflag	int	否	否	需求类型
fstatusflag	string	否	否	单据状态
iprintcount	string	否	否	打印次数
lastmodi_code	string	否	否	最后修改人编码
lastmodi_name	string	否	否	最后修改人名称
operator_code	string	否	否	制单人编码
operator_name	string	否	否	制单人名称
pk_corp	string	否	否	公司
pk_hdefdoc1	string	否	否	自定义项1PK
pk_hdefdoc10	string	否	否	自定义项10PK
pk_hdefdoc11	string	否	否	自定义项11PK
pk_hdefdoc12	string	否	否	自定义项12PK
pk_hdefdoc13	string	否	否	自定义项13PK
pk_hdefdoc14	string	否	否	自定义项14PK
pk_hdefdoc15	string	否	否	自定义项15PK
pk_hdefdoc16	string	否	否	自定义项16PK
pk_hdefdoc17	string	否	否	自定义项17PK
pk_hdefdoc18	string	否	否	自定义项18PK
pk_hdefdoc19	string	否	否	自定义项19PK
pk_hdefdoc2	string	否	否	自定义项2PK
pk_hdefdoc20	string	否	否	自定义项20PK
pk_hdefdoc3	string	否	否	自定义项3PK
pk_hdefdoc4	string	否	否	自定义项4PK
pk_hdefdoc5	string	否	否	自定义项5PK
pk_hdefdoc6	string	否	否	自定义项6PK
pk_hdefdoc7	string	否	否	自定义项7PK
pk_hdefdoc8	string	否	否	自定义项8PK
pk_hdefdoc9	string	否	否	自定义项9PK
taudittime	string	否	否	审批时间
tgathertime	string	否	否	汇总时间
tlastmaketime	string	否	否	最后修改时间
tmaketime	string	否	否	制单时间
ts	string	否	否	时间戳
vbillcode	string	否	否	单据号
vhdef1	string	否	否	自定义项1名称
vhdef10	string	否	否	自定义项10名称
vhdef11	string	否	否	自定义项11名称
vhdef12	string	否	否	自定义项12名称
vhdef13	string	否	否	自定义项13名称
vhdef14	string	否	否	自定义项14名称
vhdef15	string	否	否	自定义项15名称
vhdef16	string	否	否	自定义项16名称
vhdef17	string	否	否	自定义项17名称
vhdef18	string	否	否	自定义项18名称
vhdef19	string	否	否	自定义项19名称
vhdef2	string	否	否	自定义项2名称
vhdef20	string	否	否	自定义项20名称
vhdef3	string	否	否	自定义项3名称
vhdef4	string	否	否	自定义项4名称
vhdef5	string	否	否	自定义项5名称
vhdef6	string	否	否	自定义项6名称
vhdef7	string	否	否	自定义项7名称
vhdef8	string	否	否	自定义项8名称
vhdef9	string	否	否	自定义项9名称
vmemo	string	否	否	备注

代码示例:

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

请求参数示例:

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

复制代码

{"appBillVO":[{"parentvo":{"coperator":"apiwjh","freqtypeflag":"1","pk_corp":"2401"},"childrenvo":[{"cinventoryid":"0901","creqcalbodyid":"9999","nnum":1}]}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"vbillcode\":\"MR2309140002\",\"coperator\":\"0001A11000000002QQ4J\",\"operator_code\":\"apiwjh\",\"operator_name\":\"wjh\",\"pk_corp\":\"1005\",\"corp_code\":\"2401\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"iprintcount\":\"0\",\"tlastmaketime\":\"2023-09-14 19:36:01\",\"tmaketime\":\"2023-09-14 19:36:01\",\"freqtypeflag\":\"1\",\"cbilltypecode\":\"422X\",\"clastoperatorid\":\"0001A11000000002QQ4J\",\"lastmodi_code\":\"apiwjh\",\"lastmodi_name\":\"wjh\",\"burgency\":false,\"dapplydate\":\"2023-09-14\",\"fstatusflag\":\"8\",\"ts\":\"2023-09-14 19:36:01\"},\"childrenvo\":[{\"nnum\":\"1\",\"dreqdate\":\"2023-09-14\",\"creqcalbodyid\":\"1005F4100000000011TD\",\"bodycode\":\"9999\",\"bodyname\":\"w库存组织\",\"cinventoryid\":\"0001F410000000044TSE\",\"inventory_code\":\"0901\",\"inventory_name\":\"大数量存货\",\"pk_invbasdoc\":\"0001F410000000044TSB\",\"cnextbalancecalid\":\"1005F4100000000011TD\",\"cnextbacalid_ode\":\"9999\",\"cnextbacalid_name\":\"w库存组织\",\"corigcalid\":\"1005F4100000000011TD\",\"corigcalid_ode\":\"9999\",\"corigcalid_name\":\"w库存组织\",\"cnextbalancecorp\":\"1005\",\"nextbalcorp_code\":\"2401\",\"nextbalcorp_name\":\"wjh石油天然气集团有限公司\",\"pk_corp\":\"1005\",\"corp_code\":\"2401\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"crowno\":\"10\",\"ts\":\"2023-09-14 19:36:01\"}]}]","taskNumber":"202309140030"}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
errormsg: "表头：需求公司不能为空！"
}