|
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 creating, manipulating or deleting a validity of 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 will be processed by the device without a license key. The promotion functionality itself doesn't work without a license key.
For the mode ''deleteall'' the value of <promotion_validity_id> will not be evaluated. For the mode ''readall'' all validities that are equal or greater the value of <promotion_validity_id> will be returned. If the value is empty all available validities will be returned.
The values of the tags <start_date> and <end_date> can be set/reseted partially. The values for the apply range(s) can not be set/reseted partially. If the command contains the tag <apply_range> then an already existing apply range(s) will be deleted and replaced by the new one.
If a promotion validity is deleted its assigned articles/items set by the commands <article_promotions> will be deleted, too. This doesn't have influence on the article/items created by using the command <articles>.
|
|
 |