财政国库电子支付 电子凭证库接口说明
广州江南科友科技股份有限公司
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