Sample Hotel Transaction Flow 2

Begin the PNRBFManagement request.

<PNRBFManagement_#>

Primary PNR/BF data required to build a PNR/BF to reserve segments.

<PNRBFPrimaryBldChgMods>

Begins the PNR/BF array.

<ItemAry>

The first item in the PNR/BF is the name segment. Required.

<Item>

The data block indicator indicates the type of information in the item:
J = Profile Move
T = Ticketing
N = Name
M = Frequent Flyer Numbers
P = Phone
W = Street Address
B* = Travel Order Number *(No longer supported on Apollo or Galileo)
E = End Mark

<DataBlkInd>N</DataBlkInd>

The Name qualifier.

<NameQual>

The edit type indicates the action to be performed for the name block:
A = Add name and/or name remarks.
C = Change name and/or name remarks.
D = Delete name and/or name remarks.

<EditTypeInd>A</EditTypeInd>

<EditTypeIndAppliesTo/>

The first traveler to be added to PNR/BF.

<AddChgNameRmkQual>

<NameType/>

The last name of the primary traveler. Additional name elements indicate whether subsequent travelers have the same last name or a different last name.

<LNameID>01</LNameID>

<LName>KRAMDEN</LName>

<LNameRmk/>

<NameTypeQual>

An array lists the first names associated with the <LName> value.

<FNameAry>

<FNameItem>

The primary traveler's number in the PNR/BF. A unique sequential number relative to the previous <LNameID> value (Kramden).

<PsgrNum>01</PsgrNum>

The absolute name number. The first traveler in the PNR/BF, regardless of last name.

<AbsNameNum>01</AbsNameNum>

The primary traveler's first name.

<FName>RALPH</FName>

Ends the first name item.

<FNameRmk/>

</FNameItem>

Name data for the second traveler in the PNR/BF.

<FNameItem>

The second traveler with the <LNameID> of Kramden.

<PsgrNum>02</PsgrNum>

The second traveler listed in the PNR/BF.

<AbsNameNum>02</AbsNameNum>

The second traveler's first name.

<FName>ALICE</FName>

Ends the first name array.

<FNameRmk/>

</FNameItem>

</FNameAry>

Ends the name segment of the PNR/BF request.

</NameTypeQual>

</AddChgNameRmkQual>

</NameQual>

</Item>

The second item in the PNR/BF is the phone information. Required.

<Item>

<DataBlkInd>P</DataBlkInd>

<PhoneQual>

Indicates that data is being added to the section.

<EditTypeInd>A</EditTypeInd>

<AddPhoneQual>

The three-character city associated with the phone number.

<City>DEN</City>

The type of phone number:
R = Residence (home).
B = Business.
A = Agency
H = Hotel
N = No contact
F Fax

<Type>R</Type>

The phone number in text format, to accommodate a variety of phone formats, including access codes, and country and city codes.

<PhoneNumber>303-555-1212</PhoneNumber>

Ends the phone segment of the PNR/BF.

</AddPhoneQual>

</PhoneQual>

</Item>

Begins the address segment of the PNR/BF. Required.

<Item>

<DataBlkInd>W</DataBlkInd>

<AddrQual>

Indicates that data is being added to the section.

<EditTypeInd>A</EditTypeInd>

<AddChgAddr>

The address of the primary traveler.

<Addr>RALPH KRAMDEN @123 PEARL ST @DENVER, CO Z/80209</Addr>

Ends the address section.

</AddChgAddr>

</AddrQual>

</Item>

Ticketing information for the PNR/BF. Ticketing formats vary for Apollo and Galileo.

Required for air segments only. Does not apply to this example.

<Item>

<DataBlkInd>T</DataBlkInd>

<TkQual>

<Tk>TL30</Tk>

</TkQual>

</Item>

An end mark item. And end marks is required to signify the end of the PNR/BF data in </PNRBFPrimaryBldChgMods>. Required.

<Item>

<DataBlkInd>E</DataBlkInd>

<EndMarkQual>

<EndMark>E</EndMark>

</EndMarkQual>

