TaxFeeInfo

Syntax

The TaxFeeInfo message uses the following syntax:
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="transaction_ID"
            partner="partner_account_name">
  <Property>
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <Type>[percent|amount]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>[percent|amount]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Elements & Attributes

The TaxFeeInfo message has the following elements and attributes:
Element / @Attribute Occurrences Type Description
TaxFeeInfo 1 Complex element The root element for a message defining taxes and fees for a single property.
TaxFeeInfo / @timestamp 1 DateTime The creation date and time of this message.
TaxFeeInfo / @id 1 String A unique identifier for each TaxFeeInfo message.
TaxFeeInfo / @partner 1 String The partner account for this message. To get this value, contact us.

Note: If you have a backend that provides feeds for multiple accounts, this value needs to match the ID attribute value specified in the <RequestorID> element of your <OTA_HotelRateAmountNotifRQ> and <OTA_HotelAvailNotifRQ> messages for the same account.

TaxFeeInfo / Property 1..n Property A container for defining taxes and fees for a single property.
TaxFeeInfo / Property / ID 1 String The unique identifier for the property. This value must match the Hotel ID specified using <id> in the <listing> element in the Hotel List Feed. The Hotel ID is also listed in Hotel Center.
TaxFeeInfo / Property / Taxes 0..1 Taxes Container for one or more <Tax> elements.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax An individual tax that applies to the property.
TaxFeeInfo / Property / Taxes / Tax / Type 1 Enum

Valid values are:

  • percent: A percent of the total rate
  • amount: A flat amount to add to the final rate
TaxFeeInfo / Property / Taxes / Tax / Basis 1 Enum

Valid values are:

  • room: The <Amount> is applied to the room.
  • person: The <Amount> is applied per person. This value only applies if <Type> is set to amount.
TaxFeeInfo / Property / Taxes / Tax / Period 1 Enum

This value only applies if <Type> is set to amount.

Valid values are:

  • stay: The <Amount> is added to the total rate of the stay.
  • night: The <Amount> is added per night of the stay.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 String The three-letter currency code for the tax (for example: USD).
TaxFeeInfo / Property / Taxes / Tax / Amount 1 Float The value of the percent or amount of the tax.
TaxFeeInfo / Property / Fees 0..1 Fees Container for one or more <Fee> elements.
TaxFeeInfo / Property / Fees / Fee 1..n Fee An individual fee that applies to the property.
TaxFeeInfo / Property / Fees / Fee / Type 1 Enum

Valid values are:

  • percent: A percent of the total rate
  • amount: A flat amount to add to the final rate
TaxFeeInfo / Property / Fees / Fee / Basis 1 Enum

Valid values are:

  • room: The <Amount> is applied to the room.
  • person: The <Amount> is applied per person. This value only applies if <Type> is set to amount.
TaxFeeInfo / Property / Fees / Fee / Period 1 Enum

This value only applies if <Type> is set to amount.

Valid values are:

  • stay: The <Amount> is added to the total rate of the stay.
  • night: The <Amount> is added per night of the stay.
TaxFeeInfo / Property / Fees / Fee / Currency 0..1 String The three-letter currency code for the fee (for example: USD).
TaxFeeInfo / Property / Fees / Fee Amount 1 Float The value of the percent or amount of the fee.

Examples

Example 1

The following example showns a basic TaxFeeInfo message:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo  timestamp="2020-05-18T16:20:00-04:00"
             id="12345678">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>