Booking flow and management

Hotel-X can return errors or warnings as the severity of these issues can vary. These errors or warnings may be directly generated by the Hotel-X API layer, or they could be transmitted from the Seller's system in cases where they encounter errors on their end.

Below, you will find the list of the possible values that you will receive.

Errors List

Errors are situations where the service has been terminated for some reason. Each error returned by the Hotel-X API layer has an alphabetic code and a type. Here, you will find the various options and their explanations.

Code	Type	Description	Explanation
ACCESS_ERROR	VALIDATION_ERROR	No valid accesses found	The access is not found or it has no permission, or you are using a test access and you need to add the testMode field to "true".
MISSING_FIELD	VALIDATION_ERROR	Depending on the scenario	Some mandatory fields are missing in input.
WRONG_FIELD	VALIDATION_ERROR	Depending on the scenario	A field or fields in the request are not correct.
ALL_PROCESSES_FAILED	PROCESS_ERROR	See warnings for more information	This happens when our system has to make more than one request to the supplier's system. For example, in a search query, if we're checking availability for many hotels or suppliers, or in a booking query when we're asking about reservations for multiple bookings. If none of these requests get a successful response, we show this error. You can find more details about why it happened in the warning message. Sometimes, it can also happen if there's something wrong with the default settings.
OPTION_NOT_FOUND	PROCESS_ERROR	Depending on the scenario	Option not found in quote. This occurs when the option's status has changed between the search response and the quote response.
INTERNAL_ERROR	API_ERROR	Depending on the scenario	Covers any unexpected error or errors due to internal service.
NOT_IMPLEMENTED	API_ERROR	Depending on the scenario	The requested operation is currently unavailable and has not been implemented for this supplier integration.
TIMEOUT	CONNECTION_ERROR	Depending on the scenario	This occurs due to a connection timeout.
INTERNAL_ERROR	REQUEST_CANCELED	Depending on the scenario	Request has been cancelled and connection has been cut.

Warning List

Warnings are potentially harmful situations or errors that do not require the service to be terminated. Warnings can originate from either the Hotel-X layer or the Seller's system. In the case of a warning from the Hotel-X layer, the code and type can be as follows:

Hotel-X warnings

Code	Type	Description	Explanation
WRONG_FIELD	PLUGIN_ERROR	According to the case	It occurs when the input of the plugin is misintroduced or misconstructed.
BLACKLIST	PLUGIN_ERROR	According to the case	It occurs when the hotels or accesses are blacklisted.
MAPPING_NOT_FOUND	MAPPING_ERROR	According to the case	The option couldn't be processed due to the absence of mapping codes for the supplier context.
INTERNAL_ERROR	MAPPING_ERROR	According to the case	Internal error produced when mapping codes, it usually happens regarding hotel mapping.
COMMISSION_NOT_FOUND	API_ERROR	According to the case	This occurs when the options are discarded because the supplier returns options with a negative commission that does not allow the calculation of the net price. You need to upload the commission file to solve it.
NOT_IMPLEMENTED	API_ERROR	Depending on the scenario	The requested operation is currently unavailable and has not been implemented for this supplier integration.
REFERENCE_NOT_EXISTS	BOOKING_ERROR	Supplier has not returned any booking with this criteria	This occurs when the provided booking reference is not available in the supplier's system.

Connection warnings

If the errors originate from the connection with the Seller's system, you will receive the following codes and types:

Code	Type	Description
Depends on the Seller	101	Unspecified Error (Exception not controlled or not classified as controlled error). This could be caused by an integration error or an unexpected supplier response.
Depends on the Seller	102	Supplier Error.
Depends on the Seller	103	Too many requests to the supplier.
Depends on the Seller	104	Error indicating that the operation exceeded the allotted time for execution (refer to the common attribute timeout).
Depends on the Seller	105	Communication Error.
Depends on the Seller	204	Supplier returns 0 results in availability.
Depends on the Seller	205	The Supplier doesn’t accept the occupations RQ.
Depends on the Seller	206	The Supplier doesn’t accept the dates RQ.
Depends on the Seller	207	The Supplier doesn’t accept the request RQ.
Depends on the Seller	301	Option not found in policies.
Depends on the Seller	302	Hotel Not Found in DescriptiveInfo.
Depends on the Seller	303	Booking not confirmed in the supplier’s system.