WOSA／XFS 3.10 中文版 05

欧洲标准化委员会 专题协定

CWA 15748-9

2008年7月

ICS 35.240.50

中文版

金融服务扩展（XFS）接口说明（3.10版）第九部分：现金取款设备类接口；

程序员参考

此欧洲标准化委员会专题协定（CWA）由相关方代表专题研究组起草并通过，该专题研究组的与会成员在本协定前言部分中列出。

该专题研究组编制本协定的正式会程已经欧洲标准化委员会的各会员国背书，但欧洲标准化委员会的各会员国和欧洲标准化委员会管理中心均不对本CWA的技术性内容或与其他标准或法规可能存在的矛盾负责。

不得以任何形式将本CWA视作由欧洲标准化委员会及其成员编制的正式标准。 本CWA可以公开用作欧洲标准化委员会的会员国标准化组织的参考文件。

欧洲标准化委员会的成员包括下列国家的国家标准化组织：奥地利、比利时、保加利亚、塞浦路斯、捷克共和国、丹麦、爱沙尼亚、芬兰、法国、德国、希腊、匈牙利、冰岛、爱尔兰、意大利、拉脱维亚、立陶宛、卢森堡、马尔他、荷兰、挪威、波兰、葡萄牙、罗马尼亚、斯洛伐克、斯洛文尼亚、西班牙、瑞典、瑞士、和英国。

欧洲标准化委员会

COMITé EUROPéEN DE NORMALISATION EUROP?ISCHES KOMITEE FüR NORMUNG

管理中心地址：布鲁塞尔斯达沙特街36 B-1050（rue de Stassart, 36 B-1050 Brussels）

版权所有? 2008欧洲标准化委员会，为欧洲标准化委员会会员国在全球范围内保留以任何形式和方法进行利用的所有权利。

参考号：CWA 15748-5:2008 D/E/F

Page 2

CWA 15748-5:2008

目录

前言 ...................................................................................................................................................................................... 4

1. 绪论 ................................................................................................................................................................................. 7

1.1 颁布3.10版本的背景 ...................................................................................................................................... 7 1.2 XFS 服务-特殊程序 ........................................................................................................................................... 7

2. 现金取款设备 ................................................................................................................................................................. 8

3. 参考资料 ......................................................................................................................................................................... 9

4. 信息命令 ....................................................................................................................................................................... 10

4.1 WFS_INF_CDM_STATUS ........................................................................................................................... 10 4.2 WFS_INF_CDM_CAPABILITIES ............................................................................................................. 14 4.3 WFS_INF_CDM_CASH_UNIT_INFO ....................................................................................................... 18 4.4 WFS_INF_CDM_TELLER_INFO ............................................................................................................. 25 4.5 WFS_INF_CDM_CURRENCY_EXP ......................................................................................................... 27 4.6 WFS_INF_CDM_MIX_TYPES................................................................................................................... 28 4.7 WFS_INF_CDM_MIX_TABLE .................................................................................................................. 29 4.8 WFS_INF_CDM_PRESENT_STATUS ...................................................................................................... 30

5. 执行命令 ....................................................................................................................................................................... 32

5.1 WFS_CMD_CDM_DENOMINATE ........................................................................................................... 32 5.2 WFS_CMD_CDM_DISPENSE ................................................................................................................... 35 5.3 WFS_CMD_CDM_COUNT......................................................................................................................... 38 5.4 WFS_CMD_CDM_PRESENT..................................................................................................................... 41 5.5 WFS_CMD_CDM_REJECT ....................................................................................................................... 42 5.6 WFS_CMD_CDM_RETRACT ................................................................................................................... 43 5.7 WFS_CMD_CDM_OPEN_SHUTTER ....................................................................................................... 45 5.8 WFS_CMD_CDM_CLOSE_SHUTTER .................................................................................................... 46 5.9 WFS_CMD_CDM_SET_TELLER_INFO ................................................................................................. 47 5.10 WFS_CMD_CDM_SET_CASH_UNIT_INFO .......................................................................................... 48 5.11 WFS_CMD_CDM_START_EXCHANGE ................................................................................................. 50 5.12 WFS_CMD_CDM_END_EXCHANGE...................................................................................................... 52 5.13 WFS_CMD_CDM_OPEN_SAFE_DOOR .................................................................................................. 53 5.14 WFS_CMD_CDM_CALIBRATE_CASH_UNIT ....................................................................................... 54 5.15 WFS_CMD_CDM_SET_MIX_TABLE ...................................................................................................... 56 5.16 WFS_CMD_CDM_RESET .......................................................................................................................... 57 5.17 WFS_CMD_CDM_TEST_CASH_UNITS .................................................................................................. 59 5.18 WFS_CMD_CDM_SET_GUIDANCE_LIGH ........................................................................................... 61 5.19 WFS_CMD_CDM_POWER_SAVE_CONTROL ...................................................................................... 62 5.20 WFS_CMD_CDM_PREPARE_DISPENSE ............................................................................................... 63

