财政国库电子支付电子凭证库接口说明【2014.04.30.00】

财政国库电子支付 电子凭证库接口说明

广州江南科友科技股份有限公司

2013年03月

修订版历史

日期和代码版本 版本 说明 作者 2012-7-30 1.0 初稿 曾明军 EVoucher2012-09-30-00 2012-11-13 1.1 客户端： 雷瑞恒 EVoucher2012-01. （新增）清除U-KEY缓存ClearPinCache 9-30-02 2. （新增）客服端不带位置签名signWithoutPosition 3. （新增）验证不带位置的签名verfiySignWithoutPosition 服务端： 1. （新增）服务器端不带位置签名signWithoutPosition 2. （新增）验证不带位置的签名verfiySignWithoutPosition 3. （新增）查询日志信息接口queryVoucherLogs 4. （新增）批量查询凭证发送状态batchQuerySentVoucherStatus 5. （新增）业务系统与凭证库对账getVoucherStatement 6. （新增）撤销不带位置签名cancelSignWithoutPosition 2012-11-30 服务端： EVoucher2012-01. （新增）发送全版本凭证sendVoucherFullSigns 9-30-03 2. （新增）批量查询发送凭证状态batchQuerySentVoucherStatus 2013-03-19 2.0 客户端： EVoucher2013-01. （新增）选择印章SelectStampId 4-30-00 2. （新增）异常捕获GetLastErr 3. （新增）获取证书接口DlgSelectCertId 服务端： 1. （新增）查询凭证盖章列表queryVoucherSignStampPositions 2. （新增）指定日期读取凭证readVoucherByDate 3. （新增）发起消息对账startMsgStatement 4. （新增）查询消息对账凭证列表 queryMsgStatementVoucherNos 5. （新增）指定凭证号查询消息对账单 queryMsgStatementByVoucherNo 6. （新增）查询错误的消息对账凭证列表 queryErrorMsgStatementVoucherNos 7. （新增）重发消息reSendMessage 其他:调整部分接口与代码参数不匹配，更新服务端异常代码 2013-04-30-00 3.0 服务端： EVoucher2013-01. （新增）业务系统之间数据请求功能requestData 6-15-00 2. （新增）业务系统之间数据发送sendData 3. （新增）获取数据getData 4. （新增）指定机构查询凭证状态 queryVoucherStatusByOrgType 5. （新增）查询凭证库被篡改的电子凭证 queryTamperedVoucherNOs

1

日期和代码版本 版本 说明 作者 2013-06-15 客户端： 林因 EVoucher2013-01、（新增）验证Ukey Pin码接口VerifyPin 6-15-03 2、（新增）获取当前选择证书的CN接口 GetCurCertCN 2013-10-30 4.0 服务端: 雷瑞恒 EVoucher2013-11、（新增）指定日期查询被退回凭证readReturnVoucherByDate 2-30-00 2、（新增）批量查询被退回的凭证号 batchQueryVoucherNosByBackStatus 客户端： 1、（新增）获取操作人证书列表 GetOperatorCertsList 2014-5-20 5.0 服务端: 林因 EVoucher2014-01、（新增）获取签章、签名中的SN、DN getSnInfo 4-30-00

2

目 录

1 电子凭证库接口说明 ..................................................... 1 2 电子凭证库客户端接口 ................................................... 1

2.1 设置电子凭证服务地址 ....................................................... 1

2.1.1 功能说明 ................................................................................................................. 1

2.1.2 函数名..................................................................................................................... 2 2.1.3 输入参数 ................................................................................................................. 2 2.1.4 输出......................................................................................................................... 3 2.1.5 代码示例 ................................................................................................................. 3

2.2 设置电子印章服务地址 ....................................................... 3

2.2.1 功能说明 ................................................................................................................. 3 2.2.2 函数名..................................................................................................................... 4 2.2.3 输入参数 ................................................................................................................. 4 2.2.4 输出......................................................................................................................... 4

2.3 生成签章报文（读取UKEY印章） .............................................. 4

2.3.1 功能说明 ................................................................................................................. 4

2.3.2 函数名..................................................................................................................... 4 2.3.3 输入参数 ................................................................................................................. 5 2.3.4 输出参数 ................................................................................................................. 5

