placeholder Command:  ARTICLE SPECIAL OFFER TURNOVERS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding article based 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: 1 - 9 999
Nillable: no
Description:
The number of the department the article(s)/item(s) belonging to.
Notes:
If the department number is set to 0 then the article turnovers from <plu_no_first> to <plu_no_last> of all departments are returned
   
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: int
Range: 1 - 999 999
Nillable: no
Description:
Lower limit of the range (PLU number).
If both, the first and the last article number are set to 0 then the turnovers of all article special offers are replied.
Notes:
The turnovers of the article based special offers within the range <plu_no_first> and <plu_no_last> will be returned if they are not 0.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
Upper limit of the range (PLU number).
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 article based special offers within the range <plu_no_first> and <plu_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 department.
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: max. 20 characters
Nillable: no
Description:
The name of the department.
       
     
Mandatory: no
max. Occurrence:  1
       
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: 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. 20 characters
Nillable: no
Description:
The attribute by which the article special offer can be identified in combination with the department number and the PLU number.
       
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
The current status of the article based 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: 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: no
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: 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.