Hotel Trader's approach to connectivity relies on detailed error messages to ensure technical issues can be identified and fixed quickly. All the error codes you will receive from our system are documented here.
- Reservation errors
- Business rules violation errors
- Payment/transaction errors
- Modification errors
- Cancellation errors
- Fetch reservation errors
- Search errors
- Other errors
Errors with Error code 2000 and above are server side errors. In case you receive an Error ID >2000 please reach out to Hotel Trader Support for assistance.
Reservation Error Codes
| Error Code | Description |
|---|---|
| 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. It must be at least 3 characters. Alpha number + special characters allowed. Max 50 characters. |
| 1006 | Request format invalid. Please check |
| 1007 | The ResStatus value provided is invalid. 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 of 1 adult |
| 1018 | Invalid child age. The child's age should be between the 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 |
| 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 the client with the given HT Confirmation Code in HT Systems |
| 1030 | This rateplan is not eligible for a stay on this DOW. |
| 1031 | checkInDate in request does not match with date in htIdentifier |
| 1032 | checkOutDate in request does not match with date in htIdentifier |
| 1033 | propertyId in 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 | Unable to find nightly charges for existing room, to add existing room from db to reservationDTO |
| 1040 | Unable to find nightly charges for existing room |
| 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 Error Codes
| Error Code | Description |
|---|---|
| 1101 | Invalid ratePlanCode, cannot be null or empty |
| 1102 | The stay date is closed |
| 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 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 | Stop Sell is in effect for this roomtype. Please contact Hotel Trader Support to refresh ARI. |
| 1130 | Stop Sell is in effect for this roomtype. Please contact Hotel Trader Support to refresh ARI. |
| 1131 | Invalid roomtype code specified. Room not found |
| 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 | The stay date is closed |
| 1137 | Invalid roomTypeCode, cannot be null or empty |
| 1138 | Max LOS Stay Through restriction is not passed |
| 1139 | Min LOS Stay Through restriction is not passed |
| 1140 | Multi-room reservations can only be done across a single property |
| 1148 | Invalid cancellation charge. Reservation was rejected as the client does not allow mispriced reservations. |
Payment/Transaction Error Codes
| Error Code | Description |
|---|---|
| 1200 | Couldn't fetch transaction details |
| 1201 | Unable to process the payment request |
| 1202 | Unable to process the payment request |
| 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 | The payment gateway returned an error response |
| 1207 | Invalid request, not all payment information is passed |
| 1208 | Payment info required |
Modification Error Codes
| Error Code | Description |
|---|---|
| 1400 | Room(s) requested for modification not found |
| 1401 | The room(s) requested for cancellation have already been canceled |
Cancellation Error Codes
| Error Code | Description |
|---|---|
| 1500 | Cancel request failed, check-in date has passed |
Fetch Reservation Error Codes
| Error Code | Description |
|---|---|
| 1600 | Guest not found |
| 1601 | Reservation not found for given parameters |
| 1602 | Reservation not found for HT confirmation code |
| 1603 | Active Room(s) associated with the reservation not found |
| 1604 | Reservation Room not found for given parameters |
| 1823 | Invalid date format. Allowed format is yyyy-MM-dd'T'HH:mm:ssZ |
| 1824 | The difference between start and end date should not be more than 31 days |
| 1825 | Both start date and end date are required |
| 1826 | Invalid dates. The start date cannot be greater than the end date |
Search Error Codes
| Error Code | Description |
|---|---|
| 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 |
| 1710 | The room rate check failed, please redo the search query to get updated rates. |
| 1711 | The price has changed. Please review the changed prices and resubmit the request with the revised rates. |
| 1712 | Missing children ages do not match the children's count |
| 1714 | Invalid value for childrenAges should be null or empty string if child count = 0 |
| 1715 | Multi-room confirm price call failed due to low inventory threshold at the hotel |
| 1716 | Multi-room confirm price call failed due to non-refundable rooms |
| 1717 | Multi-room confirm price call failed because room(s) is within the penalty |
| 1718 | Price has changed. Please review the changed prices and resubmit the request with the revised rates. |
| 1719 | Invalid value for guestAges, allowed values are 0-120 years |
Other Error Codes
| Error Code | Description |
|---|---|
| 1901 | Unable to get config for the 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, Please contact HT Support |
| 1909 | Rate reconciliation failed to adjust rates, client has lower rates. |
| 1913 | Internal Server Error, Please contact HT Support |
| 1923 | Invalid nightly rates or taxes list, list cannot be null or empty, list elements cannot be null |
| 1924 | nightly Rates/Taxes list length does not match LOS |
| 1928 | Promo Rateplan unavailable |
| 1929 | Invalid request - not all restrictions passed to process a request |
| 1939 | The client is not found |