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

E8007 / E8009

SmartBook failed - could not find a better price offer.

SmartBook failed to find a better deal.

Proceed with your original room option.

E8008

Couldn't validate hotel Id.

Incorrect HotelId or an inability to recognize the hotel.

  • *Best Practice: **If a request fails due to an incorrect HotelId or an inability to recognize the hotel, implement a fallback mechanism to send an additional request using a different SupplierID and Supplier Hotel Key/ID.

E2061

Couldn’t verify credentials.

Username or password are incorrect.

Ensure that a valid credentials are provided. You can reset password through the back-Office.

E10003

Valid residency must be provided.

A null or invalid residency has been provided.

Ensure that a valid ISO Country Code was provided.

E10003

PointOfSale not found

Invalid PointOfSale Passed in the API Request.

If no values have been agreed upon and added by Gimmonix, please use Null.
Otherwise, select one of the predefined values.

E10000

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.

E10000

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.

E10003

Valid Currency must be provided.

A null or invalid currency has been provided.

Ensure that a valid ISO currency Code was provided.

E20000

Lead Pax Room ID must be provided.

LeadPaxRoomId wasn’t provided.

Ensure that a valid LeadPaxRoomId is being provided.

E10003

WorkMode must be provided.

WorkMode wasn’t provided.

Ensure that a valid WorkMode is provided.

E10003

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.

E20000

Passenger Id must be provided.

A null or invalid Passenger Id has been provided.

Ensure that a valid Passenger Id is provided.

E20000

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.

E20000

Name must be provided for a passenger.

Passenger Name wasn’t provided.

Ensure that a valid Passenger name is provided.

E10001

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.

E10001

Room Basis must be provided.

Room Basis wasn’t provided.

Ensure that a valid Room Basis is provided.

E10001

Room name must be provided.

Room name wasn’t provided.

Ensure that a valid Room name is provided.

E10001

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.

E20000

All passenger Id must be unique.

A null or invalid Passenger Id has been provided.

Ensure that each passenger Id is a unique Guid.

E4000

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.
Each Additional Passenger should be allocated in the respective room.

Ensure that the rooms allocation are valid :

  • If there more that 1 room, ensure that each room is assigned with the correct Adults counts and kids ages.
  • Ensure that allocation in the AddionalPassegners element are the same as in the Rooms element.

E4000

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 .

E8009

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.

E8009

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.

E8009

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.

E8010

Couldn't execute a book confirmation request.

A better alternative rate validation has failed

E20306 / E4080

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.

E8011

Technical failure

A booking confirmation process has failed

Supplier confirmation Error - results an 'ER' status.
Please verify in the supplier's system whether the booking was created or not, before sending any additional booking request for the same package, to prevent accidentally duplicated bookings

E8012

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.

E8004

SmartBook is not enabled for the user. Please enable SmartBook for the user and try again.

Configuration Error.

E8003

Unable to detect the applicable SmartBook work-mode for this API request.

Configuration Error.

E8002

User is not authorized to use the SmartBook feature via API. Please contact our support.

Configuration Error.

E20099

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.