Please enable JavaScript to view this site.

CWT Software Configuration Handbook 4.40

Navigation: Reference Guide CWTCONFIG.XML

PAYUNITACCOUNT element

Scroll Prev Top Next More

Element        Path: <cwt><PAYUNITACCOUNT>

rebootWhen this element is added or removed

The PAYUNITACCOUNT element is used to define how much money a pay unit can hold before it needs to be collected. A coin box, for instance, can hold a certain number of coins before the box is considered full. With the PAYUNITACCOUNT element, it is possible to specify how many coins or bills fit in the pay unit box, and the maximum amount that is allowed in the pay unit before the terminal sets the pay unit in partial error mode. A pay unit collection must then be performed to recover from the partial error mode on the pay unit.

Note:
This element must be defined for each cash pay unit that requires collection.
If values should be changed or added, a collection MUST be done prior to using the new attributes. Otherwise, the CWT freezes in the “Initializing” process on start-up.

attributes

balanceTicketId

Value:0–4294967295
Default:
Description:Defines the ticket that shall be printed when balance of the pay unit is requested. The default ticket will be used if this attribute is not defined.

collectionHistory

Value:0-65535
Default:10
Description:Number of collections stored

Note: When updating the CWT app to version 3.2.x the Collection ID is reset to zero

collectionHistoryTicketId

Value:0–4294967295
Default:
Description:Defines the ticket that shall be printed when collection history is requested on this pay unit. The default ticket will be used if this attribute is not defined.

collectionTicketId

Value:0–4294967295
Default:
Description:Defines the ticket that shall be issued for a collection on this pay unit. The default ticket will be used if this attribute is not defined.

Note: When updating the CWT app to version 3.2.x the Collection ID is reset to zero

collectionTrigger

Value:CoinBox , BillStacker, None
Default:None
Description:Defines what shall trig a collection on this pay unit. Do not define this attribute if no collection shall be done on this pay unit.

DeclineTicketId

Value:0–4294967295
Default:
Description:Defines the ticket that shall be printed when printing a Card Decline Ticket. The default ticket will be used if this attribute is not defined.

maxNum

Value:0–4294967295
0 = Max. number is disabled
Default:0
Description:Defines the maximum number of coins or bills a pay unit can contain before it is set in partial error mode.

maxSum

Value:0–4294967295
0 = Max. sum disabled
Default:0
Description:Defines the maximum amount (in ticks) that a pay unit can hold before it is set in partial error mode.

name

Value:Coin, Bill, Card, Ext0, Ext1, Ext2, Ext3
Default:
Description:The pay unit that PAYUNITACCOUNT is set up for.

numberOfBalanceTickets

Value:0-9
Default:1
Description:The number of tickets that shall be printed when balance is requested. 0 means that a collection is done but no ticket is printed.

numberOfHistoryTickets

Value:0-9
Default:1
Description:The number of tickets that shall be printed when collection history is requested. 0 means that a collection is done but no ticket is printed.

numberOfTickets

Value:0–9
Default:1
Description:The number of tickets that shall be printed at each collection. 0 means that a collection is done but no ticket is printed.

refundTicketId

Value:0–4294967295
Default:
Description:The number of tickets that shall be printed when a purchase is cancel and bills are inserted in the bill reader.

warningLevel

Value:0 – 100
0 = Warning level is disabled
Default:0
Description:Defines a percentage warning level. When the level is reached, a warning will be sent to WebOffice to inform the collection staff that a pay unit is almost filled with money.

Example:

Set-up for coin pay unit where only maxNum is defined. Maximum sum is then ignored. The terminal will send a pay unit warning to back office when the number of coins reaches 80% of 2000:

<PAYUNITACCOUNT name="Coin" maxNum="2000" warningLevel="80"/>

Example:

Set-up for coin pay unit where both maxNum and maxSum is defined to check both the number of coins and total amount (in ticks) in the coin box. Maximum number of coins is set to 3000 while the maximum sum is set to 1000000 ticks (the amount depends on the value of the tickFactor). The terminal will send a pay unit warning to back office when the number of coins reaches 90 % of either maximum number or maximum sum defined:

<PAYUNITACCOUNT name="Coin" maxNum="3000" maxSum="1000000" warningLevel="90"/>

Example:

Set-up for coin and card pay units that shall be collected when the coin box is pulled. For both pay units 100 collection history records are stored in the terminal and it will be possible to print them in the terminal. Both pay units use ticket id 19 for the collection tickets:

<PAYUNITACCOUNT name="Coin" collectionTrigger="CoinBox" collectionHistory="100" collectionTicketId="19" numberOfTickets="1"/>
<PAYUNITACCOUNT name="Card" collectionTrigger="CoinBox" collectionHistory="100" collectionTicketId="19" numberOfTickets="0" collectionHistoryTicketId="29" numberOfHistoryTickets="1"/>