Hotel Error Codes and Handling
Note :
During your development - once you book using TEST supplier's accounts, you might encounter E4100, E4050 many times, i.e. booking attempts will not always be confirmed. (This is normal when working with supplier's TEST accounts.)
Below is a breakdown list of errors you might receive within our API, full list of error codes you may receive within each relevant category type.
Search Errors
User input Errors
| Error Code | Error Info | More Info |
|---|---|---|
E10000 | Invalid user input: Dates info error | Check in date should not be in the past Check out date should be after the check in Nights parameter is obsolete and not required in the request. However, if provided, must match the number of nights between CheckIn and CheckOut |
E10001 | Invalid user input: Rooms info error | Room can't be null. Number of rooms must be between 1 to 4. There must be at least one adult in each room Number of adults in each room must not be greater than eight Total number of adults in a room must be greater than zero. Kids ages must be between 0 to 17. |
E10002 | Invalid user input: Destination info error | - Field RadiusInMeters, if specified, must be greater than zero - GeoLocationInfo.Latitude must be between -90 and 90 - GeoLocationInfo.Longitude must be between -180 and 180 - RadiusInMeters may not be specified together with HotelIds - RadiusInMeters may not be specified together with SupplierLocationIds - GeoLocationInfo may not be specified together with HotelIds - If GeoLocationInfo is specified, then RadiusInMeters must also be specified - RadiusInMeters must be specified together with HotelLocation and/or GeoLocationInfo - Request must contain either HotelLocation, HotelIds, SupplierLocationIds or GeoLocation - Number of items in HotelIds must be less than - Specify RadiusInMeters less than or equal to {} -The provided HotelLocation value 'X' couldn't be found. Please verify that you are sending an existing HotelLocation value. |
E10003 | Invalid user input: Input general error | Valid DesiredResultCurrency must be provided. Valid residency must be provided. Request not allowed. Search with DetailLevel=Default is allowed only when searching by single hotel-id Response Language is invalid - Only 'EN'(English) is currently supported. Invalid request data. The requested DetailLevel value {hotelSearchRequest.DetailLevel} is not supported |
Configuration Errors
| Error Code | Error Info | More Info |
|---|---|---|
E10199 | Configuration general error | - |
System Errors
| Error Code | Error Info | More Info |
|---|---|---|
E10200 | No results found. | |
E10201 | Supplier Communication Error. | |
E10202 | Credentials error. | |
E10203 | Access restricted. | |
E10204 | IP not authorized. | |
E10205 | Inventory access error. | |
E10206 | Requests limit reached. | QPS limit with the supplier have been reached. |
E10207 | Check in date error. | |
E10208 | Source market error. | |
E10209 | Hotel ID error. | |
E10210 | Check out date error. | |
E10211 | Search timeout error. | |
E10212 | Location error. | |
E10213 | Pax error. | |
E10214 | The requested occupancy is not supported. | |
E10297 | Request general error. | |
E10298 | Internal error. | |
E10300 | Supplier agent was not used - Supplier Name: {0}, Contract Id: {1}. | |
E10301 | No mapped hotel ids were found. Supplier Name: {0} | |
E10302 | No mapped locations were found. Supplier Name: {0}, Location Id: {1} | Did not find in scope of hotel search |
E10303 | Supplier Data Parsing Error. Supplier Name: {0}, Contract Id: {1}. | Did not find in scope of hotel search |
E10304 | Supplier Timeout Error. Supplier Name: {0}, Contract Id: {1}. | |
E10305 | Search criteria not supported. Supplier Name: {0}. | Did not find in scope of hotel search |
E10306 | Wrong configuration at supplier's system. Supplier Name: {0}. | Did not find any usage |
E10307 | Search by {0} not supported by the supplier. Supplier Name: {1} | |
E10308 | No search type is defined for the supplier. Supplier Name: {0} | |
E10398 | Unexpected search error. | |
E10399 | Search general error |
Book Errors
User input Errors
| Error Code | Error Info |
|---|---|
E20000 | Invalid user input: Customer Info error |
E20001 | Invalid user input: Credit Card Info error |
E20099 | Invalid user input: Input general error |
E3000 | Payment not authorized. |
E20225 | Booking cannot be confirmed due to credit card incorrect details: CVV |
E20221 | Booking cannot be confirmed due to incorrect price specified in the request |
Configuration Errors
| Error Code | Error Info |
|---|---|
E20100 | User is not allowed to book non-refundable Net rates. Please check the user settings. |
E20101 | User doesn't have enough Obligo to book this rate. Current obligo: {X} {X}, Required obligo: {X} {X}. Please check the obligo settings. |
E20102 | Booking price out of range. |
E20103 | Booking is not allowed on this account. |
E20104 | Book is disabled for cluster '{X}'. Please contact support |
E20221 | Booking cannot be confirmed due to incorrect price specified in the request |
E20105 | Book is disabled for service-type '{X}'. Please contact support |
E20106 | Book is disabled for book flow '{X}'. Please contact support |
E20107 | User '{0}' not authorized to perform '{1}' action. |
E20108 | The specified 'ChargeAmount': '{0}' is invalid. 'ChargeAmount' value must be greater than 0 and less than or equal to 'BookingPrice'. |
E20109 | Service-fee cannot be charged. |
E20110 | Payment method is not available. |
E20111 | Discount value is invalid |
E20199 | Configuration general error |
System Errors
| Error Code | Error Info | More info |
|---|---|---|
E20300 | Booking cannot be confirmed due to price change. | |
E20301 | Booking cannot be confirmed due to price currency change. | |
E20302 | Booking cannot be confirmed due to cancellation policy change. | This is a general change in the cxl policy |
E20303 | Booking cannot be confirmed due to cancellation policy fee currency change. | This is a currency change in the cxl policy |
E20304 | Booking cannot be confirmed due to empty availability received. | Response was received from the supplier, with no errors (otherwise it would go to "TV Errors for Supplier Errors", but with no availability |
E20305 | Booking cannot be confirmed due to no pre-book response received. | When supplier's prebook or price validation action is called as part of the book and no response is received. In this case, today, we are not returning ER segment (because no book request was sent to the supplier), but just returning general book error. |
E20306 | Request timeout limit reached. A booking may have occurred. | The supplier didn't reply to the sent book request (within 3 minutes timeout), ER Segment May have been created. upon receiving this error code, Make sure to contact the supplier to verify whether the booking was made on their side in order to avoid duplicate bookings |
E20307 | Booking a previously booked item in the same session is not allowed. | |
E20308 | Charging service-fee is not allowed on a 3D-enabled payment gateway account. | |
E20395 | No book response received. | The supplier didn't reply to the sent book request |
E20396 | Unexpected book response received. | The supplier replied to the sent book request, but returned unexpected response (unknown structure or unexpected values) ER/RQ Segment will be created upon receiving this error code, Make sure to contact the supplier to verify whether the booking was made on their side in order to avoid duplicate bookings |
E20397 | Unhandled book response error received. | The supplier replied to the sent book request with an error, which is currently not handled (not mapped into TV error). |
E20398 | Unexpected book error. | An error which occurred internally, regardless of the supplier. |
System Errors
| Error Code | Error Info |
|---|---|
E20200 | Booking cannot be confirmed due to price change. |
E20201 | Booking cannot be confirmed due to price currency change. |
E20202 | Booking cannot be confirmed due to cancellation policy change. |
E20203 | Booking cannot be confirmed due to cancellation policy fee change. |
E20204 | Booking cannot be confirmed due to cancellation policy fee currency change. |
E20205 | Booking cannot be confirmed due to cancellation policy dates change. |
E20206 | Booking cannot be confirmed due to expired rate. |
E20207 | Booking cannot be confirmed due to no availability. |
E20208 | Booking cannot be confirmed due to supplier’s 3rd party supplier error. |
E20209 | Booking cannot be confirmed due to communication errors. |
E20210 | Booking cannot be confirmed due to pax name error. |
E20211 | Booking cannot be confirmed due to pax email error. |
E20212 | Booking cannot be confirmed due to duplicate booking. |
E20213 | Booking cannot be confirmed due to credit line error. |
E20214 | Booking cannot be confirmed due to permission error. |
E20215 | Booking cannot be confirmed due to credit card authorization general error. |
E20216 | Booking cannot be confirmed due to credit card authorization error. |
E20217 | Booking cannot be confirmed due to credit card incorrect details. |
E20218 | Booking cannot be confirmed due to credit card type not supported. |
E20219 | Booking cannot be confirmed due to nationality restriction. |
E20220 | Booking cannot be confirmed due to rejected book status. |
E20297 | Booking cannot be confirmed due to general request error. |
E20298 | Booking cannot be confirmed due to general error. |
E20299 | Unhandleable supplier error ER Segment will be created upon receiving this error code, Make sure to contact the supplier to verify whether the booking was made on their side in order to avoid duplicate bookings |
More
| Error Code | Error Info | Handeling |
|---|---|---|
I0200 | Operation successful. | |
I0404 | No results found. Supplier Name: {0}, Contract Id: {1}. | |
I0405 | Request Not Supported. Supplier Name: {0}, Contract Id: {1}. | |
I0406 | Credit card details are provided when not required. Credit card details will be ignored. | |
I0600 | Duplicate passenger name. Will try to fix the name and re-book. | |
I0601 | Supplier Communication Error. Supplier Name: {0}, Contract Id: {1}. | |
W4306 | "Supplier Data Parsing Error. Supplier Name: {0}, Contract Id: {1}. | Please check the supplier's response in our log system. If the supplier's response seems valid, please contact us at [email protected] In any other case, kindly contact the supplier with details and the relevant logs. |
W4307 | Supplier Timeout Error. Supplier Name: {0}, Contract Id: {1}. | |
W4308 | Search criteria not supported. Supplier Name: {0}. | |
W4309 | Wrong configuration at supplier's system. Supplier Name: {0}. | |
E0300 | SessionId not found. | Probable to happen when you are trying to access a session which is already expired. Please report this error to [email protected] as soon as you encounter. |
E0500 | Internal error. | Severe Internal Service Error. If the error occurred during a booking attempt, please verify in supplier system if the booking has been created or not, before sending an additional booking request, to prevent duplicated bookings. Please report this error to [email protected] as soon as you encounter. |
E0501 | Request {0}.{1} doesn't exist. | |
E0502 | Supplier action is not implemented | |
E0999 | Unknown error. | |
E1000 | Supplier error. | |
E0400 | {0} action cannot be performed on a segment with status {1} | |
E1100 | Invalid request data. | Something in your request didn't pass our validation. See detailed error message for more info. Check for 2 letters valid state (for US only), check for credit card details, etc. |
E2000 | User '{0}' not authorized to perform '{1}' action. | |
E2001 | User access denied. | |
E2002 | Resource limit reached. | Means that you've exceeded the amount of allowed requests per second. If you are using your own cluster - please make sure that your traffic is directed to your dedicated endpoint. For more assistance, please contact [email protected] |
E2050 | Segment access denied. | |
E2060 | Credentials not specified. | |
E2061 | Couldn't verify credentials. | Make sure you are using valid credentials and verify in B2b that the user is not locked. |
E2062 | Providing both Credentials and SessionId is not allowed. | |
E2063 | Credit-card is suspicious (did not pass fraud check) | |
E2300 | Segment not found | |
E2301 | OrderId Mismatch | |
E3000 | Payment not authorized. | Probably credit card issue such as wrong credit card type/number/cvv, etc. or the card was declined. You can display message in your side: "Please verify your credit card details" |
E3001 | Payment was not committed. | |
E3002 | Charging service-fee is not allowed on a 3D-enabled payment gateway account. | |
E3010 | No payment methods are defined for the user. Please check the user settings | Check the user settings and make sure the user has the option to book with cash or credit. |
E3020 | User is not allowed to book non-refundable Net rates. Please check the user settings | Check the user settings and make sure the user has the option to book non-refundable rates (if needed) |
E3030 | User doesn't have enough Obligo to book this rate. Current obligo: {credit}{currency}, Required obligo {required obligo} {currency}. Please check the obligo settings. | Check the Obligo settings on the user (and its father node) level |
E3040 | '{}' was specified as the SelectedPaymentMethod, but the allowed PaymentMethod for this package is: '{}'. | Amend the SelectedPaymentMethod |
E3050 | Payment method is not available. | 1. Make sure you have set up enough obligo for the user/branch. "Admin" ==> "Obligo" 2. Make sure the user is allowed to book cash/non-refundable/credit card. "Admin" ==> "Users" 3. Make sure in supplier contract, that "Can book" option is checked. "Admin" ==> "Contracts" 4. Make sure to use the applicable PaymentMethods returned in GetPaymentPreferences respons |
E3100 | Credit card type is not allowed. | |
E3101 | Segment already marked as paid. | |
E3500 | Fare rules can't be retrieved. | |
E3501 | Route id '{0}' not found in search results. | |
E3502 | Already Ticketed. | |
E3800 | Car extra with id '{0}' was not found. | |
E3801 | Car with id '{0}' was not found. | |
E3802 | Invalid car rental location. | |
E3803 | Car rental terms are not available | no rental details provided by the supplier. Check the supplier's response and contact the supplier accordingly. |
E3600 | Hotel Id '{0}' not found in search results. | You are trying to book hotel that wasn't returned in results from current session. Acquire new session or try to book another hotel. |
E3601 | Package Id '{0}' not found in search results. | Probable to happen when trying to access or operate on a package that wasn't returned in results from current session or when a session is expired. Acquire new session. |
I3701 | No mapped hotel ids were found. Supplier Name: {0} | |
I3702 | No mapped locations were found. Supplier Name: {0}, Location Id: {1} | |
W3703 | Search by {0} not supported by the supplier. Supplier Name: {1} | |
| --Common errors on retrieving data-- | ||
E4300 | Failed to retrieve searched details. | An error occurred when trying to process results from the suppliers. Please report this error to [email protected] as soon as as you encounter. |
E4301 | No matching item found. | Please send another Reprice request - this time with correct package. |
E4302 | Failed to read session data. | Probable to happen when you are trying to access a session which is already expired. Please report this error to [email protected] as soon as as you encounter. |
E4303 | Currency '{0}' not supported. | |
| --Booking errors-- | ||
E1101 | Booking price out of range. Discount value is invalid | Please make sure that you are sending the package price as returned on our search response. If you are willing to book at a lower price than returned in the API (provide a discount) - please contact our support to enable this functionality for you. |
E4000 | Invalid book request data | Make sure you are sending all the mandatory fields in booking request. Use only English characters in names/addresses, etc. |
E4050 | Item cannot be booked. | The supplier couldn't confirm the booking and returned an error. |
E4051 | Booking is not allowed on this account. | Make sure in supplier contract, that "Can book" option is checked. "Admin" ==> "Contracts" |
E4052 | Duplicate booking | The booking failed on the supplier side - the supplier returned an indication of a duplicate booking. Therefore any further attempt is blocked on the supplier side. Best error handling on the client side would be to alter the passenger names by appending an 'A' to lead pax and 'B' for the second pax, etc, and resend the booking request. |
E4053 | The requested package is not currently available | The supplier failed to book the selected offer. No booking has been created. |
E4060 | Item cannot be booked. | Funds/deposit/out of credit issue. - Contact the supplier to refill /deposit, to prevent such errors. Refrain from making any booking attempts with the supplier until resolved |
E4070 | The supplier rejected the book attempt | No booking created, no segment created. |
E4100 | This booking can not be confirmed, as it is not available anymore. | The supplier couldn't confirm the booking. Probably no availability from the supplier. Try to book another package. |
E4101 | Cannot book the same item twice in the same session. | The system received an additional book request for a package ID, which was already booked in a previous attempt. |
| --Cancelation errors-- | ||
E4500 | Booking cannot be confirmed due to no pre-book response receive | There are 2 common scenarios where this error can be returned: 1. The supplier returned invalid or unexpected cancellation policy response, or didn't return any rates / dates / fees at all. 2. There was a price change for the selected package, between search response price to cancellation policy response price.Cancellation policy request to our API triggers (not always) another call to supplier, to get up-to-date (more recent) prices and availability for the selected package, unlike the initial search request to supplier, that might return cached prices.In that case, in order to avoid price discrepancies and eventually prevent financial damage, we return this error message. |
E4501 | Item cannot be canceled. | Contact our tech team. |
E4502 | Cancel item not supported. | |
| --SmartBook Errors-- | ||
E6000 | SmartBook failed - internal error | |
E6001 | SmartBook failed - search error | |
E6002 | SmartBook failed - prebook error | |
E6003 | SmartBook failed - book error | |
E6007 | Invalid value sent in 'ContractIds' field | The 'Allowed contracts for book' setting which is defined for this user in the Backoffice is 'Controlled via API request', but no contract ids were specified in the request. Please specify the contract ids in the request or change the setting in the Backoffice. |
E7001 | User is not authorized to use SmartBook feature via API | Please contact our support. |
E4080 | Request timeout limit reached. No booking occurred. |
SmartBook Errors
| Error Code | Error Message | Description | Handling |
|---|---|---|---|
E8007 | SmartBook failed - could not find a better price offer. | SmartBook failed to find a better deal. | Proceed with your original room option. |
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. |
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. | KidsAges doesn’t match the AdditionalPassengers Types. | Ensure that passengers allocations are matching to the requested Rooms element . |
Updated 5 months ago