placeholder Command:  SPECIAL OFFER TURNOVERS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding special offer turnovers.
 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: read Read the named item.
Description:
This command is used for the turnovers of special offers.
Notes:
The TAF (TransActionFile) and the cumlated turnover reports are only disposed if one UC3 is configured to be the TAF-Server of this network (NSM item 841).
   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0
Nillable: no
Description:
The application type.
Value Description
0 Sales application and cash register application

   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 4
Nillable: no
Description:
The number of the turnover level .
Notes:
It's possible to define for the TAF-Server (NSM Item 921) from 1 to 4 turnover levels.
The turnovers are always accumulated to each level separately and afterwards there is a report for each level.
Each turnover level can be deleted separately.

Normally the turnover levels are used in the following way:
Level 1 - Turnover per DAY
Level 2 - Turnover per WEEK
Level 3 - Turnovers per MONTH
Level 4 - Turnover per YEAR

   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
Lower limit of the range
If both, the first and the last special offer numbers are set to 0 then the turnovers of all special offers are replied.
Notes:
The turnovers of the special offers within the range <special_offer_no_first> and <special_offer_no_last> will be returned if they are not 0.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
Upper limit of the range.
If both, the first and the last special offer numbers are set to 0 then the turnovers of all special offers are replied.
Notes:
The turnovers of the special offers within the range <special_offer_no_first> and <special_offer_no_last> will be returned if they are not 0.
   
     
Mandatory: no
max. Occurrence:  1
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0 - 2
Nillable: no
Description:
The state the turnovers are replied by the device.
Value Description
0 The data are complete and valid.
1 The data may incomplete.
This can happen when e.g. at least one device is missing/inactive in the scale network.
2 The data are invalid.
This can happen when a device is still transfering its TAF entries to the central TAF and hasn't finished it yet.

       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The sequence number of the last TAF entry that has been involved in the current turnover accumulation.
       
     
Mandatory: no
max. Occurrence:  1
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the special offer.
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
The current status of the special offer.
The following values are supported:
Value Description
ACTIVE Special offer dates are within the current date.
INACTIVE Special offer dates are changed from old date to future date.
FINISHED Special offer has already expired.
DELETED Special offer is deleted

       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The name of the special offer.
Notes:
In case of deleted special offers, the special offer name will not be available in the report.
This should mean that the tags are always in the XML reply. They don't have a content in that case, e.g.
       
Mandatory: yes
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
Date and time when the special offer price becomes valid.
CCYY-MM-DDThh:mm:ss
The format is as following:
C = Century
Y = Year
M = Month
D = Day
T = Separator between date and time
h = hour
m = minute
s = second
       
Mandatory: yes
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
Date and time after that the special offer price becomes invalid.
CCYY-MM-DDThh:mm:ss
The format is as following:
C = Century
Y = Year
M = Month
D = Day
T = Separator between date and time
h = hour
m = minute
s = second
       
     
Mandatory: no
max. Occurrence:  1
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the department.
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The name of the department.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
Information and turnovers of an article/item.
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the department the article/item belongs to.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the article/item.
Notes:
The manual plus , manual minus hand and enter unit price operations are treated as plu's.
By default (desribed in customer.ini) the PLU no 999 999 is used as manual plus, 999 998 as manual minus and 999 997 as enter unit price.
Its number can be changed in the file customer.ini.
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: max. 13 characters
Nillable: no
Description:
The unique article number. Necessary to identify the article
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The name of the article/item.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
Sold amount of the article/item. This is the product of the weight multiplied by the baseprice. The value is always stored in the primary currency.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated weight of the article/item.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated number of the items.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
Total information about the articles/items..
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated amount of the articles belonging to the special offer turnover
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The weight of the accumulated items belonging to the special offer turnover.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The total number of items belonging to the special offer turnover.