Versions Compared

Version Old Version 2 New Version Current
Changes made by

Yana Brilevskaya

Yana Brilevskaya

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: HUB-11294 One of the possible reasons for error 20 on Reservation Initiate was added

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:

Table of Contents

...

10.1. SUCCESS

Means that request was successfully sent and GP Travel HUB receives correct response from supplier without any warnings and errors from supplier.

Expand
titleSuccess Response Sample XML
Code Block
languagexml
<OTA_CancelRS Version="2" EchoToken="EchoToken" TransactionIdentifier="12232" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
   <Success/>
</OTA_CancelRS>

...

10.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

Expand
titleWarning Response Sample XML
Code Block
languagexml
<Warnings>
   <Warning Code="189" Language="en" RecordID="supplierCode" ShortText="Price has been changed." Status="SENT" Type="3"/>
</Warnings>

...

10.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.

...

Expand
titleError Response Sample XML
Code Block
languagexml
<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>

...

10.4. ERROR AND WARNING CODES

Here we list all possible errors and warnings that can occur at excursion messages.

...

10.4.1. EXCURSION

...

SEARCH

The number
Expand
titleGP_ExcursionAvailRQExcursionSearchRQ

Warning/
Error

Code

Short text

Possible reason

Status

Error

Warning

15

Invalid date.

172

Requested action not possible.

  1. No information found for the requested city.

  2. The supplier supports search only by city code at this step.

NOT_SENT

Warning

172

Requested action not possible.

Requested language is not supported by supplier.

NOT_SENT

10.4.2. EXCURSION SCHEDULE

Expand
titleGP_ExcursionScheduleRQ

Warning/Error

Code

Short text

Possible reason

Status

Error

172

Requested action not possible.

  1. The supplier supports search only by excursion code at this step

  2. No information found for the requested date period

  3. No information found for the requested excursion code

NOT_SENT

10.4.3. EXCURSION AVAILABILITY

Expand
titleGP_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_SENTWarning

20

Number of passengers invalid.

The maximum number of passengers is 9 total.

NOT_SENTWarning

22

Passengers exceed commercial rules.

  1. Number of passengers must not be more then 9.

  2. 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_SENTWarning

172

Requested action not possible.

  1. Supplier does not support search by tournament.

  2. Supplier supports only search by excursion or city.

  3. Search by category doesn't support.

  4. Paging token wasn't found or expired.

  5. Supplier supports the age of children within interval between 2 and 18.

  6. Requested Excursion Category is not supported.

  7. Search by category does not support.

  8. Supplier doesn't support requested language. Language is different from what has been requested.

  9. Supplier does not support time frame search. Search results for StartDate only.

  10. No availability found in supplier's system.

SENT/NOT_SENT

Warning

184

Language code invalid.

Language not supported.

NOT_SENTWarning

320

Invalid value.

Requested category: EXCLON is not mapped.

NOT_SENTWarning

322

No availability.

SENT

357

Invalid city

Invalid city code specified.

NOT_SENTWarning

400

Invalid property code.

Invalid excursion code passes

SENT

448

System error.

Country code is not found for specified city code.

NOT_SENTWarning

450

Unable to process.

Supplier does not process children with age: 4.

NOT_SENTWarning

548

Child infant seat not available.

Infant bookings are not guaranteed, please contact supplier for further details and confirmation.

SENTWarning

558

Accounts are settled in a currency different from the quoted rate currency.

  1. Requested currency was USD, but rates returned in CAD.

  2. Rates or cancellation fee are returned in other currency than it was requested.

SENT

...

10.4.

...

4. EXCURSION CHARGES

Expand
titleGP_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.

  1. Offer availability status changed to AvailableForSale/OnRequest.

  2. Offer is not available any more.

SENT

Warning

558

Accounts are settled in a currency different from the quoted rate currency.

  1. Requested currency was USD, but rates returned in CAD.

  2. 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

