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

财政国库电子支付电子凭证库接口说明第修订版历史日期和代码版本版本说明作者2012-7-30EVoucher2012-09-30-001.0初稿曾明军2012-11-13EVoucher2012-09-30-021.1客户端：（新增）清除U-KEY缓存ClearPinCache（新增）客服端不带位置签名signWithoutPosition（新增）验证不带位置的签名verfiySignWithoutPosition服务端：（新增）服务器端不带位置签名signWithoutPosition（新增）验证不带位置的签名verfiySignWithoutPosition（新增）查询日志信息接口queryVoucherLogs（新增）批量查询凭证发送状态batchQuerySentVoucherStatus（新增）业务系统与凭证库对账getVoucherStatement（新增）撤销不带位置签名cancelSignWithoutPosition雷瑞恒2012-11-30EVoucher2012-09-30-03服务端：（新增）发送全版本凭证sendVoucherFullSigns（新增）批量查询发送凭证状态batchQuerySentVoucherStatus2013-03-19EVoucher2013-04-30-002.0客户端：（新增）选择印章HYPERLINKSelectStampId（新增）异常捕获HYPERLINKGetLastErr（新增）获取证书接口DlgSelectCertId服务端：（新增）查询凭证盖章列表queryVoucherSignStampPositions（新增）指定日期读取凭证readVoucherByDate（新增）发起消息对账startMsgStatement（新增）查询消息对账凭证列表queryMsgStatementVoucherNos（新增）指定凭证号查询消息对账单queryMsgStatementByVoucherNo（新增）查询错误的消息对账凭证列表queryErrorMsgStatementVoucherNos（新增）重发消息reSendMessage其他:调整部分接口与代码参数不匹配，更新服务端异常代码2013-04-30-00EVoucher2013-06-15-003.0服务端：（新增）业务系统之间数据请求功能requestData（新增）业务系统之间数据发送sendData（新增）获取数据getData（新增）指定机构查询凭证状态queryVoucherStatusByOrgType（新增）查询凭证库被篡改的电子凭证queryTamperedVoucherNOs2013-06-15EVoucher2013-06-15-03客户端：1、（新增）验证UkeyPin码接口VerifyPin2、（新增）获取当前选择证书的CN接口GetCurCertCN林因2013-10-30EVoucher2013-12-30-004.0服务端:1、（新增）指定日期查询被退回凭证readReturnVoucherByDate2、（新增）批量查询被退回的凭证号batchQueryVoucherNosByBackStatus客户端：1、（新增）获取操作人证书列表GetOperatorCertsList雷瑞恒2014-5-20EVoucher2014-04-30-005.0服务端:1、（新增）获取签章、签名中的SN、DNgetSnInfo林因