</Item>

The end of the primary PNR/BF build request.

</ItemAry>

</PNRBFPrimaryBldChgMods>

Begins the hotel segment sell request.

<HtlSegSellMods>

<HotelSell>

Indicates segment number

Set to Zero ('00') in initial Hotel Sell requests. Otherwise enter a valid segment number 01 - 99

<SegNum>00</SegNum>

Describes the current status of the particular Hotel itinerary segment (00). SS = Sold

<SellStatusInd>SS</SellStatusInd>

The check-in date in CCYYMMDD format.

<StartDt>20080213</StartDt>

The check-out date in CCYYMMDD format.

<EndDt>20080223</EndDt>

The number of nights customer will stay.

<NumNights>07</NumNights>

City Code: Valid airport code or city code designating the location of the hotel where the reservation was placed.

<PrimaryCity>DEN</PrimaryCity>

The two-character hotel chain code..

<Chain>ES</Chain>

The RoomMaster property ID.

<RoomMasterID>52557</RoomMasterID>

The Booking Indicator Code for the room rate. The BIC is supplied in the complete hotel availability response in Step 4.

<BIC>N2DRAC</BIC>

The name of the hotel property.

<HtlPropName>Embasy Suites</HtlPropName>

Number of adults in the booking.

<NumAdults>2</NumAdults>

Number of rooms to book.

<NumRooms>1</NumRooms>

Rate Type Sold: This indicates the level of guarantee the hotel offers for this rate.

Possible Values:

RG=Vendor guaranteed

RQ=Vendor quoted rate, but not guaranteed

<RateGuarInfo>RG</RateGuarInfo>

The returned rate is for more than one night (as in a package).

<MultiDayRateInd>Y</MultiDayRateInd>

Currency in which rates were sold. Applies to Rate Amount and Total Rate if they exist.

<Currency>USD</Currency>

The number of places to the right of the implied decimal for the currency in which the rates are quoted.

<DecPos>2</DecPos>

The number of implied decimals in rates for extra charges.

<ExtraChargeDecPos>2</ExtraChargeDecPos>

The room amount expressed in the currency defined by Currency Code. Location of implied decimal point specified by Number of Decimals.

<RateAmt>20000</RateAmt>

</HotelSell>

Begin hotel options selection.

<HotelOptionalData>

<FldAry>

<Fld>

Two-digit code that identifies which optional data is in the variable length field. For more possible Optional Field values, format, descriptions, and use, please see Industry Codes > Hotel Sell Optional Data table.

<ID>GT</ID>

This field contains the details of the optional data, based on the type specified in Optional Field Identity

<Contents>AX373900000000000EXP1209</Contents>

End Hotel Options

</Fld>

</FldAry>

</HotelOptionalData>

End Hotel Segment Sell

</HtlSegSellMods>

End Hotel Segment Sell request.

</PNRBFManagement_11>

PNRBFManagement response header

<PNRBFManagement_#>

<PNRBFPrimaryBldChg/>

Begins the hotel segment sell response.

<HtlSegSell>

Indicates the hotel type response:

0 = Link sell successful.

P = Property List returned

S = Similar Name List returned

<HotelType>

<HtlTypeInd>0</HtlTypeInd>

</HotelType>

Begins Hotel Sell related information

<HotelSell>

Segment number.

<SegNum>1</SegNum>

Describes the current status of the particular Hotel itinerary segment.

<SellStatusInd>SS</SellStatusInd>

Arrival Date

<StartDt>20080213</StartDt>

Departure Date

<EndDt>20080223</EndDt>

Number of nights guest will stay.

<NumNights>10</NumNights>

Valid airport code or city code designating the location of the hotel where the reservation was placed.

<PrimaryCity>DEN</PrimaryCity>

Chain code

<Chain>ES</Chain>

Property's RoomMaster identification number

<RoomMasterID>52557</RoomMasterID>

The full booking code for the rate sold.

<BIC>N2DRAC</BIC>

Hotel property name.

<HtlPropName>EMBASSY DENVER ARPT</HtlPropName>

