NFC读卡接口日期版本说明作者2018/12/09V1.0.0NFC&OTG证件读取，支持身份证/港澳居民居住证/护照/EID1．概述本SDK支持二代身份证、护照及EID的读取。
二代身份证接口添加了身份鉴权操作，只有当鉴权通过的用户才可以使用公司提供的解码服务器进行身份证解码。
护照及EID功能开通需要单独申请。
NFC读卡用于支持NFC的安卓设备上。
OTG读卡用于支持USB的安卓设备上(USB口需要配套专门证件读卡器)。
2．流程图3．回调在使用本SDK前必须实现ActiveCallBack接口中的相关函数，原型如下：public interface ActiveCallBack{void readProgress(int npaogress);void setUserInfo(String sztxt);}void readProgress(int npaogress);返回身份证读卡进度，一共20步。
●void setUserInfo(String sztxt);函数空实现即可，有时会返回调试信息。
4．接口●OTGReadCardAPI接口初始化操作。
paramContext:android的上下文cb:实现回调的类bNFC：统一写成false●GetVersion获取当前版本号●setServerInfo设置服务器列表（初始化后最先调用，必须）twoCardServerList:身份证解码服务器列表eidServerList:为nullbTestServer：统一填false返回值：无●NfcReadCard通过NFC读卡，同步操作，执行结束返回状态。
szAppID：APPID，每家商户的唯一ID（需要向本公司申请后获取）userInfo：用户信息，暂时为空intent:NFC句柄,OTG时填nulldefaultType:只能填eTwoGeneralCarduserData：用户透传数据，如不需要，直接填“”bAuth:填false返回值：41–失败90–成功●GetCardType返回NfcReadCard中读取的卡片类型。
票据接口函数说明一、接口概述a.概述为了执行黑龙江省财政厅发布的“财政票据电子化”即自动导入票据，电脑开票，自动核销票据，资金解缴等的方针，由各单位现有软件提供票据相关信息通过博思转入开票接口来进行自动开票。
b.原理简述单位端现有软件生成票据相关信息转成文本格式，再通过调用dll文件的相关函数把信息转入博思开票软件中，而后自动进行开票二、接口实现a.操作过程1.启动单位端现有软件与博思开票端软件2.单位端现有软件提供票据相关信息3.单位端现有软件进行开票b.软件实现过程1.业务软件凋用Dll（Pconnect或PAdvConnect）函数联接开票软件；2. 业务软件生成票面信息（需按接口规范格式）；3. 业务软件凋用Dll（PZrPjXX）函数转入票据信息，票据软件接收票据信息，并返回生成票据号、数据指纹等信息；4. 转入成功时，业务软件打印出票据。
c、Dll函数说明1、Function PConnect:integer;StdCall;联接博思开票软件,必须先调用此联接才能执行转入开票的操作返回值int：成功 1 不成功 0注：只用于联接一般开票软件2.Function PConnectSoft(aSys:PChar):integer;StdCall;联接博思开票软件，必须先调用此联接才能执行转入开票的操作,有针对系统而言参数：aSys:系统名高速开票系统:GS大型网络开票系统:NK返回值int: 成功 1 不成功 03.FunctionPAdvConnectSoft(aUser,aMm,aTzh,aSys:PChar):integer;S tdcall;联接博思开票软件并且能自动登录,有针对系统而言参数：aUser：登录用户号aMm：登录密码aTzh：登录套帐号(为空时取默认套帐)aSys：系统名返回值 int ：成功 1 不成功 04.FunctionPAdvConnect(aUser,aMm,aTzh:PChar):intger;StdCall;联接博思开票软件并且能自动登录参数：aUser：登录用户号aMm：登录密码aTzh：登录套帐号(为空时取默认套帐)注：只用于联接一般开票软件5、Function PDisConnect:integer;StdCall;断开博思开票软件的联接返回值int：成功 1 不成功 06. Function PZrPj(ZrTxt:PChar;IsPrn:integer; PjLx,Bz,Res:PChar):integer;StdCall;执行转入开票动作参数： ZrTxt : 票据数据(格式详见：数据格式说明.txt 文件)IsPrn : 0 表示显示转入票据信息后再进行开票1 表示直接开票并打印2 表示直接开票但不打印PjLx : 票据类型(传空表示取默认当前的票据类型开票，不为空则指定类型)Bz : 单据的备注 (可选的参数，可不传则转入无备注)Res: 只作为存储返回字符成功：票据类型号,票据号,金额,注册号(以,分格)错误：（错误信息）返回值: 参数Res的长度示例1：var vRes:pChar;SetLength(vRes,500);//vRes变量宽度，请定义足够大以返回完整错误信息PZrPj(SomeString,1,’001001’,’’,vRes)返回值：25vRes返回值：’成功:001001,085256,1200.3,闽财2004票’表示：传入开票内容为SomeString，票据类型为’001001’，备注为空返回值长度为25开票成功，返回值为票据类型为001001票据号为085256金额为1200.3元注册号闽财2004票示例2：var vRes:pChar;PZrPj(SomeString,1,’’,’张三’,vRes)返回值：31 vRes返回值：’错误:请先上报核销后才能开票据。
身份证阅读器SDK使用说明（V1.3）深圳华视电子读写设备有限公司目录版本变更记录 (1)1身份证阅读器SDK简介 (1)2系统需求 (1)3函数说明 (1)3.1 核心相关函数 (1)3.2 获取身份证具体信息函数 (2)3.3 人证比对相关函数 (3)3.4 函数调用流程 (3)4身份证阅读器SDK (4)4.1 文件夹组成 (4)4.2 身份阅读器SDK的使用 (5)4.2.1 SDK使用方法 (5)4.2.2 SDK使用限制 (5)4.3 身份证阅读器SDK测试程序 (5)版本变更记录1身份证阅读器SDK简介本文档描述了深圳华视身份证阅读器SDK（Windows版）的调用方法、函数定义、参数和返回值说明，供开发商进行二次开发使用。
2系统需求（1）操作系统：Windows XP（2）开发环境：本SDK采用ANSI C语言编写，假定用户采用C/C++语言作为开发工具。
3函数说明3.1核心相关函数●●●●●3.2获取身份证具体信息函数下面是一组获取身份证具体信息的函数：3.3人证比对相关函数人证比对：3.4函数调用流程身份证阅读器SDK库应用函数的调用流程如下图所示：4身份证阅读器SDK4.1文件夹组成身份证阅读器SDK，由下述文件夹组成：·Include包含身份证阅读器SDK库头文件（termb.h）；·lib包含身份证阅读器SDK库文件（静态库：termb.lib，动态库：termb.dll，CVRApi.dll，sdtapi.dll，WLTLib.dll）等；·license包含文件：license.lic, base.dat·example包含身份证阅读器SDK库测试程序；·doc包含身份证阅读器相关文档说明（身份证阅读器SDK使用说明.doc）。
4.2身份阅读器SDK的使用4.2.1SDK使用方法（1）静态库的适用方法：在VC环境下添加termb.lib附加依赖项，在调用它的应用程序里包含相应的termb.h头文件。
修改履历一产品适用范围本产品是一个WINDOWS系统的动态链接库。
适用于WINDOWS XP及以上版本的WINDOWS操作系统。
二产品组成三产品部署本产品直接复制到PC机上即可适用，要保证产品所有组成项目都在同一个目录下。
四接口函数说明4.1 接口函数列表4.2 接口函数说明接口函的数参的数命名以一个前缀说明这个参数的输入输出类型：pi_ 表示参数是输入参数。
po_ 表示参数是输出参数。
pio_ 表示参数是输入输出参数。
4.2.1 hxgc_OpenReader●函数功能打开指定端口上的读卡器。
使用完毕后要调用hxgc_CloseReader关闭。
●返回值0: 成功；1：失败。
4.2.2 hxgc_CloseReader 关闭指定端口上的读卡器。
●返回值0: 成功；1：失败。
4.2.3 hxgc_GetSamIdToStrA●函数功能获取SAM模块的编号，编号以字符串输出。
本函数为ANSI版本，SAM ID以ANSI字符串输出。
本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。
●返回值0: 成功；1：失败。
4.2.4 hxgc_GetSamIdToStrW●函数功能获取SAM模块的编号，编号以字符串输出。
本函数为UNIODE版本，SAM ID以UNIODE字符串输出。
本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。
●返回值0: 成功；1：失败。
4.2.5 hxgc_ReadIdChipInfo●函数功能读取身份证芯片信息。
本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。
●返回值0: 成功；1：失败。
4.2.6 hxgc_ReadIdBaseInfo●函数功能读取身份证基本信息，基本信息是：身份证文字信息 + 照片信息。
本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。
●返回值0: 成功；1：失败。
