Upsell
Last updated
Was this helpful?
Last updated
Was this helpful?
An Upsell integration pulls information about customers, reservations, products and services, for specified time intervals, in order to automate upselling of personalised room upgrades, add-ons and experiences to guests.
Each Mews property creates a unique set of services and related products based on what they offer to their guests. Upsell integrations pull the relevant product information (e.g. name, unique identifier, price) and store it in their system for future use. A list of all the services a property offers can be requested using . The response contains a unique identifier which can then be used to pull all related products using .
'How to' use case
API Operations
How to get the list of services offered
How to get the list of products linked to services
If the integration is offering room upgrades to guests, it is important to take availability of the resources into account. After mapping the configuration of the property in your system, use to fetch resource availability for each resource category.
'How to' use case
API Operations
How to get room or resource availability
Help Guides:
Once all of the products, services and related information are correctly stored in the Upsell system, the next step is the posting of a selected product into Mews. How this product should be posted into Mews depends on whether it exists as a product in Mews and which type of service it belongs to.
'How to' use case
API Operations
How to get a specific reservation
How to add a product order to a reservation
Linking orders to reservations
'How to' use case
API Operations
How to get checked in and checked out guests
How to get only checked in guests
How to add a product order to a guest profile
How to link an order to a reservation
'How to' use case
API Operations
How to get the list of accounting categories
How to create staff reminders
Help Guides:
If the product is related to a Stay/Accommodation service, e.g. breakfast, an extra bed or a room upgrade, then it is useful to associate it with a specific reservation. This will lead to the correct overall count of products to be posted based on the total of nights in the reservation. First, the integration should retrieve the specific reservation using . The unique identifiers of the product and the reservation are then used in to add the required product order to the reservation.
If the product is created under a non-Stay/Accommodation service, it will only be posted once and does not have to be attached to a reservation. Examples include a bottle of champagne, a one-hour massage, or a pool bar cocktail. Unlike with a traditional PMS, where charges are posted to a room, in Mews all charges are posted directly to the guest profile. All guests, both active and checked out, can be retrieved using . This operation offers numerous filters, including guest email and guest names. To retrieve only guests still checked in at the property, use . The unique identifier of the chosen guest or customer is then used to add the product to the correct profile using . If the product being posted already exists in Mews, then use . If the product does not exist in Mews then use .
When using , specify parameter LinkedReservationId
in order to link the order to a guest reservation. This will greatly assist the property when using billing automation.
(use LinkedReservationId
)
To ensure correct reporting, all revenue items posted into Mews must be associated with their correct accounting category by sending the unique identifier in the of the request. Information about all the categories configured at each property can be obtained with . If a product being added to a reservation requires further action from hotel staff, create reminders and assign responsiblities using to ensure no aspect of the guest experience is forgotten.
Ensure you follow our general for testing integrations. In addition to this, and specific to Upsell integrations, check whether you are correctly managing the Stay product postings by reviewing the Items tab of the reservation you have posted it to, or review the Product column of the which has Include products
selected in the Options section. To confirm you are relating any product that is not configured in Mews with the correct accounting category, you can review the . If done correctly, the product you've posted will be listed under the relevant accounting category.