2.4 生成签名报文（带签名位置） ................................................. 5

2.4.1 功能说明 ................................................................................................................. 5 2.4.2 函数名..................................................................................................................... 5 2.4.3 输入参数 ................................................................................................................. 5 2.4.4 输出参数 ................................................................................................................. 6

2.5 生成签名报文（不带签名位置） .............................. 错误！未定义书签。

2.5.1 功能说明 ............................................................................... 错误！未定义书签。 2.5.2 函数名................................................................................... 错误！未定义书签。 2.5.3 输入参数 ............................................................................... 错误！未定义书签。 2.5.4 输出参数 ............................................................................... 错误！未定义书签。

2.6 凭证显示控件（OCX） ........................................................ 6

2.6.1 初始化..................................................................................................................... 6 2.6.2 加载电子凭证 ......................................................................................................... 7 2.6.3 指定凭证号加载电子凭证 ..................................................................................... 8 2.6.4 指定原文加载电子凭证 ......................................................................................... 8 2.6.5 显示指定的凭证（凭证编号） ............................................................................. 9 2.6.6 显示指定的凭证（凭证索引） ........................................................................... 10 2.6.7 打印凭证（凭证号） ........................................................................................... 10 2.6.8 打印凭证（按凭证索引号） ............................................................................... 11

3

2.6.9 打印凭证（按索引范围批量打印） ................................................................... 12 2.6.10 打印当前显示的凭证 ......................................................................................... 13 2.6.11 清空凭证列表 ..................................................................................................... 13 2.6.12 移除指定凭证（凭证编号） ............................................................................. 14 2.6.13 移除指定凭证（凭证索引） ............................................................................. 14 2.6.14 查看凭证的上一联 ............................................................................................. 15 2.6.15 查看凭证下一联 ................................................................................................. 15 2.6.16 获取凭证联数 ..................................................................................................... 16 2.6.17 获取加载的凭证总数 ......................................................................................... 16 2.6.18 显示下一条凭证 ................................................................................................. 17 2.6.19 显示上一条凭证 ................................................................................................. 18 2.6.20 获取当前显示凭证的凭证编号 ......................................................................... 18 2.6.21 获取当前的显示的凭证索引 ............................................................................. 19 2.6.22 获取当前显示的凭证联号 ................................................................................. 19 2.6.23 显示任意联号凭证 ............................................................................................. 20 2.6.24 放大显示凭证 ..................................................................................................... 20 2.6.25 缩小显示凭证 ..................................................................................................... 21 2.6.26 自动适应显示凭证 ............................................................................................. 21 2.6.27 刷新显示凭证 ..................................................................................................... 21 2.6.28 设定显示指定索引凭证 ..................................................................................... 22 2.6.29 设置显示指定凭证号凭证 ................................................................................. 23 2.6.30 设置凭证显示模式 ............................................................................................. 23

2.7 不显示控件打印（后台批量打印） ............................................ 24

2.7.1 功能说明 ............................................................................................................... 24

2.7.2 函数名................................................................................................................... 24 2.7.3 输入参数 ............................................................................................................... 24 2.7.4 输出参数 ............................................................................................................... 24

2.8 打印预览接口 .............................................................. 25

2.8.1 功能说明 ............................................................................................................... 25 2.8.2 函数名................................................................................................................... 25 2.8.3 输入参数 ............................................................................................................... 25 2.8.4 输出参数 ............................................................................................................... 25

2.9 设置当前用户名 ............................................................ 25

2.9.1 功能说明 ............................................................................................................... 25 2.9.2 函数名................................................................................................................... 25 2.9.3 输入参数 ............................................................................................................... 26 2.9.4 输出参数 ............................................................................................................... 26

2.10 清除U-KEY缓存 ........................................................... 26

2.10.1 功能说明 ............................................................................................................. 26 2.10.2 函数名................................................................................................................. 26 2.10.3 输出参数 ............................................................................................................. 26

4

2.11 修改U-KEY PIN码 ......................................................... 26

2.11.1 功能说明 ............................................................................................................. 26

2.11.2 函数名................................................................................................................. 26 2.11.3 输入参数 ............................................................................................................. 27 2.11.4 输出参数 ............................................................................................................. 27

2.12 查看操作日志和签章信息 ................................................... 27

