Connector API
  • Mews Connector API
  • Getting started
  • Usage guidelines
    • Authentication
    • Requests
    • Responses
    • Environments
    • Serialization
    • Pagination
    • Best practices
  • Concepts
    • Multi-property
    • Restrictions
    • Taxation
    • Time units
  • Use cases
    • 'How to' use cases
    • Accounting
    • Customer loyalty
    • Customer management
    • Customer messaging
    • Data export
    • Device integration
    • Events
    • Guest technology
    • Housekeeping
    • Kiosk
    • Mews Payment Terminals
    • Payment automation
    • Point of sale
    • Reputation management
    • Revenue management
    • Upsell
  • API Operations
    • Common objects
    • Accounting categories
    • Accounting items
    • Accounts
    • Account notes
    • Addresses
    • Age categories
    • Availability adjustments
    • Availability blocks
    • Bills
    • Business segments
    • Cancellation policies
    • Cashiers
    • Cashier transactions
    • Commands
    • Companies
    • Companionships
    • Company contracts
    • Configuration
    • Counters
    • Countries
    • Credit cards
    • Currencies
    • Customers
    • Departments
    • Devices
    • Enterprises
    • Exchange rates
    • Exports
    • Identity documents
    • Images
    • Languages
    • Loyalty memberships
    • Loyalty programs
    • Loyalty tiers
    • Messages
    • Message threads
    • Order items
    • Orders
    • Outlet bills
    • Outlet items
    • Outlets
    • Payments
    • Payment requests
    • Preauthorizations
    • Product categories
    • Product service orders
    • Products
    • Rates
    • Rate groups
    • Reservations
    • Reservation groups
    • Resource access tokens
    • Resource blocks
    • Resources
    • Resource categories
    • Resource features
    • Restrictions
    • Routing rules
    • Rules
    • Service order notes
    • Service overbooking limits
    • Services
    • Source assignments
    • Sources
    • Tasks
    • Tax environments
    • Taxations
    • Vouchers
    • Voucher codes
  • API Events
    • Ways to communicate
    • General Webhooks
    • Integration Webhooks
    • Webhooks FAQ
    • WebSockets
  • Your integration journey
    • Certification
  • Deprecations
    • Migration guide: Get all reservations
  • Changelog
    • Changelog 2024
    • Changelog 2023
    • Changelog 2022
    • Changelog 2021
    • Changelog 2020
    • Changelog 2019
    • Changelog 2018
    • Changelog 2017
    • Changelog 2016
Powered by GitBook
On this page
  • Data pull
  • Adding items
  • Adding product items such as breakfast or a room upgrade
  • Adding product items such as champagne or a massage
  • Accounting categories and staff reminders
  • Testing your Upsell integration

Was this helpful?

  1. Use cases

Upsell

PreviousRevenue managementNextAPI Operations

Last updated 1 month ago

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.

Data pull

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:

Adding items

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.

Adding product items such as breakfast or a room upgrade

'How to' use case

API Operations

How to get a specific reservation

How to add a product order to a reservation

Adding product items such as champagne or a massage

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

Accounting categories and staff reminders

'How to' use case

API Operations

How to get the list of accounting categories

How to create staff reminders

Help Guides:

Testing your Upsell integration

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.

Creating an accounting category
how tasks are created and managed
Usage guidelines
Reservation report
Accounting Report
Mews Glossary for Open API users
Understanding services
Creating products
Add order
Add order
Add order
Add order
Product order parameters
Item parameters
Item parameters
Add order
Get all accounting categories
Get all accounting categories
Get all services
Get service availability
Get all services
Get service availability
Add task
Add task
Get all reservations
Add reservation product
Get all reservations
Add reservation product
Get all customers
Search customers
Get all customers
Search customers
Get all products
Get all products