 |
Command:
TAFS
|
For the transaction file command it will be distinguished between the request and the reply.
The following table describes the commands for requesting a taf entry.
Request 1 |
 |
Node: tafs |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
 |
|
|
 |
Node: taf |
|
Mandatory: |
yes |
|
max. Occurrence: |
unbounded |
|
Supported modes: |
delete Delete the named item. deleteall Delete all items. deletelower Delete the taf entries from the sequence number 0 till the named sequence number. read Read the named item. read+ Read the following item. readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol.
|
|
Description: This command is used for reading and deleting the content of a transaction file (TAF).
|
|
Notes: For the mode ''readall'' the following information can be helpful: If the sequence number is sent then all entries whose sequence number is greater are returned. For getting all entries the sequence number has to be set to 0.
For the mode ''deleteall'' the value of the element <sequence_no> will not be evaluated. Thus, all available entries will be deleted. The mode ''deletelower'' deletes all entries whose sequence number is lower or equal <sequence_no>.
|
|
 |
|
|
|
 |
Tag: sequence_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 2 147 483 647
|
|
Description: A continuous number for each TAF entry. Its value is starting with 1 and will never be reseted. Only a new version of a database file will reset this value. The sequence number can be used to get a unique entry point for reading or deleting TAF contents.
|
|
 |
|
|
For the transaction file command it will be distinguished between the request and the reply.
The following table describes the commands for requesting a taf entry.
Request 2 |
 |
Node: tafs |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
 |
|
|
 |
Node: taf |
|
Mandatory: |
yes |
|
max. Occurrence: |
unbounded |
|
Supported modes: |
delete Delete the named item. read Read the named item.
|
|
Description: This command is used for reading and deleting the content of a transaction file (TAF).
|
|
 |
|
|
|
 |
Tag: receipt_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The number of the receipt/label. It is only unique in combination with the date. When reaching the highest allowed receipt number/label number, the next receipt
number/label number will be reseted to the minimal number. The number will be reseted with the begin of a new day, too.
|
|
 |
|
|
|
 |
Tag: receipt_date |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: The date when the receipt or the label has been printed. Together with the receipt number it can be used to identify a receipt. 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 = month s = second
|
|
 |
|
|
Possible answer
The follwing information describes the possible reply received from the target device. |
 |
Node: tafs |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: This tag is used as container for commands regarding the transaction file (TAF).
|
|
 |
|
|
 |