Page 3

CWA 15748-5:2008

6. 事件 ............................................................................................................................................................................... 64

6.1 WFS_SRVE_CDM_SAFEDOOROPEN ..................................................................................................... 64 6.2 WFS_SRVE_CDM_SAFEDOORCLOSED ............................................................................................... 65 6.3 WFS_USRE_CDM_CASHUNITTHRESHOLD ........................................................................................ 66 6.4 WFS_SRVE_CDM_CASHUNITINFOCHANGED ................................................................................... 67 6.5 WFS_SRVE_CDM_TELLERINFOCHANGED ....................................................................................... 68 6.6 WFS_EXEE_CDM_DELAYEDDISPENSE ............................................................................................... 69 6.7 WFS_EXEE_CDM_STARTDISPENSE ..................................................................................................... 70 6.8 WFS_EXEE_CDM_CASHUNITERROR .................................................................................................. 71 6.9 WFS_SRVE_CDM_ITEMSTAKEN ........................................................................................................... 72 6.10 WFS_SRVE_CDM_COUNTS_CHANGED ............................................................................................... 73 6.11 WFS_EXEE_CDM_PARTIALDISPENSE ................................................................................................. 74 6.12 WFS_EXEE_CDM_SUBDISPENSEOK .................................................................................................... 75 6.13 WFS_EXEE_CDM_INCOMPLETEDISPENSE ...................................................................................... 76 6.14 WFS_EXEE_CDM_NOTEERROR ............................................................................................................ 77 6.15 WFS_SRVE_CDM_ITEMSPRESENTED ................................................................................................ 78 6.16 WFS_SRVE_CDM_MEDIADETECTED .................................................................................................. 79 6.17 WFS_EXEE_CDM_INPUT_P6 .................................................................................................................. 80 6.18 WFS_SRVE_CDM_DEVICEPOSITION ................................................................................................... 81 6.19 WFS_SRVE_CDM_POWER_SAVE_CHANGE ........................................................................................... 82

7. 单步取款命令流程 ....................................................................................................................................................... 83

8. 钞箱激活规则 ............................................................................................................................................................... 86

9. C-头文件 ........................................................................................................................................................................ 87

Page 4

CWA 15748-5:2008

前言

本CWA是XFS接口说明的3.10版。

欧洲标准化委员会/信息系统标准化委员会（CEN/ISSS）XFS专题研究组召集了供应商、银行和其他金融服务公司参与研讨。可以从CEN/ISSS秘书处获得参与该专题研究组并给予本CWA支持的公司名录。

本CWA于2007年11月29日经XFS专题研究组正式批准通过。欧洲标准化委员会/信息系统标准化委员会（CEN/ISSS）XFS专题研究组将持续对该规范进行评审和提出意见。因此，以后还会适时发行此CWA规范的修订版本，更新版本将取代本3.10版。

发行的CWA由以下多个部分组成：

第1部分：应用程序编程接口（API） – 服务提供程序接口（SPI）–程序员参考 第2部分：服务分类说明–程序员参考

第3部分：打印机和扫描仪设备类接口 – 程序员参考 第4部分：身份证件识别设备类接口 – 程序员参考 第5部分：现金取款设备类接口 – 程序员参考 第6部分：PIN 键盘设备类接口 – 程序员参考

