Error Handling

The GTA systems return errors in several different formats, depending on the cause of the error. It is important that you have processes in place to:

  • Capture all errors
  • Analyse all errors
  • Make changes to your systems to avoid sending GTA any further XML requests that would result in the same error

Ignoring any of these errors may lead to:

  • Poor user experience for your customers
  • Loss of revenue for both our companies

SCHEMA ERRORS 

If you are breaking the schema of our XML API (please refer to Schema Files document) we will return a HTTP-400 error. You will need to check the body of the error which contains a valid XML response providing details of the cause of the error which should make it easy for you to debug your code and correct the issue: 

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Errors>
        <Error>
            <ErrorId>XML0012</ErrorId>
            <ErrorText>
                <![CDATA[cvc-pattern-valid: Value '23456' is not facet-valid with respect to pattern '([a-zA-Z%]{0,3})' for type 't_CurrencyCode'.]]>
            </ErrorText>
        </Error>
    </Errors>
</Response>

AUTHENTICATION ERRORS 

If you are using incorrect authentication details or are posting XML messages from an IP address that is not authorised on our systems we will return a HTTP-403 error. You will need to check the body of the error which contains a valid XML response providing details of the cause of the error which should make it easy for you to correct the issue. In the case of an unauthorised IP address or if access to our systems has expired it will be necessary for you to contact us in which case please always provide copies of the XML requests and the error we return. An example of an authentication error would be: 

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Errors>
        <Error>
            <ErrorId>ERR0053</ErrorId>
            <ErrorText>
                <![CDATA[Invalid password entered for Client 123, eMail XML.client@gta-travel.com.]]>
            </ErrorText>
        </Error>
    </Errors>
</Response>

These errors are generated by our mid- and back-office systems and can come with three differently pre-fixed error codes: ‘ERR’-errors, ‘GRT’-errors and ‘XML’-errors. Examples for these are:

<?xml version="1.0" encoding="UTF-8"?>
<Response ResponseReference = "REF_P_028_126-1305706113136">
    <ResponseDetails Language = "en">
        <SearchHotelPriceResponse>
            <Errors>
                <Error>
                    <ErrorId>ERR0006</ErrorId>
                    <ErrorText><![CDATA[Parameter "check in date" with value "1999-05-05" is not valid.]]></ErrorText>
                </Error>
            </Errors>
        </SearchHotelPriceResponse>
    </ResponseDetails>
</Response>

 

<?xml version="1.0" encoding="UTF-8"?>
<Response ResponseReference = "REF_D_010_2065-10888-849958054453824" ResponseSequence = "1">
    <ResponseDetails Language = "en">
        <BookingResponse>
            <Errors>
                <Error>
                    <ErrorId>GRT3419</ErrorId>
                    <ErrorText><![CDATA[Modifications are not allowed for this item]]></ErrorText>
                    <ErrorContext ItemReference = "1" Sequence = "1"/>
                </Error>
            </Errors>
        </BookingResponse>
    </ResponseDetails>
</Response>

 

<?xml version='1.0' encoding="UTF-8" ?>
<Response ResponseReference = "REF_P_028_123-447851-3644312787499130">
    <ResponseDetails Language = "en">
        <Errors>
            <Error>
                <ErrorId>XML0017</ErrorId>
                <ErrorText>
                    <![CDATA[The following TOKEN was not found: REF_P_028_123-447851-3644312787499130]]>
                </ErrorText>
            </Error>
        </Errors>
    </ResponseDetails>
</Response>

MAINTENANCE ERROR 

 During scheduled maintenance we will return the following error to all XML requests: 

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <ResponseDetails>
        <Errors>
            <Error>
                <ErrorId>ERR0062</ErrorId>
                <ErrorText>
                    The XML API is currently unavailable. Please try again or check http://xml-support.gta-travel.com/  for system updates
                </ErrorText>
            </Error>
        </Errors>
    </ResponseDetails>
</Response>

ERROR CODES AND DESCRIPTIONS 

 Below is a list of the most common errors returned via XML. This should cover 95% of all the errors returned via the XML API. We do not provide a finite list as it would run into thousands of entries and most of them would never be returned to the client. All codes have a description associated with it which should make it easy to resolve the issue. In some cases it might be necessary to contact GTA to change a setting or to request authorisation.

Error code

Description

ERR0001

Invalid password entered for Client {1}, e-Mail {2}.

ERR0002

Unexpected error

ERR0003

Language "{1}" not valid or not supported

ERR0004

Not authorised to XML function

ERR0005

Parameter "{1}" must be entered.

ERR0006

Parameter "{1}" with value "{2}" is not valid.

ERR0007

Parameter "{1}" contains a value inconsistent with the schema

ERR0008

The maximum number of passengers allowed is 9.

ERR0009

"Age" tags specified do not correspond to NumberOfRooms

ERR0010

The "Code" parameter entered for the "Room" is invalid

ERR0011

Client {1}, e-Mail {2} is currently disabled. Please contact help desk for assistance.

ERR0012

Error '{1} - ({4})' occurred during processing of booking reference '{2}', for request type '{3}'.

ERR0013

{3}, for booking reference '{2}' failed with error code '{1}'

ERR0014

Children under the age of {1} need to be accompanied by an adult

ERR0015

Not authorised to ItemType "{1}".

ERR0016

StarRating required if MinimumRating="true" specified.

ERR0017

Unable to price item with given request parameters.

ERR0018

General Exception Error

ERR0019

Server is too busy

ERR0020

Cots are not allowed in Single Rooms

ERR0021

Unable to find any supplier rates

ERR0022