Node: taf |
|
Mandatory: |
yes |
|
max. Occurrence: |
unbounded |
|
Supported modes: |
delete Delete the named item. deleteall Delete all items. deletelower Delete the taf entries from the sequence number 0 till the named sequence number. read Read the named item. read+ Read the following item. readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol.
|
|
Description: The TransAction File contains all records of tickets and labels (only if it's configured, that the labels are listed in the TAF-File).
|
|
Notes: It's only possible to void (storno) a ticket or a label, if it's completely listed in the transaction file.
|
|
 |
|
|
|
 |
Tag: sequence_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 2 147 483 647
|
|
Description: A continuous number for each TAF entry. Its value is starting with 1 and will never be reseted. Only a new version of a database file will reset this value. The sequence number can be used to get a unique entry point for reading or deleting TAF contents.
|
|
 |
|
|
|
 |
Tag: booking_department_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The priority department number of the device which caused the registration.
|
|
 |
|
|
|
 |
Tag: device_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 999
|
|
Description: The number of the device that caused the TAF entry.
|
|
 |
|
|
|
 |
Tag: receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The number of the receipt or label. It is only unique in combination with the date. When reaching the highest allowed receipt number, the next receipt number
is reseted to the minimal number. The number will be reseted with the begin of a new day, too.
|
|
 |
|
|
|
 |
Tag: receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: The date when the receipt or the label was printed. Together with the receipt number it can be used to identify a receipt. 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 = month s = second
|
|
 |
|
|
|
 |
Tag: position_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 32 767
|
|
Description: The number of the position by which the entry is identified on a receipt. On every new receipt the position number starts with 1 and is incremented till the last entry of a receipt (total).
|
|
 |
|
|
|
 |
Tag: void_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: Tells whether the receipt was voided or not.
Value |
Description |
0 |
The receipt is not voided |
1 |
The receipt has been voided manually |
2 |
The receipt has been voided by reopening |
|
|
 |
|
|
|
 |
Tag: void_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: The date when das receipt has been voided. 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 = month s = second
|
|
 |
|
|
|
 |
Tag: void_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator who voided the receipt.
|
|
Notes: This tag is supported with version 1.25.0 and higher. The tag is still unused.
|
|
 |
|
|
|
 |
Tag: sales_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 19
|
|
Description: 0 = normal receipt in sales mode 1 = zero receipt in sales mode 2 = normal receipt in cash register mode 3 = zero receipt in cash register mode 4 = selfservice 5 = prepacking 6 = goods receipt 7 = order receipt 8 = prepayment for an order receipt 9 = unknown 10 = inventory (standard) 11 = inventory in mode 1 12 = inventory in mode 2 13 = inventory in mode 3 14 = inventory in mode 4 15 = inventory in mode 5 16 = inventory in mode 6 17 = inventory in mode 7 18 = inventory in mode 8 19 = inventory in mode 9 20 = ticket de encargo (order receipt in sales mode) 21 = flow of money 22 = delivery note 23 = delivery note as cash receipt
|
|
 |
|
|
|
 |
Tag: rewrap |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
(0/1)
|
|
Description: Informs whether this article/item has been rewrapped or not.
Value |
Description |
0 |
The article/item has not been rewrapped |
1 |
The article/item has been rewrapped |
|
|
Notes: This tag is supported with version 1.3.6 and higher.
|
|
 |
|
|
|
 |
Tag: clearing_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: Information that tells whether this entry is interesting for foodmanagement, financial reports or both.
Value |
Description |
0 |
For food management |
1 |
For financial reports |
2 |
For food management and financial reports |
3 |
Neither for food management nor for financial reports |
|
|
 |
|
|
|
 |
Tag: operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator who caused this entry.
|
|
 |
|
|
|
 |
Tag: operator_key_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 999
|
|
Description: The number of the operator key the operator is logged on.
|
|
Notes: This tag is supported with version 1.10.2 and higher. Only used for cashregister mode and sales mode.
|
|
 |
|
|
|
 |
Tag: basket_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The operator has used the basket number functionality in sales mode.
The assigned basket number is stored at this place.
|
|
Notes: This tag is supported with version 1.6.0 and higher.
|
|
 |
|
|
|
 |
Choice: |
|
|
|
|
 |
Node: taf_registration |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: TAF registration entry.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: linevoid_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the entry was voided or not.
Value |
Description |
0 |
The registration is not voided |
1 |
The registrations voided |
|
|
 |
|
|
|
|
|
 |
Tag: weight_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The origin of the weight value.
Value |
Description |
0 |
from weighing interface |
1 |
manual input |
2 |
fixed weight |
|
|
 |
|
|
|
|
|
 |
Tag: price_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The origin of the price.
Value |
Description |
0 |
From the article definition in the database |
1 |
Free base price |
2 |
Manual input by the operator |
3 |
Quantity dependent price |
|
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the department the article/item is belonging to.
|
|
 |
|
|
|
|
|
 |
Tag: plu_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description: The type of the PLU assigned in command article. Possible values:
Value |
Description |
0 |
Item sold by weight with standard baseunit (1kg/lb) |
1 |
Item sold by piece |
2 |
Fixed weight (ETICA only) |
3 |
Fixed weight/fixed price (ETICA only) |
4 |
Fixed Weight |
5 |
Fixed Weight Override |
6 |
Fixed Piece |
7 |
Fixed Piece Override |
8 |
Fixed Volume |
9 |
Fixed Volume Override |
10 |
Piece Convertible to weight (or Bread for singles) |
11 |
Piece, Fixed Weight |
12 |
Piece, Fixed Weight, Unit Price calculated |
13 |
Piece, weighed |
14 |
Piece, weighed, Unit Price calculated |
|
|
Notes: The values 4 - 10 are supported by UC3 with version V1.6.0 and higher. The values 11 - 14 are supported by UC3 with version V1.22.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: used_plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description:
PLU type the application has assigned during registration process.
It can differ to plu_type in case of running an application that doesn't support the plu type assigned in master data maintenance.
Possible values: See plu_type
|
|
 |
|
|
|
|
|
 |
Tag: plu_type_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: A more detailed information about the plu type. Possible values:
Value |
Description |
0 |
Standard type |
1 |
Enter unit price |
2 |
Manual plus |
3 |
Manual minus |
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The name of the article/item. See the command <articles>.
|
|
 |
|
|
|
|
|
 |
Tag: uan |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 13 characters
|
|
Description: The unique article number UAN). Necessary to identify the article/item. See the command <article>.
|
|
Notes: This tag is supported with version 1.0.10 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.15.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number_2 |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Second customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.19.1 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_selection_method |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
SELECTED_BY_PLU_ENTRY SELECTED_BY_PLU_PRESET SELECTED_BY_UAN_ENTRY SELECTED_BY_UAN_PRESET SELECTED_BY_CUSTOMERID_ENTRY
|
|
Description: Describes in which way an article/item has been selected.
Value |
Description |
SELECTED_BY_PLU_ENTRY |
Selected by its PLU number. |
SELECTED_BY_PLU_PRESET |
Selected by a PLU button. |
SELECTED_BY_UAN_ENTRY |
Selected by its UAN number. |
SELECTED_BY_UAN_PRESET |
Selected by a UAN button. |
SELECTED_BY_CUSTOMERID_ENTRY |
Selected by its customer ID. |
|
|
Notes: This tag is supported with version 1.10.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_group_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the article group the article/item is belonging to. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: grossweight_control_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
NO_GROSSWEIGHTCHECK GROSSWEIGHTCHECK_WITH_REJECTION GROSSWEIGHTCHECK_WITH_ENFORCEMENT GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION
|
|
Description: The way the registration has been created:
Value |
Description |
NO_GROSSWEIGHTCHECK |
No check of the grossweight has been done. |
GROSSWEIGHTCHECK_WITH_REJECTION |
The grossweight has been checked and neither the upper limit of lMaxGrossWeightSales (section [minmax] in the file customer.ini)
nor the upper limit of lMaxGrossWeight (section [minmax] in the file customer.ini) has been crossed.
|
GROSSWEIGHTCHECK_WITH_ENFORCEMENT |
The operator has enfored the registration although the upper limit for the grossweight has been crossed.
This results in setting <grossweight_control> to 0.
|
GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION |
The grossweight has been checked and the upper limit of the lMaxGrossWeight (section [minmax] in the file customer.ini) hasn't
been crossed.
|
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items if sold by piece.
|
|
 |
|
|
|
|
|
 |
Tag: used_fixed_quantity |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999 999
|
|
Description: Contains the value of a backward price calculation. The type of this value depends on the selected PLU-Type for the registration. It can be by a weight-, volume-value or number of items.
|
|
 |
|
|
|
|
|
 |
Tag: tare_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The value of the tare in the unit g (for a loadcell based on kg) or (for a loadcall based on lbs).
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_tare |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places that are belonging to <tare_value>.
|
|
 |
