Air Pricing with Taxes and Surcharges

An Air Pricing request can include tax exemptions. Responses to Air Pricing requests may include taxes and surcharges, or a may have a tax exemption that removes tax amounts.

Schema

Located in Air.xsd:

How To

  1. Include the required information for AirPriceReq.

  2. Use AirPriceReq/AirPricingModifiers/ExemptTaxes to indicate tax exemptions.

    Note: In Universal API, the only way to include Exempt Taxes is via AirPriceReq/AirPricingModifiers. No other element/attribute path includes tax exemption modifiers that process correctly.

    All or some of the taxes associated with an itinerary can be excluded from the response:

    • If @AllTaxes is set to 'True', any taxes that apply to the itinerary are excluded in the response.

    • If only certain taxes are exempt, the /CountryCode and /TaxCategory elements can be used to specify the country and specific tax type that are excluded in the response.

    Note: As of Universal API Release 19.1.8, an enhancement was released for Worldspan (1P) to support the exemption of specific taxes by tax code and/or country code, Release 19.1

    To use this feature, in Air Price and Reprice, in the ExemptTaxes element, use:

    • @AllTaxes=True - Returns all taxes exempted.
    • @CountryCode for specific country
    • @TaxCategory for specific tax category

    And /AirPricingModifiers @Sellcheck=True and Reprice

    Notes:

    • Split Pricing is not suported.
    • Galileo (1G) and Apollo (1V) already support this feature.

    For AirPrice, when both SellCheck and AirReservationLocatorCode indicators are included, the response will differ (shown below) from other transactions due to maintaining consistency between the provider and Universal API responses. For example:

    <air:TaxInfo Category=""AY"" Key=""70002"" TaxExempted=""true"">
      <air:Amount CurrencyCode=""USD"" Value=""0.00""/>
    </air:TaxInfo>

    For all other transactions,

    • Universal API only displays the non-exempted taxes. If all the taxes are exempted, and any US tax is involved, only the US tax is exempted in response.
    • @CountryCode for a specific country is not supported.

     

  3. An Air Pricing response is returned that may include surcharges and taxes (including Value Added Tax—VAT). If ExemptTaxes was sent in the request, the response will have the specified tax or taxes excluded.

    In AirPriceRsp/AirPriceResult/AirPricingSolution/AirPricingInfo:

    • The TaxInfo elements for each tax-exempt category have an Amount attribute of '0.00' and a TaxExempted attribute set to 'True'.
    • The VAT may be included in the base price (some countries include it, others file tax codes for their VAT taxes). If VAT is included in the response, the IncludesVAT indicator is set to Y. If the indicator is blank or N, VAT is not included in the response.

    In AirPriceRsp/AirPriceResult/AirPricingSolution/AirPricingInfo/FareInfo:

    • For Air v34 and higher, the attribute @TaxAmount provides for each fare component the fare component tax. It contains the currency code and value for the approximate tax amount. An alert states that the tax shown at this level is informational only, as the individual fare components may not add up to the exact total of the tax amount.
    • Note: The tax data found in the FareInfo element should NOT be sent in an AirCreateReservationReq or UniversalRecordModifyReq. This tax data is informational and will be ignored if sent in a subsequent request.

Errors and Warnings

Not all providers or suppliers support the Tax Exempt modifier. A warning is returned if the provider/supplier does not support tax exemptions.

Exceptions

ACH

Air Canada offers tax exemptions for government employees. Tax exemptions apply to Air Fares as well as Optional Services. Two types of tax exemptions are supported:

Note: An error in sent in the response if the two-character code is incorrect.

Note: If this field is not sent with the tax exempt request, an error is NOT sent to indicate it is missing.

When both TaxTerritory and CompanyName are sent in the request, both GST/HST and QST are 0.00 in the response.

RCS

RCS suppliers return total fares with no breakdown of the base fare, taxes, and total. Therefore, tax exemptions do not apply to RCS requests.