Getting Bookings

To get all unconfirmed bookings with arrival from today or any day from the future, for specific  HotelCode use the following XML request:

Please confirm all bookings after processing them in your system.

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.opentravel.org/OTA/2003/05" 
xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-in-
stance">
  <SOAP-ENV:Header>
    <ns2:Security>
      <ns2:UsernameToken>
        <ns2:Username>username</ns2:Username>
        <ns2:Password xsi:type="ns2:http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</ns2:Password>
      </ns2:UsernameToken>
    </ns2:Security>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <ns1:OTA_HotelResNotifRQ EchoToken="MYPMS001" TimeStamp="2008-12-03T08:05:40+00:00" Version="1.006" HotelCode="optionalHotelId" ChainCode="optionalChainId">
    </ns1:OTA_HotelResNotifRQ>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
If request was successful you should retrieve XML like this:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns2="http://www.opentravel.org/OTA/2003/05">
<script/>
<SOAP-ENV:Body>
<OTA_HotelResNotifRQ Version="1.000" EchoToken="MYPMS001" TimeStamp="2024-06-17T10:47:30+02:00">
<POS>
<Source>
<RequestorID Type="22" ID="WBPCRS"/>
<BookingChannel Type="5" Primary="true">
<CompanyName>WebBookingPro</CompanyName>
</BookingChannel>
</Source>
</POS>
<HotelReservations>
<HotelReservation CreatorID="WBPCRS" CreateDateTime="2024-06-17T06:55:16+02:00" ResStatus="Commit">
<UniqueID Type="14" ID="12345667" PMSConfirmationID="optional confirmation from PMS"/>
<RoomStays>
<RoomStay MarketCode="HOTEL">
<RatePlans>
<RatePlan RatePlanCode="0">
<MealsIncluded MealPlanCodes="3"/>
</RatePlan>
</RatePlans>
<RoomRates>
<RoomRate RoomTypeCode="1" NumberOfUnits="1" RatePlanCode="0">
<Rates>
<Rate RateTimeUnit="DAY" UnitMultiplier="1" EffectiveDate="2024-06-24" ExpireDate="2024-06-25" ExpireDateExclusiveIndicator="true">
<Base AmountBeforeTax="139.32" CurrencyCode="EUR"/>
<Total AmountBeforeTax="139.32" CurrencyCode="EUR"/>
</Rate>
<Rate RateTimeUnit="DAY" UnitMultiplier="1" EffectiveDate="2024-06-25" ExpireDate="2024-06-26" ExpireDateExclusiveIndicator="true">
<Base AmountBeforeTax="139.32" CurrencyCode="EUR"/>
<Total AmountBeforeTax="139.32" CurrencyCode="EUR"/>
</Rate>
<Rate RateTimeUnit="DAY" UnitMultiplier="1" EffectiveDate="2024-06-26" ExpireDate="2024-06-27" ExpireDateExclusiveIndicator="true">
<Base AmountBeforeTax="139.32" CurrencyCode="EUR"/>
<Total AmountBeforeTax="139.32" CurrencyCode="EUR"/>
</Rate>
<Rate RateTimeUnit="DAY" UnitMultiplier="1" EffectiveDate="2024-06-27" ExpireDate="2024-06-28" ExpireDateExclusiveIndicator="true">
<Base AmountBeforeTax="139.32" CurrencyCode="EUR"/>
<Total AmountBeforeTax="139.32" CurrencyCode="EUR"/>
</Rate>
</Rates>
</RoomRate>
</RoomRates>
<GuestCounts>
<GuestCount AgeQualifyingCode="10" Count="2"/>
<GuestCount AgeQualifyingCode="8" Count="0"/>
</GuestCounts>
<TimeSpan Start="2024-06-24" End="2024-06-28"/>
<Guarantee GuaranteeCode="1">
<GuaranteeDescription>
<Text>Guarantee by Credit Card.</Text>
</GuaranteeDescription>
</Guarantee>
<Total AmountAfterTax="557.28" CurrencyCode="EUR"/>
<BasicPropertyInfo HotelCode="1" ChainCode="1"/>
<ResGuestRPHs>
<ResGuestRPH RPH="1"/>
</ResGuestRPHs>
</RoomStay>
</RoomStays>
<ResGuests>
<ResGuest ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<Profile>
<Customer>
<PersonName>
<GivenName>IVAN</GivenName>
<Surname>IVIC</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<Comments>
<Comment GuestViewable="true">
<Text>additional guest information</Text>
</Comment>
</Comments>
<HotelReservationIDs>
<HotelReservationID ResID_Type="14" ResID_Value="12345667"/>
</HotelReservationIDs>
<Profiles>
<ProfileInfo>
<Profile ProfileType="1">
<Customer>
<PersonName>
<GivenName>IVAN</GivenName>
<Surname>IVIC</Surname>
</PersonName>
<Address Type="1">
<AddressLine>Adress</AddressLine>
<CityName>City</CityName>
<CountryName>HR</CountryName>
</Address>
<Email EmailType="1" DefaultInd="true">moj@moja.com</Email>
<Telephone PhoneLocationType="6" PhoneTechType="1" PhoneNumber="+38511111111"/>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGlobalInfo>
</HotelReservation>
</HotelReservations>
</OTA_HotelResNotifRQ>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
POS tag is always same.

