Event service

The functions in this service are called whenever the components on the POS layout are updating themselves. For example when items are added to the sale and the receipt control updates itself, customer is added or cleared from the transaction change, balance information is changed and etc.

Main functionality

 

Name Description
BroadcastTotalsDataChangeEnabled If this function returns true then the Totals amount box will broadcast the information to the TotalsDataChange function in the service
CustomerVisualComponentDataChanged Any time a customer is added or cleared from the sale this event is called with information about the customer. The ExtraInfo parameters on the customer object can be given values and they will be displayed if those fields have been selected to be displayed in the customer object.
PreDisplayReceiptItem This function is called before the item is displayed in the receipt control. If PreDisplayReceiptItemArgs.DisplayReceiptItem is set to false then the item will not be displayed in the receipt control.
ReceiptSaleItemDataChange

When items are added, changed or removed from the receipt control on the POS layout this even is called. Any and all fields in the itemInfo property of the SaleItemDataChangeArgs parameter can be updated or changed. The POS will then display the changed values.

Only called for Retail transactions

ReceiptCustomerDepositDataChange

When a customer deposit item is added, changed or removed from the receipt control on the POS layout this even is called. Any and all fields in the itemInfo property of the CustomerDepositDataChangeArgs parameter can be updated or changed. The POS will then display the changed values.

Only called for Customer payment transaction

TotalsDataChange

Any time the transaction is changed in anyway this function is called with information from the Totals box on the POS layout. Any and all fields in the TotalsInfo property on the TotalsDataChangeArgs parameter can be changed and the update will be reflected in the Totals box on the POS layout.

The performance of the POS can be affected by this broadcast - especially if the expected basket of items is over 40-50 items which is why this broadcast has to be enabled by changing the BroadcastTotalsDataChangeEnabled return value

PreRefreshStatusStrip

Any time the POS starts or when an operation is performed, this function is called and it allows the customization of the terminal and operator status bar through the PreRefreshStatusStripArgs object. Default values will be used if the arguments are not changed.

Development pack

To find this service in the development pack go to DevPack\Source\POS\Services