Informative Response & Messages - Handling
Ratefox API Error codes and Handling.
Below is a detailed list of potential Informative Response & Messages you may encounter while using the Ratefox API, along with the recommended handling for each message.
Message Code | Message | Description | Handling |
|---|---|---|---|
| SmartBook failed - could not find a better price offer. | SmartBook failed to find a better deal. | Proceed with your original room option. |
| Couldn't validate hotel Id. | Incorrect HotelId or an inability to recognize the hotel. |
|
| Couldn’t verify credentials. | Username or password are incorrect. | Ensure that a valid credentials are provided. You can reset password through the back-Office. |
| Valid residency must be provided. | A null or invalid residency has been provided. | Ensure that a valid ISO Country Code was provided. |
| PointOfSale not found | Invalid PointOfSale Passed in the API Request. | If no values have been agreed upon and added by Gimmonix, please use Null. |
| Check in date should not be in the past. | A valid Check-in date should be only in the future. | Ensure the Check-In date is in the future. |
| Check out date should be after the check in. | Check-In date can’t be before the check-out date. | Ensure the Check-In date is after the Check-Out date. |
| Valid Currency must be provided. | A null or invalid currency has been provided. | Ensure that a valid ISO currency Code was provided. |
| Lead Pax Room ID must be provided. | LeadPaxRoomId wasn’t provided. | Ensure that a valid LeadPaxRoomId is being provided. |
| WorkMode must be provided. | WorkMode wasn’t provided. | Ensure that a valid WorkMode is provided. |
| Language is invalid - Only ‘en’ (English) is currently supported. | A null or invalid language has been provided. | Ensure that a valid ('en) language is provided. |
| Passenger Id must be provided. | A null or invalid Passenger Id has been provided. | Ensure that a valid Passenger Id is provided. |
| Room ID must be provided in Passenger Allocation. | A null or invalid Passenger Allocation has been provided. | Ensure that a valid Passenger Allocation is provided. |
| Name must be provided for a passenger. | Passenger Name wasn’t provided. | Ensure that a valid Passenger name is provided. |
| There must be at least one adult in each room. | No adults has been allocated in a room. | Ensure that each room is allocated with at least 1 adult. |
| Room Basis must be provided. | Room Basis wasn’t provided. | Ensure that a valid Room Basis is provided. |
| Room name must be provided. | Room name wasn’t provided. | Ensure that a valid Room name is provided. |
| Room Id must be a valid, non-empty Guid. | A null or invalid Room Id has been provided. | Ensure that a valid Room Id is provided. |
| All passenger Id must be unique. | A null or invalid Passenger Id has been provided. | Ensure that each passenger Id is a unique Guid. |
| Book request does not match selected package - room b95a5248-bb4c-43d6-abe1-bf5cee98b62b should contain 2 adults. | A null or invalid Allocation has been provided. | Ensure that the rooms allocation are valid :
|
| Book request does not match original search request - mismatch in kids ages. | Kids Ages doesn’t match the AdditionalPassengers Types. | Ensure that passengers allocations are matching to the requested Rooms element . |
| Couldn't find a better offer. | No rates were received for this property. | No rates were received for this property - no action can be taken as there are no rooms available. |
| Couldn't find a better offer. | No available rates were received for this property. | No rates were received for this property - no action can be taken as there are no rooms available. |
| Couldn't find a better offer. | A better alternative rate wasn't found. | No alternative rates received for this property - no action can be taken as there are no rooms available. |
| Couldn't execute a book confirmation request. | A better alternative rate validation has failed | |
| Request timeout limit reached. No booking occurred. | A booking process has reached its timeout before executing book confirmation | A booking process has reached its timeout before executing book confirmation, no booking occured in such case. |
| Technical failure | A booking confirmation process has failed | Supplier confirmation Error - results an 'ER' status. |
| Couldn't confirm a better booking price | A better alternative rate couldn't been confirmed | No alternative rates at a better price point received for this property. |
| SmartBook is not enabled for the user. Please enable SmartBook for the user and try again. | Configuration Error. | |
| Unable to detect the applicable SmartBook work-mode for this API request. | Configuration Error. | |
| User is not authorized to use the SmartBook feature via API. Please contact our support. | Configuration Error. | |
| Check-in date must be at least X days from today. | For the client, Ratefox is configured to accept requests with a Check-in date no earlier than X days from now. | Proceed with your original room option. |
Updated 17 days ago