Supplier city not found

ERR0023

Car Key is invalid

ERR0024

Start Date must be earlier than the End Date

ERR0025

Start Time must be earlier than the End Time

ERR0026

Supplier "{1}" does not exist within the city "{2}".

ERR0027

Airport "{1}" does not exist within the city "{2}".

ERR0028

"{1}" details are not valid.

ERR0029

Unable to provide the price breakdown details for this item.

ERR0030

The minimum age for the item is {1}.

ERR0031

Attribute "{1}" is either not supplied or invalid.

ERR0032

Failed to retrieve dynamic property data via Web Services.

ERR0033

Unable To Process Request - GTA Internal Communication Error

ERR0034

Unable To Process Request - Server is too busy

ERR0035

Unable To Process Request - GTA Internal Communication Error

ERR0036

Authentication Failure

ERR0037

Unable To Process Request - GTA Internal Communication Error

ERR0038

Unable To Process Request - Response error: {0}

ERR0039

Unable To Process Request - Response error.

ERR0040

Unable To Process Request - Error With GTA Report Queue

ERR0041

Number of currencies requested exceed the limit permitted

ERR0042

Date range requested exceeds the maximum number of days

ERR0043

The report is identical except for nationality

ERR0044

Start date exceeds the maximum days in the future permitted

ERR0045

Request exceeds the maximum number of parallel requests

ERR0046

Request exceeds the frequency for the report

ERR0047

Request exceeds the frequency for the report

ERR0048

Unable To Process Request - GTA Internal Unexpected Error

ERR0049

Invalid Client ID

ERR0050

Invalid email address entered

ERR0051

Client {1}, e-Mail {2} is currently expired. Please contact help desk for assistance

ERR0052

Client {1}, e-Mail {2} is currently disabled. Please contact help desk for assistance

ERR0053

Invalid password entered for Client {1}, e-Mail {2}

ERR0054

Client IP not authorized to system. Please contact help desk for assistance

ERR0055

Language "{0}" not valid or not supported

ERR0056

Language "{0}" not authorised

ERR0057

Language "{0}" not valid or not supported

ERR0058

Parameter "Currency" with value "{0}" is not valid

ERR0059

Parameter "Currency" with value "{0}" is not authorised

ERR0060

Parameter "Currency" with value "{0}" is not valid

ERR0061

Parameter "Country" with value "{0}" is not valid

ERR0062

The XML API is currently unavailable. Please try again or check http://xml-support.gta-travel.com/ for system updates

XML services are currently under maintenance - estimated recovery time is {time}

ERR0067

The number of passengers should be in accordance to Room Type and Extra Beds

ERR0068

Booking cannot be confirmed at the expected price

ERR0079

The sub-request specified can only be sent with RequestMode set to ASYNCHRONOUS

ERR0094

If there are more than one Rate Key Ids in the request, they should be identical

ERR0097

The Creation Date of the booking can't be more than today's date

ERR0099

ReferenceSource 'api'  must be numeric and must contain upto 9 digits only

ERR0101

Number of sub-requests cannot be more than 100 for <SearchHotelPriceRequest>

ERR0102

Any sub requests in a batch of more than 50 and up to 100 for SearchHotelPriceRequest, must be with the item code

ERR0114

Number of sub-requests cannot be more than 100 for <SearchHtelPricePaxRequest>

ERR0115

Any sub requests in a batch of more than 50 and up to 100 for SearchHotelPricePaxRequest, must be with the item code

ERR0118

Booking could not confirm as one or more items were no longer available

ERR0119

‘Free Format remarks are not supported in Pax and Room Multi Item requests’

ERR0127

"Parameter "DestinationCode" must be entered"

ERR0131

Duplicate values in RoomINdex

ERR0137

“Hotel is invalid”



GRT0022

Booking master record not found

GRT0032

Hotel is invalid

GRT0039

Pax name record not found

GRT0040

Item record could not be found

GRT0057

Rooms and number of pax do not match

GRT0106

Departure date is invalid

GRT0145

Departure time is invalid

GRT0252

Pricing could not complete - rate missing

GRT0258

Option not allowed - bkg is cancelled

GRT0323

Please specify a phone/fax number

GRT0325

Duration is invalid for specified type.

GRT0373

Room type is invalid

GRT0549

Gap between service date and departure date is too great

GRT1691

Invalid DropOff code entered

GRT1830

Too Many Pax Exists For Room

GRT1847

Booking reference has already been processed

GRT1891

Unable to process request as no live booking exists for supplied reference

GRT1913

Not authorised to item type

GRT1946

Departure Point/Time combination is invalid

GRT1981

Item is not allowed to be amended

GRT2062

Booking reference record could not be found

GRT2763

Past booking items cannot be cancelled

GRT2764

Booking cannot be cancelled as past items exist

GRT3081

You are not authorised to add free-format remarks

GRT3252

Unable to create booking, cut off point for on request items has been reached.

GRT3369

Cannot book a child under the age of 16 without an adult.

GRT3418

Passenger name changes are not allowed for this item

GRT3419

Modifications are not allowed for this item

GRT3461

Not authorised to add Passenger Email

GRT3705

For this property all Hotel Room details must be the same including Code, extra bed and Id



XML0012

Schema validation failed

XML0017

The following TOKEN was not found:

XML0018

General exception error

XML0026

Could not accept {0} for pax as it is not an ASCII value.

XML0027

Item type {0} not valid.

XML0031

GTA Server is too busy.

XML0037

Booking cannot be confirmed at the expected price

XML0038

Booking cannot be confirmed at the expected price

Docs Navigation