第7部分：支票读取器/扫描设备类接口 – 程序员参考 第8部分：存放设备类接口 – 程序员参考

第9部分：文本终端单元设备类接口 – 程序员参考

第10部分：传感器和指示器单元设备类接口 – 程序员参考 第11部分：由供应商依赖模式设备类接口 – 程序员参考 第12部分：摄像头设备类接口 – 程序员参考 第13部分：报警设备类接口 – 程序员参考

第14部分：信用卡凸字识别单元设备类接口 – 程序员参考 第15部分：现金存入设备类接口 – 程序员参考 第16部分：发卡机设备类接口 – 程序员参考 第17部分：条形码读取设备类接口 – 程序员参考 第18部分：物品处理单元设备类接口 – 程序员参考 第19部分到第28部分：保留将来备用。

第29部分到第47部分是对本CWA的可选补充内容。这些部分定义了SNMP标准和服务提供程序输出统计信息的状态设置的整合。

第29部分：XFS MIB结构和SNMP扩展 – 程序员参考 第30部分：XFS MIB设备专用定义 – 打印机类 第31部分：XFS MIB设备专用定义 – ID卡设备类 第32部分：XFS MIB设备专用定义 – 现金取款设备类 第33部分：XFS MIB设备专用定义 – PIN 键盘设备类

第34部分：XFS MIB设备专用定义 – 支票读取器/扫描设备类 第35部分：XFS MIB设备专用定义 – 存放设备类

第36部分：XFS MIB设备专用定义 – 文本终端单元设备类

第37部分：XFS MIB设备专用定义 – 传感器和指示器单元设备类 第38部分：XFS MIB设备专用定义 – 摄像头设备类 第39部分：XFS MIB设备专用定义 – 报警设备类

第40部分：XFS MIB设备专用定义 – 信用卡凸字识别系统类

Page 5

CWA 15748-5:2008

第41部分：XFS MIB设备专用定义 – 现金存入设备类 第42部分：保留将来备用。

第43部分：XFS MIB设备专用定义 – 供应商依赖模式设备类 第44部分：XFS MIB应用管理

第45部分：XFS MIB设备专用定义 – 发卡机设备类 第46部分：XFS MIB设备专用定义 – 条形码读取设备类 第47部分：XFS MIB设备专用定义 – 物品处理单元设备类 第48部分到第60部分保留将来备用。

第61部分：应用程序编程接口（API） – 服务提供程序接口（SPI） – 3.10版（本CWA）移植3.0版（CWA 14050） –

程序员参考 第62部分：打印机设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第63部分：身份证识别设备类接口 – 3.10版（本CWA）移植3.02版（CWA 14050） – 程序员参考 第64部分：现金取款设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第65部分：PIN键盘设备类接口 – 3.10版（本CWA）移植3.03版（CWA 14050） – 程序员参考 第66部分：支票读取器/扫描设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第67部分：存款设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第68部分：文本终端单元设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第69部分：传感器和指示器单元设备类接口 – 3.10版（本CWA）移植3.01版（CWA 14050） – 程序员参考 第70部分：供应商依赖模式设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第71部分：摄像头设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第72部分：报警设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考

第73部分：信用卡凸字识别设备类接口 – 3.10版（本CWA）移植3.0版（CWA 14050） – 程序员参考 第74部分：现金存入设备类接口 – 3.10版（本CWA）移植3.02版（CWA 14050） – 程序员参考

除了上述程序员参考规范外，本CWA的读者还应参考本文的补充性文件——《版本注释》。《版本注释》包括对CWA规范的解释和说明，而非要求进行功能变更。可以从http://www.cen.eu/isss/Workshop/XFS上找到现行的《版本注释》版本。

该文件中的信息代表该主题研究组截止到发行之日对其所包含的问题的现有见解。仅供参考，可能对其进行更改，恕不另行通知。CEN/ISSS不对该文件做任何明示或默示保证。

本CWA可以公开用作欧洲标准化委员会的会员国标准化组织的参考文件：AENOR、AFNOR、ASRO、BDS、BSI、CSNI、CYS、DIN、DS、ELOT、EVS、IBN、IPQ、IST、LVS、LST、MSA、MSZT、NEN、NSAI、ON、PKN、SEE、SIS、SIST、SFS、SN、SNV、SUTN和UNI。

