 |
Command:
ARTICLE SPECIAL OFFERS
 |
Node: article_special_offers |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: This tag is used as container for commands regarding article specific special offers.
|
|
Notes: In the NSM of the UC3 application the content of this command is handled with NSM item 416.
|
|
 |
|
|
 |
Node: article_special_offer |
|
Mandatory: |
yes |
|
max. Occurrence: |
unbounded |
|
Supported modes: |
delete Delete the named item. deleteall Delete all items. read Read the named item. read+ Read the following item. read- Read the previous item. readall Read all items from the desired device(s). This doesn't mean comparable reading as in the L2 protocol. write Write the named item.
|
|
Description: Command for the maintenance of an article based special offer.
It allows to define an own special offer for each article/item.
In parallel to this command the previous command <special_offer> still exists
which has a higher priority than this command if an article/item is assigned a special offer in both ways at the same time.
|
|
Notes: The mode 'read' reads exactly one special offer. The mode 'read+' reads the next special offer of an article. The mode 'read-' reads the previous special offer of an article. The mode 'delete' deletes exactly one special offer. For the mode ''readall'' the following behaviour is supported: The table below shows values for the mandatory elements.
<department_no> |
<plu_no> |
<article_special_offer_id> |
Comment |
0 |
>=0 |
>=0 |
All available special offers will be returned. |
unequal 0 |
0 |
>=0 |
All available special offers within a department will be returned. |
unequal 0 |
unequal 0 |
>=0 |
All available special offers of an article/item will be returned. |
For the mode ''deleteall'' the following behaviour is supported: The table below shows values for the mandatory elements.
<department_no> |
<plu_no> |
<article_special_offer_id> |
Comment |
0 |
0 |
0 |
All available special offers will be deleted. |
unequal 0 |
0 |
0 |
All available special offers within a department will be deleted. |
unequal 0 |
unequal 0 |
0 |
All available special offers of an article/item will be deleted. |
The tag <priority> can be used as filter when deleting article special offer definitions.
It is possible to delete an article special offer definition of an article/item whose priority is set to e.g. 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 is belonging to.
|
|
 |
|
|
|
 |
Tag: plu_no |
|
Mandatory: |
yes |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
1 - 999 999
|
|
Nillable: |
no |
|
Description: The number of the article/item the special offer becomes valid.
|
|
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 special offer can be identified in combination with the department number and the plu number.
|
|
 |
|
|
|
 |
Tag: start_date |
|
Mandatory: |
no |
|
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: printer_text |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 100 characters
|
|
Nillable: |
no |
|
Description: The text printed on a receipt or on a label.
|
|
 |
|
|
|
 |
Tag: price1 |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - +99 999 999
|
|
Nillable: |
no |
|
Description: Price that replaces the <price1> of the article/item during the period between <start_date> and <end_date>. The price is stored as an integer value. The number of decimal places is stored in the countrysettings (22,55 Euro = 2255).
|
|
 |
|
|
|
 |
Tag: price2 |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - +99 999 999
|
|
Nillable: |
no |
|
Description: Price that replaces the <price2> of the article/item during the period between <start_date> and <end_date>. The price is stored as an integer value. The number of decimal places is stored in the countrysettings (22,55 Euro = 2255).
|
|
 |
|
|
|
 |
Tag: purchase_price |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
int |
|
Range: |
-9 999 999 - 99 999 999
|
|
Nillable: |
no |
|
Description: The purchase price of the article/item.
|
|
 |
|
|
|
 |
Tag: priority |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
short |
|
Range: |
1 - 10
|
|
Nillable: |
no |
|
Description:
The priority of the article/item based special offer.
This allows to define an order in the case when multiple special offers with a similar time frame are assigned to an article/item.
The smaller the value the higher is the priority.
|
|
Notes: The upper limit of the priority can be limited in file customer.ini. The default value is 10. This tag is supported with version 1.22.1 and higher.
|
|
 |
|
|
|
 |
Tag: last_change |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Nillable: |
yes |
|
Description: The last time when the record was changed. 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
|
|
 |
|
|