PMS Connection Errors

Quick Check

Most connection issues take 5-10 minutes to confirm. If you see a 429, wait for the retry time before trying again.

Use this guide when AVA cannot connect, shows a temporary limit, or reports a PMS refusal.

Automatic Retry

AVA now retries some short PMS read requests automatically. Opera OAuth also retries one transient timeout or gateway error. During check-in, AVA retries temporary reservation conflicts and PMS rate limits during room assignment and final check-in. These retries can add several seconds before AVA shows an error. You may not see a one-time network error. Cloudbeds webhook credential failures are not retried automatically.

Preserved PMS messages

If AVA shows a specific PMS error during refresh, use that message. Streamliner keeps the original PMS response instead of replacing it with a generic technical error.

Common Error Messages

Error	Meaning	Do This
"Please fill all required PMS fields"	A required field is missing for the selected PMS	Complete the required fields shown for that provider
"Failed to save PMS Integration"	Connection or authentication error	Recheck your PMS account and permissions
"Failed to save settings before connecting"	Another Essentials setting failed before OAuth started	Read the full message, fix that setting, then connect again
"Unable to communicate with the property management system"	Network or API issue	Refresh once, then test the connection again
"429" or "rate limited"	The PMS or AVA's own request budget asked you to retry later	Wait while AVA retries check-in actions, or follow the retry time shown
"409" or "Conflict"	The PMS refused the action because the reservation state or request is not allowed	Read the PMS reason, correct the reservation, then retry once
PMS_RESERVATION_MUTATION_IN_PROGRESS	A short PMS reservation update overlaps with room assignment or final check-in	Wait briefly, refresh the reservation, then retry the affected step once
"502" or "Bad Gateway"	Cloudbeds, Opera, or another PMS failed during a read or write	Read the cause, refresh once, then retry the action
"503" or "Service Unavailable"	A PMS or network service could not complete the request temporarily	Check the PMS state, refresh once, then retry the action
"non-reservations payload"	eZee returned a website or another response instead of reservation data	Check the eZee Base URL and leave it empty for the standard API
"Unsupported Cloudbeds version"	The request selected retired Cloudbeds v1 or v2	Remove the version pin, then start a new connection
"You don't have access to property ID" or "success:false"	Cloudbeds blocked the property or returned a logical access failure	Confirm the correct Cloudbeds property, then wait a minute before trying again
"webhook credentials rejected"	Cloudbeds accepted the login but rejected webhook setup	Reconnect Cloudbeds and save the settings again
"PMS cache unavailable" or a cache invalidation error	AVA could not confirm the new PMS settings across its services	Wait one minute, then save again; contact support if it repeats
611 or "Invalid Auth Code or Hotel Code"	eZee rejected an older credential snapshot after a credential change	Save the matching Hotel Code and Auth Code, then retry once
"reservationOverlapTo must be greater than reservationOverlapFrom"	The PMS rejected the stayover overlap window	Update the overlap values in your PMS, then refresh

Temporary Connection Glitch

What you see: A one-time connection error, timeout, or blank response.

Why this happens: AVA retries some short PMS read requests automatically. It also retries one transient Opera OAuth failure. A timeout or gateway error can take up to 30 seconds before showing an error. On Opera, a dropped housekeeping read or write can show up as a 502.

Fix:

1. Refresh the page once.

2. Try the action again.

3. If it keeps failing, check the PMS connection.

4. If the same error keeps returning, contact support.

   ✓ One-off glitches often clear without any setting changes.

PMS Request Takes Too Long

What you see: A PMS action waits, then shows a timeout or connection error.

Why this happens: AVA stops waiting after 60 seconds for requests without a tighter limit. Some reservation and capability reads use shorter limits. This prevents one slow PMS response from keeping a reservation action open indefinitely.

Fix:

1. Wait for the timeout message to appear.

2. Refresh the reservation or page before trying again.

3. Check the reservation in your PMS before repeating a write action.

4. Retry the action once.

5. Contact support if the timeout returns.

   ✓ The PMS action should either complete or return a clear error within about one minute.

Check before retrying

Do not repeat a reservation update while the result is unclear. Confirm the reservation state in your PMS first, then retry once.

A PMS read uses a fallback

What you see: AVA continues with less detail after a PMS read takes too long.

