Set Up Mews PMS Integration

Quick Setup

Most hotels enter the Access Token. AVA supplies advanced values when needed. This takes about 10 minutes.

This guide helps you connect AVA to Mews so reservations and guest details sync correctly. It also explains how AVA handles rate-included products, such as breakfast bundled into an OTA rate.

Where to Find It

Settings → Essentials → Property Management System (PMS) Integration

Quick Reference

Setting	What it controls	When you use it
Access Token	Connects AVA to Mews	Always
Advanced → Client Token	Required integration credential	Usually supplied by AVA deployment
Advanced → Client ID	Required Mews client identifier	Usually supplied by AVA deployment
Advanced → Demo Mode	Uses sandbox endpoints for testing	Only for test environments
Reservation comments	Pulls Mews service order notes into AVA	When AVA reads a reservation or live-billing refresh
Room payment waiver	Uses the returned invoice to decide waivers	When the invoice marks room payment as waived
Accommodation charge policies	Shows accommodation waive and hide controls in AVA payment settings	Only when your Mews connection exposes payment-policy support

Before You Start

You'll need:

• Access to the Mews admin area
• The Access Token / Token ID for the AVA integration
• Admin permission to update PMS settings in AVA

info

If you don't have the Access Token, contact your Mews admin or AVA support.

Advanced values

Mews requires the Client Token and Client ID. AVA normally supplies them through deployment configuration. Do not invent values; ask support if the fields are empty.

How to Get Your Mews Access Token

Follow these steps in Mews:

1. Log in to Mews PMS

2. Click Marketplace in the sidebar

   

3. Click My Subscriptions

   

4. Find Vouch AVA Front Desk Agent

5. Click Edit

6. Open the Access Token section

7. Copy the Token ID

   

tip

Paste the token into AVA right away so you don't lose it.

Configuration Steps

Step 1: Select Mews

1. Go to Settings → Essentials → PMS Integration
2. Click the Mews card
3. The Mews configuration form appears

Step 2: Enter Access Token

1. Paste the Token ID from Mews into the Access Token field
2. The token is hidden after save for security

Masked values are safe

If you return later and see masked characters, leave them as-is and click Save. AVA keeps the saved Access Token, Client Token, and Client ID.

If you need Advanced Mews settings (support only)

1. Click Advanced
2. Enter the values support provided:
   • Client Token
   • Client ID
3. Optional: Turn on Demo Mode if you are testing with sandbox endpoints

warning

Do not change Advanced values unless support tells you to. Wrong values can stop syncing.

Step 3: Save

1. Click Save at the bottom of the page
2. Look for the success message
3. The Access Token field shows a placeholder to protect the secret

What Happens After Connection

• ✅ AVA starts using Mews data for reservations and guest details
• ✅ The Access Token field shows masked characters
• ✅ Use Edit Token if you need to update the token later
• ℹ️ AVA keeps the current Demo Mode value when you save other Mews fields.
• ℹ️ Production does not force Demo Mode to OFF.
• ✅ Mews company names now fill reservation source labels when AVA can resolve them.
• ✅ Mews reservations are treated as hotel collect in AVA.
• ✅ Do Not Move room-lock status stays in sync with Mews.
• ✅ AVA skips blocked Mews rooms during automatic assignment and retries another clean room when possible.
• ✅ AVA pulls Mews service order notes into reservation comments.
• ✅ Matching notes can waive room payment when the invoice returns a waiver flag.
• ✅ AVA loads full invoice details before checking the waiver on single-reservation reads.
• ✅ AVA keeps unassigned Mews rooms visible in multi-room bookings.
• ✅ Guest profile updates can trigger automatic pre-arrival resend catch-up.
• ✅ Mews live billing rechecks configured payment-policy notes before it replaces a stored balance.
• ✅ Full-invoice waivers can zero the payable balance while keeping deposit and payment records for audit.
• ✅ Verified rate-included products, such as bundled breakfast, can follow a room-package waiver.
• ✅ Mews rate-group rules apply only to products included by the booked rate group.
• ⚠️ Products assigned to another rate group remain payable.
• ✅ Mews benefit postings normally use the occupied stay night, so a 27 August posting can appear for 28 August breakfast.
• ✅ Explicit same-day benefit schedules use their supplied redemption date, even when the product catalogue is unavailable.
• ✅ Room-relative service charges can follow a room-package waiver, even when Mews reports Once but posts them nightly.
• ✅ A positive balance up to THB 0.01 is suppressed when it is only an accommodation rounding residual after a waiver.
• ⚠️ Positive unclassified charges and genuine extras remain payable, including genuine THB 0.01 extras.
• ⚠️ AVA fails closed when it cannot prove a product's classification.
• ✅ Compare the complete Mews invoice before collecting an unexpected balance.

Guest & Staff Impact

