U8C API中心

API中心

库存管理
出库申请

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

出库申请单新增

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

详细描述:用于出库申请单新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/ic/sapply/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

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

参数名	类型	是否数组	必填	描述
billvo		是	是	出库申请单信息
childrenvo		是	是	出库申请单表体VO
appcastnum	string	否	否	申请辅数量
applynum	string	否	是	申请数量
castunitid	string	否	否	辅单位
cbilltypecode	string	否	否	单据类型
ccostobjectid	string	否	否	成本对象
cfirstbillbid	string	否	否	源头单据表体id
cfirstbillhid	string	否	否	源头单据表头id
cfirsttype	string	否	否	源头单据类型
cinvbasid	string	否	否	存货基本id
cinventoryid	string	否	是	存货
cprojectid	string	否	否	项目（5.0sp支持）
cqualitylevelid	string	否	否	质量等级
crowno	string	否	否	行号
csourcebillbid	string	否	否	来源单据表体ID
csourcebillhid	string	否	否	来源单据表头ID
csourcebodyts	string	否	否	来源表体时间戳
csourceheadts	string	否	否	来源表头时间戳
cunitid	string	否	否	单位
cvendorid	string	否	否	供应商
dfirstbilldate	string	否	否	源头单据制单日期
hsl	string	否	否	换算率
isclosed	string	否	否	是否关闭
ncorrespondnum	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（统计型传编码）
planrecvdate	string	否	否	计划领用日期
recvmaterwhid	string	否	否	领料仓库
sapply_bid	string	否	否	出库申请单表体主键
sapply_hid	string	否	否	出库申请单单头主键
vfirstbillcode	string	否	否	源头单据号
vfirstrowno	string	否	否	源头单据行号
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vnote	string	否	否	备注
vproductbatch	string	否	否	生产订单号
vsourcebillcode	string	否	否	来源单据号
vsourcerowno	string	否	否	来源单据行号
vsourcetype	string	否	否	来源单据类型
vuserdef1	string	否	否	自定义项1（备注型传这个）
vuserdef10	string	否	否	自定义项10（备注型传这个）
vuserdef11	string	否	否	自定义项11（备注型传这个）
vuserdef12	string	否	否	自定义项12（备注型传这个）
vuserdef13	string	否	否	自定义项13（备注型传这个）
vuserdef14	string	否	否	自定义项14（备注型传这个）
vuserdef15	string	否	否	自定义项15（备注型传这个）
vuserdef16	string	否	否	自定义项16（备注型传这个）
vuserdef17	string	否	否	自定义项17（备注型传这个）
vuserdef18	string	否	否	自定义项18（备注型传这个）
vuserdef19	string	否	否	自定义项19（备注型传这个）
vuserdef2	string	否	否	自定义项2（备注型传这个）
vuserdef20	string	否	否	自定义项20（备注型传这个）
vuserdef3	string	否	否	自定义项3（备注型传这个）
vuserdef4	string	否	否	自定义项4（备注型传这个）
vuserdef5	string	否	否	自定义项5（备注型传这个）
vuserdef6	string	否	否	自定义项6（备注型传这个）
vuserdef7	string	否	否	自定义项7（备注型传这个）
vuserdef8	string	否	否	自定义项8（备注型传这个）
vuserdef9	string	否	否	自定义项9（备注型传这个）
workcenterid	string	否	否	工作中心
parentvo		否	是	出库申请单表头VO
approver	string	否	否	审批人
cbizid	string	否	否	申请人
cdptid	string	否	否	申请部门
dapprovedate	string	否	否	审批日期
dbilldate	string	否	是	申请日期
modifiedtime	string	否	否	最后修改时间
modifier	string	否	否	最后修改人
operator	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（统计型传编码）
pk_org_id	string	否	是	申请库存组织
sapply_hid	string	否	否	表头主键
sapplydbilldate	string	否	否	记录制单日期
taudittime	string	否	否	审批时间
tmaketime	string	否	否	制单时间
totalnum	string	否	否	总数量
vbillcode	string	否	否	申请单号
vnote	string	否	否	备注
vuserdef1	string	否	否	自定义项1（备注型传这个）
vuserdef10	string	否	否	自定义项10（备注型传这个）
vuserdef11	string	否	否	自定义项11（备注型传这个）
vuserdef12	string	否	否	自定义项12（备注型传这个）
vuserdef13	string	否	否	自定义项13（备注型传这个）
vuserdef14	string	否	否	自定义项14（备注型传这个）
vuserdef15	string	否	否	自定义项15（备注型传这个）
vuserdef16	string	否	否	自定义项16（备注型传这个）
vuserdef17	string	否	否	自定义项17（备注型传这个）
vuserdef18	string	否	否	自定义项18（备注型传这个）
vuserdef19	string	否	否	自定义项19（备注型传这个）
vuserdef2	string	否	否	自定义项2（备注型传这个）
vuserdef20	string	否	否	自定义项20（备注型传这个）
vuserdef3	string	否	否	自定义项3（备注型传这个）
vuserdef4	string	否	否	自定义项4（备注型传这个）
vuserdef5	string	否	否	自定义项5（备注型传这个）
vuserdef6	string	否	否	自定义项6（备注型传这个）
vuserdef7	string	否	否	自定义项7（备注型传这个）
vuserdef8	string	否	否	自定义项8（备注型传这个）
vuserdef9	string	否	否	自定义项9（备注型传这个）

返回类型参数:

参数名	类型	是否数组	必填	描述
billvo				出库申请单信息_返回
childrenvo		是	否	出库申请单表体VO_返回
appcastnum	string	否	否	申请辅数量
applynum	string	否	否	申请数量
castunitid	string	否	否	辅单位
castunitid_code	string	否	否	存货编码
castunitid_name	string	否	否	辅单位名称
cbilltypecode	string	否	否	单据类型
ccostobjectid	string	否	否	成本对象
cfirstbillbid	string	否	否	源头单据表体id
cfirstbillhid	string	否	否	源头单据表头id
cfirsttype	string	否	否	源头单据类型
cinvbasid	string	否	否	存货基本id
cinventoryid	string	否	否	存货
cinventoryid_name	string	否	否	存货名称
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
cqualitylevelid	string	否	否	质量等级
crowno	string	否	否	行号
csourcebillbid	string	否	否	来源单据表体ID
csourcebillhid	string	否	否	来源单据表头ID
csourcebodyts	string	否	否	来源表体时间戳
csourceheadts	string	否	否	来源表头时间戳
cunitid	string	否	否	单位
cunitid_code	string	否	否	单位编码
cunitid_name	string	否	否	单位名称
cvendorid	string	否	否	供应
dfirstbilldate	string	否	否	源头单据制单日期
hsl	string	否	否	换算率
isclosed	string	否	否	是否关闭
ncorrespondnum	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
planrecvdate	string	否	否	计划领用日期
recvmaterwhid	string	否	否	领料仓库
sapply_bid	string	否	否	出库申请单表体主键
sapply_hid	string	否	否	出库申请单单头主键
vendor_code	string	否	否	供应编码
vendor_name	string	否	否	供应名称
vfirstbillcode	string	否	否	源头单据号
vfirstrowno	string	否	否	源头单据行号
vfree1	string	否	否	自由项1
vfree2	string	否	否	自由项2
vfree3	string	否	否	自由项3
vfree4	string	否	否	自由项4
vfree5	string	否	否	自由项5
vnote	string	否	否	备注
vproductbatch	string	否	否	生产订单号
vsourcebillcode	string	否	否	来源单据号
vsourcerowno	string	否	否	来源单据行号
vsourcetype	string	否	否	来源单据类型
workcenterid	string	否	否	工作中心
parentvo		是	否	出库申请单表头VO_返回
approver	string	否	否	审批人
approver_code	string	否	否	审批人编码
approver_neme	string	否	否	审批人名称
cbizid	string	否	否	申请人
cbizid_code	string	否	否	申请人编码
cbizid_name	string	否	否	申请人名称
cdptid	string	否	否	申请部门
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
dapprovedate	string	否	否	审批日期
dbilldate	string	否	否	申请日期
dept_code	string	否	否	申请部门编码
dept_name	string	否	否	申请部门名称
fstatusflag	string	否	否	单据状态
modifiedtime	string	否	否	最后修改时间
modifier	string	否	否	最后修改人
modifier_code	string	否	否	最后修改人编码
modifier_neme	string	否	否	最后修改人名称
operator	string	否	否	制单人
operator_code	string	否	否	制单人编码
operator_neme	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
pk_org_id	string	否	否	申请库存组织
pk_org_id_code	string	否	否	申请库存组织编码
pk_org_id_name	string	否	否	申请库存组织名称
sapply_hid	string	否	否	表头主键
sapplydbilldate	string	否	否	记录制单日期
taudittime	string	否	否	审批时间
tmaketime	string	否	否	制单时间
totalnum	string	否	否	总数量
vbillcode	string	否	否	申请单号
vnote	string	否	否	备注

代码示例:

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

请求参数示例:

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

复制代码

{"billvo":[{"parentvo":{"pk_org_id":"9999","dbilldate":"2023-09-12","pk_corp":"2401","operator":"apiwjh"},"childrenvo":[{"applynum":"1","cinventoryid":"0901"}]}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"parentvo\":{\"vbillcode\":\"SA2309120001\",\"dbilldate\":\"2023-09-12\",\"operator\":\"0001A11000000002QQ4J\",\"operator_code\":\"apiwjh\",\"operator_neme\":\"wjh\",\"pk_corp\":\"1005\",\"corp_code\":\"2401\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"tmaketime\":\"2023-09-12 00:00:00\",\"modifier\":\"0001A11000000002QQ4J\",\"modifier_code\":\"apiwjh\",\"modifier_neme\":\"wjh\",\"modifiedtime\":\"2023-09-12 00:00:00\",\"pk_org_id\":\"1005F4100000000011TD\",\"pk_org_id_code\":\"9999\",\"pk_org_id_name\":\"w库存组织\",\"sapplydbilldate\":\"2023-09-12\",\"sapply_hid\":\"1005ZZ10000000003700\"},\"childrenvo\":[{\"cinventoryid\":\"0901\",\"cinventoryid_name\":\"大数量存货\",\"cinvbasid\":\"0001F410000000044TSB\",\"applynum\":\"1\",\"cbilltypecode\":\"4455\",\"pk_corp\":\"1005\",\"corp_code\":\"2401\",\"corp_name\":\"wjh石油天然气集团有限公司\",\"isclosed\":false,\"sapply_bid\":\"1005ZZ10000000003701\",\"sapply_hid\":\"1005ZZ10000000003700\"}]}]","taskNumber":"202309120103"}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "传入数据有的字段为空！第1条数据：表头：[制单人]",
    "taskNumber": "202011070022"
}