 |
Command:
ARTICLE PROMOTIONS
 |
Node: article_promotions |
|
Mandatory: |
no |
|
max. Occurrence: |
unbounded |
|
Description: This tag is used as container for commands regarding the assignment of promotions to articles.
|
|
 |
|
|
 |
Node: article_promotion |
|
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: This command is used for assigning, manipulating or deleting the assignment of an article to a promotion.
|
|
Notes: To use the promotion functionality on the device it is necessary to activate it.
"Promotion" is an option which needs a license key to be enabled (uc3options.xml).
The XML command wil be processed by the device without a license key. The promotion functionality itself doesn't work without a license key.
For the mode ''read'' the tags <department_no> and <plu_no> will be evaluated. Since it is possible to assign more than one promotion definitions resp. promotion validities to an article/item the result
can be more than one hit. For the mode ''readall'' the following information can be helpful: If <department_no> is set to 0 all article promotion assignments that can be found in the system will be returned. The value of plu_no will no be evaluated.
If <department_no> is unequal 0 then all article promotion assignments will be returned whose article belongs to that department and whose
article/item number is greater than the value of plu_no. For the mode ''deleteall'' the content of <department_no> and <plu_no> will not be evaluated. For the mode ''delete'' the value of <department_no>, <plu_no>,
<promotion_definition_id> and <promotion_validity_id> will be evaluated.
|
|
 |
|
|
|
 |
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.
|
|
Notes: The plus hand, minus hand and enter unit price operations are treated like normal articles. By default (described in the file customer.ini) the plu no 999 999 is used as plus hand, the plu no 999 998 as minus hand
and the plu no 999 997 as enter unit price. The plu number can be changed in the file customer.ini.
|
|
 |
|
|
|
 |
Tag: promotion_definition_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Nillable: |
no |
|
Description: The id of the promotion definition. This value is the link to the promotion definition .
|
|
 |
|
|
|
 |
Tag: promotion_validity_id |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
string |
|
Range: |
max. 50 characters
|
|
Nillable: |
no |
|
Description: The id of the promotion validity. This value is the link to the promotion validity .
|
|
 |
|
|
|
 |
Tag: last_change |
|
Mandatory: |
no |
|
max. Occurrence: |
1 |
|
Datatype: |
dateTime |
|
Range: |
- |
|
Nillable: |
yes |
|
Description: 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
|
|
 |
|
|