The number of adult travelers in the reservation.

<NumAdults>2</NumAdults>

The number of hotel rooms in the reservation.

<NumRooms>1</NumRooms>

The vendor's confirmation number for the booking.

<ConfNum>80265184*</ConfNum>

The level of rate guarantee for this booking.
RT = RoomMaster rate, or rate not guaranteed by vendor
RG = Vendor guaranteed
RQ = Vendor quoted rate, but not guaranteed

<RateGuarInfo>RG</RateGuarInfo>

Indicates if the room rate changes during the hotel stay.

Y= Rate changes during length of stay

N= No change over the period

<RateChgInd>N</RateChgInd>

Indicates if the returned rate is for more than one night.

= Rate applies to more than one day, as in a package

N= Normal application of rate period

<MultiDayRateInd>N</MultiDayRateInd>

The currency in which the rate was sold.

<Currency>USD</Currency>

The number of decimals in the currency (0, 1, 2, or 3).

<DecPos>2</DecPos>

The number of implied decimals in rates for extra charges (0, 1, 2, or 3).

<ExtraChargeDecPos>2</ExtraChargeDecPos>

The rate amount in the vendor's currency. In this example, 1042.50 Norwegian kroner.

<RateAmt>000018995</RateAmt>

Multi-level rate code. Used for multi-level (corporate rates).

<MultilevelRate/>

Data Store Validation is only done for IBM requests. All other customers may ignore this field.

<DataStoreIndicator/>

</HotelSell>

Identifies the type of optional data:
AC = Alternate Currency
VC = Vendor Currency
AV= Advance deposit
BS= Booking source
RT = Corporate rate override
RG= Guaranteed rate
DP= Deposit
RQ= Quoted rate
RR= Rate request
GT= Payment guarantee
AD= Customer address
RA= Rollaway bed adult
RB = Alternate currency Rollaway bed adult
RD= Rollaway bed child
RE = Alternate Currency Rollaway bed child
CR= Cribs
CS = Alternate Currency Crib
EX= Extra adult
EY = Alternate Currency Extra Child
EC= Extra child
ED = Alternate Currency Extra Child
TN= Tour number
RL= Tour room location
MP= Tour meal plan
CD= Corporate discount number
FG= Frequent guest number
FT= Frequent air traveler number
BA = Credit Card Billing Address
CC = Credit Card Number from the BAS extension
CN = Credit Card Name
CV = Credit Card CVV ID
MR = Merchant Record Locator (CMR)
ID= Customer ID number
SI= Special information
NF= Reservation name - first
NL= Reservation name - last

<HotelOptionalData>

<FldAry>

<Fld>

<ID>BS</ID>

<Contents>AGT14537482</Contents>

</Fld>

<Fld>

<ID>GT</ID>

<Contents>AX373900000000000EXP1209</Contents>

</Fld>

<Fld>

<ID>NL</ID>

<Contents>KRAMDEN</Contents>

</Fld>

<Fld>

<ID>NF</ID>

<Contents>RALPH</Contents>

</Fld>

</FldAry>

</HotelOptionalData>

Begins Rule section.

<HotelRule>

Rules provided by hotel property.

Note: Cancellation data is also placed in Associated Remark and OSI/SI elements to ensure that it is stored with the PNR/BF.

<RuleInfoAry>

<RuleInfo/>

<RuleInfo>CXL:24 HR CANCELLATION REQUIRED</RuleInfo>

<RuleInfo>GUARANTEED BY CREDIT CARD</RuleInfo>

<RuleInfo>EMBASSY SUITES PAYS COMMISSION UP TO 7 NIGHTS</RuleInfo>

<RuleInfo>RENOVATION COMPLETE AT EMBASSY SUITES SFO-BURLNGAM</RuleInfo>

<RuleInfo>NEW CASE GOODS - COMP BUSINESS CENTER AND FITNESS RM *</RuleInfo>

</RuleInfoAry>

Ends the response.

</HotelRule>

</HtlSegSell>

</PNRBFManagement_#>