一卡通消费系统动态链接库说明

1、一卡通消费系统动态Ver 1.0库规划为了方便第开发自己的消费应用，需要提供一卡通消费系统的动态库。要求动态具有较好的兼容性，应尽量采用标准的 Windows 类型作为参数，方法命名及错误提示应尽量能表达出具自身的意义。动态库的大体可以分为三大部分脱机、设置消费参数、其它系统方法。一、脱机1.2.3.可以定义所有，还是剩余的；各个项的间隔符号可以定义；格式（以分号为例）：机器;状态;消费模式;消费时间（年月日时分秒）;商品;消费数量/份数;消费时长;消费/充值/转帐金额;卡余额;营业员10 金额消费20 份数消费30 时长消费40 商品消费50 充值60 转帐70 取款00:正常10:假写卡2

2、0:纠错文件命名规则4.终端(4 位)+”_”+日期时间，如 0001_20060831120506.txt二、 设置消费参数由于消费参数太多，如果采用每个参数设立一个方法，不仅在参数格式上比较复杂，也会使用其它语言调用 DLL 带来与 DLL 的传递媒介。的不便，所以采用消费参数配置文件作为第状态：消费模式：1.2.3.4.设置时间下传(存放在 NameList.txt 中)下传消费参数消费参数文件范例SystemCompanyCode=公司加密值NameValidateMode=验证方式(1 表示验证/0 表示红)COMPort=485 通讯串口,局域网此值无效BaudRate=485 通

3、讯串口波特率,局域网此值无效Servort=局域网端口,485 此值无效mnuLog=是否保存通讯日志(1 为是/0 为否)IsShowProsBar=是否显示进度条(1 为是/0 为否)BillPrPr Pr PrPrerBaudrate=小票erBusying=小票波特率(0-9600bps,1-19200bps)的忙信号(0 或 1)Number=小票打印联数(1-4)Title=打印标题(最长 16 个汉字)RepastInfo RepastNo1=餐别 TimeBgn1=开始时间TimeEnd1=结束时间(必须以同等位数的字符串表示,如 001、011)Price1=单价(可以精确到

4、两位小数点).RepastNo8= TimeBgn8= TimeEnd8=Price8=KeyInfoKey0Price=键值 0 表示的单价(可以精确到两位小数点)Key1Price=键值 1 表示的单价Key2Price=键值 2 表示的单价Key3Price=键值 3 表示的单价Key4Price=键值 4 表示的单价Key5Price=键值 5 表示的单价Key6Price=键值 6 表示的单价Key7Price=键值 7 表示的单价Key8Price=键值 8 表示的单价Key9Price=键值 8 表示的单价MocInfoConsumeMode=消费模式(0 计次1 计份2 键值3

5、 金额4 菜谱)IsInput=是否先输金额后刷卡(1 表示是0 表示否)IsUseSubsidy=是否可用补贴(1 表示是0 表示否)IsUseDiscount=是否可用折扣(1 表示是0 表示否) IsUseCorrect=是否开放消费纠错功能(1 表示是0 表示否)ChargingUnit=计费(1:秒,2:分,3:小时,4:天,5:,6:月)Chargingerval=计费时长间隔 ChargingPrice=计费单价DefaultPayment=计时模式下默认扣款金额 AllLimitTimes=总消费次数限制(0-65535)MocType=终端类型(0 表示出纳/1 表示售饭/2

6、 表示灵活消费)o=终端(1-65535)UseCardTypes=可用卡类(卡类 Addr485=485 地址(1-255)AddrLan=局域网 IP 地址1|卡类2|卡类N,ALL 表示所有卡类)WareInfoWareCode1=品种(不能以零打头并且只能数字,目前只支持 4 位)WareName1=品种名称(最长过 8 个汉字)WarePrice1=品种单价(可以精确到两位小数点).WareCode300= WareName300=WarePrice300=CardTypeInfoCardTypeNo1=卡类(1-32)CardTypeDiscount1=卡类折扣(1-100) Da

