Guest technology

Guest technology covers a range of use cases related to guest technology, especially in-room technology, such as telephones, TV and entertainment systems, room controls and internet access. A typical use case involves posting charges for in-room telephone usage.

Setup

Firstly, use Get all services to retrieve all services the property has configured in Mews. Once all services are retrieved, you can select the service against which you would like charges to be posted. To retrieve the list of configured accounting categories or accounting codes, use Get all accounting categories. This is important because a hotel may, for example, prefer to have charges for international phone calls reported with a different accounting category than for domestic phone calls.

'How to' use case	API Operations
How to get the list of property services	Get all services
How to get the list of accounting categories	Get all accounting categories

Checked-in status

Guest technology integrations typically require information on changes to reservation state, especially when a reservation is checked-in and checked-out. Rather than polling the API for state changes, it is better to subscribe to notification events using Webhooks or WebSockets. Both methods support changes to reservations. Don't know which one to use? See Ways to communicate. Once a reservation update event is received, use the reservation ID in a Get all reservations request to retrieve information about the reservation and customer.

No Post: The customer classification Cashlist is used when charges cannot be sent to the customer bill. This is commonly known as ‘No Post’.

'How to' use case	API Operations
How to listen for changes to reservations	General Webhooks (ServiceOrderUpdated event) or WebSockets (Reservation event)
How to get reservation and customer details	Get all reservations

Charging checked-in customers

Once the unique identifier of the customer to be charged is obtained, the items can be posted onto their billing tab using the Add order operation. When using Add order, specify parameter LinkedReservationId in order to link the order to a guest reservation. This will greatly assist the property when using billing automation.

'How to' use case	API Operations
How to post an order item to a guest profile	Add order
How to link an order to a reservation	Add order (use LinkedReservationId)

Testing your integration

Please ensure you follow our general Usage guidelines for testing integrations. To confirm you are relating any product that is not configured in Mews with the correct accounting category, you can review the Accounting Report. If done correctly, the product you've posted will appear under the relevant accounting category in the Revenue section of the report.

Additional help for working with the demo environment

Help Guides:

• Understanding services
• Create or delete a product
• Creating an accounting category