欢迎用户就CWA提出意见和建议，如有这些意见和建议请联系欧洲标准化委员会管理中心。

Page 31

CWA 15748-5:2008

lpszExtra

指向厂商特有或任何其它扩展信息的一个列表。返回信息为一系列“键=值”字符串以便SP进行轻松扩展。每一个字符串都是以空字符NULL结束的，最后一个字符串以两个空字符NULL结束。一个空列表可通过一个空指针或两个连续的空字符NULL来表示。

错误代码：此命令仅产生定义在[参考一]的一般错误代码。

注释： 无。

Page 32

CWA 15748-5:2008

5. 执行命令

5.1 WFS_CMD_CDM_DENOMINATE

描述： 此命令提供一个面额。面额所指定的数目需要依靠每个钞箱的支持来满足。面额取决于货币，混合算法及提

供面额的任何部分都要被应用程序支持。

此命令也被用于确认应用程序可以分配的任何有效面额。

如果不同的币种拥有相同的面额，货币名必须为一个三ASCII 0x20h 字符的数组，总额必须为零，而且混合数必须为WFS_CDM_INDIVIDUAL。然而，此约定并不被应用在单币种或非货币的情况下，例如息票。 如果WFS_INF_CDM_CAPABILITIES命令返回的结构体WFSCDMCAPS中的bCashBox值为TRUE，假设全部面额不能被满足，那么将返回部分面额，缺少的面额由现金盒来提供。

此命令被使用于四个不同的情况：

1． 为了检查是否能够分配特定的面额，命令输入的参数为币种和面额，混合算法为WFS_CDM_INDIVIDUAL，

总额为零。如果不同的币种被分配，货币名必须为一个三ASCII 0x20h 字符的数组。

2． 为了使特定总额，特定面额和可能分配的面额有效。命令输入的参数为总额，币种和面额，混合算法为

WFS_CDM_INDIVIDUAL。

3． 为了获得特定金额的面额，输入的参数必须有总额，币种和混合数。

4． 为了完成特定金额的部分面额，输入参数必须有币种，总额，混合数和特定面额部分或现金盒最小金额

中的一个，完成的面额被返回。此命令执行后，面额结构中的ulCashBox参数将被修改。

输入参数： LPWFSCDMDENOMINATE lpDenominate;

typedef struct _wfs_cdm_denominate {

USHORT usTellerID; USHORT usMixNumber; LPWFSCDMDENOMINATION lpDenomination; } WFSCDMDENOMINATE, *LPWFSCDMDENOMINATE;

usTellerID

识别柜员机。如果设备是自助服务CDM，参数将被忽略。

usMixNumber

混合算法或隐藏结构表被使用。

lpDenomination

指向一个WFSCDMDENOMINATION结构体，描述操作面额的上下文信息。

typedef struct _wfs_cdm_denomination

{

CHAR cCurrencyID[3]; ULONG ulAmount; USHORT usCount; LPULONG lpulValues; ULONG ulCashBox;

} WFSCDMDENOMINATION, *LPWFSCDMDENOMINATION;

输出参数：

错误代码：

Page 33

CWA 15748-5:2008

cCurrencyID

识别币种，符合ISO格式[参考二].如果面额包含多种币种，此参数将被设置为三个ASCII 0x20h的字符数组。

ulAmount

被定义或分配的总额。如果面额包含多种币种，此参数为零。 usCount

lpulValues链表的大小，此参数和最后的WFS_INF_CDM_CASH_UNIT_INFO命令所返回的usCount值相同，或者可以被WFS_CMD_CDM_SET_CASH_UNIT_INFO或WFS_CMD_CDM_END_EXCHANGE命令所设置。如果混合算法被使用，此参数不是必要的且被设置为零。

如果应用程序被设置为有效的usCount，SP将返回WFS_ERR_INVALID_DATA。

lpulValues

指向一个ULONG型数组。此链表指定从每个钞箱提取的钞币数。此链表同样与WFS_INF_CDM_CASH_UNIT_INFO命令返回的钞箱结构数组一致，或者可以被