7、yLimitTimes1=当天限制次数(0-255,0 表示不限制)DayLimitMoney1=当天限制金额(0-99999,99999 表示不限制) CardMinBalance1=卡上最低保留金额DisabledDate1=卡类失效日期(暂预留)UsableRepasts1=001|002|003 /可用餐别(共可以设置 8 餐,每个餐别之间以|隔开)RepastLimitTimes1=0|1|3 /当餐限制次数(共可以限制8 餐,每餐的限制次数之间以|隔开,与上面的可用餐别一一对应).CardTypeNo32= CardTypeDiscount32= DayLimitTimes32=

8、DayLimitMoney32= CardMinBalance32= DisabledDate32= UsableRepasts32=RepastLimitTimes32=CashierInfo CardNo1=出纳员 CardNo2= CardNo3=CardNo4=(最长 12 位，不能以零打头)三、 输出方法1.fnGetMocVer取得硬件版本号；定义：function fnGetMocVer(): PChar;参数：无返回值：返回2.取得最后一次错误信息；定义：function fnGetLastError(): PChar;参数：无返回值：最后一次错误信息3.取得动态库的版本号；定

9、义：function fnGetLibVer(): PChar;参数：无返回值：动态库的版本号（3 号的版本号.发布日期，如 1.0.0.918）库兼容的硬件版本号；4.取得动态定义：function fnGetLibVer(): PChar;参数：无返回值：动态库的版本号（3 号的版本号.发布日期，如 1.0.0.918）5.上传定义：function fnUploadNameList(): DWORD;参数：无返回值：详见动态库返回值定义6.上传一个function fnUploadOneName(aCardNo: PChar;aAction: DWORD = 2): DWORD;aCar

10、dNo -aAction动作(1 表示删除，2 表示增加)详见动态库返回值定义7.脱机function fnDownloadOfflineRecoraOptions - 选项(0 表示硬件ptions: DWORD = 1): DWORD;器上的所有，1 表示未的)详见动态库返回值定义8.上传系统参数function fnUploadSystemConfiptions: DWORD = 0): DWORD; stdcall;aOptions选项(0 表示所有参数，其它参数请见下表说明)USC_ALL= $00000000; /所有定义：参数：返回值：定义：参数：返回值：参数：定义：USC_TI

11、ME= $00000001; /时间:1USC_CONSUMEMODE= $00000002; /消费模式:2USC_ENCRYPTKEY USC_CASHIER USC_REPAST USC_TIMEMODE USC_WARE USC_KEYINFO USC_NAMELIST USC_NAMEMODE USC_USESUBSIDY USC_USEDISCOUNTUSC_CARDTYPE= $00000004; /公司加密值:3= $00000008; /出纳员:4= $00000010; /餐别:5= $00000020; /计时模式:6= $00000040; /商品单价:7= $0000

12、0080; /键值:8= $00000100; /:9= $00000200; /验证方式:10= $00000400; /是否可用补贴:11= $00000800; /是否可用折扣:12= $00001000; /卡类信息:13USC_DEFAULTMONEY = $00002000; /计时模式下默认扣款额:14USC_CANCORRECT= $00004000; /是否开放消费机纠错功能:15USC_LIMITTIMES= $00008000; /总消费次数限:16USC_USECARDTYPES = $00010000; /本机允许哪类卡消费:17USC_MOCTYPEO= $0002

13、0000; /本机类型:18= $00040000; /本机机号:19= $00080000; /小票打印参数:20= $00100000; /小票打印标题:21库返回值定义USC_PRUSC_PRERCFGTITLE详见动态9.上传小票打印参数定义：function fnUplorerConfig(): DWORD; stdcall;参数：无返回值：详见动态库返回值定义10. 取得最后一次脱机的文件名当调用方法fnDownloadOfflineRecord中的Systme节点的LastOfflineFile 项。成功（返回值为 0）时，从 CSC.ini 文件11. 动态SCSCSU库返回值定义S= 0; /没有错误= 50000; /未知的错误= 10001; /打开串口失败SCSCUNKNO