Promociones

Si tienes un backend que proporciona feeds para varias cuentas, este valor debe coincidir con el ID valor del atributo especificado en el archivo <RequestorID> de tu <OTA_HotelRateAmountNotifRQ> y <OTA_HotelAvailNotifRQ> mensajes para el mismo de servicio predeterminada.

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

A menos que se use <Stacking>, la promoción con el mayor descuento se aplica a la reserva cuando varias promociones son aptas.

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

Si no se especifica, cada promoción especificada en la URL actual mensaje:

• Added (si ninguna de las promociones almacenadas tiene el elemento mismo id)
• Updated (si una promoción almacenada tiene la misma id)
• Deleted (si una promoción almacenada tiene la misma id y el valor del atributo action para la promoción especificada en el mensaje actual es "delete")

Es una promoción única para una propiedad. Ten en cuenta que si action="overlay" y <Promotion> son si no se especifica, 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).

Si se especifica, el valor debe ser delete. Si no es así especificada y una con el mismo id no se almacena, esta se almacena la promoción. De lo contrario, si no se especifica, y una promoción con se almacena el mismo id, la promoción existente se se actualicen.

Si se especifica delete, la promoción almacenada con el mismo id se borró. Cuando uses delete, no incluyas ningún elemento secundario en <Promotion> Además, delete no es se permite junto con <HotelPromotions action="overlay"/>.

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

• La fecha o la fecha y hora especificadas por start deben ser anterior (o igual a) la fecha u fecha y hora especificadas por end
• Si no se especifica start, el rango es efectivamente ilimitados en términos de una hora de inicio.
• Si start se completa con la fecha "AAAA-MM-DD", es se interpreta como fecha y hora "YYYY-MM-DDT00:00:00".

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

• La fecha o la fecha y hora especificadas por end deben ser posteriores que (o igual que) la fecha u fecha y hora especificadas por start
• Si no se especifica end, el rango es efectivamente ilimitado en términos de una hora de finalización.
• Si se proporciona end con la fecha "AAAA-MM-DD", es se interpreta como fecha y hora "AAAA-MM-DDT23:59:59".

Indica los días de la semana que se permiten en el período. Si no es así especificado, todos los días están permitidos en el período. Cada carácter de la cadena especifica un día. Por ejemplo, "MTWHF" especifica que están permitidos los días de la semana 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.

Los tipos de valor válidos son los siguientes:

• Número entero: La cantidad de días antes de la entrada fecha. Por ejemplo, un valor de 30 indica la la promoción solo se aplica a las reservas realizadas al menos 30 días antes de la fecha de entrada.
• Duración de la norma ISO 8601 (días, horas y minutos): La cantidad de días (y, opcionalmente, horas/minutos) antes de la fecha de entrada. Para Por ejemplo, un valor de P30D indica solo la promoción se aplica a las reservas con al menos 30 días de anticipación a la fecha de entrada. R valor de P30DT6H requiere que la reserva se haga a las 6:00 p.m. o antes del el día 30 antes de la llegada.

Los tipos de valor válidos son los siguientes:

• Número entero: La cantidad de días antes de la entrada fecha. Por ejemplo, un valor de 30 indica la la promoción solo se aplica a las reservas realizadas hasta 30 días antes de la fecha de entrada.
• Duración de la norma ISO 8601 (días, horas y minutos): La cantidad de días (y, opcionalmente, horas/minutos) antes de la fecha de entrada. Para Por ejemplo, un valor de P30D indica solo la promoción se aplica a las reservas que se hayan realizado hasta 30 días antes de la fecha de entrada. R El valor de P30DT6H requiere una reserva a partir de las 6:00 p.m. del el día 30 antes de la llegada.

Define las restricciones sobre el valor máximo en el que se puede establecer una tarifa después de que se apliquen las promociones.

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

Si se configura el apilamiento, entonces se mostrarán varias promociones con <Ceiling> podría aplicarse a una sola estadía. Cada promoción aplicaría el descuento, seguido inmediatamente del límite. El El siguiente ejemplo demuestra cómo cada límite contribuye a la siguiente el cálculo de la promoción en la pila.

Ejemplo:

Precios para estadías de 1 noche en AmountBeforeTax 100 y hay una pila de dos promociones:

1. Promoción con el tipo de apilamiento base, a fixed_amount de 25 y un límite amount_per_night de 60
2. Promoción con el tipo de apilamiento second, fixed_amount de 25 y un límite amount_per_night de 90

Este es el orden de cálculo:

1. Primero se aplica la promoción base y los descuentos AmountBeforeTax a 75, pero luego el techo baja a 60.
2. La promoción second ofrece un descuento para las AmountBeforeTax de 60 a 35. Esto está por debajo del límite de 90, por lo que no se aplica el segundo techo. La tarifa final es de 35

El hecho de que 60 sea un límite general más estricto es irrelevante porque es válido solo para su propia promoción, y no puede haber límite que abarca toda la pila de promociones.

Cantidad máxima a la que se puede establecer una tarifa por noche después de se aplica el descuento.

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

Se aplica el amount_per_night a los impuestos y las tarifas cuando se incluyen en la tarifa por noche mediante AmountAfterTax, pero no las especificadas con TaxFeeInfo.

Define las restricciones sobre el valor mínimo en el que se puede establecer una tarifa después de que se apliquen las promociones.

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

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

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

Ejemplo:

Precios para estadías de 1 noche en AmountBeforeTax 100 y hay una pila de dos promociones:

1. Promoción con el tipo de apilamiento base, a fixed_amount de 25 y un piso amount_per_night de 90
2. Promoción con el tipo de apilamiento second, fixed_amount de 25 y un piso amount_per_night de 60

Este es el orden de cálculo:

1. Primero se aplica la promoción base y los descuentos AmountBeforeTax a 75, pero luego el precio mínimo lo eleva de hasta 90.
2. La promoción second ofrece un descuento para las AmountBeforeTax de 90 a 65. Esta sección está por encima del 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 porque es válido solo para su propia promoción, y no puede haber que abarca toda la pila de promociones.

Importe mínimo que se puede establecer una tarifa por noche después de se aplica el descuento.

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

Se aplica el amount_per_night a los impuestos y las tarifas cuando se incluyen en la tarifa por noche mediante AmountAfterTax, pero no las especificadas con TaxFeeInfo.

Un período que especifique cuándo se debe registrar la entrada para que la promoción si se aplican. Este elemento no es obligatorio si borras uno o más. promociones.

También se admite el formato YearlessDate.

• Si uno de start o end es sin año date, ambas se deben completar como fechas sin año.
• Los períodos sin año no deben concluir el año nuevo. En cambio, representar el rango como dos períodos adyacentes. Por ejemplo: {"12-29", "01-05"} se puede representar como {"12-29", "12-31"}, y {"01-01", "01-05"}

Indica los días de la semana que se permiten en el período. Si no es así especificado, todos los días están permitidos en el período. Cada carácter de la cadena especifica un día. Por ejemplo, "MTWHF" especifica que están permitidos los días de la semana 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.

Un período que especifique cuándo debe ocurrir la salida para que la promoción si se aplican. Este elemento no es obligatorio si tienes borrar una o más promociones.

También se admite el formato YearlessDate.

• Si uno de start o end no tiene año date, ambas deben completarse como fechas sin año.
• Los períodos sin año no deben concluir el año nuevo. En cambio, representar el rango como dos períodos adyacentes. Por ejemplo: {"12-29", "01-05"} se puede representar de la siguiente manera: {"12-29", "12-31"} y {"01-01", "01-05"}

Indica los días de la semana que se permiten en el período. Si no es así especificado, todos los días están permitidos en el período. Cada carácter de la cadena especifica un día. Por ejemplo, "MTWHF" especifica que están permitidos los días de la semana 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.

Exactamente uno de Discount o Se debe especificar BestDailyDiscount.

Especifica el descuento que se aplicará para esta promoción.

Exactamente uno de percentage, fixed_amount, fixed_amount_per_night fixed_price o fixed_price_per_night es como en los productos necesarios.

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

Ejemplos:

• Si la AmountAfterTax es 100 y percentage es 20, entonces

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

  80.00 = 100 * (1 - 0.2)

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

  tasa de promoción = AmountBeforeTax * (1 - porcentaje descuento) más impuestos

  90.00 = 100 * (1 - 0.2) + 10

Exactamente uno de percentage, fixed_amount, fixed_amount_per_night fixed_price o fixed_price_per_night es como en los productos necesarios.

Una cantidad fija que se restará de la suma del Tarifas por noche de AmountAfterTax (o la suma de AmountBeforeTax tarifas por noche si AmountAfterTax). Se supone que en la misma moneda que las tarifas por noche. Si es mayor que el de las tarifas nocturnas, el valor resultante es cero.

Ejemplos:

• El precio de una estadía de 1 noche AmountBeforeTax es 90, AmountAfterTax es 100 y fixed_amount es 20, entonces

  tarifa de promoción = AmountAfterTax - fija descuento

  80.00 = 100 - 20

• El precio de una estadía de 1 noche AmountBeforeTax es 100, fixed_amount es 20, y TaxFeeInfo especifica un impuesto de 8%.

  tarifa de promoción = (AmountBeforeTax - fijo descuento) * (1 + porcentaje de impuesto)

  86.40 = (100 - 20) * 1.08

• El precio de una estadía de 1 noche AmountBeforeTax es 50, fixed_amount es 60, y TaxFeeInfo especifica un impuesto de 10, luego

  tarifa de promoción = (AmountBeforeTax - fijo descuento) * impuestos

  10.00 = 0 + 10

• Si precioamos una estadía de 3 noches donde el Los valores de AmountAfterTax son 100, 110 y 120. y fixed_amount es 150, luego

  tasa de promoción = suma(AmountAfterTax) - (fija) descuento)

  180.00 = (100 + 110 + 120) - 150

Exactamente uno de percentage, fixed_amount, fixed_amount_per_night fixed_price o fixed_price_per_night es como en los productos necesarios.

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

Ejemplos:

• Si precioamos una estadía de 3 noches donde el Los valores de AmountAfterTax son 100, 110 y 120. y las fixed_amount_per_night es 10, luego

  tasa de promoción = sum(AmountBeforeTax - importe fijo descuento)

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

• Si precioamos una estadía de 3 noches donde el Los valores de AmountAfterTax son 10, 50 y 100. y las fixed_amount_per_night es 20, luego

  tasa de promoción = sum(AmountAfterTax - importe fijo descuento)

  110.00 = (0 + (50 - 20) + (100 - 20))

Exactamente uno de percentage, fixed_amount, fixed_amount_per_night fixed_price o fixed_price_per_night es como en los productos necesarios.

Si se especifican tarifas por noche de AmountAfterTax, este valor establece el precio de la estadía, incluidos los impuestos y las tarifas, en un valor específico. Si se especifica AmountBeforeTax, entonces ya sea que se especifique o no AmountAfterTax, esto establece la precio antes de impuestos de la estadía en el valor especificado. Se supone que en la misma moneda que las tarifas por noche.

Si AmountAfterTax pretende reflejar una porcentaje de impuesto y, luego, se establecerá un precio fijo para Es posible que AmountBeforeTax genere impuestos y tarifas imprecisos. En general, se recomienda usar TaxFeeInfo para especificar los impuestos y las tarifas de una propiedad.

Ejemplos:

• El precio de una estadía de 1 noche AmountBeforeTax es 90, AmountAfterTax es 100 y fixed_price es de 80, por lo que la tarifa de promoción es de 80.
• El precio de una estadía de 1 noche AmountBeforeTax es 100, fixed_amount es 80, y TaxFeeInfo especifica un impuesto de 8%; entonces,

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

  86.40 = 80 * 1.08

• Si precioamos una estadía de 3 noches donde el Los valores de AmountAfterTax son 100, 110 y 120. y fixed_amount es 300, luego

  tasa de promoción = 300

Exactamente uno de percentage, fixed_amount, fixed_amount_per_night fixed_price o fixed_price_per_night es como en los productos necesarios.

Si se especifican tarifas por noche de AmountAfterTax, este valor establece el precio por cada noche de estadía, incluidos los impuestos y las tarifas, al un valor específico. Si se especifica AmountBeforeTax, entonces ya sea que se especifique o no AmountAfterTax, esto establece la antes de impuestos por cada noche de estadía en el valor especificado. Sí están en la misma moneda que las tarifas por noche.

Si AmountAfterTax pretende reflejar una porcentaje de impuesto y, luego, se establecerá un precio fijo para Es posible que AmountBeforeTax genere impuestos y tarifas imprecisos. En general, se recomienda usar TaxFeeInfo para especificar los impuestos y las tarifas de una propiedad.

Si se especifica applied_nights, el precio nuevo es se aplica a las N noches más baratas.

Ejemplos:

• Si precioamos una estadía de 2 noches, Los valores de AmountBeforeTax son 90, 90. Los valores de AmountAfterTax son 100, 100. y fixed_price es de 80, entonces la tarifa de promoción es de 80 + 80 = 160
• Si precioamos una estadía de 2 noches, AmountBeforeTax es 100, 100; fixed_amount es 80, y TaxFeeInfo especifica un impuesto de 8%; luego, la tarifa es (80 + 80) * 1.08 = 172.8.
• Si precioamos una estadía de 3 noches donde el Los valores de AmountAfterTax son 100, 110 y 120. y fixed_amount es 110, entonces la tarifa de la promoción es 110 * 3 = 330.

Esto solo debe usarse con percentage o fixed_amount_per_night.

La cantidad de noches a las que se aplica el descuento, comenzando por es el menos costoso. Debe ser un número entero entre 1 y 99. Si no se especifica, el descuento se aplica a todas las noches.

Es la cantidad de noches requeridas para que se aplique el descuento. Cada el descuento se aplica a un segmento independiente de noches de estadía.

Por ejemplo, para una estadía de 10 noches donde stay_nights es 4 (y repeats es verdadero), por lo que hay dos noches de estadía segmentos: de la 1a a la 4a noches y de la 5a a la 8a noche el Las noches 9 y 10 no forman parte de un segmento de noche.

Si el descuento se puede aplicar a varias noches de estadía segmentos. Si es false, solo el segmento de noches de estadía en se descontará al comienzo del itinerario. Si es true, entonces cualquier segmento de noches de estadía tiene descuento.

Por ejemplo, si stay_nights es 4 y el itinerario es 10. noches, entonces, si repeats es true, entonces 2 los segmentos tienen descuento (noches 1 a 4 y noches 5 a 8); pero, si repeats es false, entonces solo 1 segmento con descuento (noches 1 a 4).

Exactamente uno de Discount o Se debe especificar BestDailyDiscount.

Especifica un descuento diario que puede aplicarse a una noche del quedarse. Esto contrasta con Discount, que aplica descuentos a estadías completas.

Cada propiedad puede tener un solo grupo de promociones que se "mejor diario". Esto significa que, por cada noche de estadía, sencillo "mejor del día" sea apta y genere la mayor se seleccionó el descuento para esa noche y es posible que se aplique.

Stacking no se puede especificar con BestDailyDiscount El "mejor diario" descuentos, lo que genera el el descuento más alto por cada noche se combinan y se tratan como un solo descuento por estadía (es decir, Discount) con el tipo de apilado establecido en base Este descuento combinado se compara con con otros <Discount> aptos promociones para encontrar una o una combinación que ofrezca el mayor descuento. combinación de BestDailyDiscount o un solo Se selecciona Discount, el que genere el precio más bajo. para el tipo de apilamiento base.

StayDates se puede especificar con este tipo de descuento pero application debe configurarse como overlap

Exactamente uno de percentage, Se requiere fixed_amount o fixed_price.

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

Ejemplos:

• Si la AmountAfterTax por una noche de estadía es de 100 y percentage es 20, luego

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

  80.00 = 100 * (1 - 0.2)

• Si la AmountBeforeTax para un ight de estadía es de 100, percentage es 20 y TaxFeeInfo especifica un impuesto de 10, luego,

  tasa de promoción = AmountBeforeTax * (1 - porcentaje descuento) más impuestos

  90.00 = 100 * (1 - 0.2) + 10

Exactamente uno de percentage, Se requiere fixed_amount o fixed_price.

Una cantidad fija que se restará de un único Tarifa por noche de AmountAfterTax (o Tarifa por noche de AmountBeforeTax si AmountAfterTax). Se supone que en la misma moneda que las tarifas por noche. Si es mayor que el de las tarifas nocturnas, 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 - fija descuento

  80.00 = 100 - 20

• Si AmountBeforeTax para una sola noche es 100, fixed_amount es 20, e TaxFeeInfo especifica un impuesto de 8% y, luego,

  tarifa de promoción = (AmountBeforeTax - fijo descuento) * (1 + porcentaje de impuesto)

  86.40 = (100 - 20) * 1.08

Exactamente uno de percentage, Se requiere fixed_amount o fixed_price.

Si se especifican tarifas por noche de AmountAfterTax, este valor establece el precio por la noche de la estadía, incluidos los impuestos y las tarifas, al un valor específico. Si se especifica AmountBeforeTax, entonces ya sea que se especifique o no AmountAfterTax, esto establece la precio antes de impuestos de la estadía en el valor especificado. Se supone que 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 de 80, por lo que la tarifa de promoción es de 80.
• Si AmountBeforeTax para una sola noche es 100, fixed_amount es 80 e TaxFeeInfo especifica un impuesto de 8% y, luego,

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

  86.40 = 80 * 1.08

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

Este elemento no debe especificarse, a menos que También se especifica <Discount>.

ID de regla de tarifas asociada con un programa de membresía.

Se pueden aplicar varias promociones a una sola tarifa en función del este parámetro de configuración:

• any: Se puede combinar con cualquier otra promoción (excepto none), pero el orden en el que deben estar las promociones no está garantizada.
• base: La mejor promoción de base apta es seleccionar y aplicar primero, antes que otras promociones. Este era antes llamado base_only.
• second: La mejor promoción apta de second se selecciona y se aplica después de una promoción de base (si corresponde) y antes de any promociones.
• none: No se puede combinar con otros. promociones.

De las combinaciones permitidas, el conjunto de promociones que genera el el descuento más alto se aplicará a la tarifa.

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 fechas de la estadía.
• any: Aplica la promoción a todas las noches del itinerario si alguna fecha del itinerario se superpone con una fecha del durante el período de estadía.
• overlap: Aplica la promoción solo a aquellas de noches en el itinerario que se superponen con una fecha en las fechas de la estadía del rango de destino de la ruta.

Siempre se debe especificar este atributo.

• Si <Discount> especifica percentage y application está establecido en all, o any, el descuento se aplica como un porcentaje del estadía completa.
• Si <Discount> especifica percentage y application se establece en overlap, el el descuento se aplica como un porcentaje de las tarifas nocturnas por superposición noches.
• <Discount> especifica fixed_amount y application establecido en overlap es una combinación no válida.
• <FreeNights> admite todo application valores. Ten en cuenta que, para overlap, solo se consideran para el descuento las noches de estadía que se superponen y los requisitos de cumplimiento.

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

También se admite el formato YearlessDate.

• Si uno de start o end no tiene año date, ambas deben completarse como fechas sin año.
• Los períodos sin año no deben concluir el año nuevo. En cambio, representar el rango como dos períodos adyacentes. Por ejemplo: {"12-29", "01-05"} se puede representar de la siguiente manera: {"12-29", "12-31"} y {"01-01", "01-05"}

Indica los días de la semana que se permiten en el período. Si no es así especificado, todos los días están permitidos en el período. Cada carácter de la cadena especifica un día. Por ejemplo, "MTWHF" especifica que están permitidos los días de la semana 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.

Los valores válidos son include y exclude

Si UserCountry type está configurado como include, la promoción se aplica a los usuarios del países incluidos en la lista.

Si el valor de UserCountry type es exclude, La promoción se aplica a usuarios que no figuran en la lista países.

Si no se establece el objeto type UserCountry, se considera como include y la promoción se aplica a los usuarios de los países enumerados.

<Success> o <Issues> es presente en cada mensaje.

<Success> o <Issues> es presente en cada mensaje.

El tipo de problema encontrado.

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