Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

Version 1 Current »

The NotifReport Request used to add information about third party reservation (accommodation, car or flight) to the GDS PNR.

OTA_NotifReportRQ*:

*mandatory

Element

Attribute

Type

Description

Min…Max occurs

NotifDetails*

Represents information about reservation which is added to GDS PNR.

1...1

Ticketing

Element is used in case of adding information to an existing PNR.

0...1

PseudoCityCode

string

Contains identification code assigned to an office/agency by a reservation system.

0...1

UniqueID*

Contains information about supplier of GDS system.

1...1

Type*

string

Indicates the type of module that is used to create or supplement PNR. Possible value: 104 (flight).

1...1

ID

string (1 - 64)

Contains reservation identifier in the third party GDS system. Attribute is used in case of adding information to an existing PNR.

0...1

ID_Context*

string (1 - 32)

Indicates supplier of GDS system in which PNR is created or complemented by third party reservations.

1...1

OTA_NotifReportRQ/NotifDetails*:

Element

Attribute

Type

Description

Min…Max occurs

HotelNotifReport

Represents accommodation booking information. This element is used in case of adding accommodation booking information to the PNR.

0...1

HotelNotifReport/HotelReservations/HotelReservation*

1...1

VehNotifReport

Represents vehicle booking information. This element is used in case of adding vehicle booking information to the PNR.

0...1

VehNotifReport/VehRes/VehResRSCore/VehReservation*

1...1

AirNotifReport

Represents flight booking information. This element is used in case of adding flight booking information to the PNR.

0...1

AirNotifReport/AirReservations/AirReservation*

1...1

OTA_NotifReportRQ/NotifDetails/HotelNotifReport/HotelReservations/HotelReservation*:

Element

Attribute

Type

Description

Min…Max occurs

RPH

integer

Special reservation identifier.

0...1

RoomStays/RoomStay*

Provide details on the room stay.

1...*

RoomStays/RoomStay/TimeSpan*

Specifies the period of stay.

1...1

Start*

yyyy-mm-dd

Defines start day of stay.

1...1

End*

yyyy-mm-dd

Defines end day of stay.

1...1

RoomStays/RoomStay/BasicPropertyInfo*

Provide basic hotel information.

1...1

HotelCityCode*

string (1 - 128)

Contain information about hotel and include supplier-specific codes, and code of supplier (HotelCodeContext) from whom this offer was obtained.

1...1

HotelName*

string (1 - 255)

1...1

HotelCodeContext*

string (1 - 32)

1...1

ResGuests/ResGuest

Represents guest details.

0...*

OTA_NotifReportRQ/NotifDetails/HotelNotifReport/HotelReservations/HotelReservation/ResGuests/ResGuest:

Element

Attribute

Type

Description

Min…Max occurs

AgeQualifyingCode*

integer (7 - infant, 8 - child, 10 - adult).

Specifies tourist age group. GP Travel HUB uses standard age qualifying OTA codes.

1…1

ResGuestRPH*

integer (default - 1)

Shows in which room this guest should be allocated.

1…1

Profiles/ProfileInfo/UniqueID*

A guest identifier.

1...1

ID*

integer

Must start with 1 and must be unique within booking. Guest with ID="1" is marked as tour lead.

1...1

Type*

integer (1)

The required attribute with fixed value "1".

1...1

Profiles/ProfileInfo/Profile/Customer*

Contains basic information about the customer.

1...1

BirthDate

yyyy-mm-dd

Mandatory for children and infants.

0...1

Profiles/ProfileInfo/Profile/Customer/PersonName*

Contains person name.

1...1

Profiles/ProfileInfo/Profile/Customer/PersonName/NamePrefix*

string

Name prefix of the guest, mandatory for TourLead, but could be optional for other guests if supplier allow that.

1...1

Profiles/ProfileInfo/Profile/Customer/PersonName/GivenName*

string

Name of the guest, mandatory for TourLead, but could be optional for other guests if supplier allow that.

1...1

Profiles/ProfileInfo/Profile/Customer/PersonName/MiddleName

string

Middle name of the guest, mandatory for TourLead, but could be optional for other guests if supplier allow that.

0...1

Profiles/ProfileInfo/Profile/Customer/PersonName/Surname*

string

Surname of the guest, mandatory for TourLead, but could be optional for other guests if supplier allow that.

1...1

Profiles/ProfileInfo/Profile/Customer/CitizenCountryName

(Self-professed) country that is claimed for citizenship.

0...2

Code

string (2 - 3)

ISO-2 or ISO-3 country code.

0...1