目录1电子凭证库接口说明 12电子凭证库客户端接口 12.1设置电子凭证服务地址 12.1.1功能说明 12.1.2函数名 22.1.3输入参数 22.1.4输出 32.1.5代码示例 32.2设置电子印章服务地址 32.2.1功能说明 32.2.2函数名 42.2.3输入参数 42.2.4输出 42.3生成签章报文（读取UKEY印章） 42.3.1功能说明 42.3.2函数名 42.3.3输入参数 52.3.4输出参数 52.4生成签名报文（带签名位置） 52.4.1功能说明 52.4.2函数名 52.4.3输入参数 52.4.4输出参数 62.5生成签名报文（不带签名位置） 62.5.1功能说明 62.5.2函数名 62.5.3输入参数 62.5.4输出参数 62.6凭证显示控件（OCX） 62.6.1初始化 72.6.2加载电子凭证 72.6.3指定凭证号加载电子凭证 82.6.4指定原文加载电子凭证 92.6.5显示指定的凭证（凭证编号） 102.6.6显示指定的凭证（凭证索引） 102.6.7打印凭证（凭证号） 112.6.8打印凭证（按凭证索引号） 122.6.9打印凭证（按索引范围批量打印） 122.6.10打印当前显示的凭证 132.6.11清空凭证列表 142.6.12移除指定凭证（凭证编号） 142.6.13移除指定凭证（凭证索引） 152.6.14查看凭证的上一联 152.6.15查看凭证下一联 162.6.16获取凭证联数 162.6.17获取加载的凭证总数 172.6.18显示下一条凭证 172.6.19显示上一条凭证 182.6.20获取当前显示凭证的凭证编号 192.6.21获取当前的显示的凭证索引 192.6.22获取当前显示的凭证联号 202.6.23显示任意联号凭证 202.6.24放大显示凭证 212.6.25缩小显示凭证 212.6.26自动适应显示凭证 212.6.27刷新显示凭证 222.6.28设定显示指定索引凭证 222.6.29设置显示指定凭证号凭证 232.6.30设置凭证显示模式 242.7不显示控件打印（后台批量打印） 242.7.1功能说明 242.7.2函数名 242.7.3输入参数 252.7.4输出参数 252.8打印预览接口 252.8.1功能说明 252.8.2函数名 252.8.3输入参数 252.8.4输出参数 262.9设置当前用户名 262.9.1功能说明 262.9.2函数名 262.9.3输入参数 262.9.4输出参数 262.10清除U-key缓存 262.10.1功能说明 262.10.2函数名 262.10.3输出参数 272.11修改U-keyPIN码 272.11.1功能说明 272.11.2函数名 272.11.3输入参数 272.11.4输出参数 272.12查看操作日志和签章信息 272.12.1功能说明 272.12.2函数名 282.12.3输入参数 282.12.4输出参数 282.13显示操作日志 282.14获取印章id接口 292.14.1功能说明 292.14.2函数名 292.14.3输入参数 292.14.4输出参数 292.15获取证书id接口 292.15.1功能说明 292.15.2函数名 302.15.3输入参数 302.15.4输出参数 302.16获取ocx调用过程异常信息 302.16.1功能说明 302.16.2函数名 302.16.3输入参数 302.16.4输出参数 302.17验证UkeyPin码接口 312.17.1功能说明 312.17.2函数名 312.17.3输入参数 312.17.4输出参数 312.18获取当前选择证书的CN接口 312.18.1功能说明 312.18.2函数名 312.18.3输入参数 312.18.4输出参数 322.19获取操作人证书列表 322.19.1功能说明 322.19.2函数名 322.19.3输入参数 322.19.4输出参数 323电子凭证库服务端接口 323.1电子凭证写入接口 323.1.1写入客户端签章的凭证 333.1.2写入客户端签名的凭证 343.1.3写入并发送服务器签章的凭证（不建议使用） 353.1.4写入并发送服务器签名的凭证 363.1.5写入指定位置服务器签章的凭证 373.1.6写入指定位置服务器签名的凭证 383.1.7写入并发送指定位置服务器签章的凭证 393.1.8写入并发送指定位置服务器签名的凭证 413.1.9写入不带位置服务器签名的凭证 423.2电子凭证查询接口 433.2.1查询未读取的凭证 433.2.2查询未签收的凭证 443.2.3指定凭证号查询凭证 453.2.4指定日期查询凭证 463.2.5查询已发送凭证状态 473.2.6查询凭证打印次数 483.2.7查询凭证类型 493.2.8指定凭证类型查询盖章位置 503.2.9指定凭证类型查询盖章位置及名称 513.2.10查询凭证盖章列表 523.2.11读取机构印章列表 533.2.12查询日志信息接口 543.2.13批量查询发送凭证状态 553.2.14指定机构查询凭证状态接口 563.2.15批量查询凭证状态 573.2.16批量查询被退回的凭证号（接收失败、签收失败、签收退回） 583.2.17验证不带位置的签名 603.2.18查询被篡改的凭证号 613.2.19获取签名、签章证书SN 623.3电子凭证状态更新接口 633.3.1确认凭证签收成功 633.3.2确认凭证签收失败 643.3.3退回凭证 653.3.4作废凭证 663.3.5发送凭证 673.3.6发送全版本凭证 683.3.7撤销凭证 693.3.8指定位置撤销凭证 703.3.9撤销凭证不带位置签名 713.4电子凭证库对账接口 723.4.1电子凭证库与业务系统对账 723.4.2电子凭证库之间对账 733.5电子凭证库回调接口 783.6电子凭证库绿色通道接口 793.6.1数据请求 793.6.2数据发送 803.6.3获取数据 813.6.4数据请求回调（业务系统提供） 823.6.5数据发送到达通知（业务系统提供） 824电子凭证业务报文格式 834.1客户端待签名(章)凭证报文 834.2服务端待签名(章)凭证报文 834.3电子凭证报文 844.4凭证签名(章)位置报文 844.5凭证签名(章)结果报文 844.6业务系统与凭证库之间对账报文 854.7业务系统与凭证库之间对账返回报文 864.8不带位置凭证服务端签名报文 864.9不带位置凭证服务端签名结果报文 864.10不带位置凭证服务端验签报文 864.11查询日志信息服务端返回报文 874.12消息对账单报文 874.13操作人证书列表 885电子凭证库异常 885.1客户端接口异常 885.2服务端接口异常 895.2.1系统级异常 895.2.2参数异常 905.2.3报文异常 905.2.4数据库访问异常 905.2.5业务逻辑异常 915.2.6签名服务异常 915.2.7印章服务异常 915.2.8消息中间件异常 925.2.9接收凭证异常 925.2.10回调异常 926业务场景举例 936.1直接支付业务 936.1.1业务流程图 936.1.2流程说明 946.2授权支付业务 966.2.1业务流程图 966.2.2流程说明 976.3拨款业务 996.3.1业务流程图 996.3.2流程说明 1007调用示例代码 1027.1客户端接口 1027.1.1JAVA调用 1027.1.2C++调用 1037.1.3C#调用 1067.2服务端接口 1087.2.1JAVA调用 1087.2.2C/C++调用 1097.2.3C#调用 110电子凭证库接口说明财政国库无纸化支撑系统（简称：无纸化支撑系统）需要支持财政与人行(商业银行)交互电子凭证数据全流程管理，主要包括：1、对全流程电子凭证进行凭证分类、签名、验签、签章及验章操作，并支持全流程电子数据版本化管理。2、实现财政与人行和商业银行系统间进行电子凭证数据的安全传输。为了简化业务系统实现以上需求，无纸化支撑系统将业务系统对电子凭证的管理进行分析整理后，归纳出对电子凭证库的接口需求，分为电子凭证库客户端接口和电子凭证库服务端接口两大类：电子凭证库客户端接口主要提供凭证盖章、查看及打印可视化的操作。电子服务端接口主要提供凭证保存及发送等后台操作。以下分客户端接口和服务端接口分别阐述相关接口，并提供部分调用示例供财政、人行、商业银行业务系统参考开发。电子凭证库客户端接口本章节描述了电子凭证库客户端的接口，调用方式采用ocx调用。调用接口异常时，需要调用GetLastErr接口获取异常信息并反馈给前端用户。设置电子凭证服务地址功能说明设置电子凭证服务地址，用于与电子凭证服务器通讯。电子凭证库客户端为简化业务系统调用的步骤，封装了如获取电子凭证模板、根据凭证号读取凭证等共用的查询操作，而此类操作需要电子凭证库客户端根据业务系统设置的地址访问电子凭证库服务。业务系统调用电子凭证库客户端时，第一步应设置电子凭证库与电子印章的服务地址。由于业务系统的客户端所处的网段不同，在设置电子凭证库与电子印章服务地址时需要根据IP地址适配。若业务系统客户端IP地址为外网网段，应设置电子凭证库与电子印章服务的外网地址；若业务系统客户端IP地址为内网网段，应设置电子凭证库与电子印章服务的内网地址；函数名intSetEvoucherServiceUrl(Stringurl);输入参数序号英文名数据类型参数说明1urlString电子凭证服务器urlhttp://地址:端口/realware/services/OCXService?wsdl输出序号英文名数据类型参数说明1Int0成功、大于0错误编码代码示例StringevoucherUrl=null;//电子凭证库服务地址StringestampUrl=null;//电子印章服务地址Inta=0;//返回结果//读取业务系统客户端IP地址，并根据网段判断IP地址是内外网booleanisInner=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)thrownewRuntimeException(“初始化电子凭证库服务地址失败,”+OCX.GetLastErr());//设置电子印章服务地址a=OCX.SetEstampServiceUrl(estampUrl);if(a!=0)thrownewRuntimeException(“初始化电子印章库服务地址失败,”+OCX.GetLastErr());//OCX初始化//OCX其他操作设置电子印章服务地址功能说明设置电子印章服务器地址，用于与电子印章服务器通讯。电子凭证库客户端签章与验章操作都需要访问电子印章服务，若通过电子凭证库服务访问电子印章，大大的降低了客户端签章与验章的性能。采用电子凭证库客户端直连电子印章服务的模式使签章、验章更加的高效。函数名intSetEstampServiceUrl(Stringurl);输入参数序号英文名数据类型参数说明1urlString电子印章服务器url吉大印章：http://地址:端口科友印章：http://地址:端口/realware/services/AsspEStampService输出序号英文名数据类型参数说明1Int0成功、大于0错误编码生成电子签章报文功能说明业务系统客户端调用此接口生成电子签章结果报文传至服务端，再由业务系统服务端调用电子凭证服务接口“HYPERLINK写入客户端签章的凭证”保存电子凭证，完成客户端电子签章操作。客户端签章依赖UKEY，电子印章类型分为公章与私章两类。私章烧制入UKEY,公章需要与UKEY的证书绑定。函数名StringGetVoucherStamp(StringcertID,StringadmDivCode,intstYear,StringvtCode,Stringstamp,StringvoucherXML)输入参数序号英文名数据类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字，20124vtCodeString凭证类型，4位字符，参见报文规范5stampString位置信息HYPERLINK凭证签名(章)位置报文6voucherXMLStringHYPERLINK客户端待签名(章)凭证报文输出参数序号英文名数据类型参数说明1StringHYPERLINK凭证签名(章)结果报文生成电子签名报文功能说明业务系统客户端调用此接口获取电子签名结果报文传至服务端，再由业务系统服务端调用电子凭证服务接口“HYPERLINK凭证签名(章)位置报文6voucherXMLStringHYPERLINK客户端待签名(章)凭证报文输出参数序号英文名数据类型参数说明1StringHYPERLINK凭证签名(章)结果报文（NULL或者长度为0，表示失败）凭证显示控件（OCX）查询打印控件用于实现对电子凭证的可视化显示打印。包括控件初始化、加载凭证和设置需要显示的凭证3个主要接口；加载凭证：增加不带报文的接口。辅助接口包括凭证打印接口。初始化功能说明用于初始化显示控件，从电子凭证服务端加载电子凭证的模板。函数名intInitialize(StringcertID,StringadmDivCode,intstYear,StringvtCode,Stringreserver1,intdisplayMode,intParamValue,intdefaultPage);输入参数：序号英文名数据类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字4vtCodeString凭证类型，4位字符，参见报文规范5reserver1String保留参数，传入”0”6displayModeint显示模式：1.列表模式2.单页模式7ParamValueint列表模式下的显示行列数：（输入2即为2行2列显示）8defaultPageint默认显示页（联）（最好默认为0）输出参数：序号英文名数据类型参数说明1Int0成功、大于0错误编码加载电子凭证功能说明添加要显示凭证信息用于客户端程序，调用此方法添加需要显示的签章凭证信息，逐笔添加。函数名intAddVoucher(StringvoucherNo,StringxmlBody);输入参数序号英文名数据类型参数说明1voucherNoString凭证编号2xmlBodyString需要显示的凭证信息，具体格式参考：《电子支付安全支撑控件电子凭证报文规范》输出参数序号英文名数据类型参数说明1int0成功、大于0错误编码指定凭证号加载电子凭证功能说明不带报文的接口，接口自动从服务器加载凭证对于回单不做全版本验证（只验证最新数据的完整性），显示时加载回单的原文进行展现。函数名intAddVoucherfromServer(StringvoucherNo);输入参数序号英文名数据类型参数说明1voucherNoString凭证单号输出参数序号英文名数据类型参数说明1int0成功、大于0错误编码指定原文加载电子凭证功能说明可将从后台下载的凭证（调用后台readVoucherAgain得到的报文）直接加载到OCX中。函数名int AddVoucherXmls(StringXmlVouchers,intbUpdatefromVoucher);输入参数序号英文名数据类型参数说明1XmlVouchersString凭证原文,具体格式参考：《电子支付安全支撑控件电子凭证报文规范》2bUpdatefromVoucherint是否从凭证库重新加载凭证，1代表是，0代表否输出参数序号英文名数据类型参数说明1int0成功、大于0错误编码显示指定的凭证（凭证编号） 功能说明定位到显示的凭证，OCX自动验签（章），取章显示。函数名intSetCurrentVoucher(StringvoucherNo);输入参数序号英文名数据类型参数说明1voucherNOString凭证号输出参数序号英文名数据类型参数说明1Int0成功、大于0错误编码显示指定的凭证（凭证索引）功能说明：本接口已不推荐使用。定位到显示的凭证，OCX自动验签（章），取章显示。函数名intdisplayVoucherByIndex(intvoucherIndex);输入参数序号英文名数据类型参数说明1voucherIndexint凭证索引（索引号从0开始）输出参数序号英文名数据类型参数说明1Int0成功大于0失败打印凭证（凭证号）功能说明打印加载到显示控件的凭证。函数名intPrintVoucherByNo(StringvoucherNo,intpageNo);输入参数序号英文名数据类型参数说明1voucherNoString凭证编号2pageNoint凭证联输出参数序号英文名数据类型参数说明1Int0成功大于0失败打印凭证（按凭证索引号）功能说明打印加载到显示控件的凭证。函数名IntPrintVoucherByIndex(intvoucherIndex,intpageNo);输入参数序号英文名数据类型参数说明1voucherIndexint凭证索引2pageNoint凭证联输出参数序号英文名数据类型参数说明1Int0成功大于0失败打印凭证（按索引范围批量打印）功能说明打印加载到显示控件的凭证。函数名intPrintVoucherByIndexRange(intbeginIndex,intendIndexintpageNo);输入参数序号英文名数据类型参数说明1beginIndexint起始凭证索引2endIndexint结束凭证索引3pageNoint凭证联输出参数序号英文名数据类型参数说明1Int0成功大于0失败打印当前显示的凭证功能说明打印当前ocx中显示的凭证函数名intPrintCurrentVoucher(intbShowPrintSettingDialog)输入参数序号英文名数据类型参数说明1bShowPrintSettingDialogInt是否显示打印提示框，1代表是，0代表否输出参数序号英文名数据类型参数说明1Int0成功大于0失败清空凭证列表功能说明清除控件中的数据，保留模板。函数名voidResetContent();移除指定凭证（凭证编号）功能说明删除控件中某笔凭证数据。函数名intremoveVoucherByNo(StringVoucherNo);输入参数序号英文名数据类型参数说明1voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败移除指定凭证（凭证索引）功能说明删除控件中某笔凭证数据。函数名intremoveVoucherByIndex(intvoucherIndex);输入参数序号英文名数据类型参数说明1voucherIndexint凭证索引输出参数序号英文名数据类型参数说明1int0成功大于0失败查看凭证的上一联功能说明实现查看凭证的上一联。函数名 intPageUp(void);输出参数序号英文名数据类型参数说明1Int0成功大于0失败查看凭证下一联功能说明 实现查看凭证下一联函数名 intPageDown(void);输出参数序号英文名数据类型参数说明1Int0成功大于0失败获取凭证联数功能说明获取凭证总联数函数名intGetPageCount(void);输出参数序号英文名数据类型参数说明1int联数获取加载的凭证总数功能说明获取当前OCX已加载的凭证总数函数名intGetVoucherCount(void)输入参数无输出参数 序号英文名数据类型参数说明1int凭证总数显示下一条凭证功能说明跳转显示OCX缓存中的下一条凭证函数名intGotoNextVoucher(void)输入参数无输出参数序号英文名数据类型参数说明1Int0成功大于0失败显示上一条凭证功能说明跳转显示OCX缓存中的上一条凭证函数名intGotoPrevVoucher(void)输入参数无输出参数序号英文名数据类型参数说明1Int0成功大于0失败获取当前显示凭证的凭证编号功能说明获取当前显示凭证的凭证编号函数名intGetCurrentVoucherNo(void)输入参数无输出参数序号英文名数据类型参数说明1String凭证编号获取当前的显示的凭证索引功能说明获取当前显示的凭证索引函数名intGetCurrentVoucherIndex(void)输入参数无输出参数序号英文名数据类型参数说明1int当前显示的凭证索引（从0开始）获取当前显示的凭证联号功能说明获取当前显示的凭证联号函数名intGetCurrentPageNo(void)输入参数无输出参数序号英文名数据类型参数说明1Int凭证联号显示任意联号凭证功能说明显示凭证时，可跳转到任意联显示函数名intGotoPage(intPageNo);输入参数序号英文名数据类型参数说明1PageNoint凭证联号输出参数序号英文名数据类型参数说明1int0成功大于0失败放大显示凭证功能说明放大显示当前正在显示的凭证函数名voidZoomIn(void);缩小显示凭证功能说明缩小显示当前正在显示的凭证函数名voidZoomOut(void);自动适应显示凭证功能说明缩放页面显示比例到刚好在查看区域中完整显示出来。函数名voidZoomToFit(void);刷新显示凭证功能说明实现动态显示签章效果（即显示凭证时进行签章操作，签章后调用此接口可刷新凭证显示印章）函数名intRefresh(StringvoucherNo)输入参数序号英文名类型参数说明1voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败设定显示指定索引凭证功能说明设置显示指定索引的凭证函数名intSelectVoucherIndex(intIndex)输入参数序号英文名类型参数说明1Indexint凭证索引（从0开始）输出参数序号英文名数据类型参数说明1Int0成功大于0失败设置显示指定凭证号凭证功能说明设置显示指定凭证号的凭证函数名intSelectVoucherNo(StringvoucherNo)输入参数序号英文名类型参数说明1voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败设置凭证显示模式功能说明设置凭证的显示模式，支持单页模式和列表模式函数名intSetDisplayMode(intnDisPlayMode,intParamValue)输入参数序号英文名类型参数说明1nDisplayint列表模式是1，单页模式是22ParamValueint当选择列表模式时，该参数代表显示维数，如输入2代表显示2行2列输出参数序号英文名数据类型参数说明1Int0成功大于0失败不显示控件打印（后台批量打印）功能说明实现凭证不显示控件后台批量打印。函数名intPrintAllVoucher(StringcertID,StringadmDivCode,intstYear,StringvtCode,intdefaultPage,StringvoucherNo);输入参数序号英文名类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字4vtCodeString凭证类型，4位字符。参见报文规范5defaultPageint打印联6voucherNoString凭证编号数组凭证号1，凭证号2…输出参数序号英文名数据类型参数说明1Int0成功大于0失败打印预览接口功能说明实现凭证打印预览。函数名intPrintPreview(StringcertID,StringadmDivCode,intstYear,StringvtCode,intPageNo,StringvoucherNo);输入参数序号英文名类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字4vtCodeString凭证类型，4位字符。参见报文规范5PageNoint打印联6voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败设置当前用户名功能说明设置当前用户名，用于打印凭证时在凭证中显示。函数名intSetCurrentUser(StringUserName);输入参数序号英文名数据类型参数说明1UserNameString用户名，打印凭证时显示在凭证中输出参数序号英文名数据类型参数说明1int0成功大于0失败清除U-key缓存功能说明清除U-Key对于pin码的缓存函数名intClearPinCache(void);输出参数序号英文名数据类型参数说明1int0成功大于0失败修改U-keyPIN码功能说明修改UKEY的pin码函数名intChangeUserPin(StringoldPin,StringnewPin);输入参数序号英文名类型参数说明1OldPinString原PIN码2newPinString新PIN码输出参数序号英文名数据类型参数说明1int剩余的重试次数查看操作日志和签章信息功能说明实现查看指定凭证号的操作日志以及签章信息函数名intGetLogInfo(StringcertID,StringadmDivCode,intstYear,StringvtCode,StringvoucherNo);输入参数序号英文名类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字4vtCodeString凭证类型，4位字符。参见报文规范5voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败显示操作日志功能说明实现查看指定凭证号的操作日志以及签章信息函数名intDlgShowLogInfo(StringcertID,StringadmDivCode,intstYear,StringvtCode,StringvoucherNo)输入参数序号英文名类型参数说明1certIDString用户证书ID(登录用户证书id)2admDivCodeString行政区划，最大长度15位3stYearint业务年度，4位数字4vtCodeString凭证类型，4位字符。参见报文规范5voucherNoString凭证编号输出参数序号英文名数据类型参数说明1Int0成功大于0失败获取印章id接口功能说明弹出选章界面，获取选章印章的id。此接口只封装了针对科友自身的印章系统，其他公司印章接口不能通过此接口获取印章id。函数名StringDlgSelectStampId(void);输入参数 无。输出参数序号英文名数据类型参数说明1String选章的印章图片id获取证书id接口功能说明弹出选证书界面，获取所选证书的证书id。此接口只封装了针对科友自身的印章系统，其他公司印章接口不能通过此接口获取印章id。函数名StringDlgSelectCertId(void)输入参数无输出参数序号英文名数据类型参数说明1String选择证书的证书id获取ocx调用过程异常信息功能说明ocx调用接口异常时，通过该接口获取错误信息。函数名StringGetLastErr();输入参数 无。输出参数序号英文名数据类型参数说明1String获取客户端调用过程中错误信息。验证UkeyPin码接口功能说明用户可调用此接口选择证书并验证UkeyPin码，若UKEY中含有多个证书则会弹出提示框选择证书。函数名intVerifyPin(void);输入参数无输出参数序号英文名数据类型参数说明1int0成功大于0失败获取当前选择证书的CN接口功能说明用户调用此接口返回当前用户选择证书的CN。函数名StringGetCurCertCN(void);输入参数无输出参数序号英文名数据类型参数说明1String当前用户选择证书的CN获取操作人证书列表功能说明用户调用此接口返回当前Ukey中所有操作人证书列表。函数名StringGetOperatorCertsList(StringStampID);输入参数序号英文名数据类型参数说明1StampIDString印章ID输出参数序号英文名数据类型参数说明1StringHYPERLINK服务端接口异常。电子凭证写入接口本章节描述了与电子凭证保存相关的接口。写入客户端签章的凭证功能说明