参数填写指南
请求参数(header):
参数填写指南| 参数名 | 必填 | 描述 | 默认值 |
|---|---|---|---|
| Content-Type | 是 | 请求体数据类型 | application/json |
| usercode | 是 | 用户 | |
| password | 是 | 密码 | |
| trantype | 否 | 翻译类型,按编码为code,不需要翻译为pk | code |
| 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_code | string | 否 | 否 | 出纳人编码 | |
| casher_name | string | 否 | 否 | 出纳人名称 | |
| checked_code | string | 否 | 否 | 审核人编码 | |
| checked_name | string | 否 | 否 | 审核人名称 | |
| checkeddate | string | 否 | 否 | 审核日期 | |
| corp_code | string | 否 | 否 | 公司编码 | |
| corp_name | string | 否 | 否 | 公司名称 | |
| detail | string | 否 | 否 | 分录 | |
| details | 是 | 否 | 分录_返回 | ||
| accsubj_code | string | 否 | 否 | 科目编码 | |
| accsubj_name | string | 否 | 否 | 科目名称 | |
| ass | 是 | 否 | 辅助核算内容 | ||
| checktypecode | string | 否 | 否 | 辅助核算类型编码 | |
| checktypename | string | 否 | 否 | 辅助核算类型名称 | |
| checkvaluecode | string | 否 | 否 | 辅助核算值编码 | |
| checkvaluename | string | 否 | 否 | 辅助核算值名称 | |
| pk_checktype | string | 否 | 否 | 辅助核算类型 | |
| pk_checkvalue | string | 否 | 否 | 辅助核算值 | |
| asses | string | 是 | 否 | 辅助核算_返回 | |
| cashflow | string | 否 | 否 | 现金流量 | |
| cashflows | 是 | 否 | 现金流量_返回 | ||
| cashflow_code | string | 否 | 否 | 现金流量表项编码 | |
| cashflow_name | string | 否 | 否 | 现金流量表项名称 | |
| currtype_code | string | 否 | 否 | 现金流量币种编码 | |
| currtype_name | string | 否 | 否 | 现金流量币种名称 | |
| money | string | 否 | 否 | 金额 | |
| pk_cashflow | string | 否 | 否 | 现金流量表项 | |
| pk_cashflowcase | string | 否 | 否 | 主键 | |
| pk_currtype | string | 否 | 否 | 现金流量币种 | |
| creditamount | string | 否 | 否 | 原币贷方发生额 | |
| creditquantity | string | 否 | 否 | 贷方数量 | |
| currtype_code | string | 否 | 否 | 币种编码 | |
| currtype_name | string | 否 | 否 | 币种名称 | |
| debitamount | string | 否 | 否 | 原币借方发生额 | |
| debitquantity | string | 否 | 否 | 借方数量 | |
| detailindex | string | 否 | 否 | 分录号 | |
| excrate1 | string | 否 | 否 | 本币汇率 | |
| explanation | string | 否 | 否 | 摘要 | |
| freevalue1 | string | 否 | 否 | 分录自定义项1(3.5版本开始支持) | |
| freevalue10 | string | 否 | 否 | 分录自定义项10(3.5版本开始支持) | |
| freevalue11 | string | 否 | 否 | 分录自定义项11(3.5版本开始支持) | |
| freevalue12 | string | 否 | 否 | 分录自定义项12(3.5版本开始支持) | |
| freevalue13 | string | 否 | 否 | 分录自定义项13(3.5版本开始支持) | |
| freevalue14 | string | 否 | 否 | 分录自定义项14(3.5版本开始支持) | |
| freevalue15 | string | 否 | 否 | 分录自定义项15(3.5版本开始支持) | |
| freevalue16 | string | 否 | 否 | 分录自定义项16(3.5版本开始支持) | |
| freevalue17 | string | 否 | 否 | 分录自定义项17(3.5版本开始支持) | |
| freevalue18 | string | 否 | 否 | 分录自定义项18(3.5版本开始支持) | |
| freevalue19 | string | 否 | 否 | 分录自定义项19(3.5版本开始支持) | |
| freevalue2 | string | 否 | 否 | 分录自定义项2(3.5版本开始支持) | |
| freevalue20 | string | 否 | 否 | 分录自定义项20(3.5版本开始支持) | |
| freevalue21 | string | 否 | 否 | 分录自定义项21(3.5版本开始支持) | |
| freevalue22 | string | 否 | 否 | 分录自定义项22(3.5版本开始支持) | |
| freevalue23 | string | 否 | 否 | 分录自定义项23(3.5版本开始支持) | |
| freevalue24 | string | 否 | 否 | 分录自定义项24(3.5版本开始支持) | |
| freevalue25 | string | 否 | 否 | 分录自定义项25(3.5版本开始支持) | |
| freevalue26 | string | 否 | 否 | 分录自定义项26(3.5版本开始支持) | |
| freevalue27 | string | 否 | 否 | 分录自定义项27(3.5版本开始支持) | |
| freevalue28 | string | 否 | 否 | 分录自定义项28(3.5版本开始支持) | |
| freevalue29 | string | 否 | 否 | 分录自定义项29(3.5版本开始支持) | |
| freevalue3 | string | 否 | 否 | 分录自定义项3(3.5版本开始支持) | |
| freevalue30 | string | 否 | 否 | 分录自定义项30(3.5版本开始支持) | |
| freevalue4 | string | 否 | 否 | 分录自定义项4(3.5版本开始支持) | |
| freevalue5 | string | 否 | 否 | 分录自定义项5(3.5版本开始支持) | |
| freevalue6 | string | 否 | 否 | 分录自定义项6(3.5版本开始支持) | |
| freevalue7 | string | 否 | 否 | 分录自定义项7(3.5版本开始支持) | |
| freevalue8 | string | 否 | 否 | 分录自定义项8(3.5版本开始支持) | |
| freevalue9 | string | 否 | 否 | 分录自定义项9(3.5版本开始支持) | |
| localcreditamount | string | 否 | 否 | 本币贷方发生额 | |
| pk_accsubj | string | 否 | 否 | 科目 | |
| pk_currtype | string | 否 | 否 | 币种 | |
| pk_detail | string | 否 | 否 | 分录主键 | |
| pk_voucher | string | 否 | 否 | 凭证主键 | |
| price | string | 否 | 否 | 单价 | |
| discardflag | string | 否 | 否 | 是否作废 | |
| explanation | string | 否 | 否 | 摘要 | |
| glorgbook_code | string | 否 | 否 | 主题账簿编码 | |
| glorgbook_name | string | 否 | 否 | 主题账簿名称 | |
| manager_code | string | 否 | 否 | 记账人编码 | |
| manager_name | string | 否 | 否 | 记账人名称 | |
| no | string | 否 | 否 | 凭证号 | |
| period | string | 否 | 否 | 会计期间 | |
| pk_casher | string | 否 | 否 | 出纳人 | |
| pk_checked | string | 否 | 否 | 审核人 | |
| pk_corp | string | 否 | 否 | 公司 | |
| pk_glorgbook | string | 否 | 否 | 主体账簿 | |
| pk_manager | string | 否 | 否 | 记账人 | |
| pk_prepared | string | 否 | 否 | 制单人 | |
| pk_system | string | 否 | 否 | 制单系统 | |
| pk_voucher | string | 否 | 否 | 凭证主键 | |
| pk_vouchertype | string | 否 | 否 | 凭证类别 | |
| prepared_code | string | 否 | 否 | 制单人编码 | |
| prepared_name | string | 否 | 否 | 制单人名称 | |
| prepareddate | string | 否 | 否 | 制单日期 | |
| signdate | string | 否 | 否 | 签字日期 | |
| signflag | string | 否 | 否 | 是否签字 | |
| tallydate | string | 否 | 否 | 记账日期 | |
| totalcredit | string | 否 | 否 | 贷方本币金额合计 | |
| totaldebit | string | 否 | 否 | 借方本币金额合计 | |
| vouchertype_code | string | 否 | 否 | 凭证类别编码 | |
| vouchertype_name | string | 否 | 否 | 凭证类别名称 | |
| year | string | 否 | 否 | 会计年度 |
代码示例:
请求参数示例:
复制代码
{
"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" }