|
|
|
|
|
 |
Tag: tarekind_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: Type of the tare:
Value |
Description |
0 |
No tare is used |
1 |
Tare read from the database or manual input |
2 |
Tare compensation by the loadcell |
|
|
 |
|
|
|
|
|
 |
Tag: item_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The baseprice of the article/item. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: item_originprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The original price before overriding it.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: price_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
- |
|
Description: The number of the used price. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: item_additional_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The additional baseprice of the article/item. It can be the baseprice for loyality customers.
The value is stored in the primary currency.
The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: additional_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
It can be the amount for loyality customers.
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
 |
|
|
|
|
|
 |
Tag: purchase_price |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The purchase price of the item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 fix decimal places fix (700 = 7.00%). If this value is set the tag <markup_discount_absolute> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: special_offer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the special offer. See the command <special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: article_special_offer_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The ID of the article based special offer. See the command <article_special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: smiley |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: Possible values:
Value |
Description |
0 |
No smiley |
1 |
Laughing smiley :-) |
2 |
Wheeping smiley :-( |
3 |
The face of the smiley is depending on the margin |
|
|
 |
|
|
|
|
|
 |
Tag: price_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
It is not allowed to change the price. |
1 |
It is allowed to change the price. |
|
|
 |
|
|
|
|
|
 |
Tag: discount_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
A discount is not allowed. |
1 |
A discount is allowed. |
|
|
 |
|
|
|
|
|
 |
Tag: extratext_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the extratext that has been used. See the command <texts>
|
|
 |
|
|
|
|
|
 |
Tag: proof_of_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The proof of origin type this article/item has been assigned to. For the assignment of an article/item to a proof of origin type see command <article_proof_of_origin_assignment>.
|
|
Notes: This tag is supported with version 1.0.10 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: lot_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The lot ID is the identfier of the lot that has been used. If this field is not set the value of the tag <field_text> with the field no 1 is the default.
|
|
Notes: Lots will be created with the command <proof_of_origin_lot>. This tag is supported with version 1.0.10 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_info_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 200 characters
|
|
Description: Contains an article/item specific ID which could be a receipt ID attached to booked position.
Receipt ID is a reference to request receipt information from an external receipt service.
|
|
Notes: This tag is supported with version 1.22.0 and higher. This ID can't be set by item data maintenance. The article info ID may be a full URL or part of a URL to retrieve e.g. bitmap for printing.
|
|
 |
|
|
|
|
|
 |
Tag: booking_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time the registration has been booked. This value might differ from the value set in <receipt_date>. 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 = month s = second
|
|
Notes: This tag is supported with version 1.24.0 and higher. Value is set for registrations done in mode inventory, otherwise this tag doesn't contain a value.
|
|
 |
|
|
|
|
|
 |
Node: proof_of_origin_lot_children |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains the fields of a lot that have been marked for the TAF in the command <proof_of_origin_type_definition>.
|
|
Notes: Supported with version 1.0.9 and higher.
|
|
 |
|
|
|
|
|
|
 |
Node: proof_of_origin_lot_child |
|
Mandatory: |
no |
|
max. Occurrence: |
20 |
|
Description: Each child contains the information of 1 field.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: field_no |
|
|
|
|
|
|
|
 |
Tag: field_text |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The text assigned to the field.
|
|
 |
|
|
|
|
|
 |
Node: simple_promotions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains promotions data based on the command <promotion_definitions>. To one registration there can be assigned more than one simple promotion.
|
|
Notes: Supported with version 1.2.0 and higher.
|
|
 |
|
|
|
|
|
|
 |
Node: simple_promotion |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: Contains the data of one simple promotion.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_definition_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: The ID of the promotion definition. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_rule_tag |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The promotion rule tag is an information the customer can use for its own. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_kind |
|
|
|
|
|
|
|
 |
Tag: markup_discount_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items in markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_rate |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 - 9 999
|
|
Description: Percentage rate with 2 decimal places.
|
|
Notes: -1200 means a discount of 12.00%.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_goods_registration |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry of a goods receipt registration.
|
|
Notes: This node contains excactly the same subnodes as the node <taf_registration>. Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: linevoid_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the entry was voided or not.
Value |
Description |
0 |
The registration is not voided |
1 |
The registrations voided |
|
|
 |
|
|
|
|
|
 |
Tag: weight_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The origin of the weight value.
Value |
Description |
0 |
from weighing interface |
1 |
manual input |
2 |
fixed weight |
|
|
 |
|
|
|
|
|
 |
Tag: price_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The origin of the price.
Value |
Description |
0 |
From the article definition in the database |
1 |
Free base price |
2 |
Manual input by the operator |
3 |
Quantity dependent price |
|
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the department the article/item is belonging to.
|
|
 |
|
|
|
|
|
 |
Tag: plu_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description: The type of the PLU. Possible values:
Value |
Description |
0 |
Item sold by weight with standard baseunit (1kg/lb) |
1 |
Item sold by piece |
2 |
Fixed weight (ETICA only) |
3 |
Fixed weight/fixed price (ETICA only) |
4 |
Fixed Weight |
5 |
Fixed Weight Override |
6 |
Fixed Piece |
7 |
Fixed Piece Override |
8 |
Fixed Volume |
9 |
Fixed Volume Override |
10 |
Piece Convertible to weight (or Bread for singles) |
11 |
Piece, Fixed Weight |
12 |
Piece, Fixed Weight, Unit Price calculated |
13 |
Piece, weighed |
14 |
Piece, weighed, Unit Price calculated |
|
|
Notes: The values 4 - 10 are supported by UC3 with version V1.6.0 and higher. The values 11 - 14 are supported by UC3 with version V1.22.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: used_plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description:
PLU type the application has assigned during registration process.
It can differ to plu_type in case of running an application that doesn't support the plu type assigned in master data maintenance.
Possible values: See plu_type
|
|
 |
|
|
|
|
|
 |
Tag: plu_type_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: A more detailed information about the plu type. Possible values:
Value |
Description |
0 |
Standard type |
1 |
Enter unit price |
2 |
Manual plus |
3 |
Manual minus |
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The name of the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: uan |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 13 characters
|
|
Description: The unique article number UAN). Necessary to identify the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.15.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number_2 |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Second customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.19.1 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_selection_method |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
SELECTED_BY_PLU_ENTRY SELECTED_BY_PLU_PRESET SELECTED_BY_UAN_ENTRY SELECTED_BY_UAN_PRESET SELECTED_BY_CUSTOMERID_ENTRY
|
|
Description: Describes in which way an article/item has been selected.
Value |
Description |
SELECTED_BY_PLU_ENTRY |
Selected by its PLU number. |
SELECTED_BY_PLU_PRESET |
Selected by a PLU button. |
SELECTED_BY_UAN_ENTRY |
Selected by its UAN number. |
SELECTED_BY_UAN_PRESET |
Selected by a UAN button. |
SELECTED_BY_CUSTOMERID_ENTRY |
Selected by its customer ID. |
|
|
Notes: This tag is supported with version 1.10.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_group_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the article group the article/item is belonging to. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: grossweight_control_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
NO_GROSSWEIGHTCHECK GROSSWEIGHTCHECK_WITH_REJECTION GROSSWEIGHTCHECK_WITH_ENFORCEMENT GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION
|
|
Description: The way the registration has been created:
Value |
Description |
NO_GROSSWEIGHTCHECK |
No check of the grossweight has been done. |
GROSSWEIGHTCHECK_WITH_REJECTION |
The grossweight has been checked and neither the upper limit of lMaxGrossWeightSales (section [minmax] in the file customer.ini)
nor the upper limit of lMaxGrossWeight (section [minmax] in the file customer.ini) has been crossed.
|
GROSSWEIGHTCHECK_WITH_ENFORCEMENT |
The operator has enfored the registration although the upper limit for the grossweight has been crossed.
This results in setting <grossweight_control> to 0.
|
GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION |
The grossweight has been checked and the upper limit of the lMaxGrossWeight (section [minmax] in the file customer.ini) hasn't
been crossed.
|
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items if sold by piece.
|
|
 |
