如何在Amadeus Fare_MasterPricerTravelBoardSearch中获取YQ税费信息？

问题背景 #

使用Amadeus的Fare_MasterPricerTravelBoardSearch服务查询票价时，默认仅返回总税额，无法获取具体税费明细。在20.2.1A版本中，可通过添加YQR参数触发服务返回税费明细，以下是具体配置方法及示例。

YQR参数配置方法 #

YQR属于定价请求类型标识，需在请求XML的<fareOptions> -> <pricingTickInfo> -> <pricingTicketing>节点下，新增<priceType>YQR</priceType>字段，以此告知服务需要返回详细税费信息。

修改后的请求XML示例 #

<?xml version="1.0" encoding="utf-8"?>
<Fare_MasterPricerTravelBoardSearch xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <numberOfUnit xmlns="http://xml.amadeus.com/FMPTBQ_20_2_1A">
        <unitNumberDetail>
            <numberOfUnits>1</numberOfUnits>
            <typeOfUnit>PX</typeOfUnit>
        </unitNumberDetail>
        <unitNumberDetail>
            <numberOfUnits>40</numberOfUnits>
            <typeOfUnit>RC</typeOfUnit>
        </unitNumberDetail>
    </numberOfUnit>
    <paxReference xmlns="http://xml.amadeus.com/FMPTBQ_20_2_1A">
        <ptc>IT</ptc>
        <traveller>
            <ref>1</ref>
        </traveller>
    </paxReference>
    <fareOptions xmlns="http://xml.amadeus.com/FMPTBQ_20_2_1A">
        <pricingTickInfo>
            <pricingTicketing>
                <priceType>XND</priceType>
                <priceType>MST</priceType>
                <priceType>RP</priceType>
                <priceType>RU</priceType>
                <priceType>ET</priceType>
                <priceType>XLC</priceType>
                <priceType>TAC</priceType>
                <priceType>CUC</priceType>
                <priceType>NAD</priceType>
                <!-- 添加YQR参数请求税费明细 -->
                <priceType>YQR</priceType>
            </pricingTicketing>
        </pricingTickInfo>
        <feeIdDescription>
            <feeId>
                <feeType>FFI</feeType>
                <feeIdNumber>3</feeIdNumber>
            </feeId>
            <feeId>
                <feeType>BYQ</feeType>
                <feeIdNumber>2</feeIdNumber>
            </feeId>
        </feeIdDescription>
        <conversionRate>
            <conversionRateDetail>
                <currency>COP</currency>
            </conversionRateDetail>
        </conversionRate>
    </fareOptions>
    <itinerary xmlns="http://xml.amadeus.com/FMPTBQ_20_2_1A">
        <requestedSegmentRef>
            <segRef>1</segRef>
        </requestedSegmentRef>
        <departureLocalization>
            <departurePoint>
                <locationId>BOG</locationId>
            </departurePoint>
        </departureLocalization>
        <arrivalLocalization>
            <arrivalPointDetails>
                <locationId>IST</locationId>
            </arrivalPointDetails>
        </arrivalLocalization>
        <timeDetails>
            <firstDateTimeDetail>
                <date>200324</date>
            </firstDateTimeDetail>
        </timeDetails>
    </itinerary>
</Fare_MasterPricerTravelBoardSearch>

返回结果说明 #

添加YQR参数后，服务返回的XML会在<paxFareProduct>节点下新增<taxDetails>集合，每个<taxDetails>节点包含具体税费的代码、金额、描述等信息，示例结构如下：

<taxDetails>
    <taxCode>US</taxCode>
    <taxAmount>12000</taxAmount>
    <taxDescription>US TRANSPORTATION TAX</taxDescription>
</taxDetails>
<taxDetails>
    <taxCode>XY</taxCode>
    <taxAmount>8000</taxAmount>
    <taxDescription>INTERNATIONAL ARRIVAL TAX</taxDescription>
</taxDetails>

原返回XML仅包含总税额<totalTaxAmount>1561770</totalTaxAmount>，添加参数后即可获取拆分后的明细数据。

内容的提问来源于stack exchange，提问作者devfaiber