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