2.12.1 功能说明 ............................................................................................................. 27 2.12.2 函数名................................................................................................................. 27 2.12.3 输入参数 ............................................................................................................. 27 2.12.4 输出参数 ............................................................................................................. 27

2.13 显示操作日志 ............................................................. 28 2.14 获取印章ID接口 .......................................................... 28

2.14.1 功能说明 ............................................................................................................. 28 2.14.2 函数名................................................................................................................. 29 2.14.3 输入参数 ............................................................................................................. 29 2.14.4 输出参数 ............................................................................................................. 29

2.15 获取证书ID接口 .......................................................... 29

2.15.1 功能说明 ............................................................................................................. 29 2.15.2 函数名................................................................................................................. 29 2.15.3 输入参数 ............................................................................................................. 29 2.15.4 输出参数 ............................................................................................................. 29

2.16 获取OCX调用过程异常信息 ................................................. 30

2.16.1 功能说明 ............................................................................................................. 30 2.16.2 函数名................................................................................................................. 30 2.16.3 输入参数 ............................................................................................................. 30 2.16.4 输出参数 ............................................................................................................. 30

2.17 验证UKEY PIN码接口 ....................................................... 30

2.17.1 功能说明 ............................................................................................................. 30 2.17.2 函数名 ................................................................................................................. 30 2.17.3 输入参数 ............................................................................................................. 30 2.17.4 输出参数 ............................................................................................................. 30

2.18 获取当前选择证书的CN接口 ................................................ 31

2.18.1 功能说明 ............................................................................................................. 31 2.18.2 函数名................................................................................................................. 31 2.18.3 输入参数 ............................................................................................................. 31 2.18.4 输出参数 ............................................................................................................. 31

2.19 获取操作人证书列表 ....................................................... 31

2.19.1 功能说明 ............................................................................................................. 31

5

2.19.2 函数名................................................................................................................. 31 2.19.3 输入参数 ............................................................................................................. 31 2.19.4 输出参数 ............................................................................................................. 32 3 电子凭证库服务端接口 .................................................. 32

3.1 电子凭证写入接口 .......................................................... 32

3.1.1 写入客户端签章的凭证 ....................................................................................... 32 3.1.2 写入客户端签名的凭证 ....................................................................................... 33 3.1.3 写入并发送服务器签章的凭证 （不建议使用） ............................................. 39 3.1.4 写入并发送服务器签名的凭证 ........................................................................... 40 3.1.5 写入指定位置服务器签章的凭证 ....................................................................... 34 3.1.6 写入指定位置服务器签名的凭证 ....................................................................... 35 3.1.7 写入并发送指定位置服务器签章的凭证 ........................................................... 36 3.1.8 写入并发送指定位置服务器签名的凭证 ........................................................... 37 3.1.9 写入不带位置服务器签名的凭证 ....................................... 错误！未定义书签。

3.2 电子凭证查询接口 .......................................................... 41

3.2.1 查询未读取的凭证 ............................................................................................... 53

3.2.2 查询未签收的凭证 ............................................................................................... 41 3.2.3 指定凭证号查询凭证 ........................................................................................... 47 3.2.4 指定日期查询凭证 ............................................................... 错误！未定义书签。 3.2.5 查询已发送凭证状态 ........................................................................................... 56 3.2.6 查询凭证打印次数 ............................................................................................... 48 3.2.7 查询凭证类型 ....................................................................................................... 49 3.2.8 指定凭证类型查询盖章位置 ............................................................................... 58 3.2.9 指定凭证类型查询盖章位置及名称 ................................................................... 46 3.2.10 查询凭证盖章列表 ............................................................................................. 50 3.2.11 读取机构印章列表 ............................................................................................. 51 3.2.12 查询日志信息接口 ............................................................................................. 54 3.2.13 批量查询发送凭证状态 ..................................................................................... 57 3.2.14 指定机构查询凭证状态接口 ............................................. 错误！未定义书签。 3.2.15 批量查询凭证状态 ............................................................................................. 42 3.2.16 批量查询被退回的凭证号（接收失败、签收失败、签收退回） ................. 44 3.2.17 验证不带位置的签名 ......................................................... 错误！未定义书签。 3.2.18 查询被篡改的凭证号 ......................................................... 错误！未定义书签。 3.2.19 获取签名、签章证书SN ................................................................................... 52

