placeholder Command:  ARTICLE PROMOTIONS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding the assignment of promotions to articles.
 
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.
   
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.
   
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.
   
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 .
   
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 .
   
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