placeholder Command:  ARTICLE SPECIFIC LABELS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding article specific label configurations.
 
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 an article specific label.
Notes:
Attention!
This command doesn't support the possibility to set or unset a single value.
Therefore when changing the value of one tag all tags have to be sent.

The label specification can be done for articles, the departments and /or an application.
The priority for the different levels is:
-> To print a label the application checks the settings for the application-mode.
-> If there are different settings for the department , this values have a higher priority.
-> If there are different settings for the article , this values have the highest priority.

The settings for this three levels are used cumulative according to the priority.

If there is a different template name for the department or the article all settings have to be done in this level, because in this case there is no cumulation.
This command doesn't support the possibility to set or unset a single value.
Therefore when changing the value of one tag all tags have to be send.

For the mode ''readall'' the following information can be helpful:
The table below shows values for the mandatory elements.
department_no plu_no Comment
0 0 All article/item label configurations of all departments will be returned.
0 unequal 0 All article/item label configurations of all departments whose plu numbers are greater or equal than the value of plu_no will be returned.
unequal 0 0 All article/item label configurations that are belonging to the desired deparment number will be returned.
unequal 0 unequal 0 All article/item label configurations of the desired department whose plu numbers are greater or equal than the value of plu_no will be returned.


For the mode ''deleteall'' the following information can be helpful:
The table below shows values for the mandatory elements.
department_no plu_no Comment
0 0 All article/item label configurations of all departments will be deleted.
0 unequal 0 All article/item label configurations of all departments whose plu numbers are greater or equal than the value of plu_no will be deleted.
unequal 0 0 All article/item label configurations that are belonging to the desired deparment number will be deleted.
unequal 0 unequal 0 All article/item label configurations of the desired department whose plu numbers are greater or equal than the value of plu_no 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.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the template that shall be used for printing the label on the first label printer.
With version V1.25.0.0 there is the support of 2 label printers in parallel (label printer and linerless printer).
This template is used for the printout on the label printer.
Notes:
A label template defines the arrangement of information on a label, e.g. position, font and size of the base price.
When printing a label for an article/item the base price will be printed at the position with the configured font.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the template that shall be used for printing the second label on the first label printer.
The second label means to print an additional label for the same article/item and is completely different to the label assigned with second_label_template.
Notes:
The delay between printing the first and second label can be defined in the file customer.ini (Switches nTimeSecondLabel and nTimeoutSecondLabel in the sections [sales], [selfservice], [prepack1] and [cashregister].)
The printout is successful when both the first and the second label could be printed without an error (TAF entry is generated when printout is successful).
This tag is supported with version V1.24.0.0 and higher.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the template that shall be used for printing a vario label - a label with variable length.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - max. font number
Nillable: no
Description:
The number of the font that shall be assigned to the first line of the TLU.
Notes:
The maximum number for the font is depending on the printer firmware.
The TLU is the name assigned to an article/item with the command articles.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - max. font number
Nillable: no
Description:
The number of the font that shall be assigned to the second line of the TLU.
Notes:
The maximum number for the font is depending on the printer firmware.
The TLU is the name assigned to an article/item with the command articles.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - max. font number
Nillable: no
Description:
The number of the font that shall be assigned to the third line of the TLU.
Notes:
The maximum number for the font is depending on the printer firmware.
The TLU is the name assigned to an article/item with the command articles.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - max. font number
Nillable: no
Description:
The number of the font that shall be assigned to the fourth line of the TLU.
Notes:
The maximum number for the font is depending on the printer firmware.
The TLU is the name assigned to an article/item with the command articles.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - max. font number
Nillable: no
Description:
The number of the font that shall be used for the ingredients.
Notes:
The maximum number for the font is depending on the printer firmware.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the text that shall be used for printing the company text.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the text that shall be used for printing the advertising text.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the text that shall be used for printing the sell by date text.
Notes:
The text number is referring the text created with the command texts the text_type=2 and the text_no=sell_by_date_text_no.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the text that shall be used for printing the best before date text.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 999 999
Nillable: no
Description:
The number of the text that shall be used for printing the packing date text.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
A description of the date format. For more information see the format documentation.
Notes:
Enables the customer to define the desired format of the date.
Useful when e.g. prepacking for another country has to be done.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
A description of the date format. For more information see the format documentation.
Notes:
Enables the customer to define the desired format of the date.
Useful when e.g. prepacking for another country has to be done.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
A description of the date format. For more information see the format documentation.
Notes:
Enables the customer to define the desired format of the date.
Useful when e.g. prepacking for another country has to be done.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 999
Nillable: no
Description:
The offset for calculating the 'sell by' date. The value is depending on the offset unit.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 999
Nillable: no
Description:
The offset for calculating the 'best before' date. The value is depending on the offset unit.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 2
Nillable: no
Description:
Value Description
0 The offset value will be interpreted as days.
1 The offset value will be interpreted as half days (1 day corresponds with the offset 2).
2 The offset value will be interpreted as hours (1 day corresponds with the offset 24).

Notes:
With version V1.16.0.0 and higher the values 1 and 2 are also supported.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 2
Nillable: no
Description:
Value Description
0 The offset value will be interpreted as days.
1 The offset value will be interpreted as half days (1 day corresponds with the offset 2).
2 The offset value will be interpreted as hours (1 day corresponds with the offset 24).

Notes:
With version V1.16.0.0 and higher the values 1 and 2 are also supported.
   
Mandatory: no
max. Occurrence: 1
Datatype: int
Range: 1 - 99 999
Nillable: no
Description:
The weight of an article sold by count.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the barcode definition.
With version V1.20.0.0 and higher it is possible to configure separate barcode definitions for articles/items sold be weight or by count.
If both tags (barcode_no and barcode_no_2) are set then barcode_no is used for articles/items sold by weight and barcode_no_2 is used for articles/items sold by count.
See also the tag barcode_no_2.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the barcode definition for articles/items sold by count.
This tag is supported with version V1.20.0.0 and higher.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 0 - 1
Nillable: no
Description:
This setting is refering to the packing date/best before date.
Value Description
0 Both, the packing date and the best before date will be printed.
1 Only one date will be printed.
If the value of the best before date offset is 0 then only the packing date will be printed.
If the value of the best before date offset is unequal 0 then only the best before date will be printed.

   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: -100 - +100
Nillable: no
Description:
The temperature by which the article/item has to be stored.
There are no decimal places for the storage temperature. A temperature of 7°C has the value 7.
   
Mandatory: no
max. Occurrence: 1
Datatype: short
Range: 1 - 9 999
Nillable: no
Description:
The number of the QR code to be printed.
This tag is supported with version V1.24.0.0 and higher.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the template that shall be used for printing the label on a second label printer.
With version V1.25.0.0 there is the support of 2 label printers in parallel (label printer and linerless printer).
This template is used for the printout on the linerless printer.
Notes:
A label template defines the arrangement of information on a label, e.g. position, font and size of the base price.
When printing a label for an article/item the base price will be printed at the position with the configured font.
This tag is supported with version V1.25.0.0 and higher.
   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: max. 100 characters
Nillable: no
Description:
The name of the template that shall be used for printing the label on a second label printer.
With version V1.25.0.0 there is the support of 2 label printers in parallel (label printer and linerless printer).
This template is used for the printout of a vario label on the linerless printer.
Notes:
A label template defines the arrangement of information on a label, e.g. position, font and size of the base price.
When printing a label for an article/item the base price will be printed at the position with the configured font.
This tag is supported with version V1.25.0.0 and higher.
   
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