3.3 电子凭证状态更新接口 ...................................................... 59

3.3.1 确认凭证签收成功 ............................................................................................... 60

3.3.2 确认凭证签收失败 ............................................................................................... 61 3.3.3 退回凭证 ............................................................................................................... 62 3.3.4 作废凭证 ............................................................................................................... 63 3.3.5 发送凭证 ............................................................................................................... 64 3.3.6 发送全版本凭证 ................................................................................................... 65

6

3.3.7 撤销凭证 ............................................................................................................... 67 3.3.8 指定位置撤销凭证 ............................................................................................... 66 3.3.9 撤销凭证不带位置签名 ....................................................... 错误！未定义书签。

3.4 电子凭证库对账接口 ........................................ 错误！未定义书签。

3.4.1 电子凭证库与业务系统对账 .............................................. 错误！未定义书签。

3.4.2 电子凭证库之间对账 ........................................................... 错误！未定义书签。

3.5 电子凭证库回调接口 ........................................................ 68 3.6 电子凭证库绿色通道接口 .................................................... 69

3.6.1 数据请求 ............................................................................................................... 69

3.6.2 数据发送 ............................................................................................................... 70 3.6.3 获取数据 ............................................................................................................... 71 3.6.4 数据请求回调（业务系统提供） ....................................................................... 72 3.6.5 数据发送到达通知（业务系统提供） ............................................................... 73 4 电子凭证业务报文格式 .................................................. 73

4.1 客户端待签名 (章)凭证报文 ................................................. 73 4.2 服务端待签名 (章)凭证报文 ................................................. 74 4.3 电子凭证报文 .............................................................. 74 4.4 凭证签名(章)位置报文 ...................................................... 74 4.5 凭证签名(章)结果报文 ...................................................... 74 4.6 业务系统与凭证库之间对账报文 .............................................. 75 4.7 业务系统与凭证库之间对账返回报文 .......................................... 76 4.8 不带位置凭证服务端签名报文 ................................................ 76 4.9 不带位置凭证服务端签名结果报文 ............................................ 76 4.10 不带位置凭证服务端验签报文 ............................................... 77 4.11 查询日志信息服务端返回报文 ............................................... 77 4.12 消息对账单报文 ........................................................... 78 4.13 操作人证书列表 ........................................................... 78

5 电子凭证库异常 ........................................................ 79

5.1 客户端接口异常 ............................................................ 79 5.2 服务端接口异常 ............................................................ 80

5.2.1 系统级异常 ........................................................................................................... 80

5.2.2 参数异常 ............................................................................................................... 80 5.2.3 报文异常 ............................................................................................................... 80 5.2.4 数据库访问异常 ................................................................................................... 81 5.2.5 业务逻辑异常 ....................................................................................................... 81 5.2.6 签名服务异常 ....................................................................................................... 81

7

5.2.7 印章服务异常 ....................................................................................................... 82 5.2.8 消息中间件异常 ................................................................................................... 82 5.2.9 接收凭证异常 ....................................................................................................... 82 5.2.10 回调异常 ............................................................................................................. 82 6 业务场景举例 .......................................................... 83

6.1 直接支付业务 .............................................................. 83

6.1.1 业务流程图 ........................................................................................................... 83 6.1.2 流程说明 ............................................................................................................... 85

6.2 授权支付业务 .............................................................. 87

6.2.1 业务流程图 ........................................................................................................... 87 6.2.2 流程说明 ............................................................................................................... 89

6.3 拨款业务 .................................................................. 91

6.3.1 业务流程图 ........................................................................................................... 91 6.3.2 流程说明 ............................................................................................................... 93 7 调用示例代码 .......................................................... 95

7.1 客户端接口 ................................................................ 95

7.1.1 JAVA调用 ............................................................................................................... 95 7.1.2 C++调用.................................................................................................................. 96 7.1.3 C#调用.................................................................................................................... 99

7.2 服务端接口 ............................................................... 101

7.2.1 JAVA调用 ............................................................................................................. 101

7.2.2 C/C++调用 ............................................................................................................ 102 7.2.3 C#调用.................................................................................................................. 103

8

1 电子凭证库接口说明

