Each response from GP Travel HUB contains identifier whether it has been processed successfully or not - the elements <Success/>, <Warning/>, <Errors/>.
There are the following possible cases:
8.1. SUCCESS
Means that request was successfully sent and GP Travel HUB receives correct response from supplier without any warnings and errors from supplier.
Success Response Sample XML
<OTA_CancelRS Version="2" EchoToken="EchoToken" TransactionIdentifier="12232" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
<Success/>
</OTA_CancelRS>
8.2. WARNING
Means that request was successfully sent and GP Travel HUB receives correct response from supplier, but there are some warnings to pay attention.
There is a structure of Warning Response that is common for every response.
Warnings/Warning:
*mandatory
Element | Attribute | Type | Description | Min…Max occurs |
|---|
| Type* | integer (1, 3, 10, 11) | Defines type of the error or warning that occurred. Refers to OTA codes "Error Warning Type (EWT)”. | 1…1 |
Code* | integer (1 - 1051) | Defines Error/Warning code. | 1…1 |
Status* | string ("SENT", "NOT_SENT") | The values are (SENT | NOT_SENT). Used for defining actual status of request. | 1…1 |
ShortText* | string | Short error description. | 1…1 |
RecordID | string | This attribute specifies supplier ID. If requests spans multiple suppliers, you can use this attribute to identify which supplier caused the problem. | 0…1 |
Language* | | For more information see Common Data Description section in Glossary. | |
DocURL | URI | If present, this URL refers to an online description of the error that occurred. | 0…1 |
Tag | string | If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. | 0…1 |
Warning Response Sample XML
<Warnings>
<Warning Code="189" Language="en" RecordID="supplierCode" ShortText="Price has been changed." Status="SENT" Type="3"/>
</Warnings>
8.3. ERROR
Means that request was not sent to supplier (supplier temporally unavailable or failed data verification) or GP Travel HUB receives incorrect response or error from supplier. In case of error GP Travel HUB additionally returns original text from supplier.
Either there can be errors returned by GP Travel HUB itself. It mostly can be cases when a request validation not passed. Requests with incorrect format can not be processed by GP Travel HUB and passed to suppliers, so GP Travel HUB returns SOAP error message.
Errors/Error element has the same structure as Warnings/Warning.
Error Response Sample XML
<Errors>
<Error Type="3" Code="172" ShortText="Generic error." Status="NOT_SENT" Tag="NORMAL" Language="en">Invalid client specified [ID:stb, IDContext: null, Instance:null]</Error>
</Errors>
8.4. ERROR AND WARNING CODES
Here we list all possible errors and warnings that can occur at transfer messages.
8.4.1. TRANSFER AVAILABILITY
GP_TransferAvailRS
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 15 | Invalid date. | Supplier supports only dates in 'yyyy-MM-dd' format. | NOT_SENT |
20 | Number of passengers invalid. | Supplier allows only 99 paxes max in request. Supplier allows only 9 paxes max in request.
| NOT_SENT |
26 | At least one adult must be included. | At least one adult must be included. | NOT_SENT |
161 | Search criteria invalid. | Supplier does not support transfers from city to city. Supplier does not support transfers to other cities.
| NOT_SENT |
172 | Requested action not possible. | Supplier supported only russian language. Supplier supported only currency RUB. There are transfers between two points in one city only. Transfer time has been changed to flight arrival time since the driver of the pickup car will check when the plane will land in order to be at the airport at the correct time. Supplier supports only search by city. Supplier does not have transfer for such destination.
| NOT_SENT |
172 | Requested action not possible. | Supplier doesn't support requested language. Language is different from what has been requested. The specified transfer time was not taken into account on search, since supplier doesn't support this.
| SENT |
184 | Language code invalid. | Supplier does not support requested language. | NOT_SENT |
253 | Invalid pick up time. | Transfer details as well as price will be more precise if transfer time specified. | SENT |
322 | No availability. | | NOT_SENT |
357 | Invalid city code specified. | Cannot find a city by IATA code. | NOT_SENT |
400 | Invalid property code | Invalid transfer code passes. | SENT |
450 | Unable to process. | | SENT |
558 | Accounts are settled in a currency different from the quoted rate currency. | Rates or cancellation fee are returned in other currency than it was requested. | SENT |
8.4.2. TRANSFER CHARGES
GP_TransferChargesRQ
Warning/Error | Code | Short text | Possible reason | Status |
Error | 161 | Search criteria invalid. | BookingCode 3e8 not found in HUB system. | NOT_SENT |
Warning | 189 | The price has been changed. | The price has been changed. | SENT |
Error | 360 | Error entry code. | There is no available information about cancellation fees for offer with bookingCode. | SENT |
Warning | 438 | Requested rate not available. | Offer availability status changed to AvailableForSale/OnRequest. Offer is not available anymore.
| SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency. | Requested currency was CAD, but cancellation fees returned in USD. | SENT |
8.4.3. RESERVATION INITIATE
GP_TransferResRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
Error | 15 | Invalid date. | Transfer date differs from Reservation Initiate message. | NOT_SENT |
Error | 20 | Number of passengers invalid. | This offer is for 2 adults, 2 children and 0 infants, but you tried to book for 2 adults, 1 children and 1 infants. | NOT_SENT |
Error | 27 | Passenger details are mandatory. | Lead passenger surname and name are required for booking. NamePrefix is mandatory, but the value is empty.
| NOT_SENT |
Error | 161 | Search criteria invalid. | Departure or destination information differs from information in Reservation Initiate message. Invalid booking code. Pick up details or drop off details are supplied incorrectly. Mandatory passenger detail is missed, e.g. The client's country is missed. Minimum connecting time must be no more than 6 hours.
| NOT_SENT |
Error | 172 | Requested action not possible. | Address should be less than 80 characters. It needs to provide both ShipName and ShippingCompany in SailingDetails. It is need to provide CodeContext, TrainDateTime and TrainNumber in RailDetails. Incorrect phone number. The address must be specified for PickUp and DropOff points. Diffdates. Child’s ages are different between avail request and res_initiate request.
| SENT/NOT_SENT |
Warning | 172 | Requested action not possible. | Comments are not supported. Supplier doesn't support requested language. Language is different from what has been requested.
| SENT |
Warning | 189 | The price has been changed. | The price has been changed. | SENT |
Warning | 209 | Transfer time has been changed. | Transfer time has been changed to flight arrival time since the driver of the pickup car will check when the plane will land in order to be at the airport at the correct time. | SENT |
Error | 227 | Pickup date time not within operating hours. | Pickup date time not within operating hours since the time that should be allowed for check in at the drop off point is 14:00 hour(s). Pick-up time must be before 13:00. | NOT_SENT |
Warning | 438 | Requested rate not available. | Offer availability status changed to AvailableForSale/OnRequest. | SENT |
Error | 450 | Unable to process. | | SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency. | Requested currency is not supported by supplier. | SENT |
Warning | 1001 | The price has been changed. | Price has been changed. | SENT |
8.4.4. RESERVATION CONFIRMATION
GP_TransferResRQ_Book
Warning/Error | Code | Short text | Possible reason | Status |
Error | 15 | Invalid date. | Transfer date differs from Reservation Initiate message. | NOT_SENT |
Error | 20 | Number of passengers invalid. | This offer is for 2 adults, 2 children and 0 infants, but you tried to book for 2 adults, 1 children and 1 infants. | NOT_SENT |
Error | 27 | Passenger details are mandatory. | Lead passenger surname and name are required for booking. NamePrefix is mandatory, but the value is empty.
| NOT_SENT |
Error | 161 | Search criteria invalid. | Departure or destination information differs from information in Reservation Initiate message. | NOT_SENT |
Error | 172 | Requested action not possible. | Phone should be less than 15 characters and more than 10 characters. Paxes info(count, children ages) in Reservation Confirmation message differ from paxes info in Reservation Initiate. Supplier does not allow booking identical guests. The address must be specified for PickUp and DropOff points. Diffdates.
| NOT_SENT |
Warning | 209 | Transfer time has been changed. | Transfer time has been changed to flight arrival time since the driver of the pickup car will check when the plane will land in order to be at the airport at the correct time. | SENT |
Error | 450 | Unable to process. | | SENT |
8.4.5. RESERVATION IGNORE
GP_TransferResRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 188 | Transaction error - please report. | The reservation ignore wasn't be completed successful. Please try again or report about error to support. | SENT |
8.4.6. TRANSFER RETRIEVAL
GP_TransferResRQ_Quote
Warning/Error | Code | Short text | Possible reason | Status |
Error | 450 | Unable to process. | | SENT |
8.4.7. CANCELLATION INITIATE
OTA_CancelRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
Error | 16 | Service has been canceled. | Can not cancel reservation. Please report. Booking is already cancelled.
| SENT |
Warning | 58 | Price(s) cannot be validated. | Supplier can not guarantee final price. | SENT |
Warning | 172 | Requested action not possible. | Cancellation fees haven't been checked real-time, but were taken from cache. | NOT_SENT |
Error | 264 | Reservation cannot be cancelled. | This reservation cannot be cancelled via API. Please contact the supplier to cancel this reservation. | SENT |
8.4.8. CANCELLATION CONFIRMATION
OTA_CancelRQ_Book
Warning/Error | Code | Short text | Possible reason | Status |
Error | 16 | Service has been canceled. | There are no service lines in this booking that can be canceled or the booking contains one or more non-canceled service lines, but none of them can be canceled as in each case the service date is too close. | SENT |
Error | 95 | Booking already cancelled. | Booking already canceled. | NOT_SENT |
Warning | 189 | Price has been changed. | The price has been changed. | SENT |
Error | 450 | Operation not supported. | Supplier does not support operation Cancel. | NOT_SENT |
Warning | 1001 | Price has been changed. | The price has been changed. | SENT |
8.4.9. CANCELLATION IGNORE
OTA_CancelRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 95 | Booking already canceled. | Booking already canceled. | NOT_SENT |
8.4.10. TRANSFER DESCRIPTIVE INFO
GP_TransferDescriptiveInfoRQ
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Invalid city. | Booking reference cannot be found. | NOT_SENT |
Error | 161 | Search criteria invalid. | BookingCode is not found in HUB system. | NOT_SENT |
Warning | 172 | Requested action not possible. | Supplier doesn't support requested language. Language is different from what has been requested.
Supplier does not support operation LocationsList. | SENT |
Warning | 220 | No rental facility details available. | | SENT |
Error | 438 | Requested rate not available. | Offer is not available any more. | |