The reservation response will return salesTax and hotelOccupancyTax values when these items apply to a specific location such as New York state or other regional or municipal governments.

Use the examples in this section to display this information properly as part of the Launch Requirements.

  • These tax values are returned in both live bookings and static test bookings.
  • Whenever salesTax and hotelOccupancyTax are returned after placing a booking, you are legally required to display these values separately in the price breakdown of your final confirmation page.
  • These items are returned in the booking response and all previous responses, if applicable to the property.
    However, there may be other regional or municipal governments that also return this information, therefore display the information as outlined any time these elements are populated.
  • salesTax and hotelOccupancyTax are already included in the TaxAndServiceFee and surchargeTotal values provided in the response. Never modify or replace TaxAndServiceFee or surchargeTotal values.
  • TaxAndServiceFee is only a subtotal for certain taxes and fees. ExtraPersonFee is not included in the calculation. Only surchargeTotal provides a complete total of all values within the Surcharge node.

Here is the Surcharges node excerpted from the example below:

<Surcharges size="3">
<Surcharge amount="65.98" type="TaxAndServiceFee" /> includes the two separate taxes below
<Surcharge amount="15.28" type="salesTax">
<Surcharge amount="36.38" type="hotelOccupancyTax">
</Surcharges>

Example display for the above surcharges with salesTax and hotelOccupancyTax displayed as a single line item:

The HotelRoomReservationResponse will return salesTax and hotelOccupancyTax values when these items apply to a specific location such as New York state or other regional or municipal governments.

Use the examples in this section to display this information properly as part of the Launch Requirements.

  • These tax values are returned in both live bookings and static test bookings.
  • Whenever salesTax and hotelOccupancyTax are returned after placing a booking, you are legally required to display these values as a separate sum labeled Hotel Occupancy and Sales Tax in the price breakdown of the final confirmation page.
  • These items are returned in the booking response and all previous responses, if applicable to the property. However, there may be other regional or municipal governments that also return this information, therefore display the information as outlined any time these elements are populated.
  • salesTax and hotelOccupancyTax are already included in the TaxAndServiceFee and surchargeTotal values provided in the response. Never modify or replace TaxAndServiceFee or surchargeTotal values.
  • TaxAndServiceFee is only a subtotal for certain taxes and fees. ExtraPersonFee is not included in the calculation. Only surchargeTotal provides a complete total of all values within the Surcharge node.

Here is the Surcharges node excerpted from the example below:

<Surcharges size="3">
<Surcharge amount="65.98" type="TaxAndServiceFee" /> includes the two separate taxes below
<Surcharge amount="15.28" type="salesTax">
<Surcharge amount="36.38" type="hotelOccupancyTax">
</Surcharges>

Example display for the above Surcharges with salesTax and hotelOccupancyTax displayed as a single line item: {: width="515" height="122"}

Reservation response in its entirety, special surcharges highlighted:

<ns2:HotelRoomReservationResponse xmlns:ns2 = "http://v3.hotel.wsapi.ean.com/">
    <itineraryId>76014245</itineraryId>
    <confirmationNumbers>1234</confirmationNumbers>
    <processedWithConfirmation>true</processedWithConfirmation>
    <supplierType>E</supplierType>
    <reservationStatusCode>CF</reservationStatusCode>
    <existingItinerary>false</existingItinerary>
    <numberOfRoomsBooked>1</numberOfRoomsBooked>
    <drivingDirections></drivingDirections>
    <checkInInstructions></checkInInstructions>
    <arrivalDate>01/27/2012</arrivalDate>
    <departureDate>01/31/2012</departureDate>
    <hotelName>The Edison Hotel</hotelName>
    <hotelAddress>228 W 47th St</hotelAddress>
    <hotelCity>New York</hotelCity>
    <hotelStateProvinceCode>NY</hotelStateProvinceCode>
    <hotelPostalCode>10036</hotelPostalCode>
    <hotelCountryCode>US</hotelCountryCode>
    <roomDescription>Double room</roomDescription>
    <cancellationPolicy>We understand that sometimes plans fall through. We do not charge a change or cancel fee. However, this property (The Edison Hotel) imposes the following penalty to its customers that we are required to pass on: Cancellations or changes made after 3:00 PM ((GMT-05:00)) on Jan 26, 2012 are subject to a 1 Night Room & Tax penalty. The property makes no refunds for no shows or early checkouts.</cancellationPolicy>
    <CancelPolicyInfoList>
        <CancelPolicyInfo>
            <versionId>206376960</versionId>
            <cancelTime>15:00:00</cancelTime>
            <startWindowHours>0</startWindowHours>
            <nightCount>1</nightCount>
            <currencyCode>USD</currencyCode>
            <timeZoneDescription>(GMT-05:00) Eastern Time (US & Canada)</timeZoneDescription>
        </CancelPolicyInfo>
        <CancelPolicyInfo>
            <versionId>206376959</versionId>
            <cancelTime>15:00:00</cancelTime>
            <startWindowHours>24</startWindowHours>
            <nightCount>0</nightCount>
            <currencyCode>USD</currencyCode>
            <timeZoneDescription>(GMT-05:00) Eastern Time (US & Canada)</timeZoneDescription>
        </CancelPolicyInfo>
    </CancelPolicyInfoList>
    <nonRefundable>false</nonRefundable>
    <rateOccupancyPerRoom>2</rateOccupancyPerRoom>
    <RateInfos size = "1">
        <RateInfo
            rateChange = "false"
            promo = "true"
            priceBreakdown = "true">
            <RoomGroup>
                <Room>
                    <numberOfAdults>2</numberOfAdults>
                    <numberOfChildren>0</numberOfChildren>
                    <firstName>test</firstName>
                    <lastName>smith</lastName>
                    <bedTypeId>13</bedTypeId>
                    <bedTypeDescription>Double Bed</bedTypeDescription>
                    <smokingPreference>E</smokingPreference>
                </Room>
            </RoomGroup>
            <ChargeableRateInfo>
                commissionableUsdTotal = "797.34"
                total = "863.32"
                surchargeTotal = "65.98"
                nightlyRateTotal = "797.34"
                averageBaseRate = "199.34"
                averageRate = "199.34"
                maxNightlyRate = "199.34"
                currencyCode = "USD">
                <NightlyRatesPerRoom size = "4">
                    <NightlyRate
                        promo = "false"
                        rate = "199.34"
                        baseRate = "199.34"/>
                    <NightlyRate
                        promo = "false"
                        rate = "199.34"
                        baseRate = "199.34"/>
                    <NightlyRate
                        promo = "false"
                        rate = "199.34"
                        baseRate = "199.34"/>
                    <NightlyRate
                        promo = "false"
                        rate = "199.34"
                        baseRate = "199.34"/>
                </NightlyRatesPerRoom>
                <Surcharges size="3">
<Surcharge amount="65.98" type="TaxAndServiceFee" /> includes the two separate taxes below
<Surcharge amount="15.28" type="salesTax">
<Surcharge amount="36.38" type="hotelOccupancyTax">
                    </Surcharges>
            </ChargeableRateInfo>
        </RateInfo>
    </RateInfos>
</ns2:HotelRoomReservationResponse>