In this article you will learn:
- ✅ What the “Reservation Search” test is
- 🔎 How to perform a reservation search in the PMS from Civitfun
- 📊 What information you can validate in the results
- ⚠️ Error messages and how to solve them
🌍 What is the “Reservation Search” test?
The Reservation Search is the first validation available within the Check-in Validation (Self-diagnosis) section of the PMS panel.
It allows you to simulate a search in your PMS directly from the Civitfun Dashboard to check that the integration between systems is working correctly.
🔎 How to perform a reservation search
Go to the PMS section in your Civitfun Dashboard and click on the pencil icon to display the PMS configuration.
In the Check-in Validation form, enter the booking data you want to validate and click the "Test booking" button.
👉 The system will query your PMS in real time and display the retrieved information directly in the Dashboard.
Required fields will be marked with a red ✱ asterisk.
⚠️ Error messages
When the system cannot find the reservation you are searching for, it will return the errors encountered during the search together with a description to help solve them.
Below you will find the most common error messages that may appear during Check-in Validation, along with their meaning and solutions:
Meaning and how to solve them
❌ No reservations found matching the filters: No reservation exists in the PMS with the entered data.
Check that the locator, name, or date are correct and match exactly what is in the PMS. Sometimes the same booking has different locators depending on the booking channel.
❌ Reservations found, but none have a valid status: The PMS returned results, but the booking is not in a status allowed for check-in (e.g. cancelled, not confirmed).
Verify the booking status in the PMS. Only confirmed and active reservations are valid for check-in.
❌ Validation error. Please check the input data: The entered data do not match the expected format (e.g. invalid characters, wrong date).
Correct the format of the fields. Use only valid letters, numbers, and dates.
❌ Unauthorized access. Please verify your credentials: The configured integration credentials are not correct.
Review the PMS integration settings in the Dashboard and re-enter your username and password.
❌ Forbidden. Access to the resource was denied: The user does not have sufficient permissions to access the requested resource.
Contact your PMS administrator to review and update your user permissions.
❌ Resource not found. The requested reservation does not exist: The PMS could not locate the specified booking.
Confirm the locator and other details in your PMS before trying again. Sometimes the same booking has different locators depending on the booking channel.
❌ Timeout. Please try again later: The PMS did not respond within the time limit.
Check your internet connection and try again. If the issue persists, verify the PMS status.
❌ Conflict detected. The booking could not be modified: The PMS detected a conflict in the requested operation.
Verify that the booking has not been modified in parallel by another user and try again.
❌ Internal server error. Please contact support: The PMS returned an unexpected error.
Try again later. If the issue continues, contact Civitfun support.
❌ Service unavailable. The server is not responding: The PMS is temporarily unavailable.
Wait a few minutes and try again. If it persists, contact your PMS provider.
❌ Unexpected error. Please try again: An unhandled error occurred in the operation.
Retry the search. If the error repeats, contact Civitfun support.
❓ FAQ
Can I use any search field?
No. The required fields are at least the locator and the check-in date. Optionally, you can also add the guest’s name.
Is this a real query?
Yes, the system queries your PMS directly, so the information displayed is real and up to date.
What should I do if the search fails?
Review the error message displayed by the system and check your PMS credentials in the integration settings.
We hope this article is useful! If you need more information, contact support@customer.civitfun.com, we’ll be happy to help. 😊✍️