XFS接口规范3.10版-现金存入模块程序员参考

wosa

需积分: 9 39 浏览量更新于2024-07-18 收藏 566KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

"CWA15748-15:2008D/E/F，XFS接口规范，Release 3.10，第15部分：现金存入模块设备类接口，程序员参考" 《WOSA 3.1 存款模块标准》是基于欧洲标准化委员会（CEN）制定的Extensions for Financial Services (XFS) 接口规范的第15部分，主要关注的是现金存入模块的设备类接口。这个规范版本为Release 3.10，适用于金融服务业，特别是自动柜员机（ATM）和其他自助服务终端的现金管理。 XFS接口规范是一种开放标准，旨在促进硬件设备（如现金存取模块）与软件应用程序之间的互操作性。它定义了不同设备类别的通用接口，使第三方开发者能够编写与各种硬件设备兼容的应用程序，无需关心底层硬件的具体实现。XFS接口通过抽象化硬件操作，降低了系统集成的复杂性和成本。在Release 3.10的现金存入模块（Cash-In Module，CIM）部分，标准详细描述了设备如何接收、验证和处理现金存款的过程。这包括但不限于以下几个关键知识点： 1. **设备控制层（Device Control Layer）**：这是XFS接口的基础，定义了软件与硬件设备之间的通信协议，包括命令集、状态报告和错误处理机制。 2. **服务访问点（Service Access Point, SAP）**：SAP是软件应用与特定设备服务交互的接口，例如存款服务。 3. **事件通知系统**：用于设备状态变化时，如现金存款完成、存款异常或设备故障等，向应用程序发送实时更新。 4. **安全性机制**：确保存款过程的安全性，可能涉及加密、认证和授权过程，以防止欺诈和未经授权的存取款。 5. **现金识别与计数**：描述了设备如何识别纸币的面额和真伪，并准确计数存入的金额。 6. **错误处理和恢复**：规定了设备在遇到问题时如何报告错误，以及软件如何引导设备进行故障恢复。 7. **兼容性与互操作性**：确保不同制造商的CIM设备能与多种软件平台无缝对接。 8. **程序员认证**：提供给开发人员的详细指南，帮助他们理解和实现XFS接口，以创建符合标准的软件解决方案。此CEN工作坊协议（CWA）虽然不作为正式的国家标准，但已被CEN的国家成员认可。它代表了行业内感兴趣各方的共识，可以作为开发符合标准且兼容现有法规的金融设备软件的重要参考。《WOSA 3.1 存款模块标准》是金融自助服务技术领域的重要文档，它促进了硬件与软件的解耦，提升了整个系统的灵活性和可靠性。理解并遵循这个标准对于设计和开发高效、安全的现金存入解决方案至关重要。

资源详情

资源推荐

Page 16

CWA 15748-15:2008

bSafeDoor

Specifies whether the WFS_CMD_CIM_OPEN_SAFE_DOOR command is supported.

bCashBox

This field is only applicable to CIM types WFS_CIM_TELLERBILL and

WFS_CIM_TELLERCOIN. It specifies whether or not the tellers have been assigned a cash box.

bRefill

This field is not used.

fwIntermediateStacker

Specifies the number of items the intermediate stacker for cash-in can hold. Zero means that there

is no intermediate stacker for cash-in available.

bItemsTakenSensor

Specifies whether or not the CIM can detect when items at the exit position are taken by the user.

If set to TRUE the Service Provider generates an accompanying

WFS_SRVE_CIM_ITEMSTAKEN event. If set to FALSE this event is not generated. This field

relates to all output positions.

bItemsInsertedSensor

Specifies whether the CIM has the ability to detect when items have actually been inserted by the

user. If set to TRUE the Service Provider generates an accompanying

WFS_SRVE_CIM_ITEMSINSERTED event. If set to FALSE this event is not generated. This

field relates to all input positions. This flag should not be reported as TRUE unless item insertion

can be detected.

fwPositions

Specifies the CIM input and output positions which are available as a combination of the

