资源预览内容
第1页 / 共130页
第2页 / 共130页
第3页 / 共130页
第4页 / 共130页
第5页 / 共130页
第6页 / 共130页
第7页 / 共130页
第8页 / 共130页
第9页 / 共130页
第10页 / 共130页
亲,该文档总共130页,到这儿已超出免费预览范围,如果喜欢就下载吧!
资源描述
中控消费平台SDK用户手册案卷号日期消费系统二次开发平台IC卡SDK(控件版)用 户 手 册 作 者: 完成日期: 签 收 人: 签收日期: 修改情况记录:版本号修改批准人修改人安装日期签收人 目录1 SDK开发说明11.1 简介11.2 背景11.3 定义11.4 SDK 安装11.5接口调用流程7l修改密码(加密)7l初始化IC卡(清空IC卡)8l发卡8l读卡9l充值102 数据结构说明112.1 消费机器数据结构11l消费机中数据表说明:11l数据添加格式162.2 卡片数据结构162.3 状态报告16l返回状态码及意义163 SDK开发函数说明183.1 消费机器sdk开发函数183.2 卡操作sdk卡发函数18l1 ZK_PosClearICCard18l2ZK_PosIssueICCard18l3ZK_PosReadICCard19l4ZK_PosWriteICCardMoney19l5ZK_PosWriteICCardPassWord19l6ZK_PosUpdateParam20l7ZK_PosReadCardSerial204 开发建议202 中控消费平台SDK用户手册1 SDK开发说明1.1 简介 SDK:是针对独立软件开发商(ISV)和系统集成商(SI)的软件开发及技术产品服务的需求,提供的消费软件系统与消费机及IC卡读写器通讯的开发组件(SDK,Software Development Kit)1.2 背景 系统名称: SDK消费系统开发组件1.3 定义 参数KEY值 卡密码,格式为每个字节密码以逗号分隔如“FF,FF,FF,FF,FF,FF”, 每个字节是该数字的ASCII码的16进制表示形式,如:卡密码是123456,那么转化后为“31,32,33,34,35,36 ”, 所有函数的卡密码格式相同,不在赘述1.4 SDK 安装l 使用消费机sdk接口函数需要用到多个动态库文件,详见“消费机dll库”文件夹,把该文件夹的所以dll文件放到工程目录下即可,具体应用参考例程l 使用卡操作sdk时,采用ocx控件形式,需要安装本公司提供的驱动程序获得控件库文件。驱动程序在“控件”文件夹中,安装好驱动后,默认目录(xp系统)在c:windowssystem32下找到以下两个文件。 Biokey.ocx控件库文件ZKOnline.ocx 控件库文件l 分别注册控件 Biokey.ocx和ZKOnline.ocx控件库文件:regsvr32.exe c:windowssystem32Biokey.ocxregsvr32.exe c:windowssystem32ZKOnline.ocx注意:Windows Vista客户需要以管理员权限才能正确执行regsvr32;l 注册成功后,就可以在相应的开发环境中导入控件。A:在Delphi 7 开发环境:第一步:ComponentImport Activex Control如下图所示:进入如下界面,按下图所示操作,安装两个控件B:在Microsoft Visual Studio .NET 2003的VB项目中第一步:注册控件,如下图所示进入注册界面 然后进入ActiveX控件测试容器界面,如下图:选择“文件注册控件”,找到注册文件,如下图所示:注册成功后,多了刚才注册的选项,如下图所示:第二步:添加控件到工具栏中,方法如下图所示:添加好后,在控件里就添加好了该控件,如下图所示:C:在Microsoft Visual C+ 6.0中使用 第一步:注册控件,方法跟VB的类似。 第二步:使用控件,操作如下图所示在下图中选择要插入的控件: 1.5接口调用流程接口调用流程如下: 消费机器接口调用流程 IC卡操作业务流程l 修改密码(加密)连接发卡器读取卡序列号成功修改主、备份扇区密码结束YN没有找到IC卡或卡是否损坏判断是否白卡白卡YNl 初始化IC卡(清空IC卡)连接发卡器读取卡序列号成功清空主、备份扇区密码结束YN没有找到IC卡或卡是否损坏l 发卡连接发卡器读取卡序列号成功判断是否白卡结束YN没有找到IC卡或卡是否损坏白卡Y判断各参数正确这不是一张空白卡,不能发卡。请将该卡先初始化!发卡写主扇区NYN成功发卡写备份扇区成功清空主扇区卡信息块NNYYl 读卡连接发卡器读取卡序列号成功解析数据结束YN没有找到IC卡或卡是否损坏读主扇区数据成功YN读备份扇区数据成功YNl 充值NY读卡成功写主扇区金额结束YN判断充值参数正确NY判断是否同一张(读两次序列号)同一卡NY成功读主扇区金额成功且写=读写备份扇区金额成功读备份扇区金额成功且写=读执行次数 10YYYYNNNN2 数据结构说明2.1 消费机器数据结构l 消费机中数据表说明:1UserInfo:(用户信息表)字段名说明SysID系统卡号UserID用户编号PIN用户工号CardNo卡号Name姓名PassWord差额密码SegNoUserType用户类型(1黑名单,0白名单)Privage权限(1管理员,0普通用户)2Template:(指纹信息) 3OpLog:(管理日志)字段名说明OPID操作员IDTIME操作时间OP操作编码4PosLog:(消费记录)字段名说明SysID系统卡号CardNo卡号PosTime消费时间PosMoney消费金额Balance余额RecNo机器流水号CardRecID卡流水号State消费类型Mealtype餐别MealDate记餐日期OPID操作员ID5PRESSKEY(键值信息表)字段名说明KeyID键值编号Price价格6StoreInfo:(商品信息)字段名说明StoreNo商品编号Name商品名称Bc条码Price价格agio折扣7Mealtype:(餐别信息)字段名说明Mlid餐别编号Name餐别名称Start开始时间End结束时间8TimeSeg:(就餐批次时间段信息)字段名说明SegID批次编号(1为固定时段)TsID时段编号Start开始时间End结束时间9FIXED(分段定值表)字段名说明TsID时段编号Start开始时间End结束时间Price价格10PayDetail:(商品消费明细信息, 商品消费时对应消费记录的明细信息)字段名说明RecNo机器流水号StoreNo商品编号Price实收价格RecSum单笔消费商品流水号11KEYDETAIL 键值消费明细表字段名说明RecNo机器流水号KeyID键值编号Price实收价格RecSum单笔消费商品流水号12TmPosLog:(记时消费数据)字段名说明SysID卡号StartTme开始时间StartBanlance开始金额EndTime结束时间EndBanlance结束金额(余额)13CARDTYPE (卡类设置表)字段名说明SortID卡类序号Name卡类名称rebate折扣Timemaxmoney次消费最大金额Daymaxmoney天消费最大金额Mealmaxmoney餐消费最大金额Daymaxtimes天消费最大次数Mealmaxtimes餐消费最大次数Lowlimit最小卡余额Maxlimit最大卡余额MealType可用餐别Enable是否可用limit有效天数BatchNo使用时段UseFinger是否使用指纹(1或0)14FULLVALUE (充值记录表)字段名说明SysID系统卡号CardNo卡号CardRecNO卡流水号Money充值金额Balance余额LogType充值类型OPID操作员IDRecNo机器流水号15SUBSIDYLOG (补贴流水记录表)字段名说明SysID系统卡号CardNo卡号Batch补贴批号Money补贴金额allowDate补贴日期16SIDYLOG(已补贴记成功录表)字段名说明SysID系统卡号CardNo卡号CardRecID卡流水号Batch补贴批号AllowTime补贴时间AllowMoney补贴金额Balance余额state补贴方式 0:清零补贴BaseBatch补贴基次RecNo机器流水号17SubSidy:(待补贴记录表)字段名说明SysID系统卡号CardNo卡号Batch补贴批号AllowMoney补贴金额BaseBatch补贴基次allowDate补贴日期l 数据添加格式向消费机中的表添加数据,是将记录组合成一个字符串发送到机器中的,字符串格式为:字段名=值(tab键)
网站客服QQ:2055934822
金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号