placeholder Command:  SALES APPLICATION CONFIGURATIONS 


Short version Long version Changes Example

Mandatory: no
max. Occurrence:  unbounded
Description:
This tag is used as container for commands regarding the configuration of sales applications.
Notes:
This command can be used without limitations for UC3 application versions lower than version 1.12.0.0.
See more details in the note for the next Tag.

 
Mandatory: yes
max. Occurrence:  unbounded
Supported modes: read Read the named 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 reading and manipulating a sales application specific configuration.
Notes:
This command can be used without limitations for UC3 application versions lower than version 1.12.0.0.

With version V1.12.0.0 and higher the functionality of this command has been shipped to command configuration_profiles
which is used in combination with the commands mode_profiles and profile_assignments.

It's not intended to use this command with versionV1.12.0.0 and higher but not at all it's possilbe to use it backwards compatible if in the file customer.ini in section [network] the parameter "bEnableConfigurationDataSynchronization" is changed. See more details about this in the document Handling-of-TransUC3-configuration-data.


For the mode '<'readall'>' the value of the element <name> will not be evaluated.
   
Mandatory: yes
max. Occurrence: 1
Datatype: short
Range: 0 - 999
Nillable: no
Description:
The number of the target device(s).
Notes:
For further information see the paragraph about Distribution of data
Device number 0 indicates all devices.
   
Mandatory: yes
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
The following names will be provided:
Name Description Range
bIsNegativePriceByCountAllowed Is negative manual input allowed? (0/1)
bIsPositivePriceByCountAllowed Is positive manual input allowed? (0/1)
bIsPriceByWeightAllowed Is unit price allowed? (0/1)
bIsPriceByWeightWithoutHashKeyAllowed Is unit price without #-key allowed? (0/1)
bIsPriceOverwriteAllowed Is it allowed to overwrite a price? (0/1)
bIsArticleCountAllowed Is multiplication of a non weighing item allowed?
The number of items will be stored in the element toi of the transaction file (taf).
(0/1)
bIsVoidRegistrationAllowed Is line void allowed? (0/1)
bIsPriceZeroRegistrationAllowed Is zero registration allowed? (0/1)
bIsOperatorAllocateFreeAllowed Is log on/off of an operator allowed? (0/1)
bIsOperatorShortFreeAllowed Is short log off of an operator allowed? (0/1)
bIsFloatingClerkAllowed Is the floating clerk desired? (0/1)
nFloatingClerkGrpNo Number of the floating clerk group 1 - 9999
bIsMultibleArticleRegistrationAllowed Is multiple registering of non weighing items allowed? (0/1)
bIsSummationAllowed Is it desired to allow more than one registration before printing? (0/1)
ePrintoutType The following types are supported:
PRINT_RECEIPT
PRINT_RECEIPT_TALON
PRINT_RECEIPT_TOTAL
PRINT_RECEIPT_TALON_TOTAL
PRINT_RECEIPT_ENDLESS
PRINT_LABEL_ENDLESS_TOTAL
PRINT_RECEIPT_ENDLESS_TALON
PRINT_RECEIPT_LABEL
PRINT_RECEIPT_LABEL_TALON
PRINT_LABEL
PRINT_LABEL_TOTAL
PRINT_LABEL_ENDLESS
PRINT_LABEL_VARIO
 
