Hospitality service

The Hospitality service is used when the POS is configured to be a hospitality POS. The service handles all of the table management functionality and has the layout of the table view within the service as well. It also handles all the functionality for split bills, transfers, station printing and etc.

 

Configurations

There area various configurations that need to be set so that the hospitality functionality will work as expected.

The functionality profile needs to be set as a hospitality profile, if that is not done then none of the hospitality functionality will work.

All the other hospitality specific functionality is explained in detail in the LS One online help.

Main functionality

 

Name Description
ConcludeTransaction This is called before the Transaction service Conclude transaction code is run.
GetDiningTableStatusText Sets the texts on the tables depending on their status
IsTableLockedByCurrentTerminal The code in this function is commented out and should only be used when absolutely necessary. See further comments and notes in the function itself.
PreparationForPayment All payment operations call this function. All items that have not been sent already to the station printer will be printed (if they are printable)
RunHospitalityPart This function is called by the POS when the user exists the POS to go back into the table view. Here all changes to the table are done and the changes are saved.
TransferTable Runs the transfer table functionality using the SplitBill dialog. This function is not called untill the second table is selected i.e. the table to transfer to.
SendToStationPrinter Used by the hospitality service itself and Central suspensions when they are configured to be printed on a station printer.
SetPrintingStatus Goes through the items on the table and decides if they need to be updated so that they will be printed on the station printer. There are a few different overloaded versions of this function.
StationPrinter class Takes care of the entire station printing functionality including creating the station printing receipt in code. There is some configuration that is used by the printing functionality please see the Printing station configurations for more information.

POS Operations

Many operations in the POS directly call the Hospitality service. Here below is a list of all the operations and which functions they call

Name Description
Any payment operation Calls functions FinalizeSplitBill, PostPayment
Change item comments Calls function SetPrintingStatus
Clear item comments Calls function SetPrintingStatus
Item comments Calls function SetPrintingStatus
Item sale Calls function IsTableLockedByCurrentTerminal
Set quantity Calls function SetPrintingStatus
Split bill Calls function SplitBill
Print hospitality type menu Calls function PrintHospitalityMenuType
Void item Calls function SetPrintingStatus
Void transaction Calls function TransactionVoided

Development pack

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

 

See also

Functionality profile (Hospitality tab)

Hospitality configurations

Central suspension service

Transaction service