API中心

  1. 总账
  2. 凭证
返回

凭证查询

接口所在U8C版本:U8 cloud2.7以及更高版本
详细描述:用于凭证查询
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/gl/voucher/pagequery

参数填写指南

请求方式:POST

请求参数(header):

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

请求参数(body):

参数名类型是否数组必填描述默认值
endTs结束时间戳(v3.5版本支持)
no_from凭证号从
no_to凭证号至
page_now当前页1
page_size每页条数5
pk_casher出纳人编码
pk_checked审核人编码
pk_glorgbook主体账簿档案
pk_manager记账人编码
pk_prepared制单人编码
pk_system制单系统编码
pk_vouchertype凭证类别简称
prepareddate_from制单日期从(传科目编码[subjcode]时此字段必传)
prepareddate_to制单日期至(传科目编码[subjcode]时此字段必传)
startTs开始时间戳(v3.5版本支持)
subjcode科目编码(v5.0sp版本支持)

返回类型参数:

参数名类型是否数组必填描述默认值
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会计年度

请求参数示例:

复制代码

{
  "includediscard":"N",
  "no_from":"2",
  "no_to":"9",
  "page_now":"1",
  "page_size":"5",
  "pk_casher":"14444444005",
  "pk_checked":"14444444004",
  "pk_glorgbook":"1000-0002",
  "pk_manager":"14444444003",
  "pk_prepared":"14444444002",
  "pk_system":"FA",
  "pk_vouchertype":"记账",
  "prepareddate_from":"2017-01-11",
  "prepareddate_to":"2018-01-11",
  "startTs": "2021-08-09 14:32:00",
  "endTs": "2021-08-10 14:32:00"
}

pk_system【凭证来源系统】字段枚举说明:

XX:外部系统交换平台
CM:成本管理
CMP:现金管理
ARAP:应收应付系统
ERM:报销管理
FA:固定资产
GL:总账
IC:库存管理
MM:生产制造
PO:采购管理
IA:存货核算
SO:销售管理
QC:质量管理
CT:合同管理
SC:委外加工
TO:内部交易
AIM:资产信息管理

正确返回示例:

复制代码

{
status: "success",
data: "{"allcount":1,"retcount":1,"datas":[{"pk_glorgbook":"000111100000000002WE","glorgbook_code":"1000-0002","glorgbook_name":"天海总公司2006会计准则账簿","pk_voucher":"10011110000000000AK0","no":"1","year":"2017","period":"01","prepareddate":"2017-01-10","pk_prepared":"0001111000000000011U","prepared_code":"14444444001","prepared_name":"体验1","pk_vouchertype":"0001DEFAULT000000001","vouchertype_code":"记账","vouchertype_name":"记账凭证","explanation":"提现","totaldebit":2000,"totalcredit":2000,"pk_system":"GL","signflag":true,"discardflag":false,"detail":[{"pk_detail":"10011110000000000AK1","pk_voucher":"10011110000000000AK0","detailindex":"1","explanation":"提现","pk_accsubj":"000111100000000007M0","accsubj_code":"1001","accsubj_name":"库存现金","pk_currtype":"00010000000000000001","currtype_code":"CNY","currtype_name":"人民币","price":0E-8,"excrate1":0E-8,"debitquantity":0E-8,"debitamount":2000,"localdebitamount":2000,"creditquantity":0E-8,"creditamount":0,"localcreditamount":0},{"pk_detail":"10011110000000000AK2","pk_voucher":"10011110000000000AK0","detailindex":"2","explanation":"提现","pk_accsubj":"000111100000000007M8","accsubj_code":"1002","accsubj_name":"银行存款","pk_currtype":"00010000000000000001","currtype_code":"CNY","currtype_name":"人民币","price":0E-8,"excrate1":0E-8,"debitquantity":0E-8,"debitamount":0,"localdebitamount":0,"creditquantity":0E-8,"creditamount":2000,"localcreditamount":2000}],"pk_corp":"1001","corp_code":"1000","corp_name":"天海总公司"}]}"
}

错误返回示例:

复制代码

 "status": "falied",
"errorcode": "-32000",
 "errormsg": "U8C返回信息:下列查询条件必须输入:[pk_glorgbook]",
"stacktrace": "nc.vo.pub.BusinessException: 下列查询条件必须输入:[pk_glorgbook]\r\nu8c.bs.action.query.AbstractQueryAction.convertToConditions(AbstractQueryAction.java:342)\r\nu8c.bs.action.query.AbstractQueryAction.queryVOS(AbstractQueryAction.java:155)\r\nu8c.bs.action.query.AbstractQueryAction.doAction(AbstractQueryAction.java:96)\r\nu8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:80)\r\nu8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:29)\r\nsun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)\r\nsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:606)\r\nnc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22)\r\nnc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44)\r\nnc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61)\r\nsun.reflect.GeneratedMethodAccessor52.invoke(Unknown Source)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:606)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34)\r\ncom.sun.proxy.$Proxy11.delegate(Unknown Source)\r\nnc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32)\r\ncom.sun.proxy.$Proxy25.invoke(Unknown Source)\r\nu8c.vo.oip.task.APITask.execute(APITask.java:93)\r\nu8c.impl.oip.task.APITaskServiceImpl.executeTask(APITaskServiceImpl.java:68)\r\nu8c.server.APIController.forWard(APIController.java:138)\r\nu8c.server.APIServletForJSON.doAction(APIServletForJSON.java:23)\r\nnc.bs.framework.server.extsys.ExtSystemInvokerServlet.doAction(ExtSystemInvokerServlet.java:170)\r\nnc.bs.framework.server.extsys.ExtSystemInvokerServlet.doPost(ExtSystemInvokerServlet.java:76)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:641)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:722)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\norg.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\nnc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\norg.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:218)\r\norg.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110)\r\norg.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506)\r\norg.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169)\r\norg.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)\r\norg.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)\r\norg.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:683)\r\norg.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445)\r\norg.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115)\r\norg.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637)\r\norg.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:316)\r\njava.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)\r\njava.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)\r\norg.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)\r\njava.lang.Thread.run(Thread.java:745)\r\n",
"taskNumber": "202006090013"
}