following flags:

Value Meaning

WFS_CIM_POSINLEFT Left input position.

WFS_CIM_POSINRIGHT Right input position.

WFS_CIM_POSINCENTER Center input position.

WFS_CIM_POSINTOP Top input position.

WFS_CIM_POSINBOTTOM Bottom input position.

WFS_CIM_POSINFRONT Front input position.

WFS_CIM_POSINREAR Rear input position.

WFS_CIM_POSOUTLEFT Left output position.

WFS_CIM_POSOUTRIGHT Right output position.

WFS_CIM_POSOUTCENTER Center output position.

WFS_CIM_POSOUTTOP Top output position.

WFS_CIM_POSOUTBOTTOM Bottom output position.

WFS_CIM_POSOUTFRONT Front output position.

WFS_CIM_POSOUTREAR Rear output position.

fwExchangeType

Specifies the type of cash unit exchange operations supported by the CIM. Values are a

combination of the following flags:

Value Meaning

WFS_CIM_EXBYHAND The CIM supports manual replenishment

either by emptying the cash unit by hand or

by replacing the cash unit.

WFS_CIM_EXTOCASSETTES The CIM supports moving items from the

replenishment cash unit to the bill cash units.

WFS_CIM_CLEARRECYCLER The CIM supports the emptying of recycle

cash units.

WFS_CIM_DEPOSITINTO The CIM supports moving items from the

deposit entrance to the bill cash units.

fwRetractAreas

Specifies the areas to which items may be retracted. This field will be set to a combination of the

following flags:

Page 17

CWA 15748-15:2008

Value Meaning

WFS_CIM_RA_RETRACT Items may be retracted to the retract cash

unit.

WFS_CIM_RA_REJECT Items may be retracted to the reject cash

unit.

WFS_CIM_RA_TRANSPORT Items may be retracted to the transport.

WFS_CIM_RA_STACKER Items may be retracted to the intermediate

stacker.

WFS_CIM_RA_BILLCASSETTES Items may be retracted to item cassettes, i.e.

cash-in and recycle cash units.

WFS_CIM_RA_NOTSUPP The CIM does not have the ability to retract.

fwRetractTransportActions

Specifies the actions which may be performed on items which have been retracted to the

transport. This field will be one of the following values:

Value Meaning

WFS_CIM_RETRACT The items may be retracted to a retract cash

unit.

WFS_CIM_REJECT The items may be retracted to a reject cash

unit.

WFS_CIM_NOTSUPP The CIM does not have the ability to retract

from the transport.

fwRetractStackerActions

Specifies the actions which may be performed on items which have been retracted to the stacker.

If the device does not have a retract capability this field will be WFS_CIM_NOTSUPP.

Otherwise this field will be set to one of the following values:

Value Meaning

WFS_CIM_PRESENT The items may be moved to the exit position.

WFS_CIM_RETRACT The items may be retracted to a retract cash

unit.

WFS_CIM_REJECT The items may be retracted to a reject cash

unit.

WFS_CIM_NOTSUPP The CIM does not have the ability to retract

from the stacker.

lpszExtra

Pointer to a list of vendor-specific, or any other extended, information. The information is

returned as a series of “key=value” strings so that it is easily extensible by Service Providers.

Each string is null-terminated, with the final string terminating with two null characters. An

empty list may be indicated by either a NULL pointer or a pointer to two consecutive null

characters.

The parameter for paragraph 6 handling [Ref. 4] is reported in lpszExtra as follows:

P6=1 paragraph 6 handling and only level 2 notes

will not be returned to the customer in a

cash-in transaction.

P6=2 paragraph 6 handling and level 2 and level 3

notes will not be returned to the customer in

a cash-in transaction.

dwGuidLights [...]

Specifies which guidance light positions are available. A number of guidance light positions are

defined below. Vendor specific guidance lights are defined starting from the end of the array. The

maximum guidance light index is WFS_CIM_GUIDLIGHTS_MAX.

The elements of this array are specified as a combination of the following flags and indicate all of