bIsGivenAndReturnAllowed Is total with change allowed?
!!!! Only when bIsSummationAllowed = 1 !!!!
(0/1)
bIsReceiptPreviewAllowed Is the preview of the current unfinished receipt allowed?
!!!! Only when bIsSummationAllowed = 1 !!!!
(0/1)
nDefaultPriceNo 0 = Price1
1 = Price2
0-1
nDefaultDepartmentNo Department number which will be used when entering a plu number. 1 - 9999
nKeyboardNo The number of the keyboard layout configured for the built-in keyboard type. 0 - 999
print.receipt.sTemplate The name of the template for printing a receipt.
If no template is assigned the default template is used.
print.receipt.bHeadtext Is a header text desired on the receipt? (0/1)
print.receipt.nHeadtext The number of the header text that shall be printed.
!!!! Only valid when print.receipt.nHeadtext = 1 !!!!
1-999999
print.receipt.bHeadbitmap Is the header bitmap desired on the receipt? (0/1)
print.receipt.bFoottext Is a footer desired on the receipt? (0/1)
print.receipt.nFoottext The number of the footer text that shall be printed.
!!!! Only valid when print.receipt.nFoottext = 1 !!!!
1-999999
print.receipt.bFootbitmap Is the footer bitmap desired on the receipt? (0/1)
print.receipt.bBranchtext Is a branch text desired on the receipt? (0/1)
print.receipt.nBranchtext The number of the branch text that shall be printed.
!!!! Only valid when print.receipt.nBranchtext = 1 !!!!
1-999999
print.receipt.bReceiptNoBig Is a bigger receipt number desired on the receipt? (0/1)
print.receipt.bPlu Is the plu number desired on the receipt? (0/1)
print.receipt.bDepartmentDetailed Is the department detailed listing of the items on the receipt desired? (0/1)
print.receipt.bDepartmentDetailedTotal Is a total over all departments desired?
!!!! Only valid when print.receipt.bDepartmentDetailed = 1 ?
(0/1)
print.receipt.bDepartmentDetailedCompact Is the printout of a compact (less paper) department detailed receipt desired?
!!!! Only valid when print.receipt.bDepartmentDetailed = 1
(0/1)
print.receipt.bBarcode Is the printout of a barcode on the receipt desired? (0/1)
print.receipt.nBarcode The number of the barcode definition used for printing the barcode on the receipt.
!!!! Only valid when print.receipt.bBarcode = 1
1-9999
print.receipt.bServedBy Is the printout of a text like You were served by: desired? (0/1)
print.receipt.nServedByText The number of the text that shall be printed.
!!!! Only valid when print.receipt.bServedBy = 1
1-999999
print.receipt.bSummationWeight Is the disclosure of the accumulated weight desired? (0/1)
print.receipt.bSummationPos 0 = The number of items shall be printed on the receipt.
1 = The number of positions shall be printed on the receipt.
(0/1)
print.receipt.bVat Is the disclosure of the vat desired? (0/1)
print.talon.bBarcode Is the printout of a barcode on the talon desired? (0/1)
print.talon.nBarcode The number of the barcode definition used for printing the barcode on the talon.
!!!! Only valid when print.talon.bBarcode = 1
1-9999
nRapidServiceOperatorKey The number of the operator key used for Rapid Service .
!!!! Only valid when bIsRapidServiceEnabled = 1 !!!!
1 - 999
bIsNumberOfWeighingArticlesPerPackAllowed Is multiplication of a weighing article allowed?
The multiplication has no effect on the calculation of the price.
The number of items will be printed on a receipt or a vario label.
The number of items will be stored in the element toi of the transaction file (taf).
(0/1)
print.receipt.bUan Is the printout of the uan desired on the receipt? (0/1)
The following keys are supported with version 1.1.2 and higher.
bIsTraceabilityAllowed Is traceability in this mode desired?. (0/1)
print.receipt.bTare Is the printout of the tare on the receipt desired? (0/1)
print.receipt.bTLUMultiline Shall all available TLU lines be printed on the receipt in up to 4 lines?
If the value is set to 0 then all available TLU line will be printed in 1 line on the receipt.
If the value is set to 1 then all available TLU lines will be rinted in up to 4 lines on the receipt
If the string contains more characters then the printer allows for one line then it will be reduced by the rules of a softbreak.
A linefeed will be converted to a blank.
(0/1)
print.receipt.bTLUWithLinefeed Only the first TLU line (if print.receipt.bTLUMultiline is set to 0) will be printed in 1 line on the receipt.
All TLU lines (if print.receipt.bTLUMultiline is set to 1) will be printed in up to 4 lines on a receipt. If the string contains more characters then the printer allows for one line then it will be reduced by the rules of a softbreak.
A line on the printer end when a linefeed in the TLU is found or the rules of a softbreak becomes valid.
(0/1)
The following key is supported with version 1.2.0 and higher.
bIsPromotionAllowed Is the use of the promotion functionality desired?. (0/1)
The following keys are supported with version 1.3.2 and higher.
bIsPaymentsEnabled Is Payments Enabled desired?
(0/1)
bIsCashDrawerClosingForced Is Forced Closing Cash Drawer desired?
(0/1)
bIsMoneyChangeForced Is Forced Money Change desired?
(0/1)
he following keys are supported with version 1.3.3 and higher.
bIsReopenReceiptAllowed Is reopen of a receipt allowed?
!!!! Only when bIsSummationAllowed = 1 !!!!
(0/1)
bIsRapidServiceEnabled Is rapid service in sales mode desired?
(0/1)
The following keys are supported with version 1.5.0 and higher.
print.receipt.bHeadtext1
print.receipt.bHeadtext2
print.receipt.bHeadtext3
print.receipt.bHeadtext4
print.receipt.bHeadtext5
print.receipt.bHeadtext6
print.receipt.bHeadtext7
Is a header text desired on the receipt?
(0/1)
print.receipt.nHeadtext1
print.receipt.nHeadtext2
print.receipt.nHeadtext3
print.receipt.nHeadtext4
print.receipt.nHeadtext5
print.receipt.nHeadtext6
print.receipt.nHeadtext7
The number of the header text that shall be printed.
!!!! Only valid when print.receipt.bHeadtext1...print.receipt.bHeadtext7 = 1 !!!!
1-999999
print.receipt.bFoottext1
print.receipt.bFoottext2
print.receipt.bFoottext3
print.receipt.bFoottext4
print.receipt.bFoottext5
print.receipt.bFoottext6
print.receipt.bFoottext7
Is a footer desired on the receipt? (0/1)
print.receipt.nFoottext1
print.receipt.nFoottext2
print.receipt.nFoottext3
print.receipt.nFoottext4
print.receipt.nFoottext5
print.receipt.nFoottext6
print.receipt.nFoottext7
The number of the footer text that shall be printed.
!!!! Only valid when print.receipt.bFoottext1...print.receipt.bFoottext7 = 1 !!!!
1-999999
print.receipt.headText.nFontNo
print.receipt.headText.nFontNo1
print.receipt.headText.nFontNo2
print.receipt.headText.nFontNo3
print.receipt.headText.nFontNo4
print.receipt.headText.nFontNo5
print.receipt.headText.nFontNo6
print.receipt.headText.nFontNo7
The number of the font text that shall be printed regarding head texts.
1-999999
print.receipt.headText.nAlignmentNo
print.receipt.headText.nAlignmentNo1
print.receipt.headText.nAlignmentNo2
print.receipt.headText.nAlignmentNo3
print.receipt.headText.nAlignmentNo4
print.receipt.headText.nAlignmentNo5
print.receipt.headText.nAlignmentNo6
print.receipt.headText.nAlignmentNo7
The number of the alignment type of the text that shall be printed regarding head texts.
1-999999
print.receipt.footText.nFontNo
print.receipt.footText.nFontNo1
print.receipt.footText.nFontNo2
print.receipt.footText.nFontNo3
print.receipt.footText.nFontNo4
print.receipt.footText.nFontNo5
print.receipt.footText.nFontNo6
print.receipt.footText.nFontNo7
The number of the font text that shall be printed regarding foot texts.
1-999999
print.receipt.footText.nAlignmentNo
print.receipt.footText.nAlignmentNo1
print.receipt.footText.nAlignmentNo2
print.receipt.footText.nAlignmentNo3
print.receipt.footText.nAlignmentNo4
print.receipt.footText.nAlignmentNo5
print.receipt.footText.nAlignmentNo6
print.receipt.footText.nAlignmentNo7
The number of the alignment type of the text that shall be printed regarding foot texts.
1-999999
print.receipt.bSeparateDepartmentReceipt If the receipt contains registrations belonging to different departments then for each department a separate receipt with a separate receipt number will be generated.
!!!! Only valid when print.receipt.bDepartmentDetailed = 1
(0/1)
The following keys are supported with version 1.5.1 and higher.
bIsCashRegisterEnabled
Is the enabling of cash register desired?
(0/1)
bIsOpenCashDrawerOnZeroReceiptEnabled
Is the opening of cash drawer on zero receipt desired?
(0/1)
bUseLotBestBeforeOffset
Is the using of lot best before offset desired?
(0/1)
nLotBestBeforeOffset
The value of the lot best before offset.
0 - 999
The following keys are supported with version 1.6.0 and higher.
bIsBReceiptsAllowed
Is basket number receipt desired?
(0/1)
print.receipt.bBarcodeBReceipt
Is the printout of a barcode with basket number desired?
(0/1)
print.receipt.nBarcodeBReceipt
The number of the barcode definition used for printing the barcode with basket number.
!!!! Only valid when print.receipt.bBarcodeBReceipt = 1
1 - 9999
print.talon.bBarcodeBReceipt
Is the printout of a barcode with basket number on talon desired?
(0/1)
print.talon.nBarcodeBReceipt
The number of the barcode definition used for printing the barcode with basket number on the talon.
!!!! Only valid when print.talon.bBarcodeBReceipt = 1
1 - 9999
The following keys are supported with version 1.6.3 and higher.
eArticleMatchcodeSearchType Allows the selection of an article/item by matchcode belonging to a department or a category. SEARCH_BY_DEPARTMENT
SEARCH_BY_CATEGORY
The following keys are supported with version 1.7.4 and higher.
bIsDepartmentChangeAllowed
Is it allowed to register articles/items of different departments on the same receipt?
!!!! Only valid when bIsSummationAllowed = 1 and when print.receipt.bDepartmentDetailed = 1.
(0/1)
The following property is supported with version 1.10.3 and higher.
bIsGrossWeightControlAllowed Is control of the grossweight desired?
This feature is used for self checkout.
For information about self checkout see the separate provided documentation from Mettler Toledo.
(0/1)

   
Mandatory: no
max. Occurrence: 1
Datatype: string
Range: -
Nillable: no
Description:
The allowed values are depending on the name of the property that shall be influenced.
The range of value is documented above.