...

10.4.

...

5. RESERVATION INITIATE

Expand
titleGP_ExcursionResRQ_Initiate

Warning/Error

Code

Short text

Possible reason

Status

Error

20

Number of passengers invalid.

  1. This offer is for 2 adults, 2 children and 0 infants, but you tried to book for 2 adults, 1 children and 1 infants.

  2. Number of paxes in Reservation Initiate message differ from paxes in Availability search.

  3. Children/Infant age cannot be different from that specified on Search.

NOT_SENT

Error

22

Passengers exceed commercial rules.

  1. Number of passengers must not be more then 9.

  2. Children/Infant age cannot be different from that specified on Search.

NOT_SENT

Error

27

Passenger details are mandatory.

  1. Mandatory lead guest details (birthdate,email,telephone,country) is missed.

  2. 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.

  1. Supplier supports the age of children within interval between 2 and 18.

  2. 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.

  1. Invalid values of departure, please fix it.

  2. PickUpAddress should be send in pickup

departure.NOT_

  1. departure.

NOT_SENT

Warning

342

Cancel fee may apply

Cancel Penalties are not provided by supplier, or provided as free text, so GP HUB is not able to return Cancellation Charges precisely as Amount. Or Cancellation policy can be shown only after reservation. Or Cancellation penalties have been changed.

SENT

Warning

438

Requested rate not available.

  1. Offer availability status changed to AvailableForSale/OnRequest.

  2. Offer is not available any more.

SENT

Error

450

Unable to process.

  1. Supplier error.

  2. Supplier's response does not contain a valid availability.

  3. Selected tickets delivery method is wrong.

  4. This delivery option requires address information.

  5. Please fill phone number for lead person. This element is required.

SENT/NOT_SENT

...

10.4.

...

6. RESERVATION CONFIRMATION

Expand
titleGP_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.

  1. Mandatory lead guest details (birthdate,email,telephone,country) is missed.

  2. 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.

  1. Please fill in all necessary supplier remarks.

  2. Departure point and time are required for this excursion.

  3. Supplier supports the age of children within interval between 2 and 18.

  4. 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.

  1. The client's country in Reservation Confirmation message is differ from Reservation Initiate message.

  2. 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

321

Required field missing.

PickUpAddress should be send in pickup departure.

NOT_

Warning

342

Cancel fee may apply

Cancel Penalties are not provided by supplier, or provided as free text, so GP HUB is not able to return Cancellation Charges precisely as Amount. Or Cancellation policy can be shown only after reservation. Or Cancellation penalties have been changed.

SENT

Error

448

System error.

purchaseDetails element is missed.

SENT

Error

450

Unable to process.

  1. Selected tickets delivery method is wrong.

  2. This delivery option requires address information.

NOT_SENT

...

10.4.

...

7. RESERVATION IGNORE

Expand
titleGP_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

...

10.4.

...

8. EXCURSION RETRIEVAL

Expand
titleGP_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

...

10.4.

...

9. CANCELLATION INITIATE

Expand
titleOTA_CancelRQ_Initiate

Warning/Error

Code

Short text

Possible reason

Status

Error

16

Service has been cancelled.

  1. Booking is already cancelled.

  2. 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..

  1. This reservation cannot be cancelled via API. Please contact the supplier to cancel this reservation.

  2. Excursion can not be cancelled in supplier system.

  3. 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

...

10.4.

...

10. CANCELLATION CONFIRMATION

Expand
titleOTA_CancelRQ_Commit

Warning/Error

Code

Short text

Possible reason

Status

Error

16

Service has been cancelled.

  1. 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.

  2. 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

...

10.4.

...

11. CANCELLATION IGNORE

Expand
titleOTA_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

...

10.4.

...

12. EXCURSION DESCRIPTIVE INFO

Expand
titleGP_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.

  1. Requested language is not supported by supplier.

  2. 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

...