The XMLPOS IP Connector integration establishes a link between your POS system and Mews Operations.

The configuration of the integration varies based on your property order and ticket processing method. 

 

The following use cases outline various scenarios and the respective configurations that can be used to give you greater visibility.

 

Learn more about setting up and configuring the XMLPOS IP Connector integration in our help article Connecting the XMLPOS IP Connector integration with your POS

 

In this article, you can learn about the use cases below: 

• Use case 1: Simple billing
• Use case 2: Detailed billing
• Use case 3: Charging a paymaster
• Use case 4: Discounts and Service Charges
• Use case 5: Outlet Bills
• Use case 6: Payments

 

Use case 1: Simple billing

 Use Case: 

• Not all bills from the POS are sent to the PMS.
• Taxes counted and declared on the POS side.
• The food revenue categories, i.e. what your guests eat, does not require itemized breakdown.  

 

 

To set up simple billing, you need:

• 1 unique service key, for example, Restaurant Pescatore.
• 1 sale accounting category, for example, Restaurant charged to room. 
• No Taxes.

 

 

 

Example of a POS bill:

 

Ticket 1234
Food	46.00
Alcohol	18.00
Soft drinks	6.50
Tips (non-taxable)	10.00
Taxes 15% (included)	9.20
Total of the bill	80.50

 

 Information the system sends to the PMS if using this simple Billing configuration: only one grouped line is sent to PMS.

 

Accounting category	Amount	Taxes
Restaurant charged to room 1234	80.50	0.00

 

Use case 2: Detailed billing

 Use Case: 

• All POS bills are sent to the PMS.
• Taxes counted and declared on PMS side.
• Revenue categories set up, i.e. categorized breakdown needed.
• One or more outlets (Revenue centers), for example Restaurant, Pool, Bar, etc.

 

To set up detailed billing, you need, for each outlet: 

• 1 unique outlet name, for example, Pescatore Restaurant. 
• 1 outlet identifier outlet 2 for Pescatore which your POS provider needs to provide. 

 

• 1 or more Serving time, for example, Lunch, Breakfast, etc.

 

For each serving time

• 16 accounting categories for the room charge and its taxes, for example, food, beverage  etc. (only one mandatory)
• 1 (optional) accounting category – the 17^th Accounting category is for Cash rounding only
• 16 (optional) accounting categories for the room charge discount and its taxes, for example, discount on food, discount on beverages etc. charged to the room. Learn more in Use case 4: Discounts and Service Charges
• 1 (optional but recommended) accounting category for tips (not taxable), for example, Gratuity. 
• 16 (optional) accounting categories for the service charge and its taxes, for example - Service charge. Learn more in Use case 4: Discounts and Service Charges

 

 

 

 

Scroll down for Discount accounting categories (up to 16 available)

Scroll down for Service Charge account categories (up to 16 available)

Scroll down for Tip Account category (1 available)

 

Example of a POS bill in gross environment:

Ticket 1234
Food	46.00
Alcohol	18.00
Soft drinks	6.50
Tips (non-taxable)	10.00
TAXES 15% included	9.20
Total of the bill	80.50

 

What the system sends to the PMS with a detailed configuration setup:

 

Accounting category	Amount	TAXES
food	40.00	6.00
alcohol	15.65	2.35
soft drink	5.65	0.85
Tips	10	0.00

 

Use case 3: Charging a paymaster

Use Case:

Some customers have a bill in the hotel but no room; they are just here for one day, or a meeting/event. In this case, the PMS opens a Paymaster for the customer or company and the POS can charge this paymaster. The system performs the recognition of the paymaster through the prefix defined in the general setup

 

 

Setup for paymaster customers:  

• In this case, the system chooses the recommended prefix ‘pm’.
• If the customer has a room, then the property enters the room number or guest surname when charging to the room.
• If the client wants to charge the paymaster using their POS, then they can enter the 'pm'- <customer number> or alternatively the last name of the paymaster customer record, for example, pm-64210 or Katrina Wedding.

Use case 4: Discounts and Service Charges

 Use Case:

• You can use discounts and Service Charges in any detailed configuration.
• When posting the bill on the POS, the POS user can add a global discount and/or Service charge to the ticket as a percentage or fixed amount.  
• You need to deduct this amount from the total net sales, as well as its taxes.
• If using a single product food revenue category, as in use case 1 the discount and/or service charges are in the same accounting category as the restaurant room charge.

 

If using the detailed billing configuration, then you need to specify a specific account category for each discounts and service charges.  Please be aware that the way in which they display will depend on your POS setup and your POS system, so recommend you check with your POS provider on how this feature will work.

 

To set up discounts and Service Charge, you need, for each outlet / serving time to populate the Discounts and service charge accounting categories with their taxes

Example of a POS detailed bill from the swimming pool restaurant in a gross environment:

Ticket 1234
Food	46.00
Discount 10$	-10.00
Alcohol	18.00
Soft drinks	6.50
Tips (non-taxable)	10.00
Service Charge %	5.00
TAXES 15% (included)	8.55
Total of the bill	75,50

 

Example information the system sends to the PMS, for ticket 1234:

Accounting category	Amount	TAXES
Pool food ticket 1234 ($46.00) less Discount on Pool food ($10.00)	31.30	4.70
Pool alcohol ticket 1234	15.65	2.35
Pool soft drink ticket 1234	5.65	0.85
Service Charge	4.35	0.65
Tips	10	0.00

Use case 5: Outlet Bills

Use Case:

• All POS bills sent to the PMS, including bills paid at the POS.
• Not all the customers pay via the PMS, some of them pay at the POS with cash, credit card, or other payment types.
• Taxes counted and declared on the PMS side.
• The system sends all revenues and payments that are paid in the POS (not sent as a customer’s room bill) to outlet bills in Mews. Note: Learn more in our help article What is the difference between Outlet revenue and Mews revenue?. 

 

 

To set up outlet bills, you need:

• To leave the paymaster ID blank for the payment mapping.
• 1 or more outlets set up in Mews.

In Mews Operations, go to the main menu  > Settings > Property > Outlets to obtain the Outlet key.

 

Example POS detailed bill, consumed at Bar in a gross environment:

 

Ticket 1234
Food	9.00
Alcohol	10.00
Soft drinks	5.00
Tips (non-taxable)	3.00
TAXES 15% (included)	3.50
Total of the bill	27.00
Visa payment	-27.00

 

What the system sends to Mews PMS in an outlet bill:

 

Accounting category	Amount	TAXES
Food	7.83	1.17
Alcohol	8.70	1.30
Soft Drinks	4.35	0.65
Tips	3.00	0.00
Visa Bar	-27.00	0.00

 

Outlet bills are available in the accounting report.

 

 

Use case 6:  Payments

 Use Case:

• All POS bills sent to the PMS including bills paid at the POS. 
• Not all customers pay via the PMS, some of them pay at the POS with cash, credit card, or other payment type.
• Taxes counted and declared on the PMS side.
• The system sends all revenues and payments that are paid in the POS (not sent as a customer’s room bill) to a paymaster bill in Mews. Note: Learn more in our help article What is the difference between Outlet revenue and Mews revenue?.

 

To set up payment mappings, you need:

 

• Outlet key is left blank
• 1 payment id, for example, 1. Note: Your POS provider needs to provide this information. 
• 1 paymaster account where the system sends all posts, for example POS-CASH Id
• 1 payment accounting category key for this payment, for example, Cash Deposit. 
• 1 external Payment, for example, Cash.

 

 

 

 

Example POS detailed bill in a gross environment:

Ticket 1234
Food	46.00
Alcohol	18.00
Soft drinks	6.50
Tips (non-taxable)	10.00
TAXES 15% (included)	9.20
Total of the bill	80.50
Cash payment	-80.50

 

What the system sends to PMS If you have the Paymaster dedicated to cash payments:

Accounting category	Amount	TAXES
food	40.00	6.00
alcohol	15.65	2.35
soft drink	5.65	0.85
Tips	10.00	0.00
Cash restaurant	-80.50	0.00