中控售飯機(jī)SDK用戶手冊(cè)

1、精品求倉(cāng)斤日期消費(fèi)系統(tǒng)二次開發(fā)平臺(tái)IC卡SDK （控件版）用戶手冊(cè)修改情況記錄:版本號(hào)修改批準(zhǔn)人修改人安裝日期簽收人welcome精品目錄 TOC o 1-5 h z HYPERLINK l bookmark2 o Current Document SDK開發(fā)說明1簡(jiǎn)介 1背景 1定義 1SDK 安裝 1接口調(diào)用流程 7修改密碼（加密） 8初始化IC卡（清空IC卡）8發(fā)卡9讀卡10充值11 HYPERLINK l bookmark11 o Current Document 2數(shù)據(jù)結(jié)構(gòu)說明1.2消費(fèi)機(jī)器數(shù)據(jù)結(jié)構(gòu) 12消費(fèi)機(jī)中數(shù)據(jù)表說明： 12數(shù)據(jù)添加格式17卡片數(shù)據(jù)結(jié)構(gòu) 17狀態(tài)報(bào)告 18返回狀

2、態(tài)碼及意義 18 HYPERLINK l bookmark13 o Current Document 3 SDK開發(fā)函數(shù)說明 20welcome精品 TOC o 1-5 h z 消費(fèi)機(jī)器sdk開發(fā)函數(shù) 20卡操作sdk卡發(fā)函數(shù) 21.ZK_PosClearICCard 21.ZK_PosIssueICCard 21.ZK_PosReadICCard 22.ZK_PosWriteICCardMoney 23.ZK_PosWriteICCardPassWord 23.ZK_PosUpdateParam 24.ZK_PosReadCardSerial 24 HYPERLINK l bookmark1

3、5 o Current Document 4開發(fā)建議25welcome精品SDK開發(fā)說明簡(jiǎn)介SDK :是針對(duì)獨(dú)立軟件開發(fā)商（ISV）和系統(tǒng)集成商（SI）的軟件開發(fā)及技術(shù)產(chǎn)品服務(wù)的需求， 提供的消費(fèi)軟件系統(tǒng)與消費(fèi)機(jī)及IC卡讀寫器通訊的開發(fā)組件（SDK , Software Development Kit）背景? 系統(tǒng)名稱：SDK消費(fèi)系統(tǒng)開發(fā)組件定義? 參數(shù)KEY值 卡密碼，格式為每個(gè)字節(jié)密碼以逗號(hào)分隔如FF,FF,FF,FF,FF,FF,每個(gè)字節(jié)是該數(shù)字的 ASCII碼的16進(jìn)制表示形式，如：卡密碼是123456 ,那么轉(zhuǎn)化后為“ 31, 32, 33, 34, 35, 36 ，所有函數(shù)的卡密碼

4、格式相同， 不在贅述SDK 安裝使用消費(fèi)機(jī)sdk接口函數(shù)需要用到多個(gè)動(dòng)態(tài)庫(kù)文件， 詳見“消費(fèi)機(jī)dll庫(kù)”文件夾， 把該文件夾的所以dll文件放到工程目錄下即可，具體應(yīng)用參考例程使用卡操作sdk時(shí)，采用ocx控件形式，需要安裝本公司提供的驅(qū)動(dòng)程序獲得控welcome精品件庫(kù)文件。驅(qū)動(dòng)程序在“控件”文件夾中，安裝好驅(qū)動(dòng)后，默認(rèn)目錄（xp系統(tǒng)）c:windowssystem32下找到以下兩個(gè)文件。Biokey.ocx控件庫(kù)文件ZKOnline.ocx控件庫(kù)文件分別注冊(cè)控件Biokey.ocx 和 ZKOnline.ocx 控件庫(kù)文件:regsvr32.exec:windowssystem32Biok

5、ey.ocxregsvr32.exec:windowssystem32ZKOnline.ocx注意：Windows Vista客戶需要以管理員權(quán)限才能正確執(zhí)行regsvr32 ;注冊(cè)成功后，就可以在相應(yīng)的開發(fā)環(huán)境中導(dǎo)入控件。A :在Delphi 7 開發(fā)環(huán)境：第一步：Component Import Activex Control 如下圖所示:7 Delphi T - lealFile Edi t %31ch Viw Jroj ect HunCMipcnent DatmBase T 血5 匚區(qū)Fwuk匕配，0m苜1直區(qū)蜷1 IfeTf Component.律 Install CompcsiLM

