placeholder Command:  TENDERS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding tenders.
Notes:
In the NSM form the UC3 application the content of this command is handled with NSM item 4+4.
 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: delete Delete the named item.
deleteall Delete all items.
read Read the named item.
read+ Read the following item.
read- Read the previous item.
readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol.
write Write the named item.
Description:
This command is used for creating, manipulating or deleting a tender.
Notes:
For the modes ''readall'' and ''deleteall'' the value of the tag <tender_no> will not be evaluated.
Thus, all tenders will be returned resp. deleted.
   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
Each tender has to be assigned a unique tender.
Notes:
The tender with number 99 is available by default with the name "EC". It is used for all payment transactions with electronic cash (if an electronic cash terminal is connected to a UC3 device). Tender number 99 can't be changed or deleted!
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: Max. 20 characters
Nillable: no
Description:
The name of the tender e.g. Euro or Dollar.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: Max. 3 characters
Nillable: no
Description:
The abreviation for the tender e.g. € or USD.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 3
Nillable: no
Description:
The number of decimal places that are possible for that tender.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1, 2 or 5
Nillable: no
Description:
The assigned rounding.
Value Description
1 Rounding to 1
2 Rounding to 2
5 Rounding to 5

   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1, 10, 100, 1000, 10000 or 100000
Nillable: no
Description:
The exchange factor describes how many units of the foreign currency are equivalent to how many units of the local currency represented in the exchange rate. If the exchange rate is set to 6457 and the exchange factor is set to 100 then it means that 100 units of the foreign currency are equivalent to 6457 units of the local currency. If the number of decimal places for the local currency is set to 2 then 100 units of the foreign currency are equivalent to 64.57 units of the local currency.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
   
Mandatory: no
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
The last time when the record was changed.
CCYY-MM-DDThh:mm:ss
The format is as following:
C = Century
Y = Year
M = Month
D = Day
T = Separator between date and time
h = hour
m = minute
s = second