Minor Update Notification - Hotel Buyers API (legacy) v1.2.73

đź’» Release Notes TGX APIs
,
1

Please be advised we are releasing an update regarding Hotel Buyers API that may affect you.

Minor changes on version v1.2.73

  • Added new RateRule “Negotiated” in Availability response.
  • Added new “Rate” node containing Description and Restriction for “Negotiated” rates in Availability response.
  • Added new node “Code” on Fees at Availability and Valuation responses.
  • Implemented new “Deadline” field on Cancellation Policies.
  • Implemented new “CalculatedDeadline” field on Cancellation Policies.
  • Added new TimeZone field on Metadata Valuation response.

Negotiated Rates

A new “Negociated Rate” has been added into our Rates. In order to allow clients to benefit from these specific rates, we’ve added extra information that provides the restrictiction about how this rate should be applied.

925Ă—344 8.33 KB

Before:

<RateRules>
   <Rules>
      <Rule type = "Negociated"/>
   </Rules>
</RateRules>

Now:

<RateRules>
   <Rules>
      <Rule type="Negociated">
         <Rates>
            <Rate Code="BAR">
               <Description>Bar description</Description>
               <Restrictions>
                  <Restriction Code="REP" type="Company">Repsol</Restriction>
                  <Restriction Code="MERC" type="Company">Mercadona</Restriction>
               </Restrictions>
            </Rate>
         </Rates>
      </Rule>
   </Rules>
</RateRules>

Fee code

To allow partners to identify certain fees, we’ve added a Code that identifies each one in an unique way.

915Ă—147 4.49 KB

Before:

<Fees>
   <Fee description="TaxAndServiceFee" includedPriceOption="true" mandatory="true" refundable="false">
      <Price amount="8.11" binding="false" commission="-1" currency="EUR"/>
   </Fee>
</Fees>

After:

<Fees>
   <Fee description="TaxAndServiceFee" includedPriceOption="true" mandatory="true" refundable="false">
      <Price amount="8.11" binding="false" commission="-1" currency="EUR"/>
      <Code>SPE</Code>
   </Fee>
</Fees>

Deadline and Timezone

In order to avoid misunderstandings we’ve made a few updates on CancellationPolicies. First of all, we’ve added a new field “Timezone” on Metadata.

In this Timezone (see the Metadata docs to check all possible values) it will specify the timezone in UTC in which the cancellation policies are situated. Keep in mind in case a buyer has any doubt about the treatment of your policies, they could add an offset to cover possible penalties and your product would be less competitive.

Additionally, we’ve added the new Deadline field on CancellationPolicies to give more precise information and avoid losing competitiveness. This field is not subjected to any ambiguity as it’s a date in UTC-0 Standard. The conversion of the date is made according to your response and the value specified on the Metadata TimeZone.

936Ă—207 10.6 KB

Also, we added a CalculatedDeadline field to specify if the Deadline has been taken from the supplier response or has been calculated by Travelgate.

Before:

<CancelPenalties nonRefundable="false">
   <CancelPenalty>
      <HoursBefore>0</HoursBefore>
      <Penalty currency="EUR" paymentType="MerchantPay" type="Importe">961.25</Penalty>
   </CancelPenalty>
</CancelPenalties>

<Valuation>
   <AllowsBlockOption reviewDate="20/06/2015">false</AllowsBlockOption>
   <InformBindingPrice reviewDate="20/06/2015">false</InformBindingPrice>
   <InformNRFRate reviewDate="20/06/2015">false</InformNRFRate>
   <InformRemarks reviewDate="20/06/2015">false</InformRemarks>
   <InformCancelPolicies reviewDate="20/06/2015">false</InformCancelPolicies>
   <InformCancelPoliciesDescription reviewDate="20/06/2015">false</InformCancelPoliciesDescription>
   <InformFees reviewDate="20/06/2015">false</InformFees>
</Valuation>

Now:

<CancelPenalties nonRefundable="false">
   <CancelPenalty>
      <HoursBefore>0</HoursBefore>
      <Penalty currency="EUR" paymentType="MerchantPay" type="Importe">961.25</Penalty>
      <Deadline>2021-12-16T05:00:00Z</Deadline>
      <CalculatedDeadline>false</CalculatedDeadline>
   </CancelPenalty>
</CancelPenalties>

<Valuation>
   <AllowsBlockOption reviewDate="20/06/2015">false</AllowsBlockOption>
   <InformBindingPrice reviewDate="20/06/2015">false</InformBindingPrice>
   <InformNRFRate reviewDate="20/06/2015">false</InformNRFRate>
   <InformRemarks reviewDate="20/06/2015">false</InformRemarks>
   <InformCancelPolicies reviewDate="20/06/2015">false</InformCancelPolicies>
   <InformCancelPoliciesDescription reviewDate="20/06/2015">false</InformCancelPoliciesDescription>
   <InformFees reviewDate="20/06/2015">false</InformFees>
   <TimeZone reviewDate="04/01/2022">[eUtc.Utc_Unknown|eUtc.HotelLocalTime|eUtc.Utc_-14|...|eUtc.Utc_0|...|eUtc.Utc_14]</TimeZone>
</Valuation>