HotelReservation @CreatorID can be WBPCRS for WebBookingPro direct reservations created from System, WBPBE for WebBookingPro web direct reservations created via booking engine. If reservation is from e.g. Booking.com by default it will be name of channel e.g. Booking.com, or if specified custom SourceCode for PMS it will be this code.
Specific SourceCode can be set both for Channel or specific custom Rate Plan. If the reservation is created via Booking.com, with assiciated specific Rate Plan, first we check for custom SourceCode for rate plan, then if set SourceCode for channel Booking.com, we will use this as final.

HotelReservation @ResStatus can be Commit, Modify or Cancel. If it is Cancel or Modify additional attribute @LastModifyDateTime will be send.
HotelReservation @PMSConfirmationID will contain ID from PMS if the reservation has been confirmed before.

RoomStay @MarketCode - if not specified specific MarketCode for custom Rate Plan, it will be used "WEB" for web direct reservations and "HOTEL" for reservations created directly in WebBookingPro and "OTA" for all other reservations.

RoomRate and RatePlan @RatePlanCode can be 0 - which specified default rate plan. If the reservations was created with custom rate plan, and custom RatePlan code is set, it will be used.

MealsIncluded @MealPlanCodes can be 14 for room-only, 3 for breakfast included, 2 for halfboard, 3 for fullboard and 1 for all-inclusive.

If GuestCount @AgeQualifyingCode is "8", it can contain additional attribute Age specific specific child age.

If there are paid deposits (prepayments) additional child called DepositPayments under RegGlobalInfo will be added.

<DepositPayments>
<GuaranteePayment>
<AmountPercent Amount="100.00"/>
<Transaction DateTime="2024-06-11T00:00:00Z" ID="trasactionId" Currency="EUR"/>
</GuaranteePayment>
</DepositPayments>


To Confirm booking please use the following request

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:ns1="http://www.opentravel.org/OTA/2003/05" xmlns:ns2="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecur-
ity-secext-1.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <SOAP-ENV:Header>
    <ns2:Security>
      <ns2:UsernameToken>
        <ns2:Username>username</ns2:Username>
        <ns2:Password xsi:type="ns2:http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">password</ns2:Password>
      </ns2:UsernameToken>
    </ns2:Security>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <ns1:OTA_HotelResNotifRS ResResponseType="Commited" EchoToken="MYPMS001" TimeStamp="2009-01-
19T10:24:24+00:00" Version="1.006">
      <ns1:Success/>
      <ns1:HotelReservations>
        <ns1:HotelReservation>
          <ns1:UniqueID Type="14" ID="1234567"/>
          <ns1:ResGlobalInfo>
            <ns1:HotelReservationIDs>
              <ns1:HotelReservationID ResID_Type="10" ResID_Value="PMSID0011" ForGuest="true"/>
            </ns1:HotelReservationIDs>
          </ns1:ResGlobalInfo>
        </ns1:HotelReservation>
      </ns1:HotelReservations>
    </ns1:OTA_HotelResNotifRS>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

UniqueID @Type="14" @ID is the number of the reservation from OTA/WebBookingPro

HotelReservationID @ResID_Type="10" @ResID_Value is the number from your system (PMS).

HotelReservations can have multiple HotelReservation childs in same request.




								
Previous Article

Getting Rooms