• Guest forms adapt to Mews rules. Required fields and hidden fields change based on Mews configuration, so guests only see what is needed.
• Reservation lookup uses Mews. If Mews is not configured, the guest lookup step will fail.
• Verified included products can follow waivers. AVA treats rate-included products as accommodation when Mews proves their inclusion.
• Rate-group rules stay scoped. AVA resolves the booked rate group before applying matching Mews product rules.
• Other rate groups remain payable. A product assigned to another rate group does not follow the waiver.
• Room-relative service charges stay included. AVA recognizes charges linked to the room-night product, even when Mews reports Once but posts them nightly.
• Staff lookup remains available. Staff can use Staff Access to compare the live PMS bill.
• Unclear waiver classification fails closed. When room payment collection is enabled, AVA routes the guest to the front desk during lookup. AVA withholds the unverified amount for staff review.
• Booking source labels can show Mews company names. If AVA can resolve a company name, it uses that name instead of a raw company ID.
• Mews source collect now defaults to hotel collect. That keeps source labels aligned with the reservation contract AVA receives.
• Locked rooms stay locked in AVA. If Mews marks a reservation as locked, Streamliner shows the lock icon in room-change views.
• Service order notes become reservation comments. Staff can review note text during reservation lookup.
• Waived room payments stay explainable. When Mews marks the invoice as waived, AVA shows the note text as the waiver reason.
• Live billing follows the same waiver rules. Room List rechecks the configured notes before it replaces a stored balance.
• Full waivers still keep audit records. AVA can show a zero balance and still preserve deposit and payment rows.
• Unclear billing needs review. AVA does not present an unverified waiver amount as collectible.
• Unexpected balances need review. Compare the displayed amount with the live Mews bill before collecting.
• Accommodation charge policies are capability-based. If Mews exposes them, AVA shows waive and hide controls in payment settings.
• Guest email changes can trigger resend catch-up. When Mews sends a guest update, AVA can re-send elapsed pre-arrival emails to the latest address.

Multi-Room Bookings Stay Complete

AVA keeps every booked Mews room visible, even before Mews assigns a physical room. The main room stays first in the list. This helps staff see the full booking during lookup and check-in.

Shared Booking References Stay Separate

If multiple Mews reservations share an external booking ID or family ID, AVA keeps each reservation separate. Guest, room, dates, status, and totals stay on the reservation you opened.

Shared Booking Emails Create Separate Guests

If two guests share the same booking email, AVA creates a separate Mews customer. AVA only reuses a customer when the document number matches an existing record. If AVA already has a direct Mews guest reference, it keeps updating that guest.

Guest Updates Stay Current

When Mews sends a guest profile update, AVA refreshes the guest record it uses for resend checks. If the guest email changed, AVA can re-send elapsed pre-arrival emails after sync.

Exact matches

AVA matches configured accommodation policy values exactly. Review the complete Mews invoice when a value does not match.

Live Billing Waivers

Use this when Room List or a reservation refresh should apply Mews payment policies again.

AVA checks fresh Mews service-order notes before replacing a stored balance. It only does that when at least one payment-policy list is configured.

Staff lookups remain available so staff can compare the reservation with the live Mews bill. When Mews proves a rate-included product belongs to the booked rate, the waiver covers that product. Room-relative service charges follow the same waiver, even when Mews reports Once but posts them nightly. A Once label alone does not create an extra charge or billing-review block. If AVA cannot prove the classification, it withholds the unverified payable amount for staff review. When room payment collection is enabled, AVA blocks reservation lookup and routes the guest to the front desk.

Small accommodation rounding residuals

After an accommodation waiver, Mews can leave a positive THB 0.01 residual from nightly service-charge rounding. AVA suppresses that residual before it reaches the payment flow when every positive charge section is accommodation. AVA still keeps unclassified charges and genuine extras payable, including genuine THB 0.01 extras.

AVA verifies a rounding product before treating it as accommodation:

• The product comes from a service order linked to the room reservation.
• Mews reports zero-priced Absolute pricing with Once frequency.
• The product uses the room's accounting category.

Only the verified product line follows the accommodation waiver. Unrelated or unverified product lines remain payable.

Check the complete Mews invoice when you see any positive balance. Collect the balance when it includes an extra or an unclassified charge.

When Mews returns a full-invoice waiver, AVA shows a zero payable balance. It still keeps deposit and payment records for audit. That lets staff review what was charged, even when the total becomes zero. When the live evaluation is verified, it can also replace a stale waived snapshot.

tip

Refresh the reservation after Mews finishes syncing. That gives AVA the newest notes and invoice state.

Troubleshooting

"Access Token is required" Error

What you see: "Access Token is required"

Fix:

1. Paste the Token ID from Mews
2. Click Save again
3. ✓ The error disappears once saved

Token Saved But No Data Syncing

What you see: You saved the token, but reservations do not appear

Fix:

1. Wait 10-15 minutes for the first sync
2. Refresh the page and confirm Mews is still selected
3. Ask your Mews admin to confirm the AVA subscription is active
4. Contact AVA support if the issue continues

Masked fields return after reload

What you see: The Access Token or advanced fields show masked characters after you reload the page.

Fix:

1. Leave the masked values in place.
2. Click Save again.
3. ✓ AVA keeps the saved Mews credentials.

You cannot find Client Token, Client ID, or Demo Mode

What you see: You do not see Client Token, Client ID, or Demo Mode fields

Fix:

