API中心

  1. 总账
  2. 凭证
返回

凭证新增

接口所在U8C版本:U8 cloud2.7以及更高版本
详细描述:（不同账簿不同公司凭证不能一起传）
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/gl/voucher/insert

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

全量参数制单最简带辅助核算带现金流量不允许修改示例
参数名类型是否数组必填描述默认值示例值
voucher是是凭证实体（不同账簿不同公司凭证不能一起传）
attachmentint否否附单据数
details是否分录
ass是否辅助核算
checktypecodestring否是辅助核算类型编码
checkvaluecodestring否是辅助核算的值编码
cashflow是否现金流量
memostring否否备注（v5.1开始支持）
moneystring否是原币金额
moneyassstring否否辅币（v5.1开始支持）
moneymainstring否是主币（v5.1开始支持）
pk_cashflowstring否是现金流量表项编码
pk_currtypestring否否现金流量币种编码
creditamountstring否是原币贷方金额（必填，没有就传0就行了）如果是两位小数建议带上英文双引号，即当作字符串类型传
creditquantitystring否否贷方数量
debitamountstring否是原币借方金额（必填，没有就传0就行了）如果是两位小数建议带上英文双引号，即当作字符串类型传
debitquantitydouble否否借方数量
detailindexint否否分录号
excrate2double否否汇率（2.7版本及以前版本不支持外面传进来，需要在外币汇率节点设置）
explanationstring否是摘要
free1string否否核销号
free2string否否核销日期
freevalue10string否否分录自定义项10
freevalue11string否否分录自定义项11
freevalue12string否否分录自定义项12
freevalue13string否否分录自定义项13
freevalue14string否否分录自定义项14
freevalue15string否否分录自定义项15
freevalue2string否否分录自定义项2
freevalue3string否否分录自定义项3
freevalue4string否否分录自定义项4
freevalue5string否否分录自定义项5
freevalue6string否否分录自定义项6
freevalue7string否否分录自定义项7
freevalue8string否否分录自定义项8
freevalue9string否否分录自定义项9
localcreditamountstring否是本币贷方金额（必填，没有就传0就行了）如果是两位小数建议带上英文双引号，即当作字符串类型传
localdebitamountstring否是本币借方金额（必填，没有就传0就行了）如果是两位小数建议带上英文双引号，即当作字符串类型传
modifyflagstring否否修改标志（不允许修改时传是16个N）
pk_accsubjstring否是科目
pk_currtypestring否是币种编码
pricedouble否否单价
explanationstring否否凭证摘要
hasCashflowModifiedstring否否凭证是否手动修改了现金流量分析（如果传现金流量此属性传Y，如果没有现金流量分析，此属性不传或传N）
isdifflagboolean否否是否差异凭证
modifyflagstring否否修改标志（当不想让界面修改时传三个N）
noint否否凭证号
pk_corpstring否是公司
pk_glorgbookstring否是账簿
pk_preparedstring否是制单人编码
pk_vouchertypestring否是凭证类别简称
prepareddatestring否否制单日期（格式示例：2021-04-27））
voucherkindint否否凭证类型0

返回类型参数:

参数名类型是否数组必填描述默认值
vouchervo凭证_返回
casher_codestring否否出纳人编码
casher_namestring否否出纳人名称
checked_codestring否否审核人编码
checked_namestring否否审核人名称
checkeddatestring否否审核日期
corp_codestring否否公司编码
corp_namestring否否公司名称
detailstring否否分录
details是否分录_返回
accsubj_codestring否否科目编码
accsubj_namestring否否科目名称
ass是否辅助核算内容
checktypecodestring否否辅助核算类型编码
checktypenamestring否否辅助核算类型名称
checkvaluecodestring否否辅助核算值编码
checkvaluenamestring否否辅助核算值名称
pk_checktypestring否否辅助核算类型
pk_checkvaluestring否否辅助核算值
assesstring是否辅助核算_返回
cashflowstring否否现金流量
cashflows是否现金流量_返回
cashflow_codestring否否现金流量表项编码
cashflow_namestring否否现金流量表项名称
currtype_codestring否否现金流量币种编码
currtype_namestring否否现金流量币种名称
moneystring否否金额
pk_cashflowstring否否现金流量表项
pk_cashflowcasestring否否主键
pk_currtypestring否否现金流量币种
creditamountstring否否原币贷方发生额
creditquantitystring否否贷方数量
currtype_codestring否否币种编码
currtype_namestring否否币种名称
debitamountstring否否原币借方发生额
debitquantitystring否否借方数量
detailindexstring否否分录号
excrate1string否否本币汇率
explanationstring否否摘要
freevalue1string否否分录自定义项1（3.5版本开始支持）
freevalue10string否否分录自定义项10（3.5版本开始支持）
freevalue11string否否分录自定义项11（3.5版本开始支持）
freevalue12string否否分录自定义项12（3.5版本开始支持）
freevalue13string否否分录自定义项13（3.5版本开始支持）
freevalue14string否否分录自定义项14（3.5版本开始支持）
freevalue15string否否分录自定义项15（3.5版本开始支持）
freevalue16string否否分录自定义项16（3.5版本开始支持）
freevalue17string否否分录自定义项17（3.5版本开始支持）
freevalue18string否否分录自定义项18（3.5版本开始支持）
freevalue19string否否分录自定义项19（3.5版本开始支持）
freevalue2string否否分录自定义项2（3.5版本开始支持）
freevalue20string否否分录自定义项20（3.5版本开始支持）
freevalue21string否否分录自定义项21（3.5版本开始支持）
freevalue22string否否分录自定义项22（3.5版本开始支持）
freevalue23string否否分录自定义项23（3.5版本开始支持）
freevalue24string否否分录自定义项24（3.5版本开始支持）
freevalue25string否否分录自定义项25（3.5版本开始支持）
freevalue26string否否分录自定义项26（3.5版本开始支持）
freevalue27string否否分录自定义项27（3.5版本开始支持）
freevalue28string否否分录自定义项28（3.5版本开始支持）
freevalue29string否否分录自定义项29（3.5版本开始支持）
freevalue3string否否分录自定义项3（3.5版本开始支持）
freevalue30string否否分录自定义项30（3.5版本开始支持）
freevalue4string否否分录自定义项4（3.5版本开始支持）
freevalue5string否否分录自定义项5（3.5版本开始支持）
freevalue6string否否分录自定义项6（3.5版本开始支持）
freevalue7string否否分录自定义项7（3.5版本开始支持）
freevalue8string否否分录自定义项8（3.5版本开始支持）
freevalue9string否否分录自定义项9（3.5版本开始支持）
localcreditamountstring否否本币贷方发生额
pk_accsubjstring否否科目
pk_currtypestring否否币种
pk_detailstring否否分录主键
pk_voucherstring否否凭证主键
pricestring否否单价
discardflagstring否否是否作废
explanationstring否否摘要
glorgbook_codestring否否主题账簿编码
glorgbook_namestring否否主题账簿名称
manager_codestring否否记账人编码
manager_namestring否否记账人名称
nostring否否凭证号
periodstring否否会计期间
pk_casherstring否否出纳人
pk_checkedstring否否审核人
pk_corpstring否否公司
pk_glorgbookstring否否主体账簿
pk_managerstring否否记账人
pk_preparedstring否否制单人
pk_systemstring否否制单系统
pk_voucherstring否否凭证主键
pk_vouchertypestring否否凭证类别
prepared_codestring否否制单人编码
prepared_namestring否否制单人名称
prepareddatestring否否制单日期
signdatestring否否签字日期
signflagstring否否是否签字
tallydatestring否否记账日期
totalcreditstring否否贷方本币金额合计
totaldebitstring否否借方本币金额合计
vouchertype_codestring否否凭证类别编码
vouchertype_namestring否否凭证类别名称
yearstring否否会计年度