OTA_NotifReportRQ/NotifDetails/VehNotifReport/VehRes/VehResRSCore/VehReservation*:

Element

Attribute

Type

Description

Min…Max occurs

RPH

integer

Special reservation identifier.

0...1

VehSegmentCore*

Identifies the common information associated with the request for the reservation of a rental vehicle.

1...1

VehSegmentCore/Vendor*

Contains info about offer's vendor. 

1...1

CompanyShortName

string (1 - 32)

Specifies vendor's name.

0...1

Code*

string (1 - 32)

Specifies vendor's code.

1...1

CodeContext*

string 1 - 32

Supplier code context.

1...1

VehSegmentCore/VehRentalCore*

Information that is common to all requests and responses associated with the reservation of a vehicle.

1...1

ReturnDateTime*

yyyy-mm-ddThh-mm-ss

Identify The Date & Time to pickup/return the vehicle.

1...1

PickUpDateTime*

yyyy-mm-ddThh-mm-ss

1...1

VehSegmentCore/VehRentalCore/PickUpLocation*

Location name, code and code context to identify pick up point.

1...1

Name

string (1 - 255)

Name of the pick up point.

0...1

LocationCode*

string (1 - 32)

Depending on LocationType: specify IATA Airport code for “Airport” type; specify City Code for “City” type; specify supplier-specific location code for “Point” type.

1...1

CodeContext*

string (1 - 32)

Defines context in which the LocationCode specified:

for “Airport” point there must be IATA airport code;

for “City” point there could be GEO or supplier or client context;

for “Point” type here must be supplier identifier.

1...1

VehSegmentCore/VehRentalCore/ReturnLocation*

Location name, code and code context to identify return point.

1...1

Name

string (1 - 255)

Name of the return point.

0...1

LocationCode*

string (1 - 32)

Depending on LocationType: specify IATA Airport code for “Airport” type; specify City Code for “City” type; specify supplier-specific location code for “Point” type.

1...1

CodeContext*

string (1 - 32)

Defines context in which the LocationCode specified:

for “Airport” point there must be IATA airport code;

for “City” point there could be GEO or supplier or client context;

for “Point” type here must be supplier identifier.

1...1

ResGuests/ResGuest

Information on the driver(s).

0...*

OTA_NotifReportRQ/NotifDetails/AirNotifReport/AirReservations/AirReservation*:

Element

Attribute

Type

Description

Min…Max occurs

RPH

integer

Special reservation identifier.

0...1

AirItinerary*

Contains flight information.

1...1

CodeContext

string

Contains the id of supplier providing offer.

0...1

AirItinerary/OriginDestinationOptions/OriginDestinationOption

For more information see Low Fare Search Response section.

0...*

AirItinerary/OriginDestinationOptions/OriginDestinationOption/FlightSegment*

A container for necessary data to describe legs of a single flight. Contains the same elements as in Low Fare Search Response, but the StopLocation element should be added:

1...*

AirItinerary/OriginDestinationOptions/OriginDestinationOption/FlightSegment/StopLocation

Contains a stop airport code and stop duration in case of stop in the flight segment (e.g. StopQuantity is not 0). This element repeats for each stop, i.e. in case 2 stops there will be 2 StopLocation elements in response.

0...9

LocationCode*

string (3)

3-character IATA code of location or airport.

1...1

GroundDuration

duration

A stop duration.

0...1

TravelerInfo

Contains information about the traveler.

0...1

TravelerInfo/AirTraveler

For more information see Reservation Initiate Request section.

0...*

BookingReferenceID*

Contains the unique record number in supplier’s system. This element is used in case of adding flight booking information to the PNR.

1...2

ID*

string

Contains reservation identifier of created PNR in supplier’s system.

1...1

Instance*