财政国库无纸化支撑系统（简称：无纸化支撑系统）需要支持财政与人行(商业银行)交互电子凭证数据全流程管理，主要包括：

1、对全流程电子凭证进行凭证分类、签名、验签、签章及验章操作，并支持全流程电子数据版本化管理。

2、实现财政与人行和商业银行系统间进行电子凭证数据的安全传输。 为了简化业务系统实现以上需求，无纸化支撑系统将业务系统对电子凭证的管理进行分析整理后，归纳出对电子凭证库的接口需求，分为电子凭证库客户端接口和电子凭证库服务端接口两大类：

1、 电子凭证库客户端接口主要提供凭证盖章、查看及打印可视化的操作。 2、 电子服务端接口主要提供凭证保存及发送等后台操作。

以下分客户端接口和服务端接口分别阐述相关接口，并提供部分调用示例供财政、人行、商业银行业务系统参考开发。

2 电子凭证库客户端接口

本章节描述了电子凭证库客户端的接口，调用方式采用ocx调用。调用接口异常时，需要调用GetLastErr接口获取异常信息并反馈给前端用户。

2.1 设置电子凭证服务地址 2.1.1 功能说明

设置电子凭证服务地址，用于与电子凭证服务器通讯。

电子凭证库客户端为简化业务系统调用的步骤，封装了如获取电子凭证模板、根据凭证号读取凭证等共用的查询操作，而此类操作需要电子凭证库客户端根据业务系统设置的地址访问电子凭证库服务。

业务系统调用电子凭证库客户端时，第一步应设置电子凭证库与电子印章的服务地址。 由于业务系统的客户端所处的网段不同，在设置电子凭证库与电子印章服务地址时需要根据

1

IP地址适配。

若业务系统客户端IP地址为外网网段，应设置电子凭证库与电子印章服务的外网地址；

若业务系统客户端IP地址为内网网段，应设置电子凭证库与电子印章服务的内网地址；

2.1.2 函数名

int SetEvoucherServiceUrl (String url);

2.1.3 输入参数

序号 1 英文名 url 数据类型 String 参数说明 电子凭证服务器url http://地址:端口/realware/services/OCXService?wsdl 2

2.1.4 输出

序号 1 英文名 数据类型 Int 参数说明 0成功、大于0错误编码 2.1.5 代码示例

String evoucherUrl =null;//电子凭证库服务地址 String estampUrl =null;//电子印章服务地址 Int a=0;//返回结果

//读取业务系统客户端IP地址，并根据网段判断IP地址是内外网 boolean isInner=this. decisionNetwork(客户端IP); If(isInner){

//客户端为内网地址,获取电子凭证库与电子印章内网地址

evoucherUrl =this.getInnerEVoucherUrl(); estampUrl =this. getInnerEStampUrl(); }else{

//客户端为外网地址,获取电子凭证库与电子印章外网地址

evoucherUrl =this.getOuterEVoucherUrl(); estampUrl =this. getOuterEStampUrl(); }

//设置电子凭证库服务地址

a=OCX. SetEvoucherServiceUrl(evoucherUrl); if(a!=0)

throw new RuntimeException(“初始化电子凭证库服务地址失败,”+ OCX. GetLastErr()); //设置电子印章服务地址

a= OCX. SetEstampServiceUrl (estampUrl); if(a!=0)

throw new RuntimeException(“初始化电子印章库服务地址失败,”+ OCX. GetLastErr()); // OCX初始化 // OCX其他操作

2.2 设置电子印章服务地址 2.2.1 功能说明

设置电子印章服务器地址，用于与电子印章服务器通讯。

电子凭证库客户端签章与验章操作都需要访问电子印章服务，若通过电子凭

3

证库服务访问电子印章，大大的降低了客户端签章与验章的性能。采用电子凭证库客户端直连电子印章服务的模式使签章、验章更加的高效。

2.2.2 函数名

int SetEstampServiceUrl (String url);

2.2.3 输入参数

序号 1 英文名 url 数据类型 String 参数说明 电子印章服务器url 吉大印章：http://地址:端口 科友印章：http://地址:端口/realware/services/AsspEStampService 2.2.4 输出

序号 1 英文名 数据类型 Int 参数说明 0成功、大于0错误编码 2.3 生成电子签章报文 2.3.1 功能说明

