 |
Command:
ARTICLE SPECIAL OFFER TURNOVERS
 |
Node: article_special_offer_turnovers |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: This tag is used as container for commands regarding article based special offer turnovers.
|
|
 |
|
|
 |
Node: article_special_offer_turnover |
|
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).
|
|
 |
|
|
|
 |
Tag: department_no |
|
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
|
|
 |
|
|
|
 |
Tag: application_type |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
0
|
|
Nillable: |
no |
|
Description: The application type.
Value |
Description |
0
|
Sales application and cash register application |
|
|
 |
|
|
|
 |
Tag: layer_no |
|
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
|
|
 |
|
|
|
 |
Tag: plu_no_first |
|
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.
|
|
 |
|
|
|
 |
Tag: plu_no_last |
|
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.
|
|
 |
|
|
|
 |
Choice: |
|
|
|
|
 |
Node: turnover_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
 |
|
|
|
|
|
 |
Tag: turnover_state |
|
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.
|
|
|
 |
|
|
|
|
|
 |
Tag: sequence_no |
|
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.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: department_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Nillable: |
no |
|
Description: The number of the department.
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Nillable: |
no |
|
Description: The name of the department.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: article_info |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Nillable: |
no |
|
Description: The number of the department the article/item belongs to.
|
|
 |
|
|
|
|
|
 |
Tag: plu_no |
|
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.
|
|
 |
|
|
|
|
|
 |
Tag: uan |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 13 characters
|
|
Nillable: |
no |
|
Description: The unique article number. Necessary to identify the article
|
|
 |
|
|
|
|
|
 |
Tag: name |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 20 characters
|
|
Nillable: |
no |
|
Description: The name of the article/item.
|
|
 |
|
|
|
|
|
|
|
|
 |
Node: article_special_offer_values |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: Information and turnovers of an article/item.
|
|
 |
|
|
|
|
|
 |
Tag: department_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 9 999
|
|
Nillable: |
no |
|
Description: The number of the department the article/item belongs to.
|
|
 |
|
|
|
|
|
 |
Tag: plu_no |
|
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.
|
|
 |
|
|
|
|
|
 |
Tag: article_special_offer_id |
|
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.
|
|
 |
|
|
|
|
|
 |
Tag: status |
|
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 |
|
|
 |
|
|
|
|
|
 |
Tag: start_date |
|
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
|
|
 |
|
|
|
|
|
 |
Tag: end_date |
|
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
|
|
 |
|
|
|
|
|
 |
Tag: amount |
|
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.
|
|
 |
|
|
|
|
|
 |
Tag: weight |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
See the range of the datatype.
|
|
Nillable: |
no |
|
Description: The accumulated weight of the article/item.
|
|
 |
|
|
|
|
|
 |
Tag: number_of_items |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
See the range of the datatype.
|
|
Nillable: |
no |
|
Description: The accumulated number of the items.
|
|
 |
|
|
|
|
|
|