WFS_CMD_CDM_SET_CASH_UNIT_INFO或WFS_CMD_CDM_END_EXCHANGE命令所设置。数组的第一个值与

钞箱结构索引为1的相关联。

数组包含每个可能的钞箱。如果钞箱在面额中不是必须的，数组相关的值应该被设置为零。 如果应用程序不需要特定的面额，lpulValues指针将为NULL。

ulCashBox

仅使用于柜员机CDM设备。柜员机现金盒所需支付的总额。

LPWFSCDMDENOMINATION lpDenomination; 相关描述参照输入结构。

混合币种被定义时，面额结构里的ulAmount参数将为零且cCurrency的值被设置成为三个ASCII为0x20h的字符。

除了定义在[参考一]的一般错误代码外，下列错误代码可能产生： 值

涵义

WFS_ERR_CDM_INVALIDCURRENCY 在CDM的钞箱中，无法找到cCurrency参数所对应的币种

WFS_ERR_CDM_INVALIDTELLERID 无效柜员机ID。此错误不会在自助服务CDM中产生

WFS_ERR_CDM_CASHUNITERROR 钞箱的问题。WFS_EXEE_CDM_CASHUNIT -ERROR事件被发送，描述此详细信息。 WFS_ERR_CDM_ usMixNumber参数为WFS_CDM_INDIVIDUAL并且INVALIDDENOMINATION

ulCashBox的值和lpulValues所指定的钞币与特定的非零总额不匹配。此错误代码不出现在特定总额为零的情况下。

WFS_ERR_CDM_INVALIDMIXNUMBER 未知的混合算法。

WFS_ERR_CDM_NOCURRENCYMIX 面额中被指定的钞箱不是相同币种。 WFS_ERR_CDM_NOTDISPENSABLE CDM无法分配此总额。 WFS_ERR_CDM_TOOMANYITEMS

请求了过多的被分配项。

Page 34

CWA 15748-5:2008

WFS_ERR_CDM_EXCHANGEACTIVE CDM处于激活状态中。

(参考WFS_CMD_CDM_START_EXCHANGE)

WFS_ERR_CDM_NOCASHBOXPRESENT

事件：

柜员机无法指派足够的现金盒。

WFS_ERR_CDM_AMOUNTNOTINMIXTABLE 无法在混合表中找到此特定金额。 除了定义在[参考一]的一般事件外，下列事件也可能产生： 值

WFS_EXEE_CDM_CASHUNITERROR

注释：

无。

涵义

一个错误在钞箱尝试面额事件中发生

Page 35

CWA 15748-5:2008

5.2 WFS_CMD_CDM_DISPENSE

描述： 此命令执行分配钞币给客户。此命令提供与WFS_CMD_CDM_DENOMINATE命令相同的钞币分配附加能力。如果

不同的币种钞币被分配，货币名必须是三个ASCII 0x20h的字符，总额必须是零，混合算法必须是WFS_CDM_INDIVIDUAL。然而，此约定并不被应用在单币种或非货币的情况下，例如息票。

此命令被使用于下列情况：

1． 输入参数为总额，币种和面额。混合算法为WFS_CDM_INDIVIDUAL。因此，如果确

定为有效面额，可以被分配。

2． 输入参数为总额，币种和面额。因此，总额的定义如果成功，可以被分配。

3． 如果总额为零，币种和面额被混合算法WFS_CDM_INDIVIDUAL所支持并有效，可以被分配。

4． 命令将计算特定金额的部分面额，并且完成面额的分配。因次，命令的输入参数应该有币种，总额，混

合算法和部分特定面额或现金盒最小金额中的一个。此命令完成后，现金盒金额可能改变。 当多个物理钞箱对应一个逻辑钞箱时，设备选择当前钞箱进行分配操作。

如果WFS_INF_CDM_CAPABILITIES命令所返回的WFSCDMCAPS结构体中的bCashBox参数为TRUE，假设全部面额不能被满足，那么将返回部分面额，缺少的面额由现金盒提供。

如果设备是柜员机CDM，输入的usPosition参数可以是WFS_CDM_POSNULL。在此情况，usTellerID参数将提供分配操作的柜员机分配位置。

