You are viewing an old version of this content. View the current version.
Compare with Current
View Version History
« Previous
Version 2
Next »
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.
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 excursion messages.
8.4.1. EXCURSION AVAILABILITY
GP_ExcursionAvailRQ
Warning/Error | Code | Short text | Possible reason | Status |
Warning | 15 | Invalid date. | The number of nights must be less than or equal to 30. | NOT_SENT |
Warning | 20 | Number of passengers invalid. | The maximum number of passengers is 9 total. | NOT_SENT |
Warning | 22 | Passengers exceed commercial rules. | Number of passengers must not be more then 9. The number of guests must not exceed 8 people.
| NOT_SENT |
Warning | 26 | At least one adult must be included. | At least one adult must be included. | NOT_SENT |
Warning | 172 | Requested action not possible. | Supplier does not support search by tournament. Supplier supports only search by excursion or city. Search by category doesn't support. Paging token wasn't found or expired. Supplier supports the age of children within interval between 2 and 18. Requested Excursion Category is not supported. Search by category does not support. Supplier doesn't support requested language. Language is different from what has been requested. Supplier does not support time frame search. Search results for StartDate only. No availability found in supplier's system.
| SENT/NOT_SENT |
Warning | 184 | Language code invalid. | Language not supported. | NOT_SENT |
Warning | 320 | Invalid value. | Requested category: EXCLON is not mapped. | NOT_SENT |
Warning | 322 | No availability. | | SENT |
Warning | 448 | System error. | Country code is not found for specified city code. | NOT_SENT |
Warning | 450 | Unable to process. | Supplier does not process children with age: 4. | NOT_SENT |
Warning | 548 | Child infant seat not available. | Infant bookings are not guaranteed, please contact supplier for further details and confirmation. | SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency. | Requested currency was USD, but rates returned in CAD. Rates or cancellation fee are returned in other currency than it was requested.
| SENT |
8.4.2. EXCURSION CHARGES
GP_ExcursionChargesRQ
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Booking reference not found. | Booking reference not found or expired. | NOT_SENT |
Warning | 172 | Requested action not possible. | Supplier doesn't support requested language. Language is different from what has been requested. | SENT |
Warning | 189 | Price has been changed. | The price has been changed. | SENT |
Warning | 342 | Cancel fee may apply. | Cancel Penalties are not provided by supplier, so they are may change on next steps. | NOT_SENT |
Error | 438 | Requested rate not available. | Offer availability status changed to AvailableForSale/OnRequest. Offer is not available any more.
| SENT |
Warning | 558 | Accounts are settled in a currency different from the quoted rate currency. | Requested currency was USD, but rates returned in CAD. Rates or cancellation fee are returned in other currency than it was requested.
| SENT |
Warning | 568 | Unable to identify timezone. | Periods of penalties (dates and time) have timezone of the tour location. | SENT |
8.4.3. RESERVATION INITIATE
GP_ExcursionResRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
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. Number of paxes in Reservation Initiate message differ from paxes in Availability search.
| NOT_SENT |
Error | 22 | Passengers exceed commercial rules. | Number of passengers must not be more then 9. Children/Infant age cannot be different from that specified on Search.
| NOT_SENT |
Error | 27 | Passenger details are mandatory. | Mandatory lead guest details (birthdate,email,telephone,country) is missed. NamePrefix is mandatory, but the value is empty.
| NOT_SENT |
Error | 87 | Booking reference invalid. | Invalid data. Error at property client reference number: property size must be between 1 and 20.
Client reference(s) 30d4 is(are) not unique. Please provide another client reference ids. | NOT_SENT |
Error | 97 | Booking reference not found. | Booking reference not found or expired.. | NOT_SENT |
Error | 145 | Duration period or dates incorrect. | Avail was done for different dates. Dates mismatch. | NOT_SENT |
Error | 161 | Search criteria invalid. | Mandatory passenger detail is missed, e.g. The client's country is missed. | NOT_SENT |
Error | 172 | Requested action not possible. | Supplier supports the age of children within interval between 2 and 18. Supplier does not provide departure with hotelCode.
| NOT_SENT |
Warning | 172 | Requested action not possible. | Supplier doesn't support requested language. Language is different from what has been requested. | SENT |
Warning | 189 | Price has been changed. | The price has been changed. | SENT |
Error | 193 | Cancellation process failed. | Children age cannot be different from that specified on Search. | NOT_SENT |
Error | 194 | No matching bookings found. | No matching bookings found. | SENT |
Warning | 197 | Comments longer than 180 characters will not be processed hotel supplier. | Comments longer than 180 characters will not be processed by hotel supplier. | SENT |
Error | 293 | Invalid departure time. | Departure Point/Time combination is invalid. | NOT_SENT/SENT |
Error | 320 | Invalid value. | NamePrefix can be only Mr, Ms and Mrs. | NOT_SENT |
Error | 321 | Required field missing. | Invalid values of departure, please fix it. PickUpAddress should be send in pickup departure.
| NOT_SENT |
Warning | 438 | Requested rate not available. | Offer availability status changed to AvailableForSale/OnRequest. Offer is not available any more.
| SENT |
Error | 450 | Unable to process. | Supplier error. Supplier's response does not contain a valid availability. Selected tickets delivery method is wrong. This delivery option requires address information. Please fill phone number for lead person. This element is required.
| SENT/NOT_SENT |
8.4.4. RESERVATION CONFIRMATION
GP_ExcursionResRQ_Book
Warning/Error | Code | Short text | Possible reason | Status |
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 | 22 | Passengers exceed commercial rules. | Number of passengers must not be more then 9. | NOT_SENT |
Error | 27 | Passenger details are mandatory. | Mandatory lead guest details (birthdate,email,telephone,country) is missed. NamePrefix is mandatory, but the value is empty.
| NOT_SENT |
Error | 161 | Search criteria invalid. | TransactionIdentifier 999999 not found. | NOT_SENT |
Error | 172 | Requested action not possible. | Please fill in all necessary supplier remarks. Departure point and time are required for this excursion. Supplier supports the age of children within interval between 2 and 18. Supplier does not provide departure with hotelCode.
| NOT_SENT |
Warning | 189 | Price has been changed. | The price has been changed. | SENT |
Error | 193 | Cancellation process failed. | Children age cannot be different from that specified on Search. | NOT_SENT |
Error | 194 | No matching bookings found. | No matching bookings found. | SENT |
Warning | 197 | Comments longer than 180 characters will not be processed hotel supplier. | Comments longer than 180 characters will not be processed by hotel supplier. | SENT |
Error | 320 | Invalid value. | The client's country in Reservation Confirmation message is differ from Reservation Initiate message. NamePrefix can be only Mr, Ms and Mrs.
| NOT_SENT |
Error | 321 | Required field missing. | PickUpAddress should be send in pickup departure. | NOT_SENT |
Error | 448 | System error. | purchaseDetails element is missed. | SENT |
Error | 450 | Unable to process. | Selected tickets delivery method is wrong. This delivery option requires address information.
| NOT_SENT |
8.4.5. RESERVATION IGNORE
GP_ExcursionResRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 161 | Search criteria invalid. | TransactionIdentifier 999999 not found. | NOT_SENT |
Error | 450 | Unable to process. | Transaction identifier 499 has been already closed. | NOT_SENT |
8.4.6. EXCURSION RETRIEVAL
GP_ExcursionResRQ_Quote
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Booking reference not found. | Client reference 'realFake' is not found. | SENT/NOT_SENT |
Error | 172 | Requested action not possible. | Supplier does not support operation Import. | NOT_SENT |
Error | 450 | Unable to process. | Booking is not found in supplier system. | SENT |
8.4.7. CANCELLATION INITIATE
OTA_CancelRQ_Initiate
Warning/Error | Code | Short text | Possible reason | Status |
Error | 16 | Service has been cancelled. | Booking is already cancelled. Service cancellation is not available from the supplier.
Excursion had already been canceled.
| SENT/NOT_SENT |
Error | 95 | Booking already cancelled. | Booking already cancelled. | SENT? |
Error | 97 | Booking reference not found. | Client reference 'realFake' is not found. | NOT_SENT |
Error | 194 | No matching bookings found. | No matching bookings found. | SENT |
Error | 197 | Undetermined error - please report. | | SENT |
Error | 264 | Reservation cannot be cancelled.. | This reservation cannot be cancelled via API. Please contact the supplier to cancel this reservation. Excursion can not be cancelled in supplier system. Excursion can be cancelled in supplier system only less than 48h before travel date.
| SENT |
Error | 450 | Unable to process. | Request was rejected on supplier side. | SENT |
Warning | 1001 | Price has been changed. | Cancellation charges have changed. | SENT |
8.4.8. CANCELLATION CONFIRMATION
OTA_CancelRQ_Commit
Warning/Error | Code | Short text | Possible reason | Status |
Error | 16 | Service has been cancelled. | 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. Excursion had already been canceled.
| SENT/NOT_SENT |
Warning | 189 | Price has been changed. | Price has been changed. | SENT |
Error | 264 | Reservation cannot be cancelled. | Excursion cancellation hasn't pass initiation phase. | NOT_SENT |
Error | 448 | System error. | Unknown cancellation status appeared. | SENT |
8.4.9. CANCELLATION IGNORE
OTA_CancelRQ_Ignore
Warning/Error | Code | Short text | Possible reason | Status |
Error | 97 | Booking reference not found. | Client reference 'realFake' is not found. | NOT_SENT |
Error | 161 | Search criteria invalid. | TransactionIdentifier 999999 not found. | NOT_SENT |
Error | 450 | Unable to process. | Transaction identifier 499 has been already closed. | NOT_SENT |
8.4.10. EXCURSION DESCRIPTIVE INFO
GP_ExcursionDescriptiveInfoRQ
Warning/Error | Code | Short text | Possible reason | Status |
Error | 145 | Offer gone. | Cannot receive Avail Token. Offer is gone. | NOT_SENT |
Error | 161 | Search criteria invalid. | BookingCode not found in HUB system. | NOT_SENT |
Warning | 172 | Requested action not possible. | Requested language is not supported by supplier. Supplier does not support operation LocationsList.
| SENT/NOT_SENT |
Warning | 184 | Language code invalid. | | NOT_SENT |
Warning | 297 | Unable to process. | Unable to process - insufficient data. Excursion unavailable. | SENT |
Warning | 322 | No availability. | The excursion is not found. | NOT_SENT |
Warning | 438 | Requested rate not available. | Offer is not available any more. | SENT |