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
  • Portfolio Access Tokens
  • Enterprises
  • Chains
  • FAQ
  • How can I obtain a Portfolio Access Token?
  • How can I tell if an Access Token is single enterprise or multi-enterprise in scope?
  • How can I tell if an API operation supports Portfolio Access Tokens?

Was this helpful?

  1. Concepts

Multi-property

PreviousConceptsNextRestrictions

Last updated 4 months ago

Was this helpful?

Terminology

This feature introduces terms such as Portfolio, Portfolio Access Token and Chain. For a full description of all the terms used, see the .

Mews Multi-Property is an optional feature of Mews Operations, which enables customers to easily manage a portfolio of multiple properties. A portfolio can be set up which allows all of the properties within the portfolio to be managed from one place, for example to centrally manage rates and vouchers.

Portfolio Access Tokens

Multi-property functionality is reflected in the API through special Portfolio Access Tokens, these are Access Tokens that give API clients access to all of the enterprises or properties within scope of the portfolio, rather than just to a single enterprise.

Enterprises

Not all API Operations support Portfolio Access Tokens. For those that do, they have an additional request parameter EnterpriseId (singular) or EnterpriseIds (plural). This enables you to specify which enterprise or enterprises you want to connect to or act upon, when using the operation. The enterprises specified must be within scope of the Portfolio Access Token you are using.

Chains

FAQ

How can I obtain a Portfolio Access Token?

How can I tell if an Access Token is single enterprise or multi-enterprise in scope?

An Access Token is an opaque series of random characters. You cannot tell from looking at a token whether it supports a single enterprise or a portfolio of multiple enterprises.

How can I tell if an API operation supports Portfolio Access Tokens?

If the operation supports multiple enterprises, for example , and you use a Portfolio Access Token but do not specify the EnterpriseIds parameter, then the operation will connect to or act upon all of the enterprises within scope of the Access Token.

Some operations, such as , accept Portfolio Access Tokens but only return information for a single enterprise. In this case, you must use the EnterpriseId parameter to specify which enterprise you are interested in. If you do not specify the EnterpriseId parameter, then the functionality is undefined, or rather it depends on the individual API operation. For example, in the case of , the operation returns information on the 'dummy' enterprise used to identify the portfolio.

Independently of portfolios, properties can be grouped into chains. Chains are used to define legal relationships between enterprises, and for sharing certain data such as customer profiles. Some API operations support filtering by ChainId, e.g. and . When used in combination with a Portfolio Access Token, ChainId (singular) or ChainIds (plural) can be used to specify which chain or chains you want to connect to or act upon when using the operation, just like with EnterpriseIds. If the operation supports multiple chains, and you use a Portfolio Access Token but do not specify the ChainIds parameter, then the operation will connect to or act upon all of the chains within scope of the Access Token.

The Mews Multi-Property feature is not available for all customers, it depends on system configuration. For more information, please get in touch via .

The description for an API operation specifies if it supports Portfolio Access Tokens, e.g. see . Such operations will normally also have EnterpriseId or EnterpriseIds as a request parameter.

partnersuccess@mews.com
Mews Glossary for Open API users
Get all loyalty programs
Get all payments
Get all order items
Get configuration
Get configuration
Get all companies