1. Click Advanced
2. ✓ The advanced fields appear inside the Advanced section

Demo Mode is on, but syncing looks wrong

What you see: Missing reservations or unexpected test data

Fix:

1. Turn off Demo Mode
2. Click Save
3. Refresh the page and check your connection status
4. Contact support if the issue continues

Demo Mode does not match after saving

What you see: The Demo Mode checkbox changes after refresh, or does not match the saved Mews setting.

Fix:

1. Open Advanced.
2. Check the Demo Mode value.
3. Save only the change you want.
4. Refresh the page.
5. Contact support if the checkbox still disagrees with the saved Mews config.

A room does not appear in room changes

What you see: The room is missing from Allow move room.

Fix:

1. Check the reservation in Mews.
2. Remove the room lock if the room should be movable.
3. Refresh the reservation in AVA.
4. Try the room change again.

Mews blocked room assignment

What you see: Check-in or room change shows "space is blocked" or "room unavailable".

Fix:

1. Wait for AVA to try another clean room.
2. Assign a different room in Mews if no clean room is available.
3. Refresh AVA and try again.

Room List still shows a balance after a waiver

What you see: Room List still shows payment after Mews should waive it.

Why this happens: The balance may be a genuine extra, an unclassified charge, or more than THB 0.01.

Fix:

1. Check the reservation's complete invoice in Mews.
2. Confirm the reservation matches Accommodation Charge Policies.
3. Make sure the policy values are still configured in AVA.
4. Refresh the reservation after Mews sync finishes.
5. Do not collect an unverified amount.
6. Ask front-desk staff to review the invoice.

THB 0.01 accommodation residual

AVA suppresses a positive THB 0.01 balance only when it is an accommodation rounding residual after a waiver. Genuine or unclassified THB 0.01 charges remain payable.

Room payment is still payable

What you see: A Mews reservation still asks for room payment.

Why this happens: The waiver did not match, or AVA needs to verify the billing classification.

Fix:

1. Open the reservation in Mews.
2. Check the complete invoice.
3. Confirm the reservation matches Accommodation Charge Policies.
4. Refresh the reservation in AVA.
5. Do not collect an unverified amount.
6. Contact support if the payment still appears.

Bundled product needs review

What you see: An included Mews product, such as breakfast, needs billing review.

Why this happens: AVA could not prove whether the product belongs to the booked rate.

This can happen when the Mews rule uses a rate group that AVA cannot resolve. Products from another rate group remain payable.

Room-relative service charges

A service charge linked to the room-night product should not need review only because Mews reports Once. If review remains, check for another unclassified product or an invoice mismatch.

Fix:

1. Check the rate's included products and complete invoice in Mews.
2. Confirm the reservation matches a value in Accommodation Charge Policies.
3. Refresh the reservation in AVA.
4. Do not collect an unverified amount.
5. Ask front-desk staff to review the complete Mews invoice.

Guest is sent to the front desk during lookup

What you see: The guest sees a front-desk review message after reservation lookup. The guest cannot continue to the rooms or payment steps.

Why this happens: A configured accommodation policy matched, but Mews could not classify a charge.

Fix:

1. Review the Mews rate, included products, and complete invoice.
2. Confirm the matching value in Settings → Payment → Accommodation Charge Policies.
3. Refresh the reservation after Mews finishes syncing.
4. Confirm the payable amount with the complete Mews invoice.
5. Ask front-desk staff to complete the check-in when review remains necessary.

AVA does not use a stored balance or collect an unverified amount.

Mews billing needs review

What you see: The displayed Mews balance differs from the complete invoice.

Why this happens: AVA could not prove the waiver's product classification.

Fix:

1. Open the reservation through Staff Access.
2. Review the reservation rate, included products, and complete invoice in Mews.
3. Confirm the configured policy matches the room package.
4. Refresh AVA after Mews data is complete.
5. Collect only an amount that AVA and Mews both confirm as payable.
6. Contact AVA support if the amounts still differ.

Waiver reason looks wrong

What you see: AVA waives the room payment, but the reason text is unexpected.

Fix:

1. Check the Mews service order note that matched.
2. Confirm the note text is the one you expect.
3. Remember that AVA matches whole words only.
4. Contact support if the waiver reason still looks wrong.

Verification Checklist

• Mews is selected in Select PMS Provider
• Access Token is entered and saved without errors
• The Access Token field shows masked characters after refresh
• Reservations begin syncing from Mews

Still Stuck?

Contact success@vouch-technologies.com if:

• ❌ Syncing does not start after 15 minutes
• ❌ You see a save error you cannot resolve
• ❌ You need Advanced settings and do not have values
• ❌ The live balance still does not match Mews after refresh
• ❌ A full waiver does not clear the accommodation balance
• ❌ The displayed balance differs from the complete Mews invoice

Helpful to include:

• Screenshot of the PMS Integration section
• Your PMS provider (Mews)
• The exact error text, if any
• Reservation confirmation number
• Screenshot of the Mews note and AVA balance
• Time the invoice last synced

Related Guides

• PMS Connection
• Payment Gateway Integration
• Manage Reservation Payments
• PMS Connection Errors