placeholder Command:  ARTICLE FORWARD PRICES 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding forward price maintenance of an article/items.
Notes:
In the NSM of the UC3 application the content of this command is handled with NSM item 413.
 
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 items forward price.
It allows the modification of an items price in advance where the price becomes valid at a predefined date and time.
Notes:
The mode 'read' reads exactly one forward price.
The mode 'read+' reads the next forward price of an article.
The mode 'read-' reads the previous forward price of an article.
The mode 'delete' deletes exactly one forward price.
For the mode ''readall'' the following behaviour is supported:
The table below shows values for the mandatory elements.
<department_no> <plu_no> <start_date> Comment
0 >=0 >=0 All available forward prices will be returned.
unequal 0 0 >=0 All available forward prices within a department will be returned.
unequal 0 unequal 0 >=0 All available forward prices 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> <start_date> Comment
0 >=0 >=0 All available forward prices will be deleted.
unequal 0 0 >=0 All available forward prices within a department will be deleted.
unequal 0 unequal 0 >=0 All available forward prices of an article/item will be deleted.

   
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 the forward price shall be assigned to.
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.
   
Mandatory: yes
max. Occurrence: 1
Datatype: dateTime
Range: -
Nillable: yes
Description:
The date when the forward 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
Notes:
The values of the tags <start_date> and <end_date> can be set/reseted partially.
   
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 at the date and time set in start_date.
The price is stored as an integer value. The number of decimal places is stored in the countrysettings (22,55 Euro = 2255).
   
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 at the date and time set in start_date.
The price is stored as an integer value. The number of decimal places is stored in the countrysettings (22,55 Euro = 2255).
   
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