Why this happens: Selected reads fail open so the guest or staff flow can continue. The fallback may show an un-enriched reservation or a simpler search result. Capability reads can temporarily report features as unavailable.

What you see	Why it happens	Fix
Reservation details look incomplete	Room-type details were not returned in time	Refresh the reservation and try again
Staff search shows fewer guest details	The profile search used a reservation-name fallback	Search again after refreshing the page
A date-dependent workflow shows the wrong date	The PMS business date was not returned in time	Refresh, then confirm the business date in your PMS
Group Checkout is missing	Capability data was unavailable during the read	Refresh, then check the PMS connection
A supported room move is refused	AVA could not confirm the required capability	Refresh, then retry once

Check the PMS before repeating a write

These fallbacks apply to reads. If a write times out, check the PMS before retrying it.

Opera Error Shows an Upstream Cause

What you see: An Opera action shows "Bad Gateway" or "Service Unavailable (503)".

Why this happens: Opera or its gateway returned a non-JSON error response. AVA shows short response text when available, or the HTTP status when it is empty.

Fix:

1. Read the full error message and note the status code.
2. If you are adding a sharer, check Opera before retrying.
3. For other actions, refresh AVA once, then retry.
4. Check Opera and AVA if the same error returns.
5. Contact support if the error continues.

Check sharers before retrying

AVA records Opera sharer creation progress. When all guests are checked in and no room move is pending, AVA returns the result without another Opera update. Pending room moves remain eligible for reconciliation. Wait briefly, refresh AVA, and check Opera before retrying. Do not create another sharer manually while the result is unclear.

PMS Refusal Shows as a Conflict

What you see: An action shows 409, "Conflict", or a specific PMS refusal. It no longer appears as a generic server error.

Why this happens: Your PMS rejected the action because a reservation rule failed. AVA keeps the upstream status and message so you can correct the cause. Most 409 responses are permanent for that request. The PMS_RESERVATION_MUTATION_IN_PROGRESS code is a temporary exception during room assignment or final check-in.

Fix:

1. Read the full PMS message.

2. Open the reservation in your PMS.

3. Correct the issue identified by the message.

4. For cancellation refusals, check whether the stay is checked in, due out, or checked out.

5. Complete required check-out steps in the PMS before retrying an in-house cancellation.

6. Refresh AVA.

7. Retry the action once.

8. If the PMS still refuses, complete the action in your PMS and contact support.

   ✓ AVA should show the updated reservation state after the PMS accepts the action.

Reservation Mutation Is Still In Progress

What you see: Room assignment or final check-in shows PMS_RESERVATION_MUTATION_IN_PROGRESS.

Why this happens: A PMS reservation update temporarily owns the reservation. This can happen after guest verification, a passport upload, or another reservation update. AVA retries this exact conflict automatically for a short period.

Fix:

1. Wait briefly for the PMS update to finish.

2. Refresh the reservation in AVA.

3. Retry the affected step once.

   ✓ The affected step should continue after the reservation update finishes.

If the code remains after retrying, contact support. Include the reservation number, PMS provider, and full error message.

PMS Validation Error During Refresh

What you see: A PMS message appears during stayover refresh, such as reservationOverlapTo must be greater than reservationOverlapFrom.

Why this happens: The PMS rejected the request because one of its validation rules failed.

Fix:

1. Read the exact PMS message.

2. Check the related setting in your PMS.

3. Correct the value that failed validation.

4. Refresh AVA once.

   ✓ You should see the original PMS message only until the PMS data is corrected.

---

Connection Failed

What you see: Error message when clicking Connect

Check These First

1. Verify credentials are correct

   • Double-check your API key or client credentials
   • Ensure no extra spaces before/after credentials
   • Confirm credentials have not expired

2. Confirm API permissions

   • Log in to your PMS admin portal
   • Verify API access is enabled for your account
   • Check that integration permissions are granted

3. Check internet connection

   • Try refreshing the page
   • Test other parts of AVA to confirm connectivity

Try This

1. Go to Settings → Essentials
2. Click Disconnect (if connected)
3. Wait 30 seconds
4. Re-enter your credentials
5. Click Connect again

Cloudbeds save fails before OAuth

What you see: "Failed to save settings before connecting: ..."

Why this happens: AVA saves other unsaved Essentials changes before starting Cloudbeds OAuth. The detailed message identifies the failed setting.

