Promociones

Descripción general

Esta API te permite especificar posibles descuentos. De las promociones especificadas, Google aplica la promoción apta o el conjunto de promociones que generan el precio más bajo. Si buscas una API que admita ajustes de frecuencia arbitrarios que puedan aumentar o disminuir el precio cuando se cumplan las condiciones, considera nuestra API de Modificaciones de tarifas. Ten en cuenta que, si ambas APIs están presentes, las modificaciones de tarifas se aplican antes que las promociones.

Solicitudes

Sintaxis

El mensaje Promotions usa la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner= "partner_key"
            id="message_ID"
            timestamp="timestamp">
  <HotelPromotions hotel_id="HotelID" action="[overlay]">
    <Promotion id="PromotionID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
      </BookingDates>
      <BookingWindow min="integer_or_duration" max="integer_or_duration"/>
      <Ceiling amount_per_night="float"/>
      <Floor amount_per_night="float"/>
      <CheckinDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckoutDates>
      <!-- Specify only one of percentage, fixed_amount, fixed_amount_per_night,
           fixed_price, or fixed_price_per_night; applied_nights is only used
           with percentage, fixed_amount_per_night, and fixed_price_per_night. -->
      <Discount percentage="float" fixed_amount="float" fixed_amount_per_night="float"
                fixed_price="float" fixed_price_per_night="float"
                applied_nights="integer_1_to_99" rank="integer_1_to_99">
        <!-- FreeNights may not be used in conjunction with attributes on Discount -->
        <FreeNights stay_nights="integer" discount_nights="integer"
                    discount_percentage="float" night_selection="[cheapest|last]"
                    repeats="boolean"/>
      </Discount>
      <!-- Exactly one of Discount or BestDailyDiscount must be specified.
           Specify only one of percentage, fixed_amount, or fixed_price. -->
      <BestDailyDiscount percentage="float" fixed_amount="float" fixed_price="float"/>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <InventoryCount min="integer" max="integer"/>
      <LengthOfStay min="integer" max="integer"/>
      <MembershipRateRule id="RateRuleID"/>
      <MinimumAmount before_discount="integer"/>
      <Occupancy min="integer" max="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <Stacking type="[any|base|none|second]"/>
      <StayDates application="[all|any|overlap]">
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

Elementos y atributos

El mensaje Promociones tiene los siguientes elementos y atributos:

Elemento / @Attribute Occurrences Tipo Descripción
Promotions 1 Complex element Es el elemento raíz de un mensaje de promociones.
Promotions / @partner 1 string Es la cuenta del socio de este mensaje. Este valor de string es el valor de “Clave de socio” que aparece en la página Configuración de la cuenta de Hotel Center.

Si tienes un backend que proporciona feeds para varias cuentas, este valor debe coincidir con el valor del atributo ID especificado en el elemento <RequestorID> de tus mensajes <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ> para la misma cuenta.
Promotions / @id 1 string Es un identificador único para este mensaje de solicitud. Este valor se muestra en el mensaje de respuesta. Los caracteres permitidos son a-z, A-Z, 0-9, _ (guion bajo) y - (guion).
Promotions / @timestamp 1 DateTime La fecha y hora de creación de este mensaje.
Promotions / HotelPromotions 0..n HotelPromotions

Promociones de una propiedad Cada promoción se aplica a una sola propiedad.

A menos que se use <Stacking>, la promoción con el mayor descuento se aplica a la reserva cuando son aptas varias promociones.
Promotions / HotelPromotions / @hotel_id 1 string Es el identificador único de la propiedad. Este valor debe coincidir con el ID de hotel especificado con <id> en el elemento <listing> del feed de lista de hoteles. El ID del hotel también aparece en Hotel Center.
Promotions / HotelPromotions / @action 0..1 enum

Si se especifica, el valor debe ser "overlay". Si el valor es "overlay", todas las promociones almacenadas se borran antes de almacenar las especificadas en el mensaje actual.

Si no se especifica, cada promoción especificada en el mensaje actual es una de las siguientes opciones:

  • Added (si ninguna de las promociones almacenadas tiene el mismo id)
  • Updated (si una promoción almacenada tiene el mismo id)
  • Deleted (si una promoción almacenada tiene el mismo id y el valor del atributo action de la promoción especificada en el mensaje actual es "delete")
Promotions / HotelPromotions / Promotion 0..99 Promotion

Es una promoción única para una propiedad. Ten en cuenta que si no se especifica action="overlay" ni <Promotion>, se borrarán todas las promociones de la propiedad.

Si necesitas usar más de 99 promociones, comunícate con tu administrador técnico de cuentas (TAM).
Promotions / HotelPromotions / Promotion / @id 1 string Es un identificador único para la promoción. La cantidad máxima de caracteres permitida es 40. Los caracteres permitidos son a-z, A-Z, 0-9, _ (guion bajo), - (guion) y . (punto).
Promotions /HotelPromotions / Promotion / @action 0..1 enum

Si se especifica, el valor debe ser delete. Si no se especifica y no se almacena una promoción con el mismo id, se almacenará esta promoción. De lo contrario, si no se especifica y se almacena una promoción con el mismo id, se actualiza la promoción existente.

Si se especifica un delete, se borra la promoción almacenada con el mismo id. Cuando uses delete, no incluyas ningún elemento secundario en <Promotion>. Además, no se permite delete junto con <HotelPromotions action="overlay"/>.
Promotions / HotelPromotions / Promotion / BookingDates 0..1 BookingDates Es un contenedor de uno o más intervalos que define cuándo se debe realizar la reserva para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange 1..99 DateRange Es un rango que especifica cuándo debe realizarse la reserva para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @start 0..1 Date o DateTime

La fecha y hora de inicio (según la zona horaria de la propiedad), inclusive, del rango.

  • La fecha o la fecha y hora especificada por start debe ser anterior (o igual) a la fecha o la fecha y hora especificada por end.
  • Si no se especifica start, el rango es efectivamente ilimitado en términos de una hora de inicio.
  • Si start se propaga como fecha “AAAA-MM-DD”, se interpreta como fecha y hora “AAAA-MM-DDT00:00:00”.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @end 0..1 Date o DateTime

La fecha y hora de finalización (según la zona horaria de la propiedad), inclusive, del rango.

  • La fecha o la fecha y hora especificada por end debe ser posterior (o igual) que la fecha o fecha y hora especificada por start.
  • Si no se especifica end, el rango es efectivamente ilimitado en términos de una hora de finalización.
  • Si end se proporciona como fecha “AAAA-MM-DD”, se interpreta como fecha y hora “AAAA-MM-DDT23:59:59”.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @days_of_week 0..1 string

Indica los días de la semana que se permiten en el período. Si no se especifica, se permiten todos los días del período. Cada carácter de la string especifica un día. Por ejemplo, “MTWHF” especifica que los días de la semana están permitidos en el período.

Los caracteres válidos son los siguientes:

  • M para el lunes
  • T para el martes
  • W para el miércoles
  • H para el jueves
  • F para el viernes
  • S para el sábado
  • U para el domingo

Cualquier combinación de caracteres es válida.
Promotions / HotelPromotions / Promotion / BookingWindow 0..1 BookingWindow Especifica el período en el que debe realizarse la reserva en relación con la fecha de entrada (según la zona horaria de la propiedad). Por ejemplo, el período de reserva se puede establecer en 7 días como mínimo, pero no más de 180 días, antes de hacer el check-in.
Promotions / HotelPromotions / Promotion / BookingWindow / @min 0..1 integer or duration Es la duración mínima antes de hacer el check-in, cuando se debe realizar la reserva para que se aplique la promoción. Si no se especifica este valor, o su valor es 0, no hay un mínimo.

Los tipos de valor válidos son los siguientes:

  • Número entero: La cantidad de días antes de la fecha de entrada Por ejemplo, un valor de 30 indica que la promoción solo se aplica a las reservas que se realicen con al menos 30 días de anticipación de la fecha de entrada.
  • Duración en formato ISO 8601 (días, horas y minutos): La cantidad de días (y, opcionalmente, horas o minutos) antes de la fecha de entrada. Por ejemplo, un valor de P30D indica que la promoción solo se aplica a las reservas que se realizan con al menos 30 días de anticipación a la fecha de entrada. Un valor de P30DT6H requiere una reserva para el día 30 antes de la llegada a las 6:00 p.m. o antes.
Promotions / HotelPromotions / Promotion / BookingWindow / @max 0..1 integer or duration Es la cantidad máxima de días previos al registro de entrada en los que se debe realizar la reserva para que se aplique la promoción. Si no se especifica este valor, o si su valor es 0, no hay un máximo.

Los tipos de valor válidos son los siguientes:

  • Número entero: La cantidad de días antes de la fecha de entrada Por ejemplo, un valor de 30 indica que la promoción solo se aplica a las reservas que se realicen, como máximo, 30 días antes de la fecha de entrada.
  • Duración en formato ISO 8601 (días, horas y minutos): La cantidad de días (y, opcionalmente, horas o minutos) antes de la fecha de entrada. Por ejemplo, un valor de P30D indica que la promoción solo se aplica a las reservas que se realicen con un máximo de 30 días antes de la fecha de entrada. Un valor de P30DT6H requiere una reserva a partir de las 6:00 p.m. del día 30 antes de la llegada.
Promotions / HotelPromotions / Promotion / Ceiling 0..1 Ceiling

Define las restricciones del valor máximo al que se puede establecer una tarifa después de que se aplican las promociones.

Las promociones siempre deben especificar un <Discount> o un <BestDailyDiscount>, de modo que, para crear una promoción que solo aplique un <Ceiling>, una opción es establecer un <Discount> con un percentage de 0.

Si se configura el apilamiento, se podrían aplicar varias promociones con <Ceiling> a una sola estadía. Cada promoción aplica su descuento, seguido inmediatamente de su límite. En el siguiente ejemplo, se muestra cómo cada límite contribuye al siguiente cálculo de promoción en la pila.

Ejemplo:

Se establece un precio para una estadía de 1 noche, en la que AmountBeforeTax es de 100 y hay una pila de dos promociones:

  1. Promoción con el tipo de apilado base, una fixed_amount de 25 y un amount_per_night de techo de 60.
  2. Promoción con tipo de apilado second, fixed_amount de 25 y un amount_per_night de techo de 90

Este es el orden de cálculo:

  1. Primero se aplica la promoción base y aplica un descuento de AmountBeforeTax a 75, pero luego el límite lo reduce a 60.
  2. Con la promoción second, los AmountBeforeTax descienden de 60 a 35. Es inferior al límite de 90, por lo que no se aplica el segundo límite. La tarifa final es de 35.

El hecho de que 60 sea un límite general más estricto es irrelevante, ya que solo es válido para su propia promoción y no puede haber ningún límite único que abarque toda la pila de promociones.
Promotions / HotelPromotions / Promotion / Ceiling / @amount_per_night 1 float

El importe máximo al que se puede establecer una tarifa por noche después de que se aplique el descuento.

Si también se especifica un elemento <Floor>, se debe establecer en un valor mayor o igual que el atributo amount_per_night de <Floor>.

amount_per_night se aplica a impuestos y tarifas cuando se incluyen en la tarifa por noche mediante AmountAfterTax, pero no en aquellos especificados mediante TaxFeeInfo.
Promotions / HotelPromotions / Promotion / Floor 0..1 Floor

Define las restricciones del valor mínimo al que se puede establecer una tarifa después de que se aplican las promociones.

Las promociones siempre deben especificar un <Discount> o un <BestDailyDiscount>, de modo que, para crear una promoción que solo aplique un <Floor>, una opción es establecer un <Discount> con un percentage de 0.

La lógica de <Floor> aún se aplica a los descuentos de <FreeNights>, incluso si se aplica un descuento de 100% a la noche gratis.

Si se configura el apilamiento, se podrían aplicar varias promociones con <Floor> a una sola estadía. Cada promoción aplicaría su descuento, seguido inmediatamente de su precio mínimo. En el siguiente ejemplo, se muestra cómo cada precio mínimo contribuye al siguiente cálculo de promoción de la pila.

Ejemplo:

Se establece un precio para una estadía de 1 noche, en la que AmountBeforeTax es de 100 y hay una pila de dos promociones:

  1. Promoción con el tipo de apilado base, una fixed_amount de 25 y un precio mínimo amount_per_night de 90
  2. Promoción con el tipo de apilado second, fixed_amount de 25 y un precio mínimo amount_per_night de 60

Este es el orden de cálculo:

  1. Primero se aplica la promoción base y se descuenta el AmountBeforeTax a 75, pero luego el precio mínimo lo aumenta a 90.
  2. Con la promoción second, se descuentan los AmountBeforeTax de 90 a 65. Esta cantidad es superior al piso de 60, por lo que no se aplica el segundo piso. La tarifa final es de 65.

El hecho de que 90 sea un precio mínimo más estricto es irrelevante, ya que solo es válido para su propia promoción, y no puede haber ningún precio mínimo que abarque toda la pila de promociones.
Promotions / HotelPromotions / Promotion / Floor / @amount_per_night 1 float

Es el importe mínimo que se puede establecer en una tarifa por noche después de aplicar el descuento.

Si también se especifica un elemento <Ceiling>, se debe establecer en un valor menor o igual que el atributo amount_per_night de <Ceiling>.

amount_per_night se aplica a impuestos y tarifas cuando se incluyen en la tarifa por noche mediante AmountAfterTax, pero no en aquellos especificados mediante TaxFeeInfo.
Promotions / HotelPromotions / Promotion / CheckinDates 0..1 CheckinDates Es un contenedor para uno o más períodos que definen cuándo debe registrarse para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange 1..20 DateRange

Es un período que especifica cuándo debe registrarse para que se aplique la promoción. Este elemento no es obligatorio si borras una o más promociones.

También se admite el formato YearlessDate.

  • Si una de las fechas de start o end es sin año, ambas se deben propagar como fechas sin año.
  • Los períodos sin año no deben coincidir con el año nuevo. En cambio, representa el período como dos períodos adyacentes. Por ejemplo, {"12-29", "01-05"} se puede representar como {"12-29", "12-31"} y {"01-01", "01-05"}.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @start 0..1 Date or YearlessDate La fecha de inicio (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser anterior o igual a la fecha de end. Si no se especifica start, el período es efectivamente ilimitado en términos de una fecha de inicio.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @end 0..1 Date or YearlessDate La fecha de finalización (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser la misma que la fecha de start o posterior a ella. Si no se especifica end, el período es efectivamente ilimitado en términos de una fecha de finalización.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @days_of_week 0..1 string

Indica los días de la semana que se permiten en el período. Si no se especifica, se permiten todos los días del período. Cada carácter de la string especifica un día. Por ejemplo, “MTWHF” especifica que los días de la semana están permitidos en el período.

Los caracteres válidos son los siguientes:

  • M para el lunes
  • T para el martes
  • W para el miércoles
  • H para el jueves
  • F para el viernes
  • S para el sábado
  • U para el domingo

Cualquier combinación de caracteres es válida.
Promotions / HotelPromotions / Promotion / CheckoutDates 0..1 CheckoutDates Es un contenedor para uno o más períodos que definen cuándo debe ocurrir la salida para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange 1..20 DateRange

Es un período que especifica cuándo debe ocurrir la salida para que se aplique la promoción. Este elemento no es obligatorio si borras una o más promociones.

También se admite el formato YearlessDate.

  • Si una de las fechas de start o end no tiene año, se deben propagar como fechas sin año.
  • Los períodos sin año no deben coincidir con el año nuevo. En cambio, representa el período como dos períodos adyacentes. Por ejemplo, {"12-29", "01-05"} se puede representar como {"12-29", "12-31"} y {"01-01", "01-05"}.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @start 0..1 Date or YearlessDate La fecha de inicio (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser anterior o igual a la fecha de end. Si no se especifica start, el período es efectivamente ilimitado en términos de una fecha de inicio.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @end 0..1 Date or YearlessDate La fecha de finalización (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser la misma que la fecha de start o posterior a ella. Si no se especifica end, el período es efectivamente ilimitado en términos de una fecha de finalización.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @days_of_week 0..1 string

Indica los días de la semana que se permiten en el período. Si no se especifica, se permiten todos los días del período. Cada carácter de la string especifica un día. Por ejemplo, “MTWHF” especifica que los días de la semana están permitidos en el período.

Los caracteres válidos son los siguientes:

  • M para el lunes
  • T para el martes
  • W para el miércoles
  • H para el jueves
  • F para el viernes
  • S para el sábado
  • U para el domingo

Cualquier combinación de caracteres es válida.
Promotions / HotelPromotions / Promotion / Devices 0..1 Devices Contenedor en el que se muestran los dispositivos de los usuarios que son aptos para la promoción. Si se especifica, la tarifa con descuento solo se ofrecerá a los usuarios aptos que tengan los dispositivos de la lista. Si no se especifica, se ofrece la tarifa con descuento a los usuarios aptos de cualquier dispositivo.
Promotions / HotelPromotions / Promotion / Devices / Device 1..3 Device Define un tipo de dispositivo de usuario que es apto para la promoción.
Promotions / HotelPromotions / Promotion / Devices / Device / @type 1 enum Es un tipo de dispositivo. El valor debe ser desktop, tablet o mobile.
Promotions / HotelPromotions / Promotion / Discount 1 Discount

Se debe especificar con exactitud uno de los valores Discount o BestDailyDiscount.

Especifica el descuento que se aplicará a esta promoción.
Promotions / HotelPromotions / Promotion / Discount / @percentage 0..1 float

Se requiere percentage, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Un valor decimal de 0 a 100 que especifica el porcentaje de descuento. Se aplica a AmountAfterTax (o a AmountBeforeTax si no se especifica AmountAfterTax).

Ejemplos:

  • Si AmountAfterTax es 100 y percentage es 20, entonces

    tarifa de promoción = AmountAfterTax * (1 - porcentaje de descuento)

    80.00 = 100 * (1 - 0.2)

  • Si AmountBeforeTax es 100, percentage es 20 y TaxFeeInfo especifica un impuesto de 10.

    tarifa promocional = AmountBeforeTax × (1 - porcentaje de descuento) + impuestos

    90.00 = 100 * (1 - 0.2) + 10
Promotions / HotelPromotions / Promotion / Discount / @fixed_amount 0..1 float

Se requiere percentage, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Es un importe fijo que se restará de la suma de las tarifas por noche de AmountAfterTax (o la suma de las tarifas por noche de AmountBeforeTax si no se especifica AmountAfterTax). Se supone que está en la misma moneda que las tarifas por noche. Si es mayor que la suma de las tarifas por noche, el valor resultante es cero.

Ejemplos:

  • Si fijamos el precio de una estadía de 1 noche en la que AmountBeforeTax es 90, AmountAfterTax es 100 y fixed_amount es 20, entonces,

    tarifa de promoción = AmountAfterTax (descuento fijo)

    80.00 = 100 - 20

  • Si fijamos un precio para una estadía de 1 noche en la que AmountBeforeTax es 100, fixed_amount es 20 y TaxFeeInfo especifica un impuesto del 8%, entonces

    tarifa promocional = (AmountBeforeTax: descuento fijo) * (1 + porcentaje de impuestos)

    86.40 = (100 - 20) * 1.08

  • Si fijamos un precio para una estadía de 1 noche en la que AmountBeforeTax es 50, fixed_amount es 60 y TaxFeeInfo especifica un impuesto de 10, entonces

    tarifa promocional = (AmountBeforeTax: descuento fijo) * impuestos

    10.00 = 0 + 10

  • Si fijamos el precio de una estadía de 3 noches en la que los valores de AmountAfterTax son 100, 110 y 120, y fixed_amount es 150, entonces

    porcentaje de promoción = suma(AmountAfterTax) - (descuento fijo)

    180.00 = (100 + 110 + 120) - 150
Promotions / HotelPromotions / Promotion / Discount / @fixed_amount_per_night 0..1 float

Se requiere percentage, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Es un descuento fijo que se aplica a cada una de las tarifas por noche de AmountAfterTax (o el N más económico si se especifica applied_nights). Si no se especifica AmountAfterTax, se aplica a AmountBeforeTax. Se supone que está en la misma moneda que las tarifas por noche. Si fixed_amount_per_night es mayor que una tarifa por noche, esta se reduce a cero; el descuento no puede hacer que una tarifa por noche sea negativa.

Ejemplos:

  • Si fijamos el precio de una estadía de 3 noches en la que los valores de AmountAfterTax son 100, 110 y 120, y el fixed_amount_per_night es 10, entonces

    porcentaje de promoción = suma(AmountBeforeTax - descuento de importe fijo)

    300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

  • Si fijamos el precio de una estadía de 3 noches en la que los valores de AmountAfterTax son 10, 50 y 100, y el fixed_amount_per_night es 20, entonces

    porcentaje de promoción = suma(AmountAfterTax - descuento de importe fijo)

    110.00 = (0 + (50 - 20) + (100 - 20))
Promotions / HotelPromotions / Promotion / Discount / @fixed_price 0..1 float

Se requiere percentage, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Si se especifican tarifas por noche de AmountAfterTax, se establecerá el precio de la estadía (incluidos los impuestos y las tarifas) en el valor especificado. Si se especifica AmountBeforeTax, independientemente de si se especifica AmountAfterTax o no, se establecerá el precio antes de impuestos de la estadía en el valor especificado. Se supone que está en la misma moneda que las tarifas por noche.

Si el objetivo de AmountAfterTax es reflejar un porcentaje de impuesto, establecer un precio fijo para AmountBeforeTax puede generar impuestos y tarifas inexactos. En general, se recomienda usar TaxFeeInfo para especificar los impuestos y las tarifas de una propiedad.

Ejemplos:

  • Si fijamos un precio para una estadía de 1 noche en la que AmountBeforeTax es 90, AmountAfterTax es 100 y fixed_price es 80, la tarifa promocional es de 80.
  • Si fijamos un precio para una estadía de 1 noche en la que AmountBeforeTax es 100, fixed_amount es 80 y TaxFeeInfo especifica un impuesto del 8%, entonces

    tarifa promocional = precio fijo * (1 + porcentaje de impuesto)

    86.40 = 80 * 1.08

  • Si fijamos el precio de una estadía de 3 noches en la que los valores de AmountAfterTax son 100, 110 y 120, y fixed_amount es 300, entonces

    porcentaje de promoción = 300
Promotions / HotelPromotions / Promotion / Discount / @fixed_price_per_night 0..1 float

Se requiere percentage, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Si se especifican tarifas por noche de AmountAfterTax, el precio de cada noche de estadía (incluidos los impuestos y las tarifas) se fijará en el valor especificado. Si se especifica AmountBeforeTax, sin importar si se especifica AmountAfterTax, esto establece el precio sin impuestos para cada noche de estadía en el valor especificado. Se supone que está en la misma moneda que las tarifas por noche.

Si el objetivo de AmountAfterTax es reflejar un porcentaje de impuesto, establecer un precio fijo para AmountBeforeTax puede generar impuestos y tarifas inexactos. En general, se recomienda usar TaxFeeInfo para especificar los impuestos y las tarifas de una propiedad.

Si se especifica un valor de applied_nights, el precio nuevo se aplica a las N noches más económicas.

Ejemplos:

  • Si fijamos el precio de una estadía de 2 noches en la que los valores de AmountBeforeTax son 90, 90, los valores de AmountAfterTax son 100, 100 y fixed_price es 80, la tarifa promocional es de 80 + 80 = 160.
  • Si fijamos el precio de una estadía de 2 noches en la que AmountBeforeTax es 100, 100; fixed_amount es 80 y TaxFeeInfo especifica un impuesto del 8%, entonces la tasa de promoción es (80 + 80) × 1.08 = 172.8.
  • Si fijamos el precio de una estadía de 3 noches en la que los valores de AmountAfterTax son 100, 110 y 120, y fixed_amount es 110, la tarifa promocional es de 110 * 3 = 330.
Promotions / HotelPromotions / Promotion / Discount / @applied_nights 0..1 integer

Solo debe usarse con percentage o fixed_amount_per_night.

La cantidad de noches a las que se aplica el descuento, empezando por la menos costosa. Debe ser un número entero entre 1 y 99. Si no se especifica, el descuento se aplica a todas las noches.
Promotions / HotelPromotions / Promotion / Discount / FreeNights 0..1 FreeNights Especifica un descuento para ciertas noches de una estadía cuando se alcanza una duración mínima de la estadía. Si se usa este elemento, no se permiten atributos del elemento Discount superior.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @stay_nights 1 integer

Cantidad de noches requeridas para que se aplique el descuento. Cada descuento se aplica a un segmento distinto de noches de estadía.

Por ejemplo, para una estadía de 10 noches en la que stay_nights es 4 (y repeats es verdadero), hay dos segmentos de noches de la estadía: la noche desde la 1a hasta la 4a y la 5a a la 8a noches; las noches 9 y 10 no forman parte del segmento de noches de estadía.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_nights 1 integer Es la cantidad de noches con descuento en cada segmento de noches de estadía.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_percentage 1 float Descuento que se aplica a las noches de descuento. Si este valor es 50, cada noche seleccionada tiene un 50% de descuento.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @night_selection 1 string Debe ser cheapest o last. Si el valor es last, las noches al final del segmento de noches de estadía tendrán un descuento. Si es cheapest, se descuentan las noches más económicas dentro del segmento de noches de estadía.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @repeats 1 boolean

Indica si el descuento se puede aplicar a varios segmentos nocturnos de estadía. Si es false, solo se descuenta el segmento de noches de estadía al comienzo del itinerario. Si es true, se descuenta cualquier segmento de noches de estadía.

Por ejemplo, si stay_nights es 4 y el itinerario es 10 noches, si repeats es true, se descontarán 2 segmentos (noches 1 a 4 y noches 5 a 8); pero, si repeats es false, solo se descontará 1 segmento (noches 1 a 4).
Promotions / HotelPromotions / Promotion / Discount / @rank 0..1 integer Asigna una clasificación a esta promoción y la habilita en la selección de clasificación, en la que solo se selecciona la promoción con la clasificación más baja. Los valores deben estar entre 1 y 99, ambos inclusive. Si varias promociones comparten la misma clasificación, se selecciona y aplica una de manera arbitraria.
Promotions / HotelPromotions / Promotion / BestDailyDiscount 1 Discount

Se debe especificar con exactitud uno de los valores Discount o BestDailyDiscount.

Especifica un descuento diario que se puede aplicar a una noche de estadía. Esto se diferencia de Discount, que aplica descuentos a estadías completas.

Cada propiedad puede tener un solo grupo de promociones que se consideran “mejores diarias”. Esto significa que, por cada noche de estadía, se selecciona y se puede aplicar la única promoción "mejor diaria" que sea apta y produzca el mayor descuento para esa noche.

Stacking no se puede especificar con BestDailyDiscount. Los "mejores descuentos diarios" que generan el descuento más significativo para cada noche se combinan y se tratan como un descuento por estadía única (es decir, Discount) con el tipo de apilado establecido en base. Este descuento combinado se compara con otras promociones de <Discount> aptas, y se puede combinar con ellas, para encontrar la que proporciona el descuento más significativo. Se selecciona la combinación de BestDailyDiscount o una sola Discount (la que genere el precio más bajo) y se aplica al tipo de apilado base.

Se puede especificar StayDates con este tipo de descuento, pero application debe establecerse en overlap

.
Promotions / HotelPromotions / Promotion / BestDailyDiscount / @percentage 0..1 float

Se requiere exactamente uno de percentage, fixed_amount o fixed_price.

Un valor decimal de 0 a 100 que especifica el porcentaje de descuento. Se aplica a AmountAfterTax (o a AmountBeforeTax si no se especifica AmountAfterTax).

Ejemplos:

  • Si el valor de AmountAfterTax por una noche de estadía es de 100 y percentage es de 20, entonces

    tarifa de promoción = AmountAfterTax * (1 - porcentaje de descuento)

    80.00 = 100 * (1 - 0.2)

  • Si AmountBeforeTax para un período de estadía es 100, percentage es 20 y TaxFeeInfo especifica un impuesto de 10.

    tarifa promocional = AmountBeforeTax × (1 - porcentaje de descuento) + impuestos

    90.00 = 100 * (1 - 0.2) + 10
Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_amount 0..1 float

Se requiere exactamente uno de percentage, fixed_amount o fixed_price.

Un importe fijo que se restará de una tarifa única por noche de AmountAfterTax (o de AmountBeforeTax si no se especifica AmountAfterTax). Se supone que está en la misma moneda que las tarifas por noche. Si es mayor que la suma de las tarifas por noche, el valor resultante es cero.

Ejemplos:

  • Si AmountBeforeTax para una sola noche es 90, AmountAfterTax es 100 y fixed_amount es 20, entonces,

    tarifa de promoción = AmountAfterTax (descuento fijo)

    80.00 = 100 - 20

  • Si AmountBeforeTax para una sola noche es 100, fixed_amount es 20 y TaxFeeInfo especifica un impuesto del 8%.

    tarifa promocional = (AmountBeforeTax: descuento fijo) * (1 + porcentaje de impuestos)

    86.40 = (100 - 20) * 1.08
Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_price 0..1 float

Se requiere exactamente uno de percentage, fixed_amount o fixed_price.

Si se especifican tarifas por noche de AmountAfterTax, el precio de la noche de estadía, incluidos los impuestos y las tarifas, se fijará en el valor especificado. Si se especifica AmountBeforeTax, independientemente de si se especifica AmountAfterTax o no, se establecerá el precio antes de impuestos de la estadía en el valor especificado. Se supone que está en la misma moneda que las tarifas por noche.

Ejemplos:

  • Si AmountBeforeTax para una sola noche es 90, AmountAfterTax es 100 y fixed_price es 80, la tarifa promocional es de 80.
  • Si AmountBeforeTax para una sola noche es 100, fixed_amount es 80 y TaxFeeInfo especifica un impuesto del 8%;

    tarifa promocional = precio fijo * (1 + porcentaje de impuesto)

    86.40 = 80 * 1.08
Promotions / HotelPromotions / Promotion / InventoryCount 0..1 InventoryCount Define las restricciones sobre la cantidad de salas de reuniones que deben estar disponibles para que se aplique esta promoción. El descuento se aplica solo a las noches que cumplen con la restricción. No se permite con el descuento de fixed_amount. Ten en cuenta que la cantidad de habitaciones disponibles se especifica con OTA_HotelInvCountNotifRQ (InvCount) o bien OTA_HotelAvailNotifRQ (BookingLimit).
Promotions / HotelPromotions / Promotion / InventoryCount / @min 0..1 integer Cantidad mínima de habitaciones que deben estar disponibles para que se aplique la promoción a la tarifa por noche. Si no se especifica, no hay un mínimo.
Promotions / HotelPromotions / Promotion / InventoryCount / @max 0..1 integer Corresponde a la cantidad máxima de habitaciones que deben estar disponibles para que se aplique la promoción a la tarifa por noche. Si no se especifica, no hay un máximo.
Promotions / HotelPromotions / Promotion / LengthOfStay 0..1 LengthOfStay Define los límites de duración de la estadía dentro de los que se puede aplicar esta promoción. La promoción no se aplica cuando la duración de la estadía supera los límites mínimo y máximo.
Promotions / HotelPromotions / Promotion / LengthOfStay / @min 0..1 integer Es la cantidad mínima de noches permitidas en la estadía para que se aplique la promoción. Si no se especifica, no hay un mínimo.
Promotions / HotelPromotions / Promotion / LengthOfStay / @max 0..1 integer Es la cantidad máxima de noches permitidas en la estadía para que se aplique la promoción. Si no se especifica, no hay un máximo.
Promotions / HotelPromotions / Promotion / MembershipRateRule 0..1 MembershipRateRule

Contenedor de una regla de tarifas de membresía que activa un tratamiento de IU específico para el descuento asociado.

No se debe especificar este elemento, a menos que también se especifique <Discount>.
Promotions / HotelPromotions / Promotion / MembershipRateRule / @id 1 string

Es el ID de la regla de tarifas asociada con un programa de membresías.
Promotions / HotelPromotions / Promotion / MinimumAmount 0..1 MinimumAmount Especifica la suma mínima de las tarifas diarias de las habitaciones (con la tarifa más grande de AmountBeforeTax o AmountAfterTax) que se debe superar para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / MinimumAmount / @before_discount 1 integer Valor que se debe superar para que se aplique la promoción.
Promotions / HotelPromotions / Promotion / Occupancy 0..1 Occupancy Define las restricciones de las ocupación para las que se aplica esta promoción. La promoción no se aplica cuando la ocupación está fuera de los límites mínimos y máximos.
Promotions / HotelPromotions / Promotion / Occupancy / @min 0..1 integer La ocupación especificada por el usuario debe ser de al menos este valor para que se aplique el descuento.
Promotions / HotelPromotions / Promotion / Occupancy / @max 0..1 integer La ocupación especificada por el usuario debe ser, como máximo, este valor para que se aplique el descuento.
Promotions / HotelPromotions / Promotion / RatePlans 0..1 RatePlans Contenedor de una lista de planes de tarifas a los que se aplica la promoción. Si no se especifica un valor de <RatePlans>, la promoción se aplica a todos los planes de tarifas.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan 1..n RatePlan Especifica un plan de tarifas. Un plan de tarifas se define mediante una combinación de paquetes, tarifas y disponibilidad, tal como se definen en los mensajes de transacción (datos de propiedad), OTA_HotelRateAmountNotifRQ y OTA_HotelAvailNotifRQ, y según lo identificado por el PackageID.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan / @id 1 string Es el identificador único del plan de tarifas. Este valor se asigna al valor de PackageID de <PackageData> en un mensaje de Transacción (datos de propiedad) y al atributo RatePlanCode de <StatusApplicationControl> en los mensajes <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ>. La cantidad máxima de caracteres permitida es 50.
Promotions / HotelPromotions / Promotion / RoomTypes 0..1 RoomTypes Contenedor para una lista de los tipos de habitaciones a los que se aplica la promoción. La promoción se aplica a cada <RoomType> especificado. Si no se especifica <RoomTypes>, la promoción se aplica a todas las salas.
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType 1..n RoomType Especifica un tipo de habitación. Un tipo de habitación se define en un elemento <RoomData> en un mensaje de Transacción (datos de propiedad) y se hace referencia a él mediante su valor <RoomID>. (El atributo InvTypeCode también hace referencia a su valor <RoomID> en los mensajes OTA_HotelRateAmountNotifRQ).
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType / @id 1 string Es el identificador único del inventario (tipo de habitación). Este valor se asigna a <RoomID> en un mensaje de transacción (datos de propiedad). La cantidad máxima de caracteres permitida es 50.
Promotions / HotelPromotions / Promotion / Stacking 0..1 Stacking Especifica cómo se pueden combinar las promociones. Si no se especifica, se supone que el "tipo" es base.
Promotions / HotelPromotions / Promotion / Stacking / @type 1 enum

Se pueden aplicar varias promociones a una sola tarifa según este parámetro de configuración:

  • any: Se puede combinar con cualquier otra promoción (excepto none), pero no se garantiza el orden en el que se deben aplicar.
  • base: Se selecciona la mejor promoción apta de base y se aplica primero, antes que las demás. Anteriormente, se llamaba base_only.
  • second: Se selecciona la mejor promoción apta de second y se aplica después de una promoción de base (si corresponde) y antes de las promociones de any.
  • none: No se puede combinar con otras promociones.

De las combinaciones permitidas, se aplica a la tarifa el conjunto de promociones que generan el mayor descuento.
Promotions / HotelPromotions / Promotion / StayDates 0..1 StayDates Es un contenedor para uno o más períodos que determinan cómo se aplica la promoción, por ejemplo, para incluir descuentos de temporada.
Promotions / HotelPromotions / Promotion / StayDates / @application 1 enum

Describe cómo se debe aplicar la promoción.

Estos son los valores válidos:

  • all: Aplica la promoción a todas las noches del itinerario si todas las fechas del itinerario se superponen con las de la estadía.
  • any: Aplica la promoción a todas las noches del itinerario si alguna fecha del itinerario se superpone con una del período de la estadía.
  • overlap: Aplica la promoción solo a las noches del itinerario que se superpongan con una fecha del período de la estadía.

Este atributo siempre se debe especificar.

  • Si <Discount> especifica percentage y application se establece en all o any, el descuento se aplica como un porcentaje de la estadía completa.
  • Si <Discount> especifica percentage y application se establece en overlap, el descuento se aplica como un porcentaje de las tarifas por noche para las noches superpuestas.
  • <Discount> que especifica fixed_amount y application establecido en overlap es una combinación no válida.
  • <FreeNights> admite todos los valores de application. Ten en cuenta que, en el caso de overlap, solo se consideran las noches de estadía superpuestas para los requisitos de descuento.
Promotions / HotelPromotions / Promotion / StayDates / DateRange 1..99 DateRange

Es un período que especifica las fechas en las que se aplicará la promoción.

También se admite el formato YearlessDate.

  • Si una de las fechas de start o end no tiene año, se deben propagar como fechas sin año.
  • Los períodos sin año no deben coincidir con el año nuevo. En cambio, representa el período como dos períodos adyacentes. Por ejemplo, {"12-29", "01-05"} se puede representar como {"12-29", "12-31"} y {"01-01", "01-05"}.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @start 0..1 Date or YearlessDate La fecha de inicio (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser anterior o igual a la fecha de end. Si no se especifica start, el período es efectivamente ilimitado en términos de una fecha de inicio.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @end 0..1 Date or YearlessDate La fecha de finalización (según la zona horaria de la propiedad), incluida la fecha del período. Esta fecha debe ser la misma que la fecha de start o posterior a ella. Si no se especifica end, el período es efectivamente ilimitado en términos de una fecha de finalización.
Promotions / HotelPromotions / Promotion / StayDates / DateRange / @days_of_week 0..1 string

Indica los días de la semana que se permiten en el período. Si no se especifica, se permiten todos los días del período. Cada carácter de la string especifica un día. Por ejemplo, “MTWHF” especifica que los días de la semana están permitidos en el período.

Los caracteres válidos son los siguientes:

  • M para el lunes
  • T para el martes
  • W para el miércoles
  • H para el jueves
  • F para el viernes
  • S para el sábado
  • U para el domingo

Cualquier combinación de caracteres es válida.
Promotions / HotelPromotions / Promotion / UserCountries 0..1 UserCountries Contenedor para mostrar una lista de las ubicaciones de los usuarios (países) que son aptas para la promoción. Si se especifica, la tarifa con descuento solo se ofrecerá a los usuarios aptos de los países de la lista. Si no se especifica, se ofrece la tarifa con descuento a los usuarios aptos de cualquier país.
Promotions / HotelPromotions / Promotion / UserCountries / @type 0..1 enum Es el tipo de especificación UserPaíses.

Los valores válidos son include y exclude.

Si el type de UserPaíses se establece como include, la promoción se aplica a los usuarios de los países enumerados.

Si el type de UserPaíses es exclude, la promoción se aplica a usuarios que no residen en los países enumerados.

Si no estableces el campo type UserPaíses, se tratará como include y la promoción se aplicará a los usuarios de los países enumerados.
Promotions / HotelPromotions / Promotion / UserCountries / Country 1..300 Country Define un país en el que los usuarios son aptos para la promoción.
Promotions / HotelPromotions / Promotion / UserCountries / Country / @code 1 string Un código de país de CLDR, como DE o FR. Ten en cuenta que, para algunos países, el código de país CLDR no es el mismo que el código de país ISO de 2 letras. Tampoco se admiten los códigos regionales de CLDR.

Ejemplos

Mensaje básico

En el siguiente ejemplo, se muestra un mensaje Promotions básico:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01" end="2020-07-31" days_of_week="MTWHF"/>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2020-10-01" end="2020-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2020-10-08" end="2020-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <Discount percentage="20" applied_nights="2"/>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <Stacking type="base"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

Condición de inventario

En el siguiente ejemplo, se muestra cómo crear un descuento si hay un inventario excedente cerca de la fecha de llegada:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow max="7"/>
      <Discount percentage="10"/>
      <InventoryCount min="3"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Cómo borrar una promoción

En el siguiente ejemplo, se muestra cómo borrar una promoción de una propiedad:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

Borrar todas las promociones

En el siguiente ejemplo, se muestra cómo borrar todas las promociones de una propiedad:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>


Superponer todas las promociones

En el siguiente ejemplo, se muestra cómo superponer <HotelPromotions> para una propiedad con una o más promociones nuevas. Cuando es action="overlay", todas las promociones almacenadas se borran antes de almacenar las promociones especificadas en el mensaje actual:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <Discount percentage="10"/>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <Stacking type="base"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

3 tipos de apilado diferentes

En el siguiente ejemplo, se muestra un caso en el que se aplicarían tres promociones diferentes (base, second, any). Ten en cuenta que no se aplicaría la promoción none, ya que las otras brindan un mejor descuento. Si el precio original fuera de USD 100, el precio con descuento sería USD 72.90.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Ninguno de los tipos de apilamiento

En el siguiente ejemplo, se muestra un caso en el que se usa la promoción none porque la combinación de otras promociones proporciona un descuento menor. Si el precio original era de $100, el precio con descuento sería de $75.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


Límites de duración del período de reserva

En el siguiente ejemplo, se muestra un caso en el que el elemento BookingWindow se usa con sus límites de inicio y finalización definidos como un tipo de duración ISO 8601. Esta restricción del período de reserva requiere reservar antes de las 6:00 p.m. del día anterior a la llegada y a partir de las 12:00 p.m. del 2o día antes de la llegada.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow min="P1DT6H" max="P2DT12H"/>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Límites de fecha y hora de las fechas de reserva

En el siguiente ejemplo, se muestra un caso en el que el elemento BookingDates se usa con los atributos start y end como tipos DateTime. Esta restricción de fechas exige que se realice entre las 6:30 a.m. del 1 de julio de 2020 y las 6:45 p.m. del 2 de julio de 2020.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01T06:30:00" end="2020-07-02T18:45:00"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

Períodos sin año

En el siguiente ejemplo, se muestra un caso en el que el elemento CheckInDates contiene DateRanges que tienen campos start y end sin años. En este ejemplo, la promoción se aplica a las fechas de entrada entre el 29/12 y el 29/1, sin importar el año. Los períodos sin año que cruzan el límite de año nuevo no son válidos, por lo que el rango de fecha se expresa como dos períodos adyacentes.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <CheckInDates>
         <DateRange start="12-29" end="12-31"/>
         <DateRange start="01-01" end="01-02"/>
      </CheckInDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


Descuento de FreeNights

En el siguiente ejemplo, se aplica un descuento del 50% para dos noches por cada cuatro noches de estadía del rango especificado de fechas de reserva. En un itinerario de diez noches, un total de cuatro noches tendría un descuento del 50%.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-01-01" end="2022-05-31"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="4" discount_nights="2" discount_percentage="50" night_selection="cheapest" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

En el siguiente ejemplo, se aplica un descuento del 50% a una noche por cada tres noches de estadía para los rangos especificados de fechas de estadía. Solo se tienen en cuenta las noches de estadía superpuestas para cumplir con los requisitos del descuento. Para el siguiente itinerario con entrada el 1 de enero de 2022 y salida el 7 de enero de 2022, las noches de estadía calificadas y los descuentos se aplican de la siguiente manera.

  • 1-1-2022 (estadía)
  • 2-1-2022 (estadía)
  • 2022-01-03
  • 04-01-2022 (con descuento)
  • 05-01-2022 (estadía)
  • 6-1-2022 (estadía)
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <StayDates application="overlap">
        <DateRange start="2022-01-01" end="2022-01-02"/>
        <DateRange start="2022-01-04" end="2022-01-06"/>
      </StayDates>
      <Discount>
        <FreeNights stay_nights="3" discount_nights="1" discount_percentage="50" night_selection="last" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>


Selección clasificada

En el siguiente ejemplo, se ofrecen dos descuentos, uno de un 20% de descuento y otro de un 15% de descuento. Durante la evaluación, solo se aplica el 15% de descuento porque tiene una clasificación más baja.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15" rank="25"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="20" rank="50"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

MejorDescuento diario

En el siguiente ejemplo, se aplica un descuento para una estadía de dos noches mediante la aplicación de BestDailyDiscount junto con un Discount.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
 <HotelPromotions hotel_id="HotelID" action="overlay">
   <Promotion id="general">
     <BestDailyDiscount fixed_amount="20"/>
   </Promotion>
   <Promotion id="may">
     <BestDailyDiscount fixed_amount="50"/>
     <StayDates application="overlap">
        <DateRange start="2023-05-01" end="2023-05-31"/>
     </StayDates>
   </Promotion>
   <Promotion id="fiesta">
     <Discount fixed_amount_per_night="5"/>
     <Stacking type="any"/>
   </Promotion>
 </HotelPromotions>
</Promotions>

Considera una estadía de dos noches del 30 de abril de 2023 al 2 de mayo de 2023. A modo de cálculo, la combinación de los mejores descuentos diarios que generan el descuento más significativo se encuentra primero.

Durante la primera noche, la promoción “general” es el único importe apto con un descuento fijo de 20.

Por segunda noche, la promoción “mayo” ofrece un descuento mayor que el descuento “general”. Por lo tanto, cuando se selecciona “may” (mayo), el importe de descuento fijo es 50.

Luego, para la estadía, la promoción "fiesta" aplica descuentos a 5 por noche o a 10 en total. Se puede acumular con la combinación de los mejores descuentos diarios porque "fiesta" tiene el tipo de pila establecido en any. Si se estableciera en base, solo se aplicará la combinación de los mejores descuentos diarios o el descuento “fiesta”. Consulta la descripción de Stacking para obtener más información.

“En general, el precio de la estadía recibe un descuento fijo de 20 + 50 + 10 = 80.

Respuestas

Sintaxis

El mensaje PromotionsResponse usa la siguiente sintaxis:

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues are populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code"
           status="issue_type">
      issue_description
    </Issue>
  </Issues>
</PromotionsResponse>

Elementos y atributos

El mensaje PromotionsResponse tiene los siguientes elementos y atributos:

Elemento / @Attribute Occurrences Tipo Descripción
PromotionsResponse 1 Complex element El elemento raíz que indica el éxito o los problemas de un mensaje de solicitud de promociones recibido.
PromotionsResponse / @timestamp 1 DateTime La fecha y hora de creación de este mensaje.
PromotionsResponse / @id 1 string Es el identificador único del mensaje de promociones asociado.
PromotionsResponse / @partner 1 string Es la cuenta del socio de este mensaje.
PromotionsResponse / Success 0..1 Success Indica que el mensaje de promociones se procesó correctamente sin advertencias, errores ni fallas.

<Success> o <Issues> están presentes en cada mensaje.
PromotionsResponse / Issues 0..1 Issues Es un contenedor para uno o más problemas que se encontraron durante el procesamiento del mensaje de promociones.

<Success> o <Issues> están presentes en cada mensaje.
PromotionsResponse / Issues / Issue 1..n Issue Es la descripción de una advertencia, un error o una falla durante el procesamiento del mensaje de promociones. Puedes encontrar detalles sobre estos problemas en Mensajes de error sobre el estado del feed.
PromotionsResponse / Issues / Issue / @code 1 integer Es el identificador del problema.
PromotionsResponse / Issues / Issue / @status 1 enum

El tipo de problema encontrado.

Los valores válidos son warning, error, y failure.

Ejemplos

Completado correctamente

La siguiente respuesta es una respuesta a un mensaje de promociones que se procesó correctamente.

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</PromotionsResponse>

Issues

La siguiente respuesta es una respuesta a un mensaje de promociones que no se procesó debido a errores.

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</PromotionsResponse>