Skip to main content

Connector Errors

What Are Connector Errors?​

When a Buyer's request fails at the Seller, the Travelgate Connector receives a message describing what happened. Travelgate translates that message into the error you receive in HotelX or the Legacy Buyers API. Each error includes:

  • type: the kind of error. Several Connector errors can share the same type.
  • code (HotelX only): the Connector error id. It identifies the exact situation, so you can find the right fix faster.
  • description: the standard description and, when the Seller provides it, the Seller's own message.

Look up your type and code in Error Codes and What They Mean. In the Legacy Buyers API there is no code, so the description is the only place with the error details.

Example (HotelX):​

"errors": [
{
"type": "301",
"code": "11301",
"description": "Option not found in quote External: Rooms not found"
}
]

Example (Legacy Buyers API):​

<applicationErrors>
<type>301</type>
<description>
Option not found in quote: Rooms not found
Total options to try to do match: 6
Hotel: 12345 - HotelsMatch=1
Board: BB - BoardsMatch=1
Parameters - OptionsMatch=6:
Payment Type: Merchant - OptionsMatch=6

Rooms count: 1 - OptionsMatch=0
Room 1 - RoomsMatch=0:
OccupancyRefId=1
Code=Superior Room
Description=Superior Room
LegacyRoomId=1#Superior Room
</description>
</applicationErrors>

Error Codes and What They Mean​

Find your error type and code in the table. Follow the link on the type to read what it means and how to resolve it.

Error typeError code (Connector Error id)What it means
10122101Internal error
10122107Maximum number of options exceeded
10211102Seller error
10211205Seller session expired
10211206Seller request or response cannot be processed
10211207Bad request to Seller
10211304Price changed
10211305Booking not found
10212401Unauthorized
10331103Too many requests to the Seller
10431104Connection timeout with Seller
10522105Internal connection error
10522106Seller response exceeded the maximum size
10531105Communication error
10612106Request aborted by client
20411204No results found
20712207Request not accepted by Seller
20712501Operation not implemented
30111301Option not found in quote
30211302Hotel not found
30311303Booking not confirmed
tip

A 301 error also includes a diagnostic trace in its description that pinpoints why the option was not found. See 301 Error to learn how to read it.

Seller Details in the Description​

When the Seller provides details, they are added to the end of the error description:

  • HotelX: appended after the standard description, preceded by External:.
  • Legacy Buyers API: appended after the standard description, preceded by a colon.

These details are the Seller's own message, so their wording can vary between Sellers. They often explain the root cause and can help you resolve the issue faster.

How to Troubleshoot Connector Errors​

1. Identify the Error​

Check the type and code of the error you received in the table above.

2. Read the Description​

Check whether the description includes Seller details. They can contain context that is not part of the standard description.

Open the article linked to your error type and apply every recommendation that corresponds to your case. These steps are designed to let you diagnose and fix most errors on your own, giving you the fastest path back to normal operation.

4. Contact Travelgate Support​

If the error persists after completing the recommended steps, our team is ready to help. Contact Travelgate Support and include:

  • The request and response logs of your transaction.
  • The operation and the access or connection used.
  • The timestamp of the request.
  • The error type, code, and description.