Fix:

1. Read the full error banner.

2. Correct the setting named in the message.

3. Save the setting if AVA shows a save action.

4. Select Connect to Cloudbeds again.

   ✓ Cloudbeds opens after the pre-connect save succeeds.

Cloudbeds OAuth exchange fails

What you see: The connection shows Version is required or rejects the authorization code exchange.

Why this happens: Cloudbeds authorization codes are single-use. A failed callback cannot be replayed. AVA now defaults an omitted Cloudbeds OAuth version to v3.

Fix:

1. Go to Settings → Essentials.

2. Select Connect to Cloudbeds.

3. Log in to Cloudbeds and select Authorize or Allow.

4. Complete the connection. Cloudbeds generates a fresh authorization code.

5. Contact support if a new connection fails again.

   ✓ The Cloudbeds connection should finish without asking you to enter a version.

Cloudbeds v1 or v2 is rejected

What you see: AVA shows an unsupported Cloudbeds version error.

Why this happens: Cloudbeds v1 and v2 adapters are retired. Versionless Cloudbeds routing uses v3.

Fix:

1. Clear any explicit Cloudbeds version setting or pin.

2. Ask your integration administrator to remove a v1 or v2 caller pin.

3. Go to Settings → Essentials.

4. Select Connect to Cloudbeds and complete authorization again.

   ✓ The new connection uses Cloudbeds v3.

PMS Settings Save Does Not Complete

What you see: AVA accepts your PMS details, then shows a cache or service error.

Why this happens: AVA confirms the updated settings across PMS services before completing the save. After a successful save, an older in-flight refresh cannot restore the previous credentials.

Fix:

1. Wait one minute before trying again.

2. Refresh Settings → Essentials → PMS Integration.

3. Leave masked credentials unchanged unless you are replacing them.

4. Click Save again.

5. Confirm the success message before using PMS-powered workflows.

   ✓ The new credentials should work across AVA servers after the save succeeds.

Contact support if the same error appears after three attempts. Include the full error message, PMS provider, and time of the failed save.

eZee Code 611 After a Credential Change

What you see: eZee returns 611, "Invalid Auth Code or Hotel Code", after you update PMS credentials.

Why this happens: An older PMS request may still be finishing with the previous credential snapshot. AVA marks that snapshot obsolete after your save.

Fix:

1. Confirm the Hotel Code and Auth Code belong to the same eZee property.

2. Go to Settings → Essentials → PMS Integration.

3. Save the updated credentials.

4. Wait for the success message.

5. Retry the PMS action once.

   ✓ The next PMS operation should use the new credentials.

Contact support if code 611 remains after a successful save.

Rate Limit Reached

What you see: A 429 error, a rate-limited message, or a request that includes a retry time.

Why this happens: Cloudbeds or AVA's own request budget is temporarily limiting requests. AVA keeps the retry timing from either source when it is available. AVA also keeps separate request budgets for different feature areas, so one busy page is less likely to slow another. Room assignment and final check-in also retry a temporary PMS 429 automatically. Those actions may take several extra seconds before they continue or show an error. Some other guest-facing calls wait briefly when AVA's own bucket is empty. That only applies to short local bursts, not vendor cooldowns. If Cloudbeds returns the same access error several times, AVA pauses the next retry briefly.

Rate limit isolation

If one page keeps showing 429s, the problem is usually limited to that page or feature area. Other parts of AVA may still work normally while you wait.

Fix:

1. Wait for the retry time shown in the error.

2. Refresh the page once.

3. Try the action again.

4. If the issue repeats, wait a few minutes before retrying.

5. If no retry time appears, treat it as a short temporary limit and try again later.

   ✓ You should see the request succeed after the retry time passes and the request budget is available.

During room assignment or final check-in

Let the current action finish before selecting Retry. If AVA still shows a friendly room-assignment error, check the reservation in your PMS. Then refresh AVA and retry the affected step once.

Cloudbeds Access Error

What you see: A Cloudbeds access message, such as You don't have access to property ID, keeps returning.

Why this happens: The connected Cloudbeds account cannot read that property. AVA pauses repeated retries so the same failure does not flood Cloudbeds.

Fix:

1. Confirm you are logged into the correct Cloudbeds property.

2. Ask a Cloudbeds admin to verify the property access and permissions.