业务系统客户端调用此接口生成电子签章结果报文传至服务端，再由业务系统服务端调用电子凭证服务接口“写入客户端签章的凭证”保存电子凭证，完成客户端电子签章操作。

客户端签章依赖UKEY，电子印章类型分为公章与私章两类。 私章烧制入UKEY,公章需要与UKEY的证书绑定。

2.3.2 函数名

String GetVoucherStamp(String certID, String admDivCode, int stYear, String

4

vtCode, String stamp, String voucherXML)

2.3.3 输入参数

序号 1 2 3 4 5 6 英文名 certID admDivCode stYear vtCode stamp 数据类型 String String int String String String 参数说明 用户证书ID(登录用户证书id) 行政区划，最大长度15位 业务年度，4位数字，2012 凭证类型，4位字符，参见报文规范 位置信息 凭证签名(章)位置报文 voucherXML 客户端待签名 (章)凭证报文 2.3.4 输出参数

序号 1 英文名 数据类型 String 参数说明 凭证签名(章)结果报文 2.4 生成电子签名报文 2.4.1 功能说明

业务系统客户端调用此接口获取电子签名结果报文传至服务端，再由业务系统服务端调用电子凭证服务接口“写入客户端签名的凭证”保存电子凭证，完成客户端电子签名操作。

2.4.2 函数名

String GetVoucherSign(string certID, string admDivCode, int stYear, string vtCode, string certInfo,string voucherXML );

2.4.3 输入参数

序号 1 2 3 4

英文名 certID admDivCode stYear vtCode 数据类型 String String int String 参数说明 用户证书ID(登录用户证书id) 行政区划，最大长度15位 业务年度，4位数字，2012 凭证类型，4位字符，参见报文规范 5

5 6

String String certInfo voucherXML 凭证签名(章)位置报文 客户端待签名 (章)凭证报文 2.4.4 输出参数

序号 1 英文名 数据类型 String 参数说明 凭证签名(章)结果报文（NULL或者长度为0，表示失败）

2.5 凭证显示控件（OCX）

查询打印控件用于实现对电子凭证的可视化显示打印。

包括控件初始化、加载凭证和设置需要显示的凭证3个主要接口； 加载凭证：增加不带报文的接口。 辅助接口包括凭证打印接口。

2.5.1 初始化

2.5.1.1 功能说明

用于初始化显示控件，从电子凭证服务端加载电子凭证的模板。

2.5.1.2 函数名

int Initialize(String certID, String admDivCode, int stYear, String vtCode, String reserver1, int displayMode, int ParamValue, int defaultPage);

2.5.1.3 输入参数：

序号 1 2 3 4

英文名 certID admDivCode stYear vtCode 数据类型 String String int String 参数说明 用户证书ID(登录用户证书id) 行政区划，最大长度15位 业务年度，4位数字 凭证类型，4位字符，参见报文规范 6

2.5.8.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

2.5.9 打印凭证（按索引范围批量打印）

2.5.9.1 功能说明

打印加载到显示控件的凭证。

2.5.9.2 函数名

int PrintVoucherByIndexRange(int beginIndex, int endIndex int pageNo);

2.5.9.3 输入参数

序号 1 2 3 英文名 beginIndex endIndex pageNo 数据类型 int int int 参数说明 起始凭证索引 结束凭证索引 凭证联

2.5.9.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

12

2.5.10 打印当前显示的凭证

2.5.10.1 功能说明

打印当前ocx中显示的凭证

2.5.10.2 函数名

int PrintCurrentVoucher(int bShowPrintSettingDialog)

2.5.10.3 输入参数

序号 1 英文名 bShowPrintSettingDialog 数据类型 Int 参数说明 是否显示打印提示框，1代表是，0代表否 2.5.10.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

2.5.11 清空凭证列表

2.5.11.1 功能说明

清除控件中的数据，保留模板。

2.5.11.2 函数名

void ResetContent();

13

2.5.12 移除指定凭证（凭证编号）

2.5.12.1 功能说明

删除控件中某笔凭证数据。

2.5.12.2 函数名

int removeVoucherByNo(String VoucherNo );

2.5.12.3 输入参数

