U8C API中心

API中心

采购管理
物资需求申请

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

物资需求申请单保存即审批

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

详细描述:用于物资需求申请单保存即审批

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式: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	否	否	备注

返回类型参数:

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

No Data

代码示例:

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

请求参数示例:

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

复制代码

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

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"vbillcode\":\"MR2009090008\",\"coperator\":\"000132100000000000UO\",\"operator_code\":\"18242366050\",\"operator_name\":\"刘云祥\",\"pk_corp\":\"1007\",\"corp_code\":\"8888\",\"corp_name\":\"刘云祥集团\",\"iprintcount\":\"0\",\"tlastmaketime\":\"2020-09-09 11:17:02\",\"tmaketime\":\"2020-09-09 11:17:02\",\"freqtypeflag\":\"0\",\"capproverid\":\"000132100000000000UO\",\"approverid_code\":\"18242366050\",\"approverid_name\":\"刘云祥\",\"cbilltypecode\":\"422X\",\"clastoperatorid\":\"000132100000000000UO\",\"lastmodi_code\":\"18242366050\",\"lastmodi_name\":\"刘云祥\",\"burgency\":false,\"dapplydate\":\"2020-09-09\",\"fstatusflag\":\"8\",\"ts\":\"2020-09-09 11:17:02\",\"taudittime\":\"2020-09-09 11:17:02\"},\"childrenvo\":[{\"nnum\":22,\"dreqdate\":\"2020-09-09\",\"creqcalbodyid\":\"1007121000000000008R\",\"bodycode\":\"1000\",\"bodyname\":\"集团组织01\",\"cinventoryid\":\"00011210000000003L1N\",\"inventory_code\":\"IN0001\",\"inventory_name\":\"苹果\",\"pk_invbasdoc\":\"000132100000000002VJ\",\"cnextbalancecalid\":\"100712100000000000RT\",\"cnextbacalid_ode\":\"2000\",\"cnextbacalid_name\":\"平衡库存组织\",\"corigcalid\":\"1007121000000000008R\",\"corigcalid_ode\":\"1000\",\"corigcalid_name\":\"集团组织01\",\"cnextbalancecorp\":\"1007\",\"nextbalcorp_code\":\"8888\",\"nextbalcorp_name\":\"刘云祥集团\",\"pk_corp\":\"1007\",\"corp_code\":\"8888\",\"corp_name\":\"刘云祥集团\",\"crowno\":\"10\",\"ts\":\"2020-09-09 11:17:02\"}]}]",
    "taskNumber": "202009090017"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "下面的档案无法翻译：档案类型：库存组织,档案编码：1000,档案类型：公司目录,档案编码：88888,档案类型：存货档案,档案编码：IN0001,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！",
    "taskNumber": "202009090018"
}