 |
Command:
TENDERS
 |
Node: tenders |
|
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.
|
|
 |
|
|
 |
Node: tender |
|
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.
|
|
 |
|
|
|
 |
Tag: tender_no |
|
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!
|
|
 |
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
Max. 20 characters
|
|
Nillable: |
no |
|
Description: The name of the tender e.g. Euro or Dollar.
|
|
 |
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
Max. 3 characters
|
|
Nillable: |
no |
|
Description: The abreviation for the tender e.g. € or USD.
|
|
 |
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Nillable: |
no |
|
Description: The number of decimal places that are possible for that tender.
|
|
 |
|
|
|
 |
Tag: rounding |
|
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 |
|
|
 |
|
|
|
 |
Tag: factor |
|
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.
|
|
 |
|
|
|
 |
Tag: rate |
|
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.
|
|
 |
|
|
|
 |
Tag: last_change |
|
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
|
|
 |
|
|