WFSCDMDISPENSE结构体中的bPresent参数定义为分配操作中是否已经呈现给客户的部分。如果此参数为TRUE，钞币将被移动到通道中，否则钞币将会被移动到暂存。第二种情况，参数将在WFS_CMD_CDM_PRESENT命令中分配钞币给客户时被使用。如果bPresent参数为FALSE，thefwPosition参数将无效。如果CDM没有暂存，bPresent参数无效。

输入参数： LPWFSCDMDISPENSE lpDispense;

typedef struct _wfs_cdm_dispense {

USHORT usTellerID; USHORT usMixNumber; WORD fwPosition; BOOL bPresent;

LPWFSCDMDENOMINATION lpDenomination; } WFSCDMDISPENSE, *LPWFSCDMDISPENSE;

usTellerID

定义柜员机。当设备为自助服务CDM时，参数无效。

usMixNumber

混合算法和隐藏混合表被使用于建立支持总额的面额。如果参数值为WFS_CDM_

INDIVIDUAL，被lpDenomination值支持的有效面额优先进行分配操作。如果找到的是无效的，没选择的面额将会被计算。

Page 36

CWA 15748-5:2008

输出参数：

错误代码：

fwPosition

定义金额从哪个位置被分配。如果设备为自助CDM此参数无效，这时，输出位将和usTellerID参数相关。此参数可能为下列特定值： 值

涵义

WFS_CDM_POSNULL 默认配置信息被使用。可能是随即位或由柜员机自己决定。

WFS_CDM_POSLEFT 呈现钞币到设备的左边位置 WFS_CDM_POSRIGHT 呈现钞币到设备的右边位置 WFS_CDM_POSCENTER 呈现钞币到设备的中间位置 WFS_CDM_POSTOP 呈现钞币到设备的上面位置 WFS_CDM_POSBOTTOM 呈现钞币到设备的下面位置 WFS_CDM_POSFRONT 呈现钞币到设备的前面位置 WFS_CDM_POSREAR 呈现钞币到设备的后面位置

bPresent

如果参数为TRUE，钞币将被移动到退出位置。否则，钞币将会被移动到暂存。

lpDenomination

指向WFSCDMDENOMINATION结构体，此结构体将描述分配动作中被使用的面额信息。关于WFSCDMDENOMINATION结构体的更多信息请参考WFS_CMD_CDM_DENOMINATE命令中的定义。

LPWFSCDMDENOMINATION lpDenomination;

关于WFSCDMDENOMINATION结构体的更多信息请参考WFS_CMD_CDM_DENOMINATE命令中的定义。

此结构体的值显示为分配总额和每个钞箱的分配钞币数。

混合币种被分配时，面额结构里的ulAmount参数将为零且cCurrency的值被设置成为三个ASCII为0x20h的字符。

除了定义在[参考一]的一般错误代码外，下列错误代码可能产生：

值

涵义

WFS_ERR_CDM_INVALIDCURRENCY 在CDM的钞箱中，无法找到cCurrency参数所对应的币种

WFS_ERR_CDM_INVALIDTELLERID 无效柜员机ID。此错误不会在自助服务CDM中产生

WFS_ERR_CDM_CASHUNITERROR

钞箱的问题。WFS_EXEE_CDM_CASHUNIT -ERROR事件被发送，描述此详细信息。

WFS_ERR_CDM_INVALIDDENOMINATION 现金盒与钞箱值的总数多余指定的金额 WFS_ERR_CDM_INVALIDMIXNUMBER 未知的混合算法。

WFS_ERR_CDM_NOCURRENCYMIX 钞箱中包含两个或更多的不同币种被选择 WFS_ERR_CDM_NOTDISPENSABLE CDM无法分配此总额。

WFS_ERR_CDM_TOOMANYITEMS 请求了过多的被分配项。此错误一般也出现在bPresent为FALSE时候单步取款动作的请求 WFS_ERR_CDM_UNSUPPOSITION 指定的输出位置不被支持

WFS_ERR_CDM_SAFEDOOROPEN

保险箱是打开的。为了完成此次操作，设备需要保险箱是关闭的。 Page 37