|
|
|
|
|
 |
Tag: used_fixed_quantity |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999 999
|
|
Description: Contains the value of a backward price calculation. The type of this value depends on the selected PLU-Type for the registration. It can be by a weight-, volume-value or number of items.
|
|
 |
|
|
|
|
|
 |
Tag: tare_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The value of the tare in the unit g (for a loadcell based on kg) or (for a loadcall based on lbs).
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_tare |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places that are belonging to <tare_value>.
|
|
 |
|
|
|
|
|
 |
Tag: tarekind_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: Type of the tare:
Value |
Description |
0 |
No tare is used |
1 |
Tare read from the database or manual input |
2 |
Tare compensation by the loadcell |
|
|
 |
|
|
|
|
|
 |
Tag: item_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The baseprice of the article/item. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: item_originprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The original price before overriding it.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: price_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
- |
|
Description: The number of the used price. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: item_additional_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The additional baseprice of the article/item. It can be the baseprice for loyality customers.
The value is stored in the primary currency.
The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: additional_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
It can be the amount for loyality customers.
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
 |
|
|
|
|
|
 |
Tag: purchase_price |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The purchase price of the item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 fix decimal places fix (700 = 7.00%). If this value is set the tag <markup_discount_absolute> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: special_offer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the special offer. See the command <special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: article_special_offer_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The ID of the article based special offer. See the command <article_special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: smiley |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: Possible values:
Value |
Description |
0 |
No smiley |
1 |
Laughing smiley :-) |
2 |
Wheeping smiley :-( |
3 |
The face of the smiley is depending on the margin |
|
|
 |
|
|
|
|
|
 |
Tag: price_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
It is not allowed to change the price. |
1 |
It is allowed to change the price. |
|
|
 |
|
|
|
|
|
 |
Tag: discount_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
A discount is not allowed. |
1 |
A discount is allowed. |
|
|
 |
|
|
|
|
|
 |
Tag: extratext_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the extratext that has been used. See the command <texts>
|
|
 |
|
|
|
|
|
 |
Tag: proof_of_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The proof of origin type this article/item has been assigned to. For the assignment of an article/item to a proof of origin type see command <article_proof_of_origin_assignment>.
|
|
 |
|
|
|
|
|
 |
Tag: lot_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The lot ID The is the identfier of the lot that has been used. If this field is not set the value of the tag <field_text> with the field no 1 is the default.
|
|
Notes: Lots will be created with the command <proof_of_origin_lot>.
|
|
 |
|
|
|
|
|
 |
Tag: article_info_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 200 characters
|
|
Description: Contains an article/item specific ID which could be a receipt ID attached to booked position.
Receipt ID is a reference to request receipt information from an external receipt service.
|
|
Notes: This tag is supported with version 1.22.0 and higher. This ID can't be set by item data maintenance. The article info ID may be a full URL or part of a URL to retrieve e.g. bitmap for printing.
|
|
 |
|
|
|
|
|
 |
Tag: booking_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time the registration has been booked. This value might differ from the value set in <receipt_date>. 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 = month s = second
|
|
Notes: This tag is supported with version 1.24.0 and higher. Value is set for registrations done in mode inventory, otherwise this tag doesn't contain a value.
|
|
 |
|
|
|
|
|
 |
Node: proof_of_origin_lot_children |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains the fields of a lot that have been marked for the TAF in the command <proof_of_origin_type_definition>.
|
|
 |
|
|
|
|
|
|
 |
Node: proof_of_origin_lot_child |
|
Mandatory: |
no |
|
max. Occurrence: |
20 |
|
Description: Each child contains the information of 1 field.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: field_no |
|
|
|
|
|
|
|
 |
Tag: field_text |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The text assigned to the field.
|
|
 |
|
|
|
|
|
 |
Node: simple_promotions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains promotions data based on the command <promotion_definitions>. To one registration there can be assigned more than one simple promotion.
|
|
 |
|
|
|
|
|
|
 |
Node: simple_promotion |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: Contains the data of one simple promotion.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_definition_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: The ID of the promotion definition. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_rule_tag |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The promotion rule tag is an information the customer can use for its own. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_kind |
|
|
|
|
|
|
|
 |
Tag: markup_discount_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items in markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_rate |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 - 9 999
|
|
Description: Percentage rate with 2 decimal places.
|
|
Notes: -1200 means a discount of 12.00%.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_order_registration |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry of an order receipt registration.
|
|
Notes: This node contains excactly the same subnodes as the node <taf_registration>. Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: linevoid_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the entry was voided or not.
Value |
Description |
0 |
The registration is not voided |
1 |
The registrations voided |
|
|
 |
|
|
|
|
|
 |
Tag: weight_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The origin of the weight value.
Value |
Description |
0 |
from weighing interface |
1 |
manual input |
2 |
fixed weight |
|
|
 |
|
|
|
|
|
 |
Tag: price_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The origin of the price.
Value |
Description |
0 |
From the article definition in the database |
1 |
Free base price |
2 |
Manual input by the operator |
3 |
Quantity dependent price |
|
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the department the article/item is belonging to.
|
|
 |
|
|
|
|
|
 |
Tag: plu_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description: The type of the PLU. Possible values:
Value |
Description |
0 |
Item sold by weight with standard baseunit (1kg/lb) |
1 |
Item sold by piece |
2 |
Fixed weight (ETICA only) |
3 |
Fixed weight/fixed price (ETICA only) |
4 |
Fixed Weight |
5 |
Fixed Weight Override |
6 |
Fixed Piece |
7 |
Fixed Piece Override |
8 |
Fixed Volume |
9 |
Fixed Volume Override |
10 |
Piece Convertible to weight (or Bread for singles) |
11 |
Piece, Fixed Weight |
12 |
Piece, Fixed Weight, Unit Price calculated |
13 |
Piece, weighed |
14 |
Piece, weighed, Unit Price calculated |
|
|
Notes: The values 4 - 10 are supported by UC3 with version V1.6.0 and higher. The values 11 - 14 are supported by UC3 with version V1.22.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: used_plu_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 14
|
|
Description:
PLU type the application has assigned during registration process.
It can differ to plu_type in case of running an application that doesn't support the plu type assigned in master data maintenance.
Possible values: See plu_type
|
|
 |
|
|
|
|
|
 |
Tag: plu_type_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: A more detailed information about the plu type. Possible values:
Value |
Description |
0 |
Standard type |
1 |
Enter unit price |
2 |
Manual plus |
3 |
Manual minus |
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The name of the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: uan |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 13 characters
|
|
Description: The unique article number UAN). Necessary to identify the article/item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.15.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_article_number_2 |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Second customer specific article number that allows a customer to identify an article/item by its own definition.
|
|
Notes: This tag is supported with version 1.19.1 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_selection_method |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
SELECTED_BY_PLU_ENTRY SELECTED_BY_PLU_PRESET SELECTED_BY_UAN_ENTRY SELECTED_BY_UAN_PRESET SELECTED_BY_CUSTOMERID_ENTRY
|
|
Description: Describes in which way an article/item has been selected.
Value |
Description |
SELECTED_BY_PLU_ENTRY |
Selected by its PLU number. |
SELECTED_BY_PLU_PRESET |
Selected by a PLU button. |
SELECTED_BY_UAN_ENTRY |
Selected by its UAN number. |
SELECTED_BY_UAN_PRESET |
Selected by a UAN button. |
SELECTED_BY_CUSTOMERID_ENTRY |
Selected by its customer ID. |
|
|
Notes: This tag is supported with version 1.10.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: article_group_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the article group the article/item is belonging to. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: grossweight_control_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
NO_GROSSWEIGHTCHECK GROSSWEIGHTCHECK_WITH_REJECTION GROSSWEIGHTCHECK_WITH_ENFORCEMENT GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION
|
|
Description: The way the registration has been created:
Value |
Description |
NO_GROSSWEIGHTCHECK |
No check of the grossweight has been done. |
GROSSWEIGHTCHECK_WITH_REJECTION |
The grossweight has been checked and neither the upper limit of lMaxGrossWeightSales (section [minmax] in the file customer.ini)
nor the upper limit of lMaxGrossWeight (section [minmax] in the file customer.ini) has been crossed.
|
GROSSWEIGHTCHECK_WITH_ENFORCEMENT |
The operator has enfored the registration although the upper limit for the grossweight has been crossed.
This results in setting <grossweight_control> to 0.
|
GROSSWEIGHTCHECK_WITH_REJECTION_NO_TOTALISATION |
The grossweight has been checked and the upper limit of the lMaxGrossWeight (section [minmax] in the file customer.ini) hasn't
been crossed.
|
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items if sold by piece.
|
|
 |
