Hotel Trader's approach to the integration relies on full transparency. The sections below provide information on the error codes that Hotel Trader:
- Expects its clients to return in the error responses to ARI Messages
- Sends to its clients on reservation failures
Quick Links
ARI Error Codes
If the ARI messages are not processed correctly, the client must send the following error codes in the OTA_HotelAvailNotifRS and OTA_HotelRatePlanNotifRS objects.
| Error Code | Error Message |
|---|---|
| 1102 | Invalid credentials |
| 1104 | Echotoken is missing |
| 1105 | The hotel code is missing |
| 1106 | Rateplan code is missing |
| 1107 | The Roomtype code is missing |
| 1108 | The end date is older than start date |
| 1110 | The date format is incorrect for the start date |
| 1111 | The date format is incorrect for the end date |
| 1112 | The hotel code is invalid [Please return this error code in the scenario where the hotel code is not created within your system] |
| 1113 | The Rateplan code is invalid [Please return this error code in the scenario where the rateplan code is not created within your system] |
| 1114 | Roomtype code is invalid [Please return this error code in the scenario where the roomtype code is not created within your system] |
| 1115 | The booking limit value is invalid |
| 1117 | Length of stay value is invalid |
| 1118 | The lead time value is invalid |
| 1119 | AmountBeforeTax value is invalid |
| 1121 | AdditionalGuestAmount value is invalid |
Reservation Error Codes
In case of any failures in booking/modification/cancellation requests, Hotel Trader sends the following error codes in the OTA_HotelResNotifRS object.
Client Payload Request Errors
| Error Code | Error Message |
|---|---|
| 1000 | Invalid CheckInDate. CheckInDate is in the past |
| 1001 | Invalid dates. CheckInDate cannot be greater than CheckOutDate |
| 1002 | Invalid CheckOutDate. CheckOutDate is in the past |
| 1003 | Missing CheckInDate or CheckOutDate, dates are required! |
| 1004 | Duplicate Client Confirmation code received, reservation already exists with same client confirmation number |
| 1005 | Client confirmation code can't be null or empty. Must be at least 3 characters. Alpha number + special characters allowed. Max 50 characters. |
| 1006 | Request format invalid. Please check |
| 1007 | Invalid ResStatus value provided. Acceptable values are BOOK(COMMIT - deprecated), MODIFY or CANCEL. values are case insensitive. |
| 1008 | Unable to read the request XML |
| 1009 | Invalid date format. Allowed format is yyyymmdd |
| 1010 | Invalid date format. Allowed format is yyyy-mm-dd |
| 1011 | No reservation was found for the Client confirmation code |
| 1012 | Stay length cannot be zero |
| 1013 | The length of your trip exceeds the maximum of 28 nights. Please adjust your travel dates |
| 1014 | The date is closed. Roomtype is not enabled for this Rateplan. rateplan to roomtype mapping not found |
| 1016 | Unable to read guest information. Please ensure guest details are present. |
| 1017 | Room occupancy requires a minimum 1 adult |
| 1018 | Invalid child age. Child age should be between specified ages for the property unless otherwise specified by the hotel. |
| 1019 | Invalid infant age. Infant age should be 0 or 1 unless otherwise specified by the hotel. |
| 1020 | Child ages do not match no. of children |
| 1021 | CostBreakDownList is null or empty for daily rates |
| 1022 | The guest type is invalid. Guest Type can be AD for Adult, CH for Child, IN for Infant |
| 1024 | Invalid Request - missing Nightly Rates / daily breakup for stay date(s) |
| 1025 | Invalid Request - missing Nightly Taxes / daily breakup for stay date(s) |
| 1026 | Invalid Request - missing client Rates for stay date(s) |
| 1027 | Invalid htIdentifier |
| 1028 | htIdentifier expired |
| 1029 | Reservation not found for a client with given HT Confirmation Code in HT Systems |
| 1030 | This rateplan is not eligible for a stay on this DOW. |
| 1031 | checkInDate in the request does not match with date in htIdentifier |
| 1032 | checkOutDate in the request does not match with date in htIdentifier |
| 1033 | propertyId in the request does not match with htPropertyId in htIdentifier |
| 1034 | Invalid guest details, firstName required |
| 1035 | Invalid guest details, lastName required |
| 1036 | Invalid guest details, email required |
| 1037 | Invalid guest details, phone required |
| 1039 | Modify request failed, internal error |
| 1040 | Internal server error. Please contact HT Support. |
| 1043 | Invalid request, multi-room requests can have only REF or non-REF rooms |
| 1044 | Invalid validArrivalDow for given checkInDate |
| 1045 | Invalid htIdentifier, already used for a different request |
| 1046 | Authorization failed, please check the credentials |
| 1047 | Unable to read guest information. Please ensure the guest count is present |
| 1048 | Room-level client confirmation code should be unique across rooms in a multi-room request |
| 1049 | Internal server error, Please contact HT developers |
| 1050 | Invalid request, otaClientName is required |
Business Rules Violation Errors
| Error Code | Error Message |
|---|---|
| 1101 | Invalid ratePlanCode, cannot be null or empty |
| 1102 | Rate is not available for this date |
| 1103 | Stop Sale in effect for 1 or more stay date(s) |
| 1104 | Date is closed for 1 or more stay date(s) |
| 1105 | Rates must be specified for all stay dates |
| 1106 | Date is closed |
| 1107 | Max Adult Occupancy Restrictions not met for room |
| 1108 | Max Children's Occupancy Restrictions not met for room |
| 1109 | Max Total Occupancy Restrictions not met for room |
| 1110 | Min Adult Occupancy Restrictions not met for room |
| 1111 | Min Children Occupancy Restrictions not met for room |
| 1112 | Price is null |
| 1113 | Price is zero |
| 1114 | Stop Sell is in effect for this property. Please contact Hotel Trader Support to refresh ARI. |
| 1115 | Stop Sell is in effect for this property. Please contact Hotel Trader Support to refresh ARI. |
| 1116 | Stop Sell is in effect for this property. Please contact Hotel Trader Support to refresh ARI. |
| 1117 | Property not found |
| 1118 | Stop Sell is in effect for this rateplan. Please contact Hotel Trader Support to refresh ARI. |
| 1119 | Stop Sell is in effect for this rateplan. Please contact Hotel Trader Support to refresh ARI. |
| 1120 | Stop Sell is in effect for this rateplan. Please contact Hotel Trader Support to refresh ARI. |
| 1121 | The arrival date is closed for check-in |
| 1122 | The date is closed |
| 1123 | Departure date is closed for check-out |
| 1124 | Max LOS restriction is not passed |
| 1125 | MinLeadTime restriction not passed |
| 1126 | Min LOS restriction is not passed |
| 1127 | Room Inventory is null |
| 1128 | Room Inventory is zero |
| 1129 | Rateplan is not found or active for client |
| 1130 | Stop Sell is in effect for this roomtype. Please contact Hotel Trader Support to refresh ARI. |
| 1131 | Invalid roomtype code specified. |
| 1132 | Invalid rate. Reservation rejected as client does not allow mispriced reservations. |
| 1133 | The date is closed for children |
| 1135 | MaxLeadTime restriction not passed |
| 1136 | Rate is not available for this date |
| 1137 | Invalid roomTypeCode, cannot be null or empty |
| 1138 | Max LOS Stay Thorugh restriction is not passed |
| 1139 | Min LOS Stay Thorugh restriction is not passed |
Payment/Transaction Errors
| Error Code | Error Message |
|---|---|
| 1200 | Could'nt fetch transaction details |
| 1201 | Payment error |
| 1202 | Payment error |
| 1203 | PaymentInformation.paymentAmount should be the sum of roomsDetails.roomRate.roomTotalAmount fields. |
| 1204 | Could not process this request due to a Payment Gateway error. Please contact Hotel Trader Support. |
| 1205 | Refund Failure |
| 1206 | Refund Failure while saving to database. |
| 1207 | Invalid request, not all payment information is passed |
| 1208 | Payment Info required |
Modification/Cancellation Errors
| Error Code | Error Message |
|---|---|
| 1400 | Room(s) requested for modification not found |
| 1401 | The room (s) requested for cancellation have already been canceled |
Inconsistent Cancellation Request Errors
| Error Code | Error Message |
|---|---|
| 1500 | Cancel request failed, check-in date has passed |
Non-Hotel Trader Reservation Errors
| Error Code | Error Message |
|---|---|
| 1600 | Guest not found |
| 1601 | Reservation not found for given parameters |
| 1602 | Reservation not found |
| 1603 | Active Room(s) not found |
| 1604 | Reservation Room not found for given parameters |
Errors 1700 - 1799
| Error Code | Error Message |
|---|---|
| 1700 | Error, Request payload not found |
| 1701 | File name to fetch Request payload not found |
| 1702 | Error while Repushing request - could not get Request Payload |
| 1703 | Invalid Repush request - not all required params passed |
| 1704 | Request status MODIFY not supported for Repush Module |
| 1705 | netPrice is a required field, and cannot be null or 0 |
| 1706 | tax is a required field, and cannot be null or 0 |
| 1707 | Invalid value for childrenAges, allowed values are 0-12 years, both inclusive |
| 1708 | Invalid Repush request - reservation_incoming entry not found |
| 1709 | Invalid Repush request - not supported for PULL client/admin requests |
| 1710 | Confirm price call failed due to internal server error |
| 1711 | The price has changed. Please review the changed prices and resubmit the request with the revised rates. |
| 1712 | Missing children's age does not match children's count |
| 1713 | Invalid Repush request - not all restrictions passed and ignoreChecks = false |
| 1714 | Invalid value for childrenAges should be null or empty string if child count = 0 |
Errors 1800 - 1899
| Error Code | Error Message |
|---|---|
| 1800 | User not found |
| 1801 | HT Confirmation Code is required field |
| 1802 | Client Confirmation Code is required field |
| 1803 | CRS Confirmation codes are required to update the CRS confirmation codes for the reservation |
| 1804 | Modification failed as the room was already canceled. |
| 1805 | The room is already canceled in the database. |
| 1806 | Not all nightly values were passed for a modification request |
| 1807 | Cancel fee error, pass at least 1 room htConfCode |
| 1808 | Duplicate HT Confirmation code |
| 1809 | At least 1 room required for booking |
| 1810 | Call to create booking failed |
| 1811 | Invalid request, need nightlySourceRates since no ARI exists for given parameters |
| 1812 | Invalid request, need nightlySourceTaxes since no ARI exists for given parameters |
| 1813 | Invalid request, need nightlySourceRates for all nights of stays since no ARI exists for given parameters |
| 1814 | Invalid request, need nightlySourceTaxes for all nights of stays since no ARI exists for given parameters |
| 1815 | Client Room Confirmation Code is required field |
| 1816 | Purge Reservation failed, not a test client's reservation |
| 1817 | Purge Reservation failed, reservation could not be cancelled upstream |
| 1818 | Invalid Modify request, please check all values are passed |
| 1819 | HT Room Confirmation Code is required field |
| 1820 | Room not found for given HT Room Confirmation Code |
Errors 1900 - 1999
| Error Code | Error Message |
|---|---|
| 1901 | Unable to get config for client, check integration |
| 1902 | Please contact HT Sales, client connection is not enabled. |
| 1903 | Stop Sell is in effect for this promotional rateplan. Please contact Hotel Trader Support to refresh ARI. |
| 1904 | Invalid Promo Rateplan History |
| 1905 | Promotional Rateplan has expired and a Stop Sell is in effect. Please contact Hotel Trader Support to refresh ARI. |
| 1906 | Internal server error, Please contact HT Support |
| 1907 | Internal server error |
| 1908 | Reservation failure entry not found in res_inc |
| 1909 | The client sent rates not found in the grace period. |
| 1910 | Internal error, no implementation |
| 1911 | Internal error, no implementation |
| 1912 | Internal error, no implementation |
| 1913 | Internal Server Error, Please contact HT Support |
| 1914 | The client sent a lower price. Price recon case not yet implemented. |
| 1915 | CRS ID or PMS ID is not null in the database and it already exists, so not updating |
| 1916 | Both the CRS ID and PMS ID cannot be null |
| 1917 | Internal server error |
| 1918 | Internal server error, Please contact HT Support |
| 1919 | Internal server error, Please contact HT Support |
| 1920 | Internal server error, Please contact HT Support |
| 1921 | Internal server error, Please contact HT Support |
| 1922 | Internal server error, Please contact HT Support |
| 1923 | Invalid request |
| 1924 | Internal server error, Please contact HT Support |
| 1925 | Internal server error, Please contact HT developers |
| 1926 | Internal server error, Please contact HT developers |
| 1927 | Internal server error, Please contact HT developers |
| 1928 | Promo Rateplan unavailable |
| 1929 | Invalid request - not all restrictions passed to process a request |
| 1930 | Admin reservation request error, not all restrictions passed and ignoreChecks = false |
| 1931 | Internal server error, Please contact HT developers |
| 1932 | Internal server error, Please contact HT developers |
| 1933 | Internal server error, Please contact HT developers |
| 1934 | Internal server error, Please contact HT developers |
| 1935 | Internal server error, Please contact HT developers |
| 1936 | Internal server error, Please contact HT developers |
| 1937 | Internal server error, Please contact HT developers |
| 1938 | Internal server error, Please contact HT developers |
| 1939 | The client is not found |