3. Wait a minute before trying again.

4. Refresh once after the access issue is fixed.

   ✓ The next connection attempt should succeed after Cloudbeds accepts the request.

What you see → Fix

What you see	Fix
The error appears once	Wait for the retry time, then try again
The error keeps coming back	Pause for a few minutes, then retry
Reservations still do not load	Check Sync Issues

Cloudbeds Webhook Credentials Are Rejected

What you see: Cloudbeds keeps accepting the connection, but webhook repair fails after you save settings.

Why this happens: Cloudbeds accepted the login, but it did not accept the webhook permissions AVA needs.

Fix:

1. Reconnect Cloudbeds from Settings → Essentials.

2. Complete the Cloudbeds authorization prompt again.

3. Save your active pre-arrival settings again.

4. Ask a Cloudbeds admin to review the app permissions if it still fails.

   ✓ After the permissions are refreshed, webhook repair should complete normally.

---

Reservations Not Syncing

What you see: No reservations appear after connecting, or reservations are missing

Quick Fixes

1. Click Refresh in the Operations View
2. Wait 5-10 minutes for initial sync to complete
3. Verify reservations exist in your PMS for today's date

Check PMS Settings

1. Go to Settings → Essentials
2. Scroll to PMS Integration section
3. Verify the connection status shows "Connected"
4. Check sync settings are configured correctly

Still Not Working?

• Confirm the reservation dates match the dates you're viewing in AVA
• Check that the reservation status in PMS allows syncing (confirmed, not cancelled)
• Verify guest count is greater than 0

---

Sync Delays

What you see: Reservations appear with a delay

Normal Behavior

Most PMS systems sync every 5-15 minutes. Real-time sync availability depends on:

• Your PMS plan level
• The specific PMS provider

Reduce Delays

1. Use manual refresh when needed
2. Contact your PMS provider about real-time API access
3. Schedule sync during low-activity periods

---

Authentication Errors

What you see: "Invalid credentials" or "Authentication failed"

For Cloudbeds

1. Log in to Cloudbeds
2. Go to Settings → Integrations → API
3. Generate new API credentials
4. Copy credentials exactly (use copy button if available)
5. Paste into AVA without modifications

For Opera Cloud

1. Wait up to 30 seconds for AVA to finish its automatic retry. This covers one transient OAuth timeout or gateway error.

2. Retry the action only if the error remains.

3. Verify the environment URL is correct (test versus production).

4. Confirm the client ID, client secret, hotel ID, and enterpriseId.

5. Re-enter the credentials in Settings → Essentials → PMS Integration, then click Save.

6. Contact your Oracle representative if the error still appears.

   ✓ A one-time transient or cached-credential failure can recover without disconnecting Opera.

For Mews

1. Log in to Mews Commander
2. Go to Settings → Integrations
3. Find Vouch AVA and regenerate access token
4. Update token in AVA settings

---

When to Contact Support

Cloudbeds Rates or Rate Plans Are Unavailable

What you see: Cloudbeds connects, but the calendar or rate-plan actions are missing.

Why this happens: Calendar reads and rate-plan mutations use separate capabilities.

Fix:

1. Refresh Operations → Rates & Availability.

2. Confirm the Cloudbeds property is still the active PMS.

3. Ask your AVA administrator whether the required Cloudbeds capability is enabled.

4. Create new sellable rate plans in Cloudbeds, not AVA.

   ✓ Cloudbeds catalog visibility does not guarantee that every action is available.

Cloudbeds ARI save is still pending

What you see: AVA accepts a rate or restriction change, but the calendar still shows the old value.

Fix:

1. Wait for the Cloudbeds job status to finish.

2. Refresh the calendar once.

3. Check the same date and rate row.

4. Do not submit the same change repeatedly while it is pending.

5. Contact support if the published value remains unchanged.

   ✓ AVA shows success only after it verifies the value in the Cloudbeds calendar.

Contact support if:

• You've tried all troubleshooting steps
• Error messages reference system errors or technical issues
• PMS changes are not reflected after 30 minutes

Email: success@vouch-technologies.com

Include:

• Screenshot of error message
• PMS type (Cloudbeds/Opera/Mews)
• Time issue started
• Steps you've already tried

Related Guides

• Cloudbeds Integration
• Opera Integration
• Mews Integration
• Sync Issues