Promozioni

Se hai un backend che fornisce feed per più account, questo valore deve corrispondere al valore dell'attributo ID specificato nell'elemento <RequestorID> dei messaggi <OTA_HotelRateAmountNotifRQ> e <OTA_HotelAvailNotifRQ> per lo stesso account.

Promozioni per una proprietà. Ogni promozione viene applicata a una singola proprietà.

A meno che non venga utilizzato <Stacking>, quando sono idonee più promozioni viene applicata quella con lo sconto maggiore.

Se specificato, il valore deve essere "overlay". Quando il valore è "overlay", tutte le promozioni archiviate vengono eliminate prima di archiviare le promozioni specificate nel messaggio corrente.

Se non specificato, allora ogni promozione specificata nel messaggio corrente viene:

• Added (se nessuna delle promozioni archiviate ha lo stesso id)
• Updated (se una promozione archiviata ha lo stesso id)
• Deleted (se una promozione archiviata ha lo stesso id e il valore dell'attributo action per la promozione specificata nel messaggio corrente è "delete")

Una singola promozione per una proprietà. Tieni presente che se action="overlay" e <Promotion> non sono specificati, tutte le promozioni relative alla proprietà verranno eliminate.

Se devi utilizzare più di 99 promozioni, contatta il tuo Technical Account Manager (TAM).

Se specificato, il valore deve essere delete. Se il valore non è specificato e se non viene archiviata una promozione con lo stesso id, allora questa promozione viene archiviata. In caso contrario, se il valore non è specificato e se viene archiviata una promozione con lo stesso id, allora la promozione esistente viene aggiornata.

Se specifichi delete, la promozione archiviata con lo stesso id viene eliminata. Quando utilizzi delete, non includere nessun elemento secondario in <Promotion>. Inoltre, delete non è consentito insieme a <HotelPromotions action="overlay"/>.

La data o la data e l'ora di inizio (in base al fuso orario della proprietà), incluse, dell'intervallo.

• La data o la data/ora specificata da start deve essere precedente (o uguale) alla data o alla data/ora specificata da end.
• Se start non è specificato, l'intervallo è effettivamente illimitato in termini di ora di inizio.
• Se start viene compilato come data "AAAA-MM-GG", viene interpretato come data e ora "AAAA-MM-GGT00:00:00".

La data o la data e l'ora di fine (in base al fuso orario della proprietà), incluse, dell'intervallo.

• La data o la data/ora specificata da end deve essere successiva (o uguale) alla data o alla data/ora specificata da start.
• Se end non è specificato, l'intervallo è effettivamente illimitato in termini di ora di fine.
• Se end viene fornito come data "AAAA-MM-GG", viene interpretato come data e ora "AAAA-MM-GGT23:59:59".

I giorni della settimana consentiti nell'intervallo di date. Se il valore non viene specificato, saranno consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali.

I caratteri validi sono:

• M per lunedì
• T per martedì
• W per mercoledì
• H per giovedì
• F per venerdì
• S per sabato
• U per domenica

Sono valide tutte le combinazioni di caratteri.

I tipi di valore validi sono:

• Numero intero: il numero di giorni prima della data di check-in. Ad esempio, un valore 30 indica che la promozione si applica solo alle prenotazioni effettuate almeno 30 giorni prima della data di check-in.
• Durata ISO 8601 (giorni, ore e minuti): il numero di giorni (e, facoltativamente, ore/minuti) prima della data di check-in. Ad esempio, un valore P30D indica che la promozione si applica solo alle prenotazioni effettuate almeno 30 giorni prima della data di check-in. Un valore P30DT6H richiede la prenotazione entro le 18:00 del 30° giorno prima dell'arrivo.

I tipi di valore validi sono:

• Numero intero: il numero di giorni prima della data di check-in. Ad esempio, un valore 30 indica che la promozione si applica solo alle prenotazioni effettuate al massimo 30 giorni prima della data di check-in.
• Durata ISO 8601 (giorni, ore e minuti): il numero di giorni (e, facoltativamente, ore/minuti) prima della data di check-in. Ad esempio, un valore P30D indica che la promozione si applica solo alle prenotazioni effettuate al massimo 30 giorni prima della data di check-in. Un valore P30DT6H richiede la prenotazione a partire dalle ore 18:00 del trentesimo giorno prima dell'arrivo.

Definisce le restrizioni relative al valore massimo che può essere impostato per una tariffa dopo l'applicazione delle promozioni.

Le promozioni devono sempre specificare un <Discount> o un <BestDailyDiscount>, quindi per creare una promozione che applichi solo un <Ceiling>, un'opzione è impostare un <Discount> con un percentage di 0.

Se è configurato l'accatastamento, a un singolo soggiorno possono essere applicate più promozioni con <Ceiling>. A ogni promozione viene applicato il relativo sconto, immediatamente seguito dal relativo limite. L' esempio seguente mostra in che modo ogni limite contribuisce al calcolo della promozione successiva nello stack.

Esempio:

Definizione del prezzo di un soggiorno di una notte in cui AmountBeforeTax è equale a 100 e sono presenti due promozioni in serie:

1. Promozione con tipo di cumulo base, un fixed_amount di 25 e un amount_per_night massimo di 60
2. Promozione con tipo di cumulo second, fixed_amount pari a 25 e un limite superiore amount_per_night pari a 90

Ecco l'ordine di calcolo:

1. La promozione base viene applicata per prima e consente di ottenere uno sconto di AmountBeforeTax a 75, ma il limite massimo viene ridotto a 60.
2. La promozione second applica uno sconto sul AmountBeforeTax da 60 a 35. Questo valore è inferiore al limite di 90, pertanto il secondo limite non viene applicato. La tariffa finale è 35.

Il fatto che 60 sia un limite massimo complessivo più rigoroso è irrilevante poiché è valido solo per la promozione in questione e non può esserci un singolo limite massimo che si estenda all'intero stack di promozioni.

L'importo massimo che può essere impostato per una tariffa per notte dopo l'applicazione dello sconto.

Se è specificato anche un elemento <Floor>, questo deve essere impostato su un valore maggiore o uguale all'attributo amount_per_night in <Floor>.

amount_per_night viene applicato a tasse e commissioni quando sono incluse nella tariffa per notte utilizzando AmountAfterTax, ma non a quelle specificate utilizzando TaxFeeInfo.

Definisce le restrizioni relative al valore minimo che può essere impostato per una tariffa dopo l'applicazione delle promozioni.

Le promozioni devono sempre specificare un <Discount> o un <BestDailyDiscount>, quindi per creare una promozione che applichi solo un <Floor>, un'opzione è impostare un <Discount> con un percentage di 0.

La logica di <Floor> si applica ancora agli sconti di <FreeNights>, anche se alla notte senza costi è applicato uno sconto di 100%.

Se è configurato l'accatastamento, a un singolo soggiorno possono essere applicate più promozioni con <Floor>. A ogni promozione viene applicato il relativo sconto, immediatamente seguito dal prezzo minimo. L' esempio seguente mostra in che modo ogni livello contribuisce al calcolo della promozione successiva nello stack.

Esempio:

Definizione del prezzo di un soggiorno di una notte in cui AmountBeforeTax è equale a 100 e sono presenti due promozioni in serie:

1. Promozione con tipo di cumulo base, un fixed_amount di 25 e un minimo amount_per_night di 90
2. Promozione con tipo di cumulo second, fixed_amount pari a 25 e un valore minimo amount_per_night pari a 60

Ecco l'ordine di calcolo:

1. La promozione base viene applicata per prima e sconta il AmountBeforeTax a 75, ma il prezzo minimo viene poi aumentato a 90.
2. La promozione second applica uno sconto sul AmountBeforeTax da 90 a 65. Questo valore è superiore al limite minimo di 60, pertanto il secondo limite non viene applicato. La tariffa finale è 65.

Il fatto che 90 sia un limite inferiore complessivo più rigoroso è irrilevante poiché è valido solo per la promozione in questione e non può esserci un singolo limite inferiore che si estenda all'intero stack di promozioni.

L'importo minimo che può essere impostato per una tariffa per notte dopo l'applicazione dello sconto.

Se viene specificato anche un elemento <Ceiling>, questo deve essere impostato su un valore minore o uguale all'attributo amount_per_night in <Ceiling>.

amount_per_night viene applicato a tasse e commissioni quando sono incluse nella tariffa per notte utilizzando AmountAfterTax, ma non a quelle specificate utilizzando TaxFeeInfo.

Un intervallo di date che specifica il periodo in cui deve essere effettuato il check-in affinché venga applicata la promozione. Questo elemento non è richiesto se stai eliminando una o più promozioni.

È supportato anche il formato YearlessDate.

• Se una delle date (start o end) non include l'anno, entrambe devono essere compilate come date senza anno.
• Gli intervalli di date senza anno non devono includere il nuovo anno. Rappresenta invece l'intervallo come due intervalli di date adiacenti. Ad esempio, {"12-29", "01-05"} può essere rappresentato come {"12-29", "12-31"} e {"01-01", "01-05"}.

I giorni della settimana consentiti nell'intervallo di date. Se il valore non viene specificato, saranno consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali.

I caratteri validi sono:

• M per lunedì
• T per martedì
• W per mercoledì
• H per giovedì
• F per venerdì
• S per sabato
• U per domenica

Sono valide tutte le combinazioni di caratteri.

Un intervallo di date che specifica il periodo in cui deve essere effettuato il check-out affinché venga applicata la promozione. Questo elemento non è richiesto se stai eliminando una o più promozioni.

È supportato anche il formato YearlessDate.

• Se una delle date (start o end) non include l'anno, entrambe devono essere compilate come date senza anno.
• Gli intervalli di date senza anno non devono includere il nuovo anno. Rappresenta invece l'intervallo come due intervalli di date adiacenti. Ad esempio, {"12-29", "01-05"} può essere rappresentato come {"12-29", "12-31"} e {"01-01", "01-05"}.

I giorni della settimana consentiti nell'intervallo di date. Se il valore non viene specificato, saranno consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali.

I caratteri validi sono:

• M per lunedì
• T per martedì
• W per mercoledì
• H per giovedì
• F per venerdì
• S per sabato
• U per domenica

Sono valide tutte le combinazioni di caratteri.

È necessario specificare esattamente un valore per Discount o BestDailyDiscount.

Specifica lo sconto da applicare a questa promozione.

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Un valore decimale compreso tra 0 e 100 che specifica la percentuale di sconto. Viene applicato a AmountAfterTax (o AmountBeforeTax se AmountAfterTax non è specificato).

Esempi:

• Se AmountAfterTax è 100 e percentage è 20, allora

  tariffa promozionale = AmountAfterTax * (1 - percentuale di sconto)

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

• Se AmountBeforeTax è 100, percentage è 20 e TaxFeeInfo specifica una tassa pari a 10, allora

  tariffa promozionale = AmountBeforeTax * (1 - percentuale di sconto) + tassa

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

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Un valore decimale compreso tra 0 e 100 che specifica la percentuale di sconto base. Come per percentage, viene applicato a AmountAfterTax (o AmountBeforeTax se AmountAfterTax non è specificato).

A differenza di percentage, questo sconto viene sempre calcolato come percentuale delle tariffe di base, indipendentemente dalle promozioni precedenti che sono state applicate in sequenza.

Esempio:

• Supponiamo di avere due promozioni applicate in sequenza a un soggiorno di una notte al prezzo di 100. Il primo è uno sconto percentuale regolare del 10%, mentre il secondo è una percentuale di sconto base del 10%. Il tasso scontato sarà quindi 80, poiché entrambe le promozioni fanno uno sconto di 10. Tieni presente che se anche la seconda promozione fosse uno sconto percentuale normale, il tasso scontato sarebbe 81, poiché la seconda promozione offre uno sconto del 10% di 90.

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Un importo fisso che deve essere sottratto dalla somma delle AmountAfterTax tariffe per notte (o dalla somma delle tariffe per notte di AmountBeforeTax se AmountAfterTax non è specificato). Si presume che la valuta sia la stessa delle tariffe per notte. Se questo valore è maggiore della somma delle tariffe per notte, si avrà un valore pari a zero.

Esempi:

• Se si sta definendo il prezzo di un soggiorno di una notte in cui AmountBeforeTax è 90, AmountAfterTax è 100 e fixed_amount è 20, allora

  tariffa promozionale = AmountAfterTax - sconto fisso

  80,00 = 100 - 20

• Se si sta definendo il prezzo di un soggiorno di una notte in cui AmountBeforeTax è 100, fixed_amount è 20 e TaxFeeInfo specifica una tassa pari all'8%, allora

  tariffa promozionale = (AmountBeforeTax - sconto fisso) * (1 + tassa percentuale)

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

• Se si sta definendo il prezzo di un soggiorno di una notte in cui AmountBeforeTax è 50, fixed_amount è 60 e TaxFeeInfo specifica una tassa pari a 10, allora

  tariffa promozionale = (AmountBeforeTax - sconto fisso) * tassa

  10,00 = 0 + 10

• Se si sta definendo il prezzo di un soggiorno di tre notti in cui i valori di AmountAfterTax sono 100, 110 e 120, con fixed_amount pari a 150, allora

  tariffa promozionale = somma(AmountAfterTax) - (sconto fisso)

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

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Uno sconto fisso applicato a ogni tariffa per notte di AmountAfterTax (o alla N più economica se viene specificato applied_nights). Se AmountAfterTax non è specificato, viene applicato a AmountBeforeTax. Si presume che la valuta sia la stessa delle tariffe per notte. Se fixed_amount_per_night è maggiore di una tariffa per notte, questa tariffa viene ridotta a zero poiché lo sconto non può far diventare negativa una tariffa per notte.

Esempi:

• Se si sta definendo il prezzo di un soggiorno di tre notti in cui i valori di AmountAfterTax sono 100, 110 e 120, con fixed_amount_per_night pari a 10, allora

  tariffa promozionale = somma(AmountBeforeTax - importo sconto fisso)

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

• Se si sta definendo il prezzo di un soggiorno di tre notti in cui i valori di AmountAfterTax sono 10, 50 e 100, con fixed_amount_per_night pari a 20, allora

  tariffa promozionale = somma(AmountAfterTax - importo sconto fisso)

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

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Se vengono specificate le tariffe per notte AmountAfterTax, il prezzo del soggiorno, incluse tasse e commissioni, viene impostato sul valore specificato. Se viene specificato AmountBeforeTax, indipendentemente dal fatto che AmountAfterTax sia specificato o meno, il prezzo al netto delle imposte per il soggiorno viene impostato sul valore specificato. Si presume che la valuta sia la stessa delle tariffe per notte.

Se AmountAfterTax deve riflettere una imposta percentuale, l'impostazione di un prezzo fisso per AmountBeforeTax può comportare tasse e commissioni imprecise. In generale, è vivamente consigliato di utilizzare TaxFeeInfo per specificare le tasse e le commissioni di una proprietà.

Esempi:

• Se si sta definendo il prezzo di un soggiorno di una notte in cui AmountBeforeTax è 90, AmountAfterTax è 100 e fixed_price è 80, la tariffa promozionale è 80.
• Se si sta definendo il prezzo di un soggiorno di una notte in cui AmountBeforeTax è 100, fixed_amount è 80 e TaxFeeInfo specifica una tassa pari all'8%, allora

  tariffa promozionale = prezzo fisso * (1 + tassa percentuale)

  86,40 = 80 * 1,08

• Se si sta definendo il prezzo di un soggiorno di tre notti in cui i valori di AmountAfterTax sono 100, 110 e 120, con fixed_amount pari a 300, allora

  tariffa promozionale = 300

È obbligatorio specificare un solo valore tra percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price o fixed_price_per_night.

Se vengono specificate le tariffe per notte AmountAfterTax, il prezzo per ogni notte di soggiorno, incluse tasse e commissioni, viene impostato sul valore specificato. Se viene specificato AmountBeforeTax, il prezzo al netto delle imposte per ogni notte di soggiorno viene impostato sul valore specificato, indipendentemente dal fatto che AmountAfterTax sia specificato o meno. Si presume che la valuta sia la stessa delle tariffe per notte.

Se AmountAfterTax deve riflettere una imposta percentuale, l'impostazione di un prezzo fisso per AmountBeforeTax può comportare tasse e commissioni imprecise. In generale, è vivamente consigliato di utilizzare TaxFeeInfo per specificare le tasse e le commissioni di una proprietà.

Se viene specificato applied_nights, il nuovo prezzo viene applicato alle N notti meno costose.

Esempi:

• Se si sta definendo il prezzo di un soggiorno di 2 notti in cui i valori di AmountBeforeTax sono 90, 90; i valori di AmountAfterTax sono 100, 100; e fixed_price è 80, la tariffa promozionale è 80 + 80 = 160.
• Se si sta definendo il prezzo di un soggiorno di 2 notti in cui AmountBeforeTax è 100, 100; fixed_amount è 80 e TaxFeeInfo specifica una tassa pari all'8%, allora la tariffa della promozione è (80 + 80) * 1,08 = 172,8.
• Se si sta definendo il prezzo di un soggiorno di tre notti in cui i valori di AmountAfterTax sono 100, 110 e 120, con fixed_amount pari a 110, il tasso di promozione è 110 * 3 = 330.

Deve essere utilizzato solo con percentage o fixed_amount_per_night.

Il numero di notti a cui viene applicato lo sconto, a partire dalla meno costosa. Deve essere un numero intero compreso tra 1 e 99. Se non specificato, lo sconto viene applicato a tutte le notti.

Numero di notti necessarie per l'applicazione dello sconto. Ogni sconto viene applicato a un segmento separato di notti del soggiorno.

Ad esempio, per un soggiorno di 10 notti in cui stay_nights è equale a 4 (e repeats è true), esistono due segmenti di notti di soggiorno: dalla prima alla quarta notte e dalla quinta all'ottava notte; la nona e la decima notte non fanno parte di un segmento di notti di soggiorno.

Indica se lo sconto può essere applicato a più segmenti di notti di soggiorno. Se false, viene scontato solo il segmento di notti di soggiorno all'inizio dell'itinerario. Se true, viene applicato uno sconto a qualsiasi segmento di notti del soggiorno.

Ad esempio, se stay_nights è 4 e l'itinerario è di 10 notti, se repeats è true, vengono scontati 2 segmenti (notti 1-4 e notti 5-8); ma se repeats è false, viene scontato solo un segmento (notti 1-4).

È necessario specificare esattamente un valore per Discount o BestDailyDiscount.

Specifica un sconto giornaliero che può essere applicato a una notte di soggiorno. Questo è in contrasto con Discount, che applica gli sconti a interi soggiorni.

Ogni proprietà può avere un singolo gruppo di promozioni considerate "migliori giornaliere". Ciò significa che per ogni notte di soggiorno, viene selezionata e può essere applicata la singola promozione "migliore giornaliera" idonea che offre lo sconto più elevato per quella notte.

Stacking può essere specificato con BestDailyDiscount. Deve essere impostato su base o none. Gli sconti "migliori giornalieri" che generano lo sconto più elevato per ogni notte vengono combinati e trattati come uno sconto per un singolo soggiorno (ovvero Discount), rispettando il tipo di cumulo configurato. Questo sconto combinato viene confrontato con altre promozioni <Discount> idonee e può essere cumulato con queste per trovare la promozione o la combinazione che offre lo sconto più elevato. La combinazione di BestDailyDiscount o un singolo Discount, a seconda di quale genera il prezzo più basso, viene selezionata e applicata per il tipo di cumulo base.

StayDates può essere specificato con questo tipo di sconto, ma application deve essere impostato su overlap

È necessario specificare un solo valore tra percentage, fixed_amount e fixed_price.

Un valore decimale compreso tra 0 e 100 che specifica la percentuale di sconto. Viene applicato a AmountAfterTax (o AmountBeforeTax se AmountAfterTax non è specificato).

Esempi:

• Se AmountAfterTax per una notte di soggiorno è 100 e percentage è 20, allora

  tariffa promozionale = AmountAfterTax * (1 - percentuale di sconto)

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

• Se AmountBeforeTax per una notte di soggiorno è 100, percentage è 20 e TaxFeeInfo specifica una tassa pari a 10, allora

  tariffa promozionale = AmountBeforeTax * (1 - percentuale di sconto) + tassa

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

È necessario specificare un solo valore tra percentage, fixed_amount e fixed_price.

Un importo fisso da sottrarre a una singola AmountAfterTax tariffa per notte (o AmountBeforeTax tariffa per notte se AmountAfterTax non è specificato). Si presume che la valuta sia la stessa delle tariffe per notte. Se questo valore è maggiore della somma delle tariffe per notte, si avrà un valore pari a zero.

Esempi:

• Se AmountBeforeTax per una sola notte è 90, AmountAfterTax è 100 e fixed_amount è 20, allora

  tariffa promozionale = AmountAfterTax - sconto fisso

  80,00 = 100 - 20

• Se AmountBeforeTax per una sola notte è 100, fixed_amount è 20 e TaxFeeInfo specifica una tassa pari all'8%, allora

  tariffa promozionale = (AmountBeforeTax - sconto fisso) * (1 + tassa percentuale)

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

È necessario specificare un solo valore tra percentage, fixed_amount e fixed_price.

Se vengono specificate le tariffe per notte AmountAfterTax, il prezzo per la notte di soggiorno, incluse tasse e commissioni, viene impostato sul valore specificato. Se viene specificato AmountBeforeTax, indipendentemente dal fatto che AmountAfterTax sia specificato o meno, il prezzo al netto delle imposte per il soggiorno viene impostato sul valore specificato. Si presume che la valuta sia la stessa delle tariffe per notte.

Esempi:

• Se AmountBeforeTax per una sola notte è 90, AmountAfterTax è 100 e fixed_price è 80, la tariffa della promozione è 80.
• Se AmountBeforeTax per una sola notte è 100, fixed_amount è 80 e TaxFeeInfo specifica una tassa pari all'8%, allora

  tariffa promozionale = prezzo fisso * (1 + tassa percentuale)

  86,40 = 80 * 1,08

Contenitore per una regola della tariffa per membri che attiva un'opzione di interfaccia utente specifica per lo sconto associato.

Questo elemento non deve essere specificato, a meno che non sia specificato anche <Discount>.

ID della regola tariffaria associata a un programma fedeltà.

Questa impostazione specifica se a una singola tariffa sono applicabili più promozioni:

• any: cumulabile con qualsiasi altra promozione (tranne none), ma l'ordine in cui le promozioni devono essere applicate non è garantito.
• base: la migliore promozione base idonea viene selezionata e applicata per prima, prima delle altre promozioni. In precedenza era chiamato base_only.
• second: la migliore promozione second idonea viene selezionata e applicata dopo una promozione base (se applicabile) e prima delle promozioni any.
• none: non cumulabile con altre promozioni.

Tra le combinazioni consentite, alla tariffa verrà applicato l'insieme di promozioni che offre lo sconto più elevato.

Descrive in che modo deve essere applicata la promozione.

I valori validi sono:

• all: applica la promozione a ogni notte nell'itinerario se tutte le date nell'itinerario si sovrappongono alle date del soggiorno.
• any: applica la promozione a tutte le notti nell'itinerario se una qualsiasi data nell'itinerario si sovrappone a una data nell'intervallo di date del soggiorno.
• overlap: applica la promozione solo alle notti dell'itinerario che si sovrappongono a una data compresa nell'intervallo di date del soggiorno.

Questo attributo deve essere sempre specificato.

• Se per <Discount> è specificato percentage e application è impostato su all o any, lo sconto viene applicato come percentuale dell'intero soggiorno.
• Se per <Discount> è specificato percentage e application è impostato su overlap, lo sconto viene applicato come percentuale delle tariffe per notte per le notti che si sovrappongono.
• La combinazione di <Discount> con specificato fixed_amount e application impostato su overlap non è valida.
• <FreeNights> supporta tutti i valori application. Tieni presente che per overlap, solo le notti di soggiorno sovrapposte vengono prese in considerazione per i requisiti di sconto.

Un intervallo di date che specifica le date in cui deve essere applicata la promozione.

È supportato anche il formato YearlessDate.

• Se una delle date (start o end) non include l'anno, entrambe devono essere compilate come date senza anno.
• Gli intervalli di date senza anno non devono includere il nuovo anno. Rappresenta invece l'intervallo come due intervalli di date adiacenti. Ad esempio, {"12-29", "01-05"} può essere rappresentato come {"12-29", "12-31"} e {"01-01", "01-05"}.

Se vuoi impostare l'intervallo StayDates per consentire la promozione in giorni specifici della settimana, devi impostare la data start come data corrente senza end in modo che la promozione non scada.

Devi specificare il valore start se il valore end non è fornito.

Devi specificare il valore end se il valore start non è fornito.

I giorni della settimana consentiti nell'intervallo di date. Se il valore non viene specificato, saranno consentiti tutti i giorni nell'intervallo di date. Ogni carattere nella stringa specifica un giorno. Ad esempio, "MTWHF" specifica che nell'intervallo di date sono consentiti i giorni feriali.

I caratteri validi sono:

• M per lunedì
• T per martedì
• W per mercoledì
• H per giovedì
• F per venerdì
• S per sabato
• U per domenica

Sono valide tutte le combinazioni di caratteri.

I valori validi sono include e exclude.

Se type UserCountries è impostato su include, la promozione si applica agli utenti dei paesi elencati.

Se type UserCountries è exclude, la promozione si applica agli utenti al di fuori dei paesi elencati.

Se type UserCountries non è impostato, viene trattato come include e la promozione viene applicata agli utenti dei paesi elencati.

In ogni messaggio è presente <Success> o <Issues>.

In ogni messaggio è presente <Success> o <Issues>.

Il tipo di problema riscontrato.

I valori validi sono warning, error e failure.