CWA 15748-5:2008

WFS_ERR_CDM_EXCHANGEACTIVE WFS_ERR_CDM_NOCASHBOXPRESENT WFS_ERR_CDM_ITEMSNOTTAKEN WFS_ERR_CDM_ITEMSLEFT

CDM处于激活状态中。

柜员机无法指派足够的现金盒。

在单步取款动作时钞币未被取走，此错误出现在硬件操时情况

由于优先分配，呈现或回收存款操作的结果，钞币被留在传输通道或出口位置

WFS_ERR_CDM_AMOUNTNOTINMIXTABLE 混合表无法找到此特定金额。

如果WFSCDMDISPENSE结构体中的bPresent参数值为TRUE，下列错误也可能产生： 值

涵义 呈现。

WFS_ERR_CDM_SHUTTEROPEN

需要关闭时，钞门依旧开着。没有钞币呈现。 呈现。

WFS_ERR_CDM_PRERRORITEMS

错误发生在钞币应该被移动到出口位时，至少有一些钞币没有呈现。

WFS_ERR_CDM_PRERRORUNKNOWN 错误发生在钞币应该被移动到出口位时，钞币的位

置未知。可能需要介入现金总额统计进行调解。

WFS_ERR_CDM_PRERRORNOITEMS 错误发生在钞币应该被移动到出口位时，没有钞币WFS_ERR_CDM_SHUTTERNOTOPEN 在需要的时候，钞门没有打开或打不开。没有钞币

事件：

除了定义在[参考一]的一般事件外，下列事件也可能产生： 值

WFS_USRE_CDM_CASHUNITTHRESHOLD WFS_EXEE_CDM_DELAYEDDISPENSE WFS_EXEE_CDM_STARTDISPENSE WFS_EXEE_CDM_CASHUNITERROR WFS_SRVE_CDM_ITEMSTAKEN WFS_EXEE_CDM_PARTIALDISPENSE WFS_EXEE_CDM_SUBDISPENSEOK

涵义

一个钞箱已经达到阈值情况 分配操作在指定时间之前被延时 分配操作开始延时时被触发 钞箱因为分配操作而产生一个错误

用户移动了呈现钞币。如果取款不是单步取款，事件将在取款动作完成后触发。 显示分配动作被服务单部分配操作分开 单步取款操作成功完成

论此面额处于暂存或被客户取走，都将反回WFS_ERR_CDM_NOTDISPENSABLE错误代码。

WFS_EXEE_CDM_NOTEERROR WFS_EXEE_CDM_INPUT_P6

注释：

无。

一个钞币发现错误已经发生。

ECB6 水平2和/或水平3的纸币已被发现。

WFS_EXEE_CDM_INCOMPLETEDISPENSE 无法分配完整的面额，仅能分配部分面额，无

Page 38

CWA 15748-5:2008

5.3 WFS_CMD_CDM_COUNT

描述： 此命令将清空物理钞箱。钞箱的所有钞币都将被分配和移动到指定输出位置。

CDM能够侦测到的钞币分配数和钞币记录数可能不同。如果CDM无法区别钞币分配数和钞币记录数，那么，ulDispensed参数将会和ulCounted参数相同。

如果WFS_CMD_CDM_COUNT命令执行成功，物理钞箱WFSCDMPHCU结构体的ulCount参数将被重置。

输入参数： LPWFSCDMPHYSICALCU lpPhysicalCU;

typedef struct _wfs_cdm_physical_cu {

BOOL bEmptyAll; WORD fwPosition;

LPSTR lpPhysicalPositionName; } WFSCDMPHYSICALCU, *LPWFSCDMPHYSICALCU;

输出参数：

{ LPSTR lpPhysicalPositionName; CHAR cUnitId[5]; ULONG ulDispensed; ULONG ulCounted; USHORT usPStatus;

} WFSCDMCOUNTEDPHYSCU, *LPWFSCDMCOUNTEDPHYSCU;

bEmptyAll

指定是否所有的物理钞箱都被清空。如果此参数为TRUE，lpPhysicalPositionName参数将无效。 fwPosition

指定本地的哪些钞币将被移动。参数可能是下列值之一： 值