the possible flash rates (type B) and colors (type C) that the guidance light indicator is capable of

handling. If the guidance light indicator only supports one color then no value of type C is

returned. A value of WFS_CIM_GUIDANCE_NOT_AVAILABLE indicates that the device has

no guidance light indicator or the device controls the light directly with no application control

possible.

Page 18

CWA 15748-15:2008

Value Meaning Type

WFS_CIM_GUIDANCE_NOT_AVAILABLE There is no guidance light control A

available at this position.

WFS_CIM_GUIDANCE_OFF The light can be off. B

WFS_CIM_GUIDANCE_SLOW_FLASH The light can blink slowly. B

WFS_CIM_GUIDANCE_MEDIUM_FLASH The light can blink medium B

frequency.

WFS_CIM_GUIDANCE_QUICK_FLASH The light can blink quickly. B

WFS_CIM_GUIDANCE_CONTINUOUS The light can be continuous B

(steady).

WFS_CIM_GUIDANCE_RED The light can be red. C

WFS_CIM_GUIDANCE_GREEN The light can be green. C

WFS_CIM_GUIDANCE_YELLOW The light can be yellow. C

WFS_CIM_GUIDANCE_BLUE The light can be blue. C

WFS_CIM_GUIDANCE_CYAN The light can be cyan. C

WFS_CIM_GUIDANCE_MAGENTA The light can be magenta. C

WFS_CIM_GUIDANCE_WHITE The light can be white. C

Each array index represents an input/output position in the CIM. The elements are accessed using

the following definitions for the index value:

Value Meaning

WFS_CIM_GUIDANCE_POSINNULL The default input position.

WFS_CIM_GUIDANCE_POSINLEFT Left input position.

WFS_CIM_GUIDANCE_POSINRIGHT Right input position.

WFS_CIM_GUIDANCE_POSINCENTER Center input position.

WFS_CIM_GUIDANCE_POSINTOP Top input position.

WFS_CIM_GUIDANCE_POSINBOTTOM Bottom input position.

WFS_CIM_GUIDANCE_POSINFRONT Front input position.

WFS_CIM_GUIDANCE_POSINREAR Rear input position.

WFS_CIM_GUIDANCE_POSOUTLEFT Left output position.

WFS_CIM_GUIDANCE_POSOUTRIGHT Right output position.

WFS_CIM_GUIDANCE_POSOUTCENTER Center output position.

WFS_CIM_GUIDANCE_POSOUTTOP Top output position.

WFS_CIM_GUIDANCE_POSOUTBOTTOM Bottom output position.

WFS_CIM_GUIDANCE_POSOUTFRONT Front output position.

WFS_CIM_GUIDANCE_POSOUTREAR Rear output position.

WFS_CIM_GUIDANCE_POSOUTNULL The default output position.

dwItemInfoTypes

Specifies the types of information that can be retrieved through the

WFS_INF_CIM_GET_ITEM_INFO command as a combination of the following flags:

Value Meaning

WFS_CIM_ITEM_SERIALNUMBER Serial Number of the item.

WFS_CIM_ITEM_SIGNATURE P6 Signature of the item.

bCompareSignatures

Specifies if the Service Provider has the ability to compare signatures through

WFS_CMD_CIM_COMPARE_P6_SIGNATURE. If this field is set to FALSE, the

WFS_CMD_CIM_COMPARE_P6_SIGNATURE returns WFS_ERR_UNSUPP_COMMAND.

bPowerSaveControl

Specifies whether power saving control is available. This can either be TRUE if available or

FALSE if not available.

Error Codes Only the generic error codes defined in [Ref. 1] can be generated by this command.

Comments Applications which rely on the lpszExtra parameter may not be device or vendor-independent.

Page 19

CWA 15748-15:2008

4.3 WFS_INF_CIM_CASH_UNIT_INFO

Description This command is used to obtain information about the status and contents of the cash-in units and

recycle units in the CIM.

Where a logical cash-in unit or recycle unit is configured but there is no corresponding physical