序号 1 英文名 voucherNo 数据类型 String 参数说明 凭证编号

2.5.12.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败 2.5.13 移除指定凭证（凭证索引）

2.5.13.1 功能说明

删除控件中某笔凭证数据。

2.5.13.2 函数名

int removeVoucherByIndex(int voucherIndex );

14

2.5.13.3 输入参数

序号 1 英文名 voucherIndex 数据类型 int 参数说明 凭证索引

2.5.13.4 输出参数

序号 1 英文名 数据类型 int 参数说明 0成功大于0失败 2.5.14 查看凭证的上一联

2.5.14.1 功能说明

实现查看凭证的上一联。

2.5.14.2 函数名

int PageUp (void);

2.5.14.3 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

2.5.15 查看凭证下一联

2.5.15.1 功能说明

实现查看凭证下一联

15

2.5.15.2 函数名

int PageDown (void);

2.5.15.3 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

2.5.16 获取凭证联数

2.5.16.1 功能说明

获取凭证总联数

2.5.16.2 函数名

int GetPageCount (void);

2.5.16.3 输出参数

序号 1 英文名 数据类型 int 参数说明 联数

2.5.17 获取加载的凭证总数

2.5.17.1 功能说明

获取当前OCX已加载的凭证总数

2.5.17.2 函数名

int GetVoucherCount(void)

16

2.5.17.3 输入参数

无

2.5.17.4 输出参数

序号 1 英文名 数据类型 int 参数说明 凭证总数

2.5.18 显示下一条凭证

2.5.18.1 功能说明

跳转显示OCX缓存中的下一条凭证

2.5.18.2 函数名

int GotoNextVoucher(void)

2.5.18.3 输入参数

无

2.5.18.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

17

2.5.19 显示上一条凭证

2.5.19.1 功能说明

跳转显示OCX缓存中的上一条凭证

2.5.19.2 函数名

int GotoPrevVoucher(void)

2.5.19.3 输入参数

无

2.5.19.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 0成功大于0失败

2.5.20 获取当前显示凭证的凭证编号

2.5.20.1 功能说明

获取当前显示凭证的凭证编号

2.5.20.2 函数名

int GetCurrentVoucherNo(void)

2.5.20.3 输入参数

无

18

2.5.20.4 输出参数

序号 1 英文名 数据类型 String 参数说明 凭证编号

2.5.21 获取当前的显示的凭证索引

2.5.21.1 功能说明

获取当前显示的凭证索引

2.5.21.2 函数名

int GetCurrentVoucherIndex(void)

2.5.21.3 输入参数

无

2.5.21.4 输出参数

序号 1 英文名 数据类型 int 参数说明 当前显示的凭证索引（从0开始）

2.5.22 获取当前显示的凭证联号

2.5.22.1 功能说明

获取当前显示的凭证联号

2.5.22.2 函数名

int GetCurrentPageNo(void)

19

2.5.22.3 输入参数

无

2.5.22.4 输出参数

序号 1 英文名 数据类型 Int 参数说明 凭证联号

2.5.23 显示任意联号凭证

2.5.23.1 功能说明

显示凭证时，可跳转到任意联显示

2.5.23.2 函数名

int GotoPage (int PageNo);

2.5.23.3 输入参数

序号 1 英文名 PageNo 数据类型 int 参数说明 凭证联号 2.5.23.4 输出参数

序号 1 英文名 数据类型 int 参数说明 0成功大于0失败

2.5.24 放大显示凭证

2.5.24.1 功能说明

放大显示当前正在显示的凭证

20

2.5.24.2 函数名

void ZoomIn (void);

2.5.25 缩小显示凭证

2.5.25.1 功能说明

缩小显示当前正在显示的凭证

2.5.25.2 函数名

void ZoomOut(void);

2.5.26 自动适应显示凭证

2.5.26.1 功能说明

缩放页面显示比例到刚好在查看区域中完整显示出来。

2.5.26.2 函数名

void ZoomToFit(void);

2.5.27 刷新显示凭证

2.5.27.1 功能说明

实现动态显示签章效果（即显示凭证时进行签章操作，签章后调用此接口可刷新凭证显示印章）

2.5.27.2 函数名

int Refresh (String voucherNo)

21

本文来源：https://www.bwwdw.com/article/tot3.html