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
  • Initial configuration
  • Managing resources
  • Staff tasks
  • Dirty status
  • Testing your integration
  • Additional help for working with the demo environment

Was this helpful?

  1. Use cases

Housekeeping

PreviousGuest technologyNextKiosk

Last updated 5 months ago

Was this helpful?

A Housekeeping integration pulls live information about the physical state of rooms and other space resources, allows the housekeeping staff to update the state from the Housekeeping system and pushes this data back into Mews.

Initial configuration

The integration must first retrieve all the resources the property has configured in Mews using . The response contains all relevant information needed to map the physical configuration of the property in the external system.

'How to' use case

API Operations

How to get the list of rooms and spaces

Terminology: For an explanation of terms like room, space and resource, see the .

Managing resources

To ensure all of the information is synchronized between the two systems, a Housekeeping integration can monitor changes to the state of a resource. Rather than polling the API for state changes, you can subscribe to notification events using or . Both methods support changes to resources. Don't know which one to use? See .

'How to' use case

API Operations

How to listen for changes to reservations

How to get reservation and customer details

Once a staff member has cleaned or inspected a room, the state can be updated in Mews using , specifying the new state of the resource.

'How to' use case

API Operations

How to update the state of a resource

Resource blocks are blocks of rooms or resources set to 'out of order' or 'internal use'. Information about resource blocks can be requested using . Housekeeping integrations can also manage blocks through and .

'How to' use case

API Operations

How to get information about resource blocks

How to add a resource block

How to delete resource blocks

Staff tasks

'How to' use case

API Operations

How to add a staff task

How to get information about departments

How to get the list of staff tasks

Dirty status

Mews allows properties to configure when a space will be marked as Dirty, upon check-in or check-out, in their Stay service settings. They can also configure a specific housekeeping time interval after which, if a space is vacant, it will automatically change state to Dirty. For example, if the field is set to two days, the space will automatically become Dirty after two days. Each unit represents a period of 24 hours, with automatic changes occurring between 04:00 and 05:00. The maximum amount of time for this time interval is 7 days, after which the state will automatically change to Dirty to adhere to regulations preventing Legionella.

Testing your integration

Additional help for working with the demo environment

Help Guides:

(ServiceOrderUpdated event) or (Reservation event)

If you need to create a task directly in Mews, this can be done using . If a task should be assigned to a specific department, the unique identifiers required for this action can be retrieved using . A list of existing tasks can be retrieved from Mews using .

Please ensure you follow our general for testing integrations. In addition to this, using the credentials, you can run the (housekeeping report) to cross-check if the integration is working correctly.

Usage guidelines
demo environment
Space Status Report
Out-of-service and out-of-order
How to set up a stay service
General Webhooks
WebSockets
Mews Glossary for Open API users
Webhooks
WebSockets
Ways to communicate
Get all resource blocks
Add resource block
Delete resource blocks
Get all resource blocks
Add resource block
Delete resource blocks
Get all departments
Get all departments
Add task
Get all tasks
Add task
Get all tasks
Get all resources
Update resources
Get all resources
Update resources
Get all reservations