cash unit currently present in the device, information about the missing cash-in unit or recycle

unit will still be returned in the lppCashIn field of the output parameter. The status of the cash-in

unit or recycle unit will be reported as WFS_CIM_STATCUMISSING.

It is possible that one logical cash-in unit or recycle unit may be associated with more than one

physical cash unit. In this case, the number of cash unit structures returned in lpCashInfo will

reflect the number of logical cash-in units or recycle units in the CIM. That is, if a system

contains four physical cash-in units but two of these are treated as one logical cash-in unit,

lpCashInfo will contain information about the three logical cash-in units and a usCount of 3.

Information about the physical cash-in unit(s) or recycle unit(s) associated with a logical cash-in

unit or recycle unit is contained in the WFSCIMCASHUNIT structure representing the logical

cash-in unit or recycle unit.

It is also possible that multiple logical cash-in units or recycle units may be associated with one

physical cash unit. This should only occur if the physical cash unit is capable of handling this

situation, i.e. if it can store multiple denominations and report meaningful count and

replenishment information for each denomination. In this case the information returned in

lpCashInfo will again reflect the number of logical cash-in units or recycle units in the CIM.

Counts

Item counts are typically based on software counts and therefore may not represent the actual

number of items in the cash unit.

Persistent values are maintained through power failures, open sessions, close session and system

resets.

If a cash unit is shared between the CDM and CIM device class, then CDM operations will result

in count changes in the CIM cash unit structure and vice versa. All counts are reported

consistently on both interfaces at all times.

Threshold Events

The threshold event, WFS_USRE_CIM_CASHUNITTHRESHOLD

(WFS_CIM_STATCUHIGH), can be triggered either by hardware sensors in the device or by the

ulCount reaching the ulMaximum value.

The application can check if the device has this capability by querying the bHardwareSensors

field of the physical cash unit structure. If any of the physical cash units associated with the

logical cash unit have this capability, then threshold events based on hardware sensors may be

triggered.

In the situation where the cash unit is associated with multiple physical cash units.

WFS_SRVE_CIM_CASHUNITINFOCHANGED can be generated when each of the physical

cash units reaches the threshold. When the final physical cash unit reaches the threshold, the

WFS_USRE_CIM_CASHUNITTHRESHOLD (WFS_CIM_STATCUHIGH), event will be

generated.

Exchanges

If a physical cash unit is inserted (including removal followed by a reinsertion) when the device is

not in the exchange state the usPStatus of the physical cash unit will be set to

WFS_CIM_STATCUMANIP and the values of the physical cash unit prior to its’ removal will be

returned in any subsequent WFS_INF_CIM_CASH_UNIT_INFO command. The physical cash

unit will not be used in any operation. The application must perform an exchange operation

specifying the new values for the physical cash unit in order to recover the situation.

On recycling and retract units the counts and status reflect the physical status of the cassette and

therefore are consistently reported on both the CDM and CIM interfaces. When a value is

changed through an exchange on one interface it is also changed on the other.

Recyclers

The CIM interface reports all cash units including cash-out only cash units. The CDM interface

does not report cash-in only cash units but does report cash units used on both interfaces, i.e.

剩余111页未读，继续阅读

weixin_43131970

粉丝: 0
资源: 1

XFS接口规范3.10版-现金存入模块程序员参考

WOSA标准开发环境

wosa标准

金融行业WOSA 3.1接口规范

wosa xfs3.2协议

wosa/xfs 3.30

WOSA框架详细介绍

wosa 测试工具 3.20

wosa wincor

wosa3.2英文原版（全）

常用wosa模块文档中文版

WOSA3.1全部资料

WOSA3.0标准错误码

wosa3.1接口规范

Wosa3.1文档.rar

Wosa标准文档中文版

WOSA规范，XFS3.1规范中文版

wosa3.1标准中文版

WOSA规范、XFS3.1规范的库文件和头文件

wosa标准（英文版）全

WOSA/XFS 3.30 标准文档

最新资源