Guest technology integrations, such as telephone systems or entertainment systems, are used to identify guests on telephones or TVs and to generate revenue by charging guests for outside phone calls.
The integration should use the Get all services operation to retrieve all services the property has configured in Mews.
Once all services are retrieved, the service which you would like all charges to be sent to can be selected. Alternatively, a field where the ServiceId can be entered can be used.
The Get all accounting categories operation should be used to retrieve all accounting categories the property has configured in Mews. This is important as a hotel may prefer to have charges for international phone calls reported with a different accounting category than domestic phone calls.
Guest technology integrations require information on changes to reservation state. Rather than polling the Mews 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 all information about the reservation and customer.
Note: The customer classification
Cashlistis used when charges cannot be sent to the customer bill. This is commonly known as ‘No Post’.
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. If the product being posted already exists in Mews, then use Product order parameters. If the product does not exist in Mews then use the Item parameters.
Please ensure you follow our general 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 Mews Accounting Report. If done correctly, the product you've posted will appear under the relevant accounting category in the Revenue section of the report.