Page Comparison

The Service structure is used for passing on information about charges for extras and services. Services can be provided at the HotelReservation level (no ServiceRPH) or to on a RoomStay or RoomRate level. The ServiceRPH serves only to link a charge to a room or a rate.

All Service totals provided should be considered full amounts added to the base reservation charge. In other words, the charges are not per person or per day but full charges. The total amounts provided for the RoomStay and Reservation should be considered as inclusive of extras.

For a list of possible service types see Service and Extra Charge Reference Table

Reservation Services

Code Block

language	html/xml

<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:32:47+08:00" EchoToken="echo-abc123">
  <Success/>
  <ReservationsList>
    <HotelReservation CreateDateTime="2007-12-09T08:51:45.000+0000" ResStatus="Book">
      <POS>
        <Source>
          <RequestorID Type="22" ID="SITEMINDER"/>
          <BookingChannel Primary="true" Type="7">
            <CompanyName Code="WTF">Wotif</CompanyName>
          </BookingChannel>
        </Source>
      </POS>
      <UniqueID Type="14" ID="WTF-001"/>
      <UniqueID Type="16" ID="1243132" ID_Context="MESSAGE_UNIQUE_ID"/>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="DR" RatePlanCode="RAC" NumberOfUnits="1">
              <Rates>
                <Rate UnitMultiplier="3" RateTimeUnit="Day" EffectiveDate="2013-03-12" ExpireDate="2013-03-15">
                  <Base AmountAfterTax="30.00" CurrencyCode="USD"/>
                </Rate>
              </Rates>
            </RoomRate>
          </RoomRates>
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="2"/>
          </GuestCounts>
          <TimeSpan Start="2013-03-12" End="2013-03-15"/>
          <Total AmountAfterTax="90.00" CurrencyCode="USD"/>
          <BasicPropertyInfo HotelCode="10107"/>
        </RoomStay>
      </RoomStays>
      <Services>
        <Service ServiceInventoryCode="OTHER" Inclusive="true" ServiceRPH="1" Quantity="1" ID="12345" ID_Context="CHANNEL" Type="18">
          <Price>
            <Total AmountAfterTax="80.00" CurrencyCode="USD"/>
          </Price>
          <ServiceDetails>
            <TimeSpan End="2013-03-15" Start="2013-03-12"/>
          </ServiceDetails>
        </Service>
      </Services>
      <ResGuests>
        <ResGuest ArrivalTime="10:30:00">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="16" ID="12345" ID_Context="CHANNEL"/>
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>James</GivenName>
                    <MiddleName>Herbert</MiddleName>
                  </PersonName>
                  <Telephone PhoneNumber="555-1234"/>
                  <Email>james.bond@mi5.co.uk</Email>
                  <Address>
                    <AddressLine>Claretta House</AddressLine>
                    <CityName>London</CityName>
                    <PostalCode>EC1 2PG</PostalCode>
                    <StateProv>Middlesex</StateProv>
                    <CountryName>United Kingdom</CountryName>
                  </Address>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <Total AmountAfterTax="140.00" CurrencyCode="USD"/>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="RES_3243525"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </ReservationsList>
</OTA_ResRetrieveRS>

RoomStay Services

Code Block

language	html/xml

<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:32:47+08:00" EchoToken="echo-abc123">
  <Success/>
  <ReservationsList>
    <HotelReservation CreateDateTime="2007-12-09T08:51:45.000+0000" ResStatus="Book">
      <POS>
        <Source>
          <RequestorID Type="22" ID="SITEMINDER"/>
          <BookingChannel Primary="true" Type="7">
            <CompanyName Code="WTF">Wotif</CompanyName>
          </BookingChannel>
        </Source>
      </POS>
      <UniqueID Type="14" ID="WTF-001"/>
      <UniqueID Type="16" ID="1243132" ID_Context="MESSAGE_UNIQUE_ID"/>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="DR" RatePlanCode="RAC" NumberOfUnits="1">
              <Rates>
                <Rate UnitMultiplier="3" RateTimeUnit="Day" EffectiveDate="2013-03-12" ExpireDate="2013-03-15">
                  <Base AmountAfterTax="30.00" CurrencyCode="USD"/>
                </Rate>
              </Rates>
            </RoomRate>
          </RoomRates>
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="2"/>
          </GuestCounts>
          <ServiceRPHs>
            <ServiceRPH RPH="1"/>
          </ServiceRPHs>
          <TimeSpan Start="2013-03-12" End="2013-03-15"/>
          <Total AmountAfterTax="90.00" CurrencyCode="USD"/>
          <BasicPropertyInfo HotelCode="10107"/>
        </RoomStay>
      </RoomStays>
      <Services>
        <Service ServiceInventoryCode="MEAL" Inclusive="true" ServiceRPH="1" Quantity="1" ID="12345" ID_Context="CHANNEL" Type="18">
          <Price>
            <Total AmountAfterTax="50.00" CurrencyCode="USD"/>
            <RateDescription>
              <Text>Breakfast buffet</Text>
            </RateDescription>
          </Price>
          <ServiceDetails>
            <TimeSpan End="2013-03-15" Start="2013-03-12"/>
          </ServiceDetails>
        </Service>
      </Services>
      <ResGuests>
        <ResGuest ArrivalTime="10:30:00">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="16" ID="12345" ID_Context="CHANNEL"/>
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>James</GivenName>
                    <MiddleName>Herbert</MiddleName>
                  </PersonName>
                  <Telephone PhoneNumber="555-1234"/>
                  <Email>james.bond@mi5.co.uk</Email>
                  <Address>
                    <AddressLine>Claretta House</AddressLine>
                    <CityName>London</CityName>
                    <PostalCode>EC1 2PG</PostalCode>
                    <StateProv>Middlesex</StateProv>
                    <CountryName>United Kingdom</CountryName>
                  </Address>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <Total AmountAfterTax="140.00" CurrencyCode="USD"/>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="RES_3243525"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </ReservationsList>
</OTA_ResRetrieveRS>

RoomRate Services

Code Block

language	html/xml

<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:32:47+08:00" EchoToken="echo-abc123">
  <Success/>
  <ReservationsList>
    <HotelReservation CreateDateTime="2007-12-09T08:51:45.000+0000" ResStatus="Book">
      <POS>
        <Source>
          <RequestorID Type="22" ID="SITEMINDER"/>
          <BookingChannel Primary="true" Type="7">
            <CompanyName Code="WTF">Wotif</CompanyName>
          </BookingChannel>
        </Source>
      </POS>
      <UniqueID Type="14" ID="WTF-001"/>
      <UniqueID Type="16" ID="1243132" ID_Context="MESSAGE_UNIQUE_ID"/>
      <RoomStays>
        <RoomStay>
          <RoomRates>
            <RoomRate RoomTypeCode="DR" RatePlanCode="RAC" NumberOfUnits="1">
              <Rates>
                <Rate UnitMultiplier="3" RateTimeUnit="Day" EffectiveDate="2013-03-12" ExpireDate="2013-03-15">
                  <Base AmountAfterTax="30.00" CurrencyCode="USD"/>
                </Rate>
              </Rates>
              <ServiceRPHs>
                <ServiceRPH RPH="1"/>
              </ServiceRPHs>
            </RoomRate>
          </RoomRates>
          <GuestCounts>
            <GuestCount AgeQualifyingCode="10" Count="3"/>
          </GuestCounts>
          <TimeSpan Start="2013-03-12" End="2013-03-15"/>
          <Total AmountAfterTax="90.00" CurrencyCode="USD"/>
          <BasicPropertyInfo HotelCode="10107"/>
        </RoomStay>
      </RoomStays>
      <Services>
        <Service ServiceInventoryCode="EXTRA_PERSON" Inclusive="true" ServiceRPH="1" Quantity="1" ID="12345" ID_Context="CHANNEL" Type="18">
          <Price>
            <Total AmountAfterTax="30.00" CurrencyCode="USD"/>
            <RateDescription>
              <Text>Extra person charge $10.00 per night</Text>
            </RateDescription>
          </Price>
          <ServiceDetails>
            <TimeSpan End="2013-03-15" Start="2013-03-12"/>
          </ServiceDetails>
        </Service>
      </Services>
      <ResGuests>
        <ResGuest ArrivalTime="10:30:00">
          <Profiles>
            <ProfileInfo>
              <UniqueID Type="16" ID="12345" ID_Context="CHANNEL"/>
              <Profile ProfileType="1">
                <Customer>
                  <PersonName>
                    <GivenName>James</GivenName>
                    <MiddleName>Herbert</MiddleName>
                  </PersonName>
                  <Telephone PhoneNumber="555-1234"/>
                  <Email>james.bond@mi5.co.uk</Email>
                  <Address>
                    <AddressLine>Claretta House</AddressLine>
                    <CityName>London</CityName>
                    <PostalCode>EC1 2PG</PostalCode>
                    <StateProv>Middlesex</StateProv>
                    <CountryName>United Kingdom</CountryName>
                  </Address>
                </Customer>
              </Profile>
            </ProfileInfo>
          </Profiles>
        </ResGuest>
      </ResGuests>
      <ResGlobalInfo>
        <Total AmountAfterTax="120.00" CurrencyCode="USD"/>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="RES_3243525"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </ReservationsList>
</OTA_ResRetrieveRS>

Versions Compared

Old Version 2

New Version 3

Key

Reservation Services

RoomStay Services

RoomRate Services