代码示例:

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

请求参数示例:

制单最简带辅助核算带现金流量不允许修改示例

复制代码

{"voucher":[{"details":[{"explanation":"测试1","pk_accsubj":"1001","pk_currtype":"CNY","debitamount":10},{"explanation":"测试1","pk_accsubj":"6001","pk_currtype":"CNY","creditamount":10}],"pk_corp":"876","pk_glorgbook":"1202-2018E","pk_prepared":"demo1","pk_vouchertype":"234"}]}

正确返回示例:

复制代码

{"status":"success","data":"[{\"pk_glorgbook\":\"00011110000000001G58\",\"glorgbook_code\":\"1000-0003\",\"glorgbook_name\":\"天海总公司报告账簿\",\"pk_voucher\":\"000114100000000027OT\",\"no\":\"2\",\"year\":\"2018\",\"period\":\"06\",\"prepareddate\":\"2018-06-26\",\"pk_prepared\":\"000111100000000000VI\",\"prepared_code\":\"14444444002\",\"prepared_name\":\"李鑫\",\"pk_vouchertype\":\"0001DEFAULT000000001\",\"vouchertype_code\":\"记账\",\"vouchertype_name\":\"记账凭证\",\"explanation\":\"SDK测试ZZ\",\"totaldebit\":100,\"totalcredit\":100,\"pk_system\":\"XX\",\"signflag\":false,\"discardflag\":false,\"detail\":[{\"pk_detail\":\"10011410000000000DY9\",\"pk_voucher\":\"000114100000000027OT\",\"detailindex\":\"1\",\"explanation\":\"SDK测试ZZ\",\"pk_accsubj\":\"00011110000000001G62\",\"accsubj_code\":\"1221\",\"accsubj_name\":\"其他应收款\",\"pk_currtype\":\"00010000000000000001\",\"currtype_code\":\"CNY\",\"currtype_name\":\"人民币\",\"price\":0,\"excrate1\":0,\"debitquantity\":0,\"debitamount\":100,\"localdebitamount\":100,\"creditquantity\":0,\"creditamount\":0,\"localcreditamount\":0,\"ass\":[{\"pk_checktype\":\"00010000000000000001\"}]},{\"pk_detail\":\"10011410000000000DYA\",\"pk_voucher\":\"000114100000000027OT\",\"detailindex\":\"2\",\"explanation\":\"SDK测试ZZ\",\"pk_accsubj\":\"00011110000000001G62\",\"accsubj_code\":\"1221\",\"accsubj_name\":\"其他应收款\",\"pk_currtype\":\"00010000000000000001\",\"currtype_code\":\"CNY\",\"currtype_name\":\"人民币\",\"price\":0,\"excrate1\":0,\"debitquantity\":0,\"debitamount\":0,\"localdebitamount\":0,\"creditquantity\":0,\"creditamount\":100,\"localcreditamount\":100,\"ass\":[{\"pk_checktype\":\"00010000000000000001\"}]}],\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\"}]"}

错误返回示例:

复制代码

{"status":"falied","errorcode":"-32000","errormsg":"下面的档案无法翻译：档案类型：凭证类别,档案编码：记账1,可能的原因是当前单据使用的公司没有启用单据所在的模块或者档案没有分配到当前使用的公司！"}