string ("supplier", “PNR")

Indicates type of Booking Reference ID.

1...1

ID_Context

string

Contains supplier code. Required only if Instance=”supplier”.

0...1

Important Note: HUB can send PNR number of third party system in two different ways in NotifReport request.

  1. Element BookingReferenceID with attribute @Instance = ‘PNR’ and element CompanyName with attribute @CodeContext = ‘GDS’:

<BookingReferenceID ID="JBXJEQ" Instance="PNR">
   <CompanyName CodeContext="GDS"/>
</BookingReferenceID>

2. Element BookingReferenceID with attribute @Instance = ‘supplier’:

<BookingReferenceID ID="Z78YAT" Instance="supplier"/>

First option (attribute @Instance = ‘PNR’ and @CodeContext = ‘GDS’) has a higher priority. Therefore, if HUB shows element BookingReferenceID with attribute @Innstance = ‘PNR’ and @CodeContext = ‘GDS’ in Reservation Confirmation response, then element BookingReferenceID with attribute @Innstance = ‘PNR’ should also be specified in NotifReport request.

 Adding accommodation reservation information to the new PNR Sample XML
<OTA_NotifReportRQ EchoToken="123" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
         <BookingChannel PriceDomain="1" Type="7"/>
      </Source>
   </POS>
   <NotifDetails>
      <HotelNotifReport>
         <HotelReservations>
            <HotelReservation RPH="1">
               <RoomStays>
                  <RoomStay>
                     <TimeSpan End="2019-10-27" Start="2019-10-20"/>
                     <BasicPropertyInfo HotelCityCode="MAD" HotelCodeContext="supplierCode" HotelName="Corinthia Lisboa Hotel"/>
                  </RoomStay>
               </RoomStays>
               <ResGuests>
                  <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
                     <Profiles>
                        <ProfileInfo>
                           <UniqueID ID="1" Type="1"/>
                           <Profile>
                              <Customer>
                                 <PersonName>
                                    <NamePrefix>Mr</NamePrefix>
                                    <GivenName>Oleg</GivenName>
                                    <Surname>Ivanov</Surname>
                                 </PersonName>
                              </Customer>
                           </Profile>
                        </ProfileInfo>
                     </Profiles>
                  </ResGuest>
               </ResGuests>
            </HotelReservation>
         </HotelReservations>
      </HotelNotifReport>
   </NotifDetails>
   <UniqueID ID_Context="supplierCode" Type="104"/>
</OTA_NotifReportRQ>
 Adding vehicle reservation information to the new PNR Sample XML
<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="123" Version="2">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22" />
         <BookingChannel PriceDomain="1" Type="7" />
      </Source>
   </POS>
   <NotifDetails>
      <VehNotifReport>
         <VehRes>
            <VehResRSCore>
               <VehReservation RPH="1">
                  <VehSegmentCore>
                     <Vendor Code="ZR" CodeContext="supplierCode" CompanyShortName="DOLLAR THRIFTY" />
                     <VehRentalCore PickUpDateTime="2019-10-01T07:00:00" ReturnDateTime="2019-10-09T07:00:00">
                        <PickUpLocation CodeContext="supplierCode" LocationCode="MAD" />
                        <ReturnLocation CodeContext="supplierCode" LocationCode="BCN" />
                     </VehRentalCore>
                  </VehSegmentCore>
                  <ResGuests>
                     <ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
                        <Profiles>
                           <ProfileInfo>
                              <UniqueID ID="1" Type="1" />
                              <Profile>
                                 <Customer>
                                    <PersonName>
                                       <NamePrefix>Mr</NamePrefix>
                                       <GivenName>Oleg</GivenName>
                                       <Surname>Ivanov</Surname>
                                    </PersonName>
                                 </Customer>
                              </Profile>
                           </ProfileInfo>
                        </Profiles>
                     </ResGuest>
                  </ResGuests>
               </VehReservation>
            </VehResRSCore>
         </VehRes>
      </VehNotifReport>
   </NotifDetails>
   <UniqueID ID_Context="supplierCode" Type="104" />
</OTA_NotifReportRQ>
 Adding flight reservation information to the new PNR Sample XML
<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="123" Version="2">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22" />
         <BookingChannel PriceDomain="1" Type="7" />
      </ota:Source>
   </POS>
   <NotifDetails>
      <AirNotifReport>
         <AirReservations>
            <AirReservation RPH="1">
               <AirItinerary CodeContext="supplierCode">
                  <OriginDestinationOptions>
                     <OriginDestinationOption RPH="1">
                        <FlightSegment ArrivalDateTime="2019-10-23T06:10:00" DepartureDateTime="2019-10-21T21:20:00" FlightNumber="532" RPH="11">
                           <DepartureAirport LocationCode="LHR" />
                           <ArrivalAirport LocationCode="SYD" />
                           <MarektingAirline Code="LH" />
                           <BookingClassAvails>
                              <BookingClassAvail ResBookDesigCode="Y" />
                           </BookingClassAvails>
                        </FlightSegment>
                     </OriginDestinationOption>
                  </OriginDestinationOptions>
               </AirItinerary>
               <TravelerInfo>
                  <AirTraveler PassengerTypeCode="ADT">
                     <ProfileRef>
                        <UniqueID ID="1" Type="1" />
                     </ProfileRef>
                     <PersonName>
                        <NamePrefix>Mr</NamePrefix>
                        <GivenName>Peter</GivenName>
                        <Surname>Thomasson</Surname>
                     </PersonName>
                  </AirTraveler>
               </TravelerInfo>
               <BookingReferenceID ID="YP4374Z" Instance="PNR">
                   <CompanyName CodeContext="GDS"/>
               </BookingReferenceID>
            </AirReservation>
         </AirReservations>
      </AirNotifReport>
   </NotifDetails>
   <UniqueID ID_Context="supplierCode" Type="104" />
</OTA_NotifReportRQ>
 Adding accommodation reservation information to the existing PNR Sample XML
<OTA_NotifReportRQ EchoToken="123" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
         <BookingChannel PriceDomain="1" Type="7"/>
      </Source>
   </POS>
   <NotifDetails>
      <HotelNotifReport>
         <HotelReservations>
            <HotelReservation RPH="1">
               <RoomStays>
                  <RoomStay>
                     <TimeSpan End="2019-12-27" Start="2019-12-20"/>
                     <BasicPropertyInfo HotelCityCode="LIS" HotelCodeContext="supplierCode" HotelName="Corinthia Lisboa Hotel"/>
                  </RoomStay>
               </RoomStays>
            </HotelReservation>
         </HotelReservations>
      </HotelNotifReport>
   </NotifDetails>
   <Ticketing PseudoCityCode="XXXX000YY"/>
   <UniqueID ID="OIAK2P" ID_Context="supplierCode" Type="104"/>
</OTA_NotifReportRQ>
 Adding vehicle reservation information to the existing PNR Sample XML
<OTA_NotifReportRQ EchoToken="123" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
         <BookingChannel PriceDomain="1" Type="7"/>
      </Source>
   </POS>
   <NotifDetails>
      <VehNotifReport>
         <VehRes>
            <VehResRSCore>
               <VehReservation RPH="1">
                  <VehSegmentCore>
                     <Vendor Code="ZR" CodeContext="supplierCode" CompanyShortName="DOLLAR THRIFTY"/>
                     <VehRentalCore PickUpDateTime="2019-12-01T07:00:00" ReturnDateTime="2019-12-09T07:00:00">
                        <PickUpLocation CodeContext="supplierCode" LocationCode="MAD"/>
                        <ReturnLocation CodeContext="supplierCode" LocationCode="BCN"/>
                     </VehRentalCore>
                  </VehSegmentCore>
               </VehReservation>
            </VehResRSCore>
         </VehRes>
      </VehNotifReport>
   </NotifDetails>
   <Ticketing PseudoCityCode="XXXX000YY"/>
   <UniqueID ID="BOAU23" ID_Context="supplierCode" Type="104"/>
</OTA_NotifReportRQ>
 Adding flight reservation information to the existing PNR Sample XML
<OTA_NotifReportRQ EchoToken="123" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
   <POS>
      <Source>
         <RequestorID ID="client" MessagePassword="pwd" Type="22"/>
         <BookingChannel PriceDomain="1" Type="7"/>
      </Source>
   </POS>
   <NotifDetails>
      <AirNotifReport>
         <AirReservations>
            <AirReservation RPH="1">
               <AirItinerary CodeContext="supplierCode">
                  <OriginDestinationOptions>
                     <OriginDestinationOption RPH="1">
                        <FlightSegment ArrivalDateTime="2019-12-23T06:10:00" DepartureDateTime="2019-12-21T21:20:00" FlightNumber="532" RPH="11">
                           <DepartureAirport LocationCode="LHR"/>
                           <ArrivalAirport LocationCode="SYD"/>
                           <MarketingAirline Code="6X"/>
                           <BookingClassAvails>
                              <BookingClassAvail ResBookDesigCode="Y"/>
                           </BookingClassAvails>
                        </FlightSegment>
                        <FlightSegment ArrivalDateTime="2019-12-23T17:00:00" DepartureDateTime="2019-12-23T10:30:00" FlightNumber="954" RPH="12">
                           <DepartureAirport LocationCode="SYD"/>
                           <ArrivalAirport LocationCode="HND"/>
                           <MarketingAirline Code="6X"/>
                           <BookingClassAvails>
                              <BookingClassAvail ResBookDesigCode="Y"/>
                           </BookingClassAvails>
                        </FlightSegment>
                     </OriginDestinationOption>
                  </OriginDestinationOptions>
               </AirItinerary>
               <BookingReferenceID ID="YP4374Z" Instance="PNR"/>
            </AirReservation>
         </AirReservations>
      </AirNotifReport>
   </NotifDetails>
   <Ticketing PseudoCityCode="XXXX000YY"/>
   <UniqueID ID="KYAL22" ID_Context="supplierCode" Type="104"/>
</OTA_NotifReportRQ>

  • No labels