涵义

WFS_CDM_POSNULL 输出位置由SP决定

WFS_CDM_POSLEFT 呈现钞币到设备的左边位置 WFS_CDM_POSRIGHT 呈现钞币到设备的右边位置 WFS_CDM_POSCENTER 呈现钞币到设备的中间位置 WFS_CDM_POSTOP 呈现钞币到设备的上面位置 WFS_CDM_POSBOTTOM 呈现钞币到设备的下面位置 WFS_CDM_POSFRONT 呈现钞币到设备的前面位置 WFS_CDM_POSREAR 呈现钞币到设备的后面位置 WFS_CDM_POSREJECT 拒绝使用输出位置

lpPhysicalPositionName

设定哪一个物理钞箱将被清空计数。此参数在WFSCDMPHCU结构体中的具有详细说明。

LPWFSCDMCOUNT lpCount; typedef struct _wfs_cdm_count

{ USHORT usNumPhysicalCUs;

LPWFSCDMCOUNTEDPHYSCU *lppCountedPhysCUs; } WFSCDMCOUNT, *LPWFSCDMCOUNT; usNumPhysicalCUs

参数指定返回的物理钞箱结构(WFSCDMCOUNTEDPHYSCU)的数字。参数值总是大于1。 lppCountedPhysCUs 指向一个WFSCDMCOUNTEDPHYSCU结构体的数组。 typedef struct _wfs_cdm_counted_phys_cu

错误代码：

事件：

Page 39

CWA 15748-5:2008

lpPhysicalPositionName

设定哪一个物理钞箱将被清空计数。此参数在WFSCDMPHCU结构体中的具有详细说明。 cUnitID

钞箱ID。此参数是WFSCDMPHCU结构体中用于定义的标识。

ulDispensed

在清空钞箱时被分配的钞币数。

ulCounted

在清空钞箱时被记录的钞币数。

usPStatus

提供物理钞箱的状态。可能是下列值之一： 值

涵义

WFS_CDM_STATCUOK 钞箱状态良好 WFS_CDM_STATCUFULL 钞箱已满

WFS_CDM_STATCUHIGH 钞箱将满(即达到或超过了WFSCDMCASH -UNIT 结构体中定义的ulMaximum阈值) WFS_CDM_STATCULOW 钞箱将空 WFS_CDM_STATCUEMPTY 钞箱已空 WFS_CDM_STATCUINOP 无效的钞箱 WFS_CDM_STATCUMISSING 没有钞箱

WFS_CDM_STATCUNOVAL 设定钞箱的值无效 WFS_CDM_STATCUNOREF 钞箱注释无参考值可用

WFS_CDM_STATCUMANIP

设备不处于激活状态时，钞箱被插入(包括更换)。此钞箱不能做分配动作

除了定义在[参考一]的一般错误代码外，下列错误代码可能产生：

值

涵义

WFS_ERR_CDM_CASHUNITERROR 钞箱的问题。WFS_EXEE_CDM_CASHUNIT -ERROR事件被发送，描述此详细信息。 WFS_ERR_CDM_UNSUPPOSITION 指定位置不被支持。

WFS_ERR_CDM_SAFEDOOROPEN

保险箱是打开的。为了完成此次操作，设备需要保险箱是关闭的。

WFS_ERR_CDM_EXCHANGEACTIVE CDM服务处于激活状态中

除了定义在[参考一]的一般事件外，下列事件也可能产生： 值

涵义

WFS_EXEE_CDM_CASHUNITERROR 钞箱因为记录操作而产生一个错误 WFS_SRVE_CDM_ITEMSTAKEN

腾空到输出位置上的钞币已经被用户取走 WFS_SRVE_CDM_ITEMSPRESENTED 钞币已经被腾空到输出位置。继续操作前，这

些钞币可能需要从输出位上移走。

WFS_EXEE_CDM_NOTEERROR 一个钞币发现错误已经发生。

WFS_EXEE_CDM_INPUT_P6

ECB6 水平2和/或水平3的纸币已被发现。

Page 40

CWA 15748-5:2008

注释：

无。

本文来源：https://www.bwwdw.com/article/h2y6.html