placeholder Command:  SCALE TURNOVERS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding requests of scale turnovers.
 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: read Read the named item.
Description:
This command is used to read the turnover of UC3 network devices.
Notes:
The TAF (TransActionFile) and the cumulated 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 - 4
Nillable: no
Description:
The application type.
Value Description
0 Sales application and cash register application
2 Self service application

Notes:
At the moment the value 0 is supported.
   
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 841) 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
Description:
The header that contains general turnover information.
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0 - 2
Nillable: no
Description:
The status of this turnover report.
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: 1 - 2 147 483 647
Nillable: no
Description:
The sequence number of the last TAF entry that has been involved in the current turnover accumulation.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
Turnover information about one operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the operator.
Notes:
See the command <operators>
       
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The sum of all price to pays of all receipts generated by this operator.
The amount can be the product of weight multiplied by 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 articles/items of all receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of the accumulated items of all receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of customers of all receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated amount of linevoids about all receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of linevoids about all receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated amount of voided receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of voided receipts that have been generated by this operator.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of zero receipts that have been generated by this operator.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
Turnover information about one operator for special offers.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the operator.
Notes:
See the command <operators>.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The sum of all price to pays of all registrations where a special offer has been assigned and that have been generated by this operator.
The amount can be the product of weight multiplied by 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 weight of the accumulated items marked as special offer.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
The summation about all operators.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated weight of all registrations that have been generated by all operators.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of accumulated articles/items about all operators.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of customers about all operators.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
The turnover information about one device.
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the department the scale turnovers refer to.
Notes:
The scale turnovers are arranged by department.
!!!! The element is available with UC3 version V1.17.2 and higher. !!!!
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 999
Nillable: no
Description:
The number of the device.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The amount accumulated on this device.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The weight of the accumulated articles/items on this device.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of the accumulated items on this device.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of customers on this device.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
The turnover information about all devices.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The amount accumulated about all devices.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The weight of the accumulated articles/items about all devices.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of accumulated articles/items about all devices.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of customers about all devices.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
The turnover information about a VAT (Value Added Tax) number.
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0 - 9 999
Nillable: no
Description:
The VAT number.
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0 - 9 999
Nillable: no
Description:
The value of the VAT. The VAT value is always stored with 2 decimal places.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated amount of all registrations that used this VAT.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The accumulated amount where this VAT number has been assigned to.
       
     
Mandatory: no
max. Occurrence:  unbounded
Description:
Turnover information about markups or discounts used on a scale.
!!!! This section is supported with UC3 version V1.27.0 and higher. !!!!
       
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The markup/discount number.
See command <markup_discounts>.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of registration the markup/discount has been applied.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The amount of the markup/discount summarized over all applied registrations.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The number of totals the markup/discount has been applied.
       
Mandatory: yes
max. Occurrence: 1
Datatype: int
Range: See the range of the datatype.
Nillable: no
Description:
The amount of the markup/discount summarized over all applied totals.