Extensions for Financial Services (XFS) interface specification Release 3.40 - Part 74: Cash-In Module Device Class Interface - Migration from version 3.30 (CWA 16926) to Version 3.40 (this CWA) - Programmer's Reference
金融服务扩展(XFS)接口规范3.40版.第74部分:现金模块设备类接口.从3.30版(CWA 16926)到3.40版(本CWA)的迁移.程序员参考
发布日期:
2020-02-12
实施日期:
2020-02-12
本规范描述了符合XFS的现金收入模块(CIM)服务提供商的功能。它定义了可以使用WFSGetInfo、WFSAsyncGetInfo、WFSExecute和WFSAsyncExecute函数向服务提供者发出的特定于服务的命令。通过断电、打开会话、关闭会话和系统重置来维护持久值。本规范涵盖项目验收。“物品”是指任何可以接受的媒介,包括优惠券、文件、票据和硬币。但是,如果硬币和纸币都被接受,则必须为每个硬币和纸币分别提供服务。本规范中的所有货币参数均表示为最小分配单位数量,如WFS-INF-CIM-currency-EXP命令的说明中所定义。CIM有两种类型:自助CIM和出纳CIM。自助服务CIM在自动化环境中运行,而出纳CIM有操作员在场。以下命令提供的功能仅适用于出纳CIM:WFS_CMD_CIM_SET_TELLER_信息WFS_INF_CIM_SET_TELLER_信息CIM可能是带有现金分发模块(CDM)的复合设备的一部分。此CIMCDM组合在本规范中称为“现金回收器”。有关CDM接口的详细信息,请参见[参考文献3]。如果设备是现金回收器,则如果两个接口上都需要现金单位交换,则不能同时执行交换。一个接口上的交换必须完成(WFS_CMD_CIM_END_exchange必须已完成),然后才能在另一个接口上启动交换。如果未遵循正确的序列,则将返回WFS_ERR_CIM_EXCHANGEACTIVE错误代码。CIM接口可用于现金回收设备上的所有兑换操作,此接口应用于多种货币和/或面额的现金单位(包括与同一面额关联的多个票据标识符)。如果CDM接口上的操作影响可通过CIM接口获得的回收现金单位计数,则将发布WFS_SRVE_CIM_COUNTS_CHANGED事件。CDM接口上的以下命令可能会影响CIM计数:WFS_CMD_CDM_分发WFS U CMD U CDM U出席WFS U CMD U CDM U缩回WFS指令CDM计数WFS_CMD_CDM_拒绝WFS_CMD_CDM_SET_CASH_UNIT_信息世界粮食首脑会议WFS_CMD_CDM_CALIBRATE_CASH_单位WFS_CMD_CDM_重置WFS_CMD_CDM_TEST_CASH_单位XFS3.40被设计为最小化向后兼容性问题。本文档通过突出显示文本的添加和删除,突出显示了在3.30和3.40版本之间对CIM设备类所做的更改。
This specification describes the functionality of an XFS compliant Cash-In Module (CIM) Service Provider. It defines the service-specific commands that can be issued to the Service Provider using the WFSGetInfo, WFSAsyncGetInfo, WFSExecute and WFSAsyncExecute functions.
Persistent values are maintained through power failures, open sessions, close session and system resets.
This specification covers the acceptance of items. An "item" is defined as any media that can be accepted and includes coupons, documents, bills and coins. However, if coins and bills are both to be accepted separate Service Providers must be implemented for each.
All currency parameters in this specification are expressed as a quantity of minimum dispense units, as defined in the description of the WFS_INF_CIM_CURRENCY_EXP command.
There are two types of CIM: Self-Service CIM and Teller CIM. A Self-Service CIM operates in an automated environment, while a Teller CIM has an operator present. The functionality provided by the following commands is only applicable to a Teller CIM:
WFS_CMD_CIM_SET_TELLER_INFO
WFS_INF_CIM_SET_TELLER_INFO
It is possible for the CIM to be part of a compound device with the Cash Dispenser Module (CDM). This CIM\CDM combination is referred to throughout this specification as a “cash recycler”. For details of the CDM interface see [Ref. 3].
If the device is a cash recycler then, if cash unit exchanges are required on both interfaces, the exchanges cannot be performed concurrently. An exchange on one interface must be complete (the WFS_CMD_CIM_END_EXCHANGE must have completed) before an exchange can start on the other interface. The WFS_ERR_CIM_EXCHANGEACTIVE error code will be returned if the correct sequence is not adhered to.
The CIM interface can be used for all exchange operations on cash recycle devices, and this interface should be used for cash units of multiple currencies and/or denominations (including multiple note identifiers associated with the same denomination).
The event WFS_SRVE_CIM_COUNTS_CHANGED will be posted if an operation on the CDM interface affects the recycle cash unit counts which are available through the CIM interface.
The following commands on the CDM interface may affect the CIM counts:
WFS_CMD_CDM_DISPENSE
WFS_CMD_CDM_PRESENT
WFS_CMD_CDM_RETRACT
WFS_CMD_CDM_COUNT
WFS_CMD_CDM_REJECT
WFS_CMD_CDM_SET_CASH_UNIT_INFO
WFS_CMD_CDM_END_EXCHANGE
WFS_CMD_CDM_CALIBRATE_CASH_UNIT
WFS_CMD_CDM_RESET
WFS_CMD_CDM_TEST_CASH_UNITS
XFS 3.40 has been designed to minimize backwards compatibility issues. This document highlights the changes made to the CIM device class between version 3.30 and 3.40, by highlighting the additions and deletions to the text.