|
|
|
|
|
 |
Tag: used_fixed_quantity |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999 999
|
|
Description: Contains the value of a backward price calculation. The type of this value depends on the selected PLU-Type for the registration. It can be by a weight-, volume-value or number of items.
|
|
 |
|
|
|
|
|
 |
Tag: tare_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The value of the tare in the unit g (for a loadcell based on kg) or (for a loadcall based on lbs).
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_tare |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places that are belonging to <tare_value>.
|
|
 |
|
|
|
|
|
 |
Tag: tarekind_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: Type of the tare:
Value |
Description |
0 |
No tare is used |
1 |
Tare read from the database or manual input |
2 |
Tare compensation by the loadcell |
|
|
 |
|
|
|
|
|
 |
Tag: item_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The baseprice of the article/item. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: item_originprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The original price before overriding it.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: price_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
- |
|
Description: The number of the used price. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: item_additional_baseprice |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The additional baseprice of the article/item. It can be the baseprice for loyality customers.
The value is stored in the primary currency.
The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: additional_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
It can be the amount for loyality customers.
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
 |
|
|
|
|
|
 |
Tag: purchase_price |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Description: The purchase price of the item. See the command <article>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 fix decimal places fix (700 = 7.00%). If this value is set the tag <markup_discount_absolute> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: special_offer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the special offer. See the command <special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: article_special_offer_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The ID of the article based special offer. See the command <article_special_offers>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: smiley |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: Possible values:
Value |
Description |
0 |
No smiley |
1 |
Laughing smiley :-) |
2 |
Wheeping smiley :-( |
3 |
The face of the smiley is depending on the margin |
|
|
 |
|
|
|
|
|
 |
Tag: price_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
It is not allowed to change the price. |
1 |
It is allowed to change the price. |
|
|
 |
|
|
|
|
|
 |
Tag: discount_flag |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
flagType |
|
Range: |
(0/1)
|
|
Description: Possible values:
Value |
Description |
0 |
A discount is not allowed. |
1 |
A discount is allowed. |
|
|
 |
|
|
|
|
|
 |
Tag: extratext_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the extratext that has been used. See the command <texts>
|
|
 |
|
|
|
|
|
 |
Tag: proof_of_origin_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The proof of origin type this article/item has been assigned to. For the assignment of an article/item to a proof of origin type see command <article_proof_of_origin_assignment>.
|
|
 |
|
|
|
|
|
 |
Tag: lot_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The lot ID The is the identfier of the lot that has been used. If this field is not set the value of the tag <field_text> with the field no 1 is the default.
|
|
Notes: Lots will be created with the command <proof_of_origin_lot>.
|
|
 |
|
|
|
|
|
 |
Tag: article_info_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 200 characters
|
|
Description: Contains an article/item specific ID which could be a receipt ID attached to booked position.
Receipt ID is a reference to request receipt information from an external receipt service.
|
|
Notes: This tag is supported with version 1.22.0 and higher. This ID can't be set by item data maintenance. The article info ID may be a full URL or part of a URL to retrieve e.g. bitmap for printing.
|
|
 |
|
|
|
|
|
 |
Tag: booking_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time the registration has been booked. This value might differ from the value set in <receipt_date>. 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 = month s = second
|
|
Notes: This tag is supported with version 1.24.0 and higher. Value is set for registrations done in mode inventory, otherwise this tag doesn't contain a value.
|
|
 |
|
|
|
|
|
 |
Node: proof_of_origin_lot_children |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains the fields of a lot that have been marked for the TAF in the command <proof_of_origin_type_definition>.
|
|
 |
|
|
|
|
|
|
 |
Node: proof_of_origin_lot_child |
|
Mandatory: |
no |
|
max. Occurrence: |
20 |
|
Description: Each child contains the information of 1 field.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: field_no |
|
|
|
|
|
|
|
 |
Tag: field_text |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The text assigned to the field.
|
|
 |
|
|
|
|
|
 |
Node: simple_promotions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: This tag contains promotions data based on the command <promotion_definitions>. To one registration there can be assigned more than one simple promotion.
|
|
 |
|
|
|
|
|
|
 |
Node: simple_promotion |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: Contains the data of one simple promotion.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_definition_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: The ID of the promotion definition. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: promotion_rule_tag |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The promotion rule tag is an information the customer can use for its own. See command <promotion_definitions>.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_kind |
|
|
|
|
|
|
|
 |
Tag: markup_discount_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items in markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount.
|
|
 |
|
|
|
|
|
|
|
 |
Tag: markup_discount_rate |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 - 9 999
|
|
Description: Percentage rate with 2 decimal places.
|
|
Notes: -1200 means a discount of 12.00%.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_order_prepayment |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about a prepayment to an order receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The amount of the prepayment the customer has done.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_prepayment_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A total for a prepayment to an order receipt entry.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_goods_order_customer_summary |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A summary about following goods/order receipts (including a prepayment to an order receipt). This entry appears in the TAF each time when goods/order receipts have been booked on a cash receipt. If the goods/order receipts have been voided then only this TAF entry appears. The voided goods/order receipts are not listed.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: linevoid_state |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the following goods/order receipts belonging to the customer <customer_no> have been voided or not.
Value |
Description |
0 |
The goods/order receipts have not been voided |
1 |
The goods/order receipts have been voided |
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all receipts that have been assigned to the customer identified by <customer_no> without a price reduction.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all receipts that have been assigned to the customer identified by <customer_no> with price reduction.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_vat |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A VAT entry.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: turnover |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: Its the summation of the amounts.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_goods_vat |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A VAT entry of a goods receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: turnover |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: Its the summation of the amounts.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_order_vat |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A VAT entry of an order receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: vat_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The number of the used VAT. See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: vat_value |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: The value of the VAT. The VAT is always stored with 2 decimal places 5% = 500, 5,5% = 550). See the command <vat>.
|
|
 |
|
|
|
|
|
 |
Tag: turnover |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: Its the summation of the amounts.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_subtotal |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A subtotal entry.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is supported with version 1.9.0 and higher. This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items belonging to the subtotal.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a subtotal.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_goods_subtotal |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A subtotal entry of a goods receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items belonging to the subtotal.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a subtotal.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_order_subtotal |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A subtotal entry of an order receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The amount can be the product of weight multiplied by the baseprice. The value is always stored in the primary currency.
A price reduction like a discount has not been attached.
|
|
Notes: The amount with an attached price reduction is stored in the tag <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description:
The sum that the customer has to pay for the article(s)/item(s).
Its the amount +/- markup or discount or another price reduction. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of articles/items belonging to the subtotal.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a subtotal.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A tender entry.
|
|
Notes: Supported with version 1.3.2 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: payback |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: Contains PAYBACK specific information.
|
|
Notes: Supported with version 1.15.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: card_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 16 characters
|
|
Description: The number of the loyality card by which a customer has been identified.
|
|
 |
|
|
|
|
|
 |
Tag: terminal_name |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The terminal ID of the POS terminal that is making a call to the LoyalityPartner server. It reflects the serial number of the UC3 device.
|
|
 |
|
|
|
|
|
 |
Tag: number_new_points |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 – 99 999 999
|
|
Description: The number of points the customer gets for this receipt.
|
|
 |
|
|
|
|
|
 |
Node: coupons |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Description: Coupons that have been assigned to this receipt/label.
|
|
 |
|
|
|
|
|
|
 |
Tag: coupon_id |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Datatype: |
string |
|
Range: |
max. 13 characters
|
|
Description: EAN number by which a coupon is identified.
|
|
 |
|
|
|
|
|
 |
Tag: terminal_transaction_id |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: Globally unique identifier for the redemption transaction. The ID will be generated by using the serial number of the device + the number of seconds since 1970-01-01.
|
|
 |
|
|
|
|
|
 |
Tag: redemption_points |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 – 99 999 999
|
|
Description: Number of points to redeem.
This is the number of points the scale sends to the PAYBACK server and indicates the number of points that shall
be used for redemption.
|
|
 |
|
|
|
|
|
 |
Tag: redeemed_amount |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 – 99 999 999
|
|
Description: Redeemed amount in Euro. This is the value the PAYBACK server has redeemed based on the input (see <redemption_points>) of the scale.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A total entry.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_goods_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: Total entry of a goods receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_order_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: Total entry of an order receipt.
|
|
Notes: Supported with version 1.9.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_deleted_goods_receipts |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A summary about deleted goods receipts. Necessary to adjust the financial reports. Each of these entries is followed by a <taf_deleted_goods_orders_total> entry.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_receipts |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The number of receipts that have been deleted.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all deleted goods receipts without price reduction.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all deleted goods receipts including price reduction.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_deleted_order_receipts |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A summary about deleted order receipts. Necessary to adjust the financial reports. Each of these entries is followed by a <taf_deleted_goods_orders_total> entry.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_receipts |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The number of receipts that have been deleted.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all deleted order receipts without price reduction.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated price of all deleted order receipts including price reduction.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_deleted_prepayments |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A summary about deleted prepayments for order receipts. Necessary to adjust the financial reports. Each of these entries is followed by a <taf_deleted_goods_orders_total> entry.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_receipts |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The number of prepayments that have been deleted.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The cumulated prepayments.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: Cumulation about all deleted prepayments.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_deleted_goods_orders_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: A total entry belonging to a preceding deleted goods/order receipt entry.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: ecash |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about an electronic cash payment.
|
|
Notes: Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: card_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The type of the card used for electronic payment.
|
|
 |
|
|
|
|
|
 |
Tag: terminal_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 2 147 483 647
|
|
Description: The ID of the payment terminal.
|
|
 |
|
|
|
|
|
 |
Tag: terminal_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 2 147 483 647
|
|
Description: The number of the receipt printed on the payment terminal.
|
|
Notes: The receipt number is necessary to void a receipt.
|
|
 |
|
|
|
|
|
 |
Tag: terminal_trace_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 2 147 483 647
|
|
Description: The trace number created for each receipt of the payment terminal.
|
|
Notes: The trace number can be necessary to void a receipt (depending on the payment terminal type).
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_paid_in |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about a payment.
|
|
Notes: Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
Notes: This entry will be completed by a <taf_flow_of_money_total> entry.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
 |
Tag: reference |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: A reference to the paid in operation done in the NSM. In the NSM the vendor has the possibility to add an information (reference) to this TAF entry when he does a paid in operation.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_paid_out |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about a payout.
|
|
Notes: This entry will be completed by a <taf_flow_of_money_total> entry. Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
 |
Tag: reference |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: A reference to the paid out operation done in the NSM. In the NSM the vendor has the possibility to add an information (reference) to this TAF entry when he does a paid out operation.
|
|
Notes: Supported with version 1.13.0 and higher.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_loan |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about a loan.
|
|
Notes: This entry will be completed by a <taf_flow_of_money_total> entry. Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
 |
Tag: reference |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: A reference to the loan operation done in the NSM. In the NSM the vendor has the possibility to add an information (reference) to this TAF entry when he does a loan operation.
|
|
Notes: Supported with version 1.13.0 and higher. The reference is not used by the NSM at the moment.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_pick_up |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about a pick up. A pick up is the amount that has been removed from the cash register for security reasons.
|
|
Notes: This entry will be completed by a <taf_flow_of_money_total> entry. Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
 |
Tag: reference |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: A reference to the pick up operation done in the NSM. In the NSM the vendor has the possibility to add an information (reference) to this TAF entry when he does a pick up operation.
|
|
Notes: Supported with version 1.13.0 and higher. The reference is not used by the NSM at the moment.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_tender_actual |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: An entry about the actual tender in the cash register.
|
|
Notes: This entry will be completed by a <taf_flow_of_money_total> entry. Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: tender_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 99
|
|
Description: The number of the tender. See the command <tenders>.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Description: The name of the tender e.g. Euro or Dollar
|
|
 |
|
|
|
|
|
 |
Tag: shortname |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 3 characters
|
|
Description: Short version of the tender name e.g. € or USD.
|
|
 |
|
|
|
|
|
 |
Tag: rounding |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-
|
|
Description: Possible values:
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 - 100 000
|
|
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
|
|
Description: The exchange rate related to the local currency. The number of decimal places is depending on the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_tender |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The money given in the foreign currency.
|
|
 |
|
|
|
|
|
 |
Tag: decimals |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places of <money_given_tender>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given_local |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999 999
|
|
Description: The value of the money given in the foreign currency in relation to the local currency.
|
|
 |
|
|
|
|
|
 |
Tag: reference |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Description: A reference to the actual tender operation done in the NSM. In the NSM the vendor has the possibility to add an information (reference) to this TAF entry when he does a paid in operation.
|
|
Notes: Supported with version 1.13.0 and higher. The reference is not used by the NSM at the moment.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: taf_flow_of_money_total |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Description: Total entry that completes a flow of money entry. This can be a paid in entry, a paid out entry, a loan entry, a pick up entry or an actual tender entry.
|
|
Notes: Supported with version 1.10.0 and higher.
|
|
 |
|
|
|
|
|
 |
Tag: customer_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999
|
|
Description: The number by which a customer can be identified. It's the order receipt number or the goods receipt number.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_operator_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Description: The number of the operator that did the registration for an order receipt or a goods receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 99 999 999
|
|
Description: The receipt number of the goods receipt or order receipt.
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: customer_receipt_date |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Description: Date and time when the goods receipt or order receipt has been generated. 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 = month s = second
|
|
Notes: This tag is used in cash register mode only.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-99 999 999 - 99 999 999
|
|
Description: The weight of the sold article(s)/item(s). The weight is always stored as 1/1000 of the unit the loadcell is configured, e.g. 1/1000 of a kg or 1/1000 of a lb.
|
|
Notes: There is no cross reference to the tag <decimal_places_weight>.
|
|
 |
|
|
|
|
|
 |
Tag: decimal_places_weight |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 3
|
|
Description: The number of decimal places the loadcell runs with. A loadcell with 3 decimal places delivers the value 1.000. Stored in the tag <weight> will be 1000. A loadcell with 2 decimal places delivers the value 1.00. Stored in the tag <weight> will be 1000.
|
|
Notes:
|
|
 |
|
|
|
|
|
 |
Tag: weightunit_type |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 2
|
|
Description: The unit on which the weight is based on:
Value |
Description |
0 |
unknown |
1 |
based on kg |
2 |
based on lb |
|
|
 |
|
|
|
|
|
 |
Tag: grossweight_control |
|
|
|
|
|
 |
Tag: rounding_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: If a rounding rule for a total has been used then it contains the amount by which the price to pay has been modified,
e.g. a total of 22,34 € has been rounded to 22,30 €. This field then has the value '4'.
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration amounts.
|
|
 |
|
|
|
|
|
 |
Tag: price_to_pay |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The sum of all registration price to pays.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of items belonging to the total. See <number_of_positions>. Remember: 1 position on a receipt can contain more than 1 item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_positions |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
0 - 99 999
|
|
Description: The number of positions that are belonging to a total.
|
|
 |
|
|
|
|
|
 |
Tag: total_ean |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Description: The information used for printing the ean belonging to the total. The encoding defintion for this is used from the configuration
and is not part of the 'total_ean'.
|
|
 |
|
|
|
|
|
 |
Tag: sales_category_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 9 999
|
|
Description: A number to identify the sales categorie.
|
|
Notes: Sales categories are not supported until now.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_no |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Description: The number of the markup or discount that has been used. See the command <markup_discounts>.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_percentage |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
-9 999 - 9 999
|
|
Description: The value of the markup or discount as a percentage value with 2 decimal places fix (700 = 7.00%). In this case the element
'markup_discount_absolute' is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_absolute |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the markup or discount as an absolute value. With this it is possible to define the markup or discount as an absolute value and not as an percentage value. In this case the element <markup_discount_percentage> is unused. A discount has a negative sign.
|
|
 |
|
|
|
|
|
 |
Tag: markup_discount_amount |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The value of the calculated markup or discount. If the markup or discount was defined as absolute value it is identicall with that element. Otherwise it is the product of <amount> and <markup_discount_percentage>.
|
|
 |
|
|
|
|
|
 |
Tag: money_given |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money that the customer gave to the operator to pay its bill. The value is stored in the primary currency. The number of decimal places is stored in the country settings.
|
|
 |
|
|
|
|
|
 |
Tag: money_changed |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-999 999 999 - 999 999 999
|
|
Description: The money changed by the operator. It's the difference between <money_given> and <price_to_pay>.
|
|
 |
|
|
|
|
|
 |
Tag: total_with_change_mode |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0 - 1
|
|
Description: Tells whether the mode for calculating the change is set or not in the settings.
Value |
Description |
0 |
Total with change is not activated |
1 |
Total with change is activated |
|
|
Notes: This mode can be manipulated with the command <sales_application_configurations>
|
|
 |
|
|
|
|
|
|