6、i匕)Access Dat醫(yī)向Imjort ActiveX Control.,ircj ect I axiagei- Olj ect LiLS;eclLaif| (nolhing selected|Propefties Everts |Croats Cymyon胃nt T軻plat自Install Fckages. , PCoufigure Falette尸！ D曲回：PM% Jcl+ 二Variable5ZUcinstari+ l Ikes：進(jìn)入如下界面，按下圖所示操作，安裝兩個(gè)控件welcome精品B:在 Microsoft Visual Studio .NET 2003 的 VB 項(xiàng)目中

7、第一步：注冊(cè)控件，如下圖所示進(jìn)入注冊(cè)界面welcome精品國(guó)工WUO 總匚心7-T r 4口 D 熱口口TT. Ti E K Oil一匚I CUT三可 口幣一 IE CIT二丁 MP工一上小河口一項(xiàng)U/ 疝用上K口底 壽匚工*!1 I設(shè)計(jì)-For*l-vb I設(shè)計(jì)局試必?cái)?shù)據(jù)心 工具6r窗口直希助QD .工所同 調(diào)試進(jìn)程H） ctrimt+r %逢接到設(shè)爵國(guó)）. 4-+ 4 4- + K 7_%連接到數(shù)據(jù)庫(kù) 添加/移除工具箱項(xiàng)立）Ctrl+T 外接程序管理骷色二一 生成注降nb BT團(tuán) 宏皿*O 升綴iMtial Basic 6代媽）.一. %:一一乂控件過福溶黑 創(chuàng)建GUID3 Dotfusc

8、*t*r Community Ed七on 楮誤有找區(qū)）上地I TT iTi-pl 平自口 丁 S K%P - -然后進(jìn)入ActiveX控件測(cè)試容器界面，如下圖:選擇“文件 注冊(cè)控件，找到注冊(cè)文件，如下圖所示:welcome精品注冊(cè)成功后，多了剛才注冊(cè)的選項(xiàng)，如下圖所示:第二步：添加控件到工具欄中，方法如下圖所示:welcome精品區(qū)工具箱數(shù)據(jù)蛆件出刪除選項(xiàng)卡Bits. 重命名選項(xiàng)卡盤）e55= | /力口/移除項(xiàng)QL.按字母順序排序。FrocV列表視圖T.添加選項(xiàng)卡電）Beppl顯示慚有選項(xiàng)卡區(qū)）AFI01上移 QJ）下移（P常規(guī)添加好后，在控件里就添加好了該控件，如下圖所示:welcome精

9、品C:在 Microsoft Visual C+ 6.0 中使用第一步：注冊(cè)控件，方法跟 VB的類似。第二步：使用控件，操作如下圖所示在下圖中選擇要插入的控件:1.5接口調(diào)用流程接口調(diào)用流程如下:welcome精品消費(fèi)機(jī)器接口調(diào)用流程IC卡操作業(yè)務(wù)流程修改密碼（加密）初始化IC卡（清空IC卡）精品發(fā)卡沒有找 到IC卡 或卡是 否損壞這不是一 張空白卡， 不能發(fā)卡。 請(qǐng)將該卡 先初始化！精品讀卡沒有找到IC 卡或卡是否 損壞welcome精品充值精品2數(shù)據(jù)結(jié)構(gòu)說明2.1消費(fèi)機(jī)器數(shù)據(jù)結(jié)構(gòu)消費(fèi)機(jī)中數(shù)據(jù)表說明：. UserInfo :（用戶信息表）字段名說明SysID系統(tǒng)卡號(hào)UserID用戶編號(hào)PIN

10、用戶工號(hào)CardNo的Name姓名PassWord差額密碼SegNoUserType用戶類型（1黑名單,0白名單）welcome精品Privage權(quán)限（1管理員,0普通用戶）Template :（指紋信息）OpLog :（管理日志）字段名說明OPID操作員IDTIME操作時(shí)間OP操作編碼PosLog :（消費(fèi)記錄）字段名說明SysID系統(tǒng)卡號(hào)CardNo的PosTime消費(fèi)時(shí)間PosMoney消費(fèi)金額Balance余額RecNo機(jī)器流水號(hào)CardRecID卡流水號(hào)State消費(fèi)類型Mealtype餐別MealDate記餐日期OPID操作員ID. PRESSKEY（鍵值信息表）字段名說明KeyI

11、D鍵值編號(hào)Price價(jià)格welcome精品Storeinfo :（商品信息）字段名說明StoreNo商口口編pName商品名稱Bc條碼Price價(jià)格agio折扣Mealtype :（餐別信息）字段名說明Mlid餐別編號(hào)Name餐別名稱Start開始時(shí)間End結(jié)束時(shí)間TimeSeg :（就餐批次時(shí)間段信息）字段名說明SegID批次編號(hào)（1為固定時(shí)段）TsID時(shí)段編號(hào)Start開始時(shí)間End結(jié)束時(shí)間FIXED （分段定值表）字段名說明TsID時(shí)段編號(hào)Start開始時(shí)間End結(jié)束時(shí)間Price價(jià)格welcome精品PayDetail :（商品消費(fèi)明細(xì)信息，商品消費(fèi)時(shí)對(duì)應(yīng)消費(fèi)記錄的 明細(xì)信息）字段名說

12、明RecNo機(jī)器流水號(hào)StoreNo商口口編pPrice實(shí)收價(jià)格RecSum單筆消費(fèi)商品流水號(hào). KEYDETAIL鍵值消費(fèi)明細(xì)表字段名說明RecNo機(jī)器流水號(hào)KeyID鍵值編號(hào)Price實(shí)收價(jià)格RecSum單筆消費(fèi)商品流水號(hào). TmPosLog :（記時(shí)消費(fèi)數(shù)據(jù)）字段名說明SysID的StartTme開始時(shí)間StartBanlance開始金額EndTime結(jié)束時(shí)間EndBanlance結(jié)束金額（余額）. CARDTYPE （卡類設(shè)置表）字段名說明SortID卡類序號(hào)Name卡類名稱rebate折扣Timemaxmoney次消費(fèi)最大金額Daymaxmoney天消費(fèi)最大金額welcome精品Me

13、almaxmoney餐消費(fèi)最大金額Daymaxtimes天消費(fèi)最大次數(shù)Mealmaxtimes餐消費(fèi)最大次數(shù)Lowlimit最小卡余額Maxlimit取大k余額MealType可用餐別Enable是否可用limit后效天數(shù)BatchNo使用時(shí)段UseFinger是否使用指紋（1或0）. FULLVALUE （充值記錄表）字段名說明SysID系統(tǒng)卡號(hào)CardNoCardRecNO卡流水號(hào)Money充值金額Balance余額LogType充值OPID操作員IDRecNo機(jī)器流水號(hào). SUBSIDYLOG（補(bǔ)貼流水記錄表）字段名說明SysID系統(tǒng)卡號(hào)CardNo的Batch補(bǔ)貼批號(hào)Money補(bǔ)貼金額

14、allowDate補(bǔ)貼日期SIDYLOG （已補(bǔ)貼記成功錄表）字段名說明welcome精品SysID系統(tǒng)卡號(hào)CardNoCardRecID卡流水號(hào)Batch補(bǔ)貼批號(hào)AllowTime補(bǔ)貼時(shí)間AllowMoney補(bǔ)貼金額Balance余額state補(bǔ)貼方式0:清零補(bǔ)貼BaseBatch補(bǔ)貼基次RecNo機(jī)器流水號(hào). SubSidy :（待補(bǔ)貼記錄表）字段名說明SysID系統(tǒng)H P.、勺CardNoHH P.、勺Batch補(bǔ)貼批號(hào)AllowMoney補(bǔ)貼金額BaseBatch補(bǔ)貼基次allowDate補(bǔ)貼日期數(shù)據(jù)添加格式向消費(fèi)機(jī)中的表添加數(shù)據(jù)，是將記錄組合成一個(gè)字符串發(fā)送到機(jī)器中的，字符串格式為：

15、字段名=值（tab鍵）字段名=值記錄與記錄之間以換行符號(hào)連接如商品資料的一條記錄為StoreNo=1 Name=包子 Bc=464654646 Price=0.5agio=80 ”,注意：字段之間是tab符號(hào)從消費(fèi)機(jī)讀取的格式也相同，需要自行解析字符串，得到每條記錄每個(gè)字段的數(shù)據(jù)。卡片數(shù)據(jù)結(jié)構(gòu)讀取卡片返回?cái)?shù)據(jù)的組成結(jié)構(gòu)welcome精品數(shù)據(jù)格式采用“字段名 1=值1 ,字段名2=值2的形式字段名為上述余額扇區(qū)結(jié)構(gòu)說明中的字段名狀態(tài)報(bào)告返回狀態(tài)碼及意義-1：Result :=傳入?yún)?shù)非法-2：Result :=主、備份扇區(qū)數(shù)據(jù)不一致1：Result :=操作失敗2：Result :=數(shù)據(jù)丟包3:

16、Result :=沒有選擇準(zhǔn)確的 COM 口;4:Result :=和卡通訊超時(shí),;5, 7:Result := XOR 校驗(yàn)出錯(cuò),;$A:Result :=輸入的參數(shù)大于最大允許范圍，溢出$80:welcome精品Result :=參數(shù)設(shè)置成功,;$81:Result :=參數(shù)設(shè)置失敗,;$82:Result :=通訊超時(shí);$83:Result :=卡不存在;$84:Result :=接收卡數(shù)據(jù)出錯(cuò),;$85:Result :=輸入?yún)?shù)或者輸入命令格式錯(cuò)誤$87:Result :=未知的錯(cuò)誤,;$8A:Result :=在塊初始化中出現(xiàn)錯(cuò)誤,;$8B:Result :=在防沖突過程中得到錯(cuò)誤

17、的序列號(hào)$8C:Result :=密碼認(rèn)證沒通過,;$8F:Result :=讀寫設(shè)備接收到了未定義的命令$90:welcome精品Result :=卡不支持這個(gè)命令,;$91:Result :=命令格式有錯(cuò)誤,;$92:Result :=在命令的FLAG參數(shù)中，不支持OPTION模式;$93:Result :=要操彳的 BLOCK不存在,;$94:Result :=要操作的對(duì)象已經(jīng)別鎖定，不能進(jìn)行修改,;$95:Result :=鎖定操作不成功,;$96:Result :=寫操作不成功,;用途獲得接口函數(shù)執(zhí)行結(jié)果狀態(tài)描述內(nèi)容（適用與卡操作函數(shù)）3 SDK開發(fā)函數(shù)說明消費(fèi)機(jī)器sdk開發(fā)函數(shù)詳細(xì)

18、參閱dataapi接口使用指南welcome精品卡操作sdk卡發(fā)函數(shù). ZK_PosClearICCard【功能】對(duì)卡進(jìn)行初始化，清除卡片數(shù)據(jù)，將扇區(qū)字節(jié)寫為0X 00【需要參數(shù)說明】commHandle: int :無(wú)符號(hào)整型，發(fā)卡器端口資源句柄，默認(rèn)為key: string : 卡密碼。mainsec :整型，115,主扇區(qū)號(hào)，每個(gè)扇區(qū)的三個(gè)塊backsec :整型，115,備份扇區(qū)號(hào)，每個(gè)扇區(qū)的三個(gè)塊【返回值】=0 :初始化成功0 :其它見2.3狀態(tài)報(bào)告描述ZK_PosIssueICCard【功能】對(duì)卡寫數(shù)據(jù)，發(fā)放卡片【需要參數(shù)說明】commHandle :整型，發(fā)卡器設(shè)備句柄key :

19、卡密碼overPwd :整型，六位數(shù)字，超額密碼Cardno :整型，1 999999999 ,卡號(hào)welcome精品money :整型，初始金額，1999900 ,cardtype :整型，199,卡片類別號(hào)batchNo :整型，卡片版本號(hào)miansec :整型，115,主扇區(qū)號(hào)backsec :整型，1 15 ,備份扇區(qū)號(hào)【返回值】=0 :發(fā)卡成功0 :其它見2.3狀態(tài)報(bào)告描述ZK_PosReadICCard【功能】讀取卡片數(shù)據(jù)，數(shù)據(jù)包括卡號(hào)，余額等信息【參數(shù)說明】commHandle :整型，發(fā)卡器設(shè)備句柄，0key :卡密碼miansec :整型，115,主扇區(qū)號(hào)backsec :整

20、型，1 15 ,備份扇區(qū)號(hào)Data :字符串，返回讀取的數(shù)據(jù)，數(shù)據(jù)格式采用“字段名1=值1,字段名2=值2”的形式【返回值】返回字符串”字段名 1=值，字段名1=值”，可以判斷字符串是否包含=或字符串長(zhǎng)度，不包含則失敗，其它見 2.3狀態(tài)報(bào)告描述welcome精品ZK_PosWriteICCardMoney【功能】對(duì)卡片寫入金額充值，主扇區(qū)和備份扇區(qū)的第二和第三塊需要寫成相同的數(shù)據(jù)?！緟?shù)說明】commHandle :無(wú)符號(hào)整型，發(fā)卡器設(shè)備句柄key :卡密碼Money :整型，1 999900 ,寫入金額mainsect :整型。1 15 ,存儲(chǔ)數(shù)據(jù)的主扇區(qū)號(hào)backsec :整型，115,備份扇區(qū)號(hào)【返回值】=0 :充值成功1 :其它見2.3狀態(tài)報(bào)告描述ZK_PosWriteICCardPassWord【功能】修改卡密碼【參數(shù)說明】commHandle :整型，發(fā)卡器設(shè)備句柄oldkey :六位數(shù)字字符串，原卡密碼newkey :六位數(shù)字字符串，新密碼mainsect :整型。1 15 ,存儲(chǔ)數(shù)據(jù)的主扇區(qū)號(hào)backsec :整型，115,備份扇區(qū)號(hào)welcome精品【返回值】=0 :成功1 :其它見2.3狀態(tài)報(bào)告描述ZK