Promoções

Se você tem um back-end que fornece feeds para várias contas, esse valor precisa corresponder ao ID o valor do atributo especificado em <RequestorID> do elemento <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> mensagens iguais do Compute Engine.

Promoções de uma propriedade. Cada promoção se aplica a uma única .

A menos que <Stacking> seja usado, a promoção com o maior desconto será aplicada à reserva quando várias promoções são qualificadas.

Se especificado, o valor deve ser "overlay": Quando o valor for "overlay", todos as promoções armazenadas são excluídas antes do armazenamento das promoções especificadas. na mensagem atual.

Se não for especificado, cada promoção especificada na regra é:

• Added (se nenhuma das promoções armazenadas tiver o mesmo id)
• Updated (se uma promoção armazenada tiver a mesma id)
• Deleted (se uma promoção armazenada tiver a mesma id e o valor do atributo action da promoção especificada na mensagem atual é "delete").

Uma única promoção para uma propriedade. Observe que, se action="overlay" e um <Promotion> são não for especificada, todas as promoções da propriedade serão excluídas.

Se você precisar usar mais de 99 promoções, entre em contato com seu Gerente técnico de contas (TAM).

Se especificado, o valor precisa ser delete. Caso contrário especificado, e um promoção com o mesmo id não é armazenada, então esse promoção é armazenada. Caso contrário, se não for especificado, e uma promoção com o mesmo id for armazenado, a promoção existente será atualizado.

Se delete for especificado, a promoção armazenada com o mesmo id será excluído. Ao usar delete, não inclua elementos filhos no <Promotion>. Além disso, delete não é permitido em conjunto com <HotelPromotions action="overlay"/>.

A data ou data/hora de início (com base no fuso horário da propriedade) inclusive, do intervalo.

• A data ou data e hora especificadas por start precisam ser anterior (ou igual à) data ou hora especificada pelo end.
• Se start não for especificado, o intervalo estará efetivamente ilimitado em termos de horário de início.
• Se start for preenchido como a data "AAAA-MM-DD", ele será interpretado como a data/hora "AAAA-MM-DDT00:00:00".

A data de término ou data e hora (com base no fuso horário da propriedade) inclusive, do intervalo.

• A data ou data e hora especificadas por end precisam ser posteriores que (ou igual à) data ou data e hora especificadas pelo start.
• Se end não for especificado, o intervalo será ilimitado em termos de horário de término.
• Se end for fornecido como a data "AAAA-MM-DD", será interpretado como data e hora "AAAA-MM-DDT23:59:59".

Os dias da semana permitidos no período. Se não for especificado, todos os dias serão permitidos no período. Cada na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período.

Os caracteres válidos são:

• M para segunda-feira
• T para terça-feira
• W para quarta-feira
• H para quinta-feira
• F para sexta-feira
• S para sábado
• U para domingo

Qualquer combinação de caracteres é válida.

Os tipos de valor válidos são:

• Número inteiro: o número de dias antes do check-in data. Por exemplo, um valor de 30 indica que a promoção só se aplica a reservas feitas pelo menos 30 dias antes da data de check-in.
• Duração ISO 8601 (dias, horas e minutos): o número de dias (e opcionalmente horas/minutos) antes da data de check-in. Para exemplo, um valor de P30D indica apenas que a promoção se aplica a reservas feitas pelo menos 30 dias antes da data do check-in. Um O valor de P30DT6H exige reserva até as 18h em no 30o dia antes da chegada.

Os tipos de valor válidos são:

• Número inteiro: o número de dias antes do check-in data. Por exemplo, um valor de 30 indica que a promoção só se aplica a reservas com no máximo 30 dias de antecedência à data de check-in.
• Duração ISO 8601 (dias, horas e minutos): o número de dias (e opcionalmente horas/minutos) antes da data de check-in. Para exemplo, um valor de P30D indica apenas que a promoção se aplica às reservas feitas até 30 dias antes da data do check-in. Um O valor de P30DT6H exige reserva a partir das 18h para no 30o dia antes da chegada.

Define restrições sobre o valor máximo que pode ser definido para uma taxa após a aplicação das promoções.

As promoções precisam sempre especificar um <Discount> ou um <BestDailyDiscount>. Para criar uma promoção que aplique apenas um <Ceiling>, uma opção é definir um <Discount> com um percentage de 0.

Se a empilhamento estiver configurada, várias promoções com <Ceiling> poderão ser aplicadas a uma única estadia. Cada promoção aplicaria seu desconto, imediatamente seguido por seu teto. O exemplo a seguir demonstra como cada teto contribui para o próximo cálculo da promoção na pilha.

Exemplo:

Preço de uma estadia de 1 noite em que AmountBeforeTax está 100 e houver uma pilha de duas promoções:

1. Promoção com tipo de empilhamento base, a fixed_amount de 25 e um teto amount_per_night de 60
2. Promoção com tipo de empilhamento second, fixed_amount de 25 e um teto amount_per_night de 90

Esta é a ordem do cálculo:

1. A promoção base é aplicada primeiro, e os descontos de AmountBeforeTax para 75, mas o teto abaixa para 60.
2. A promoção second desconta o AmountBeforeTax de 60 a 35. Isso está abaixo do teto. de 90 para que o segundo teto não seja aplicado. A taxa final é 35.

O fato de que 60 é um limite geral mais rígido é irrelevante, pois ele é válido somente para sua própria promoção, e não pode haver que cubra toda a pilha de promoções.

O valor máximo que uma tarifa noturna pode ser definida após o será aplicado.

Se um elemento <Floor> também for especificado, esse deve ser definido com um valor maior ou igual ao Atributo amount_per_night em <Floor>:

O valor de amount_per_night será aplicado aos tributos e taxas quando estão incluídas no valor da diária usando AmountAfterTax, mas diferentes daqueles especificados em TaxFeeInfo.

Define as restrições do valor mínimo que pode ser definido para uma taxa. após a aplicação das promoções.

As promoções sempre precisam especificar um <Discount> ou um <BestDailyDiscount>. Portanto, para criar uma promoção que só aplica uma <Floor>, uma opção é definir <Discount> com percentage de 0.

A lógica <Floor> ainda se aplica a <FreeNights> de desconto, mesmo que a noite sem custo financeiro tenha um 100% de desconto aplicado a ele.

Se o empilhamento estiver configurado, várias promoções com <Floor> pode ser aplicada a uma única estadia. Cada promoção aplicaria seu desconto, imediatamente seguido pelo preço mínimo. O exemplo a seguir demonstra como cada andar contribui para o próximo andar cálculo da promoção na pilha.

Exemplo:

Preço de uma estadia de 1 noite em que AmountBeforeTax está 100 e houver uma pilha de duas promoções:

1. Promoção com tipo de empilhamento base, a fixed_amount de 25 e um andar amount_per_night de 90
2. Promoção com tipo de empilhamento second, fixed_amount de 25 e um andar amount_per_night de 60

Confira a ordem de cálculo:

1. A promoção base é aplicada primeiro, e os descontos AmountBeforeTax para 75, mas o valor mínimo aumenta em até 90.
2. A promoção second desconta o AmountBeforeTax de 90 a 65. Está acima do chão. de 60 para que o segundo andar não seja aplicado. A taxa final é 65.

O fato de que 90 é um preço mínimo mais rígido é irrelevante, pois ele é válido somente para sua própria promoção, e não pode haver que abrange toda a pilha de promoções.

O valor mínimo que pode ser definido para uma diária após a será aplicado.

Se um elemento <Ceiling> também for especificado, esse deve ser definido com um valor menor ou igual ao Atributo amount_per_night em <Ceiling>:

amount_per_night é aplicado a tributos e taxas quando eles estão incluídos na tarifa noturna usando AmountAfterTax, mas não aqueles especificados usando TaxFeeInfo.

Um período que especifica quando o check-in precisa ocorrer para que a promoção seja aplicada. Este elemento não é necessário se você estiver excluindo um ou mais promoções.

O formato YearlessDate também é compatível.

• Se um dos start ou end for uma data sem ano, ambos precisarão ser preenchidos como datas sem ano.
• Os períodos sem ano não podem estar próximos ao ano novo. Em vez disso, represente o intervalo como dois períodos adjacentes. Por exemplo: {"12-29", "01-05"} pode ser representado como {"12-29", "12-31"} e {"01-01", "01-05"}

Os dias da semana permitidos no período. Caso contrário especificado, todos os dias são permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período.

Os caracteres válidos são:

• M para segunda-feira
• T para terça-feira
• W para quarta-feira
• H para quinta-feira
• F para sexta-feira
• S para sábado
• U para domingo

Qualquer combinação de caracteres é válida.

Um período que especifica quando o check-out precisa ocorrer para que a promoção seja aplicada. Esse elemento não é necessário se você excluindo uma ou mais promoções.

O formato YearlessDate também é compatível.

• Se um de start ou end for um valor anual data, ambos devem ser preenchidos como datas sem ano.
• Os períodos sem ano não podem se estender até o ano novo. Em vez disso, representar o período como dois períodos adjacentes. Por exemplo: {"12-29", "01-05"} pode ser representado como {"12-29", "12-31"} e {"01-01", "01-05"}

Os dias da semana permitidos no período. Caso contrário especificado, todos os dias são permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período.

Os caracteres válidos são:

• M para segunda-feira
• T para terça-feira
• W para quarta-feira
• H para quinta-feira
• F para sexta-feira
• S para sábado
• U para domingo

Qualquer combinação de caracteres é válida.

Exatamente um de Discount ou BestDailyDiscount precisa ser especificado.

Especifica o desconto a ser aplicado a esta promoção.

Exatamente um de percentage, fixed_amount, fixed_amount_per_night fixed_price ou fixed_price_per_night é obrigatórios.

Um valor decimal de 0 a 100 que especifica o desconto percentual. for aplicado a AmountAfterTax (ou AmountBeforeTax se AmountAfterTax não for especificado).

Exemplos:

• Se AmountAfterTax for 100 e percentage for 20, então

  taxa da promoção = AmountAfterTax * (1 - porcentagem desconto)

  80,00 = 100 * (1 - 0,2)

• Se AmountBeforeTax for 100, percentage é 20 e TaxFeeInfo especifica um imposto de 10, então

  taxa da promoção = AmountBeforeTax * (1 - porcentagem desconto) + tributos

  90,00 = 100 * (1 - 0,2) + 10

Exatamente um de percentage, fixed_amount, fixed_amount_per_night fixed_price ou fixed_price_per_night é obrigatórios.

Um valor fixo a ser subtraído da soma do Taxas por noite de AmountAfterTax (ou soma de AmountBeforeTax tarifas por noite se AmountAfterTax não foi especificado). Presume-se que na mesma moeda das diárias. Se for maior do que soma das taxas noturnas, o valor resultante é zero.

Exemplos:

• Se o preço de uma estadia de uma noite for AmountBeforeTax 90, AmountAfterTax 100 e fixed_amount 20,

  taxa de promoção = AmountAfterTax - fixo desconto

  80,00 = 100 - 20

• Se estivermos definindo o preço de uma estadia de uma noite em que AmountBeforeTax é 100, fixed_amount é 20 e TaxFeeInfo especifica um imposto de 8%, então

  taxa de promoção = (AmountBeforeTax - fixo desconto) * (1 + percentual de tributo)

  86,40 = (100 - 20) * 1,08

• Se estamos cobrando uma estadia de 1 noite em que AmountBeforeTax é 50, fixed_amount é 60, e TaxFeeInfo especifica um imposto de 10, então

  taxa de promoção = (AmountBeforeTax - fixo desconto) * tributo

  10,00 = 0 + 10

• Se estamos cobrando uma estadia de três noites em que o Os valores de AmountAfterTax são 100, 110 e 120. e fixed_amount é 150, então

  taxa de promoção = sum(AmountAfterTax) - (fixo) desconto)

  180,00 = (100 + 110 + 120) - 150

Exatamente um de percentage, fixed_amount, fixed_amount_per_night fixed_price ou fixed_price_per_night é obrigatórios.

Um desconto fixo aplicado a cada um dos AmountAfterTax as tarifas por noite (ou o N mais barato se applied_nights for especificado). Se AmountAfterTax não for especificado, ele será aplicado a AmountBeforeTax. Presume-se que na mesma moeda das diárias. Se fixed_amount_per_night é maior que essa tarifa é reduzida a zero, ou seja, não pode fazer com que o valor da diária se torne negativo.

Exemplos:

• Se estamos cobrando uma estadia de três noites em que o Os valores de AmountAfterTax são 100, 110 e 120. e o fixed_amount_per_night é 10, então

  taxa de promoção = sum(AmountBeforeTax - valor fixo desconto)

  300,00 = ((100 - 10) + (110 - 10) + (120 - 10))

• Se estamos cobrando uma estadia de três noites em que o Os valores de AmountAfterTax são 10, 50 e 100. e o fixed_amount_per_night é 20, então

  taxa de promoção = sum(AmountAfterTax - valor fixo desconto)

  110,00 = (0 + (50 - 20) + (100 - 20))

Exatamente um de percentage, fixed_amount, fixed_amount_per_night fixed_price ou fixed_price_per_night é obrigatórios.

Se as tarifas noturnas de AmountAfterTax forem especificadas, este define o preço da estadia, incluindo impostos e taxas, para o o valor especificado. Se AmountBeforeTax for especificado, então independentemente de AmountAfterTax ser especificado ou não, o preço sem tributos da estadia para o valor especificado. Presume-se que na mesma moeda das diárias.

Se o objetivo de AmountAfterTax for refletir uma taxa percentual, definir um preço fixo para AmountBeforeTax pode resultar em tributos e taxas incorretos. Em geral, é altamente recomendável usar TaxFeeInfo para especificar os tributos e as taxas de uma propriedade.

Exemplos:

• Se estamos cobrando uma estadia de 1 noite em que AmountBeforeTax é 90, AmountAfterTax é 100 e fixed_price for 80, a taxa de promoção será 80.
• Se estamos cobrando uma estadia de 1 noite em que AmountBeforeTax é 100, fixed_amount for 80 e TaxFeeInfo especificar um imposto de 8%,

  taxa da promoção = preço fixo * (1 + percentual de tributos)

  86,40 = 80 * 1,08

• Se estamos cobrando uma estadia de três noites em que o Os valores de AmountAfterTax são 100, 110 e 120. e fixed_amount é 300, então

  taxa de promoção = 300

Exatamente um de percentage, fixed_amount, fixed_amount_per_night fixed_price ou fixed_price_per_night é obrigatórios.

Se as tarifas noturnas de AmountAfterTax forem especificadas, este define o preço de cada noite de estadia, incluindo impostos e taxas, para o o valor especificado. Se AmountBeforeTax for especificado, então independentemente de AmountAfterTax ser especificado ou não, o preço sem tributos de cada noite de estadia conforme o valor especificado. É estão na mesma moeda que as tarifas noturnas.

Se AmountAfterTax tiver como objetivo refletir uma percentual de imposto e definir um preço fixo para O AmountBeforeTax pode resultar em tarifas e tributos incorretos. Em geral, é altamente recomendável usar TaxFeeInfo para especificar os tributos e as taxas de uma propriedade.

Se applied_nights for especificado, o novo preço será aplicado às N diárias mais baratas.

Exemplos:

• Se estamos cobrando uma estadia de duas noites em que Os valores AmountBeforeTax são 90, 90. Os valores AmountAfterTax são 100, 100. e fixed_price é 80, então a taxa de promoção é 80 + 80 = 160.
• Se o preço de uma estadia de duas noites for AmountBeforeTax 100, 100, fixed_amount 80 e TaxFeeInfo especificar um imposto de 8%, a taxa de promoção será (80 + 80) * 1,08 = 172,8.
• Se estamos cobrando uma estadia de três noites em que o Os valores de AmountAfterTax são 100, 110 e 120. e fixed_amount é 110, então a taxa da promoção é 110 * 3 = 330.

Ele só deve ser usado com percentage ou fixed_amount_per_night.

O número de noites a que o desconto é aplicado, começando com o mais barato. Precisa ser um número inteiro de 1 a 99. Se não for especificado, o desconto será aplicado a todas as noites.

Número de noites necessárias para que o desconto seja aplicado. Cada desconto é aplicado a um segmento separado de noites de estadia.

Por exemplo, para uma estadia de 10 noites em que stay_nights é 4 (e repeats é verdadeiro), há dois segmentos de noites de estadia: da primeira à quarta noite e da quinta à oitava noite. A nona e a décima noite não fazem parte de um segmento de noites de estadia.

Se o desconto pode ser aplicado a vários segmentos de estadias Se for false, somente o segmento de noites da estadia em no início do itinerário é descontado. Se for true, então: qualquer segmento de noites da estadia é descontado.

Por exemplo, se stay_nights for 4 e o itinerário for 10 noites, então, se repeats for true, então 2 os segmentos são descontados (1 a 4 noites e 5 a 8 noites); mas, se repeats é false, então apenas 1 segmento é com desconto (noites de 1 a 4).

É preciso especificar exatamente um entre Discount ou BestDailyDiscount.

Especifica um o desconto diário, que pode ser aplicado a uma noite de estadia. Isso está em contrastar com Discount, que aplica descontos a toda fica.

Cada propriedade pode ter um único grupo de promoções que são consideradas "melhores diárias". Isso significa que, para cada noite de estadia, a única promoção "melhor diária" que for qualificada e gerar o maior desconto para essa noite será selecionada e poderá ser aplicada.

Stacking pode ser especificado com BestDailyDiscount. Ele precisa ser definido como base ou none. O "melhor diário" descontos que produzem o maior desconto para cada noite são combinadas e tratadas como desconto de estadia única (por exemplo, Discount) respeitando o tipo de empilhamento configurado. Esse desconto combinado é comparado a outras promoções <Discount> qualificadas e pode ser empilhado para encontrar a combinação que oferece o desconto mais alto. A combinação de BestDailyDiscount ou um Discount único, o que gerar o preço mais baixo, é selecionados e aplicados para o tipo de empilhamento base.

O StayDates pode ser especificado com esse tipo de desconto, mas o application precisa ser definido como overlap

Exatamente um de percentage, fixed_amount ou fixed_price é obrigatório.

Um valor decimal de 0 a 100 que especifica o desconto percentual. for aplicado a AmountAfterTax (ou AmountBeforeTax se AmountAfterTax não for especificado).

Exemplos:

• Se AmountAfterTax para uma noite de estadia for 100 e percentage for 20, então

  taxa da promoção = AmountAfterTax * (1 - porcentagem desconto)

  80,00 = 100 * (1 - 0,2)

• Se AmountBeforeTax para um limite de estadia for 100, percentage é 20 e TaxFeeInfo especifica um imposto de 10, então

  taxa da promoção = AmountBeforeTax * (1 - porcentagem desconto) + tributos

  90,00 = 100 * (1 - 0,2) + 10

Exatamente um de percentage, fixed_amount ou fixed_price é obrigatório.

Um valor fixo a ser subtraído de uma diária de AmountAfterTax ou AmountBeforeTax, se AmountAfterTax não for especificado. Presume-se que na mesma moeda das diárias. Se for maior do que soma das taxas noturnas, o valor resultante é zero.

Exemplos:

• Se AmountBeforeTax para uma única noite for 90, AmountAfterTax é 100 e fixed_amount for 20, então

  taxa de promoção = AmountAfterTax - fixo desconto

  80,00 = 100 - 20

• Se AmountBeforeTax for 100, fixed_amount for 20 e TaxFeeInfo especificar um imposto de 8%, então

  taxa de promoção = (AmountBeforeTax - desconto fixo) * (1 + taxa percentual)

  86,40 = (100 - 20) * 1,08

É necessário incluir exatamente um destes campos: percentage, fixed_amount ou fixed_price.

Se as tarifas noturnas de AmountAfterTax forem especificadas, este define o preço da estadia, incluindo impostos e taxas, para o o valor especificado. Se AmountBeforeTax for especificado, então independentemente de AmountAfterTax ser especificado ou não, o preço sem tributos da estadia para o valor especificado. Presume-se que na mesma moeda das diárias.

Exemplos:

• Se AmountBeforeTax para uma única noite for 90, AmountAfterTax é 100 e fixed_price for 80, a taxa de promoção será 80.
• Se AmountBeforeTax para uma única noite for 100, fixed_amount é 80, e TaxFeeInfo especifica um imposto de 8%, então

  taxa da promoção = preço fixo * (1 + percentual de tributos)

  86,40 = 80 * 1,08

Contêiner para uma regra de taxa de associação que aciona um tratamento de IU específico para o desconto associado.

Esse elemento não deve ser especificado, a menos que <Discount> também é especificado.

ID da regra de tarifação associada a um programa de associação.

Várias promoções podem ser aplicadas a uma única taxa, dependendo da essa configuração:

• any: pode ser combinado com qualquer outra promoção (exceto none), mas a ordem em que as promoções são aplicada não é garantida.
• base: a melhor promoção base qualificada é selecionadas e aplicadas antes de outras promoções. Isso foi antes chamado de base_only.
• second: a melhor promoção second qualificada é selecionado e aplicado depois de uma promoção base (se aplicável) e antes de any promoções.
• none: não pode ser combinado com outros promoções.

Das combinações permitidas, o conjunto de promoções que resulta na o maior desconto será aplicado à tarifa.

Descreve como a promoção deve ser aplicada.

Os valores válidos são:

• all: aplica a promoção a todas as noites no Itinerário se todas as datas do itinerário se sobrepuserem com as datas da estadia.
• any: aplica a promoção a todas as noites do itinerário se alguma data do itinerário se sobrepuser a uma data no período da estadia.
• overlap: aplica a promoção somente aos usuários. noites do itinerário que se sobrepõem a uma data nas datas da estadia do intervalo 10.240.0.0/16.

Esse atributo deve sempre ser especificado.

• Se <Discount> especificar percentage e application for definido como all ou any, o desconto será aplicado como uma porcentagem da estadia completa.
• Se <Discount> especificar percentage e application estiver definido como overlap, o o desconto é aplicado como uma porcentagem das tarifas noturnas sobrepostas noites.
• <Discount> especificando fixed_amount e application definido como overlap é um combinação inválida.
• <FreeNights> suporta todos application. Para overlap, apenas as noites de estadia sobrepostas são consideradas para os requisitos de desconto.

Um período que especifica as datas em que a promoção será aplicada.

O formato YearlessDate também é compatível.

• Se start ou end for uma transação anual data, ambos devem ser preenchidos como datas sem ano.
• Os períodos sem ano não podem estar próximos ao ano novo. Em vez disso, representar o período como dois períodos adjacentes. Por exemplo: {"12-29", "01-05"} pode ser representado como {"12-29", "12-31"} e {"01-01", "01-05"}

Se você quiser definir o intervalo StayDates como permitir a promoção em dias específicos da semana, você deve definir o start como a data atual sem end. Portanto, para que a promoção não expire.

Especifique o valor start se o O valor de end não foi fornecido.

Especifique o valor end se o O valor de start não foi fornecido.

Os dias da semana permitidos no período. Caso contrário especificado, todos os dias são permitidos no período. Cada caractere na string especifica um dia. Por exemplo, "MTWHF" especifica que os dias da semana são permitidos no período.

Os caracteres válidos são:

• M para segunda-feira
• T para terça-feira
• W para quarta-feira
• H para quinta-feira
• F para sexta-feira
• S para sábado
• U para domingo

Qualquer combinação de caracteres é válida.

Os valores válidos são include e exclude.

Se o campo Usercountries type estiver definido como include, a promoção será válida para os usuários do países listados.

Se o type de Userpaíses for exclude, a promoção se aplica a usuários fora dos países.

Se a propriedade type de Userpaíses não estiver definida, ela será tratada como include e a promoção será aplicada aos usuários de os países listados.

<Success> ou <Issues> são presentes em cada mensagem.

<Success> ou <Issues> são presentes em cada mensagem.

O tipo de problema encontrado.

Os valores válidos são warning, error e failure.