Promocje

Jeśli masz backend, który udostępnia pliki danych dla wielu kont, ta wartość musi być zgodna z wartością atrybutu ID określoną w elemencie <RequestorID> wiadomości <OTA_HotelRateAmountNotifRQ> i <OTA_HotelAvailNotifRQ> dla tego samego konta.

Promocje dotyczące usługi. Każda promocja dotyczy tylko jednej usługi.

Jeśli nie użyjesz <Stacking>, do rezerwacji zostanie zastosowana promocja z największą zniżką, gdy kwalifikuje się do niej kilka promocji.

Jeśli została określona, wartość musi wynosić "overlay". Gdy wartość wynosi "overlay", wszystkie zapisane promocje są usuwane przed zapisaniem promocji określonych w bieżącej wiadomości.

Jeśli nie określisz tu żadnej wartości, każda promocja określona w bieżącej wiadomości będzie:

• Added (jeśli żadna z przechowywanych promocji nie ma tego samego atrybutu id)
• Updated (jeśli zapisana promocja ma taką samą wartość id)
• Deleted (jeśli zapisana promocja ma taką samą wartość atrybutu action jak promocja określona w bieżącej wiadomości, a wartość atrybutu id wynosi "delete")

Jedna promocja dotycząca obiektu. Pamiętaj, że jeśli nie określisz action="overlay" ani <Promotion>, wszystkie promocje dotyczące usługi zostaną usunięte.

Jeśli chcesz użyć więcej niż 99 promocji, skontaktuj się z technicznym menedżerem konta.

Jeśli została określona, wartość musi wynosić delete. Jeśli nie zostanie podany i nie jest przechowywana promocja z tym samym id, ta promocja zostanie zapisana. W przeciwnym razie, jeśli nie zostanie określona i jest przechowywana promocja z tym samym identyfikatorem id, istniejąca promocja zostanie zaktualizowana.

Jeśli podasz wartość delete, zapisana promocja z tym samym identyfikatorem id zostanie usunięta. Jeśli używasz elementu delete, nie umieszczaj w nim żadnych elementów podrzędnych.<Promotion> Ponadto nie można używać delete w połączeniu z <HotelPromotions action="overlay"/>.

Data lub data i godzina rozpoczęcia zakresu (w strefie czasowej usługi) włącznie z wartościami granicznymi.

• Data lub data i godzina określone przez start muszą być wcześniejsze niż data lub data i godzina określone przez end (lub takie same).
• Jeśli nie podasz wartości start, zakres będzie w zasadzie nieograniczony pod względem czasu rozpoczęcia.
• Jeśli pole start zawiera datę w formacie „RRRR-MM-DD”, jest ona interpretowana jako data i godzina „RRRR-MM-DDT00:00:00”.

Data lub data i godzina zakończenia zakresu (według strefy czasowej usługi) włącznie.

• Data lub data i godzina określone przez end muszą być późniejsze (lub takie same) niż data lub data i godzina określone przez start.
• Jeśli nie podasz wartości end, zakres będzie w zasadzie nieograniczony pod względem czasu zakończenia.
• Jeśli end jest podana jako data „RRRR-MM-DD”, jest interpretowana jako data i godzina „RRRR-MM-DDT23:59:59”.

Dni tygodnia dozwolone w zakresie dat. Jeśli nie określisz dni, wszystkie dni w zakresie dat będą dozwolone. Każdy znak w ciągu określa dzień. Na przykład „MTWHF” oznacza, że w zakresie dat dozwolone są dni powszednie.

Prawidłowe znaki to:

• M w przypadku poniedziałku
• T – wtorek
• W na środę
• H w przypadku czwartku
• F w piątek
• S w sobotę
• U w niedzielę

Dowolna kombinacja znaków jest prawidłowa.

Prawidłowe typy wartości to:

• Liczba całkowita: liczba dni przed datą zameldowania. Na przykład wartość 30 oznacza, że promocja dotyczy tylko rezerwacji dokonanych co najmniej 30 dni przed datą zameldowania.
• Czas trwania w formacie ISO 8601 (dni, godziny i minuty): liczba dni (opcjonalnie godzin i minut) przed datą zameldowania. Na przykład wartość P30D oznacza, że promocja dotyczy tylko rezerwacji dokonanych co najmniej 30 dni przed datą zameldowania. Wartość P30DT6H wymaga rezerwacji najpóźniej do godziny 18:00 w 30 dniu przed przyjazdem.

Prawidłowe typy wartości to:

• Liczba całkowita: liczba dni przed datą zameldowania. Na przykład wartość 30 oznacza, że promocja dotyczy tylko rezerwacji dokonanych maksymalnie 30 dni przed datą zameldowania.
• Czas trwania w formacie ISO 8601 (dni, godziny i minuty): liczba dni (opcjonalnie godzin i minut) przed datą zameldowania. Na przykład wartość P30D oznacza, że promocja dotyczy tylko rezerwacji dokonanych najpóźniej 30 dni przed datą zameldowania. Wartość P30DT6H wymaga rezerwacji najpóźniej o godzinie 18:00 w 30 dniu przed przyjazdem.

Określa ograniczenia dotyczące maksymalnej wartości, jaką może osiągnąć stawka po zastosowaniu promocji.

Promocje muszą zawsze określać <Discount> lub <BestDailyDiscount>, więc aby utworzyć promocję, która stosuje tylko <Ceiling>, można ustawić <Discount> z wartością percentage równą 0.

Jeśli kumulowanie jest skonfigurowane, do jednego pobytu może mieć zastosowanie kilka promocji z <Ceiling>. Każda promocja zastosuje rabat, a następnie limit. Poniższy przykład pokazuje, jak każdy limit przyczynia się do obliczenia kolejnej promocji w stosie.

Przykład:

Cena za 1-dniowy pobyt, w przypadku którego AmountBeforeTax wynosi 100, a dostępne są 2 promocje:

1. Promocja z typem łączenia base, wartością fixed_amount 25 i limitem amount_per_night 60
2. Promocja z typem łączenia second, fixed_amount o wartości 25 i limitem amount_per_night wynoszącym 90

Kolejność obliczeń jest następująca:

1. Promocja base jest stosowana w pierwszej kolejności i obniża cenę AmountBeforeTax do 75 zł, ale potem limit obniża ją do 60 zł.
2. Promocja second obniża cenę AmountBeforeTax z 60 zł do 35 zł. Jest to poniżej limitu 90, więc drugi limit nie jest stosowany. Stawka końcowa to 35.

Fakt, że 60 zł to bardziej rygorystyczny ogólny limit, nie ma znaczenia, ponieważ obowiązuje on tylko w przypadku danej promocji, a nie może istnieć jeden limit obejmujący cały stos promocji.

Maksymalna kwota, na jaką można ustawić cenę za noc po zastosowaniu zniżki.

Jeśli określony jest też element <Floor>, ta wartość musi być większa lub równa wartości atrybutu amount_per_night w <Floor>.

amount_per_night jest stosowana do podatków i opłat, gdy są one uwzględnione w cenie za noc przy użyciu AmountAfterTax, ale nie do tych określonych za pomocą TaxFeeInfo.

Określa ograniczenia dotyczące minimalnej wartości, jaką można ustawić po zastosowaniu promocji.

Promocje muszą zawsze określać <Discount> lub <BestDailyDiscount>, więc aby utworzyć promocję, która stosuje tylko <Floor>, można ustawić <Discount> z wartością percentage równą 0.

Logika <Floor> nadal obowiązuje w przypadku zniżek <FreeNights>, nawet jeśli do bezpłatnej nocy zastosowano zniżkę 100%.

Jeśli kumulowanie jest skonfigurowane, do jednego pobytu może mieć zastosowanie kilka promocji z <Floor>. Każda promocja zastosuje rabat, a następnie cenę minimalną. Poniższy przykład pokazuje, jak każda wartość progowa wpływa na obliczanie kolejnej promocji w stosie.

Przykład:

Cena za 1-dniowy pobyt, w przypadku którego AmountBeforeTax wynosi 100, a dostępne są 2 promocje:

1. Promocja z typem łączenia base, wartością fixed_amount 25 i wartością minimalną amount_per_night 90
2. Promocja z typem łączenia second, fixed_amount o wartości 25 i wartością minimalną amount_per_night wynoszącą 60

Kolejność obliczeń jest następująca:

1. Promocja base jest stosowana w pierwszej kolejności i obniża cenę AmountBeforeTax do 75, ale potem dolna granica podnosi ją do 90.
2. Promocja second obniża cenę AmountBeforeTax z 90 zł do 65 zł. Jest to powyżej progu 60, więc drugie piętro nie jest stosowane. Stawka końcowa to 65.

Fakt, że wartość 90 jest bardziej rygorystycznym progiem minimalnym, nie ma znaczenia, ponieważ obowiązuje tylko w przypadku danej promocji i nie może istnieć jeden próg minimalny obejmujący cały stos promocji.

Minimalna kwota, na jaką można ustawić cenę za noc po zastosowaniu rabatu.

Jeśli określony jest też element <Ceiling>, ta wartość musi być mniejsza lub równa wartości atrybutu amount_per_night w elemencie <Ceiling>.

amount_per_night jest stosowana do podatków i opłat, gdy są one uwzględnione w cenie za noc przy użyciu AmountAfterTax, ale nie do tych określonych za pomocą TaxFeeInfo.

Zakres dat określający, kiedy musi nastąpić zameldowanie, aby można było zastosować promocję. Ten element nie jest wymagany, jeśli usuwasz co najmniej jedną promocję.

Obsługiwany jest też format YearlessDate.

• Jeśli jedna z wartości start lub end jest datą bez roku, obie muszą być datami bez roku.
• Zakresy dat bez roku nie mogą obejmować nowego roku. Zamiast tego przedstaw zakres jako 2 sąsiadujące ze sobą zakresy dat. Na przykład {"12-29", "01-05"} można przedstawić jako {"12-29", "12-31"} i {"01-01", "01-05"}.

Dni tygodnia dozwolone w zakresie dat. Jeśli nie określisz dni, wszystkie dni w zakresie dat będą dozwolone. Każdy znak w ciągu określa dzień. Na przykład „MTWHF” oznacza, że w zakresie dat dozwolone są dni powszednie.

Prawidłowe znaki to:

• M w przypadku poniedziałku
• T – wtorek
• W na środę
• H w przypadku czwartku
• F w piątek
• S w sobotę
• U w niedzielę

Dowolna kombinacja znaków jest prawidłowa.

Zakres dat określający, kiedy musi nastąpić płatność, aby można było zastosować promocję. Ten element nie jest wymagany, jeśli usuwasz co najmniej jedną promocję.

Obsługiwany jest też format YearlessDate.

• Jeśli jedna z wartości start lub end jest datą bez roku, obie muszą być datami bez roku.
• Zakresy dat bez roku nie mogą obejmować nowego roku. Zamiast tego przedstaw zakres jako 2 sąsiadujące ze sobą zakresy dat. Na przykład {"12-29", "01-05"} można przedstawić jako {"12-29", "12-31"} i {"01-01", "01-05"}.

Dni tygodnia dozwolone w zakresie dat. Jeśli nie określisz dni, wszystkie dni w zakresie dat będą dozwolone. Każdy znak w ciągu określa dzień. Na przykład „MTWHF” oznacza, że w zakresie dat dozwolone są dni powszednie.

Prawidłowe znaki to:

• M w przypadku poniedziałku
• T – wtorek
• W na środę
• H w przypadku czwartku
• F w piątek
• S w sobotę
• U w niedzielę

Dowolna kombinacja znaków jest prawidłowa.

Należy podać dokładnie jedną z tych wartości: Discount lub BestDailyDiscount.

Określa rabat, który ma zostać zastosowany w ramach tej promocji.

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Wartość dziesiętna z zakresu 0–100 określająca rabat procentowy. Jest on stosowany do elementu AmountAfterTax (lub AmountBeforeTax, jeśli element AmountAfterTax nie został określony).

Przykłady:

• Jeśli AmountAfterTax wynosi 100, a percentage wynosi 20, to

  cena promocyjna = AmountAfterTax * (1 – rabat procentowy)

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

• Jeśli AmountBeforeTax wynosi 100, percentage wynosi 20, a w elemencie TaxFeeInfo określono podatek w wysokości 10,

  cena promocyjna = AmountBeforeTax * (1 – rabat procentowy) + podatek

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

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Wartość dziesiętna z zakresu 0–100 określająca procent rabatu podstawowego. Podobnie jak w przypadku percentage, jest ona stosowana do AmountAfterTax (lub AmountBeforeTax, jeśli nie określono AmountAfterTax).

W przeciwieństwie do percentage ten rabat jest zawsze obliczany jako procent stawek podstawowych, niezależnie od wcześniejszych promocji, które zostały zastosowane kolejno.

Przykład:

• Załóżmy, że mamy 2 promocje, które są stosowane kolejno do 1-dniowego pobytu w cenie 100. Pierwszy to zwykły rabat procentowy w wysokości 10%, a drugi to rabat procentowy w wysokości 10% ceny podstawowej. Wtedy cena po rabacie wyniesie 80, ponieważ obie promocje obniżają cenę o 10. Jeśli druga promocja również byłaby zwykłym rabatem procentowym, cena po rabacie wyniosłaby 81, ponieważ druga promocja obniża cenę o 10% z 90.

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Stała kwota do odjęcia od sumy AmountAfterTax stawek za noc (lub sumy AmountBeforeTax stawek za noc, jeśli nie określono AmountAfterTax). Zakłada się, że jest ona podana w tej samej walucie co ceny za noc. Jeśli jest ona większa niż suma cen za noc, wynikowa wartość wynosi zero.

Przykłady:

• Jeśli obliczamy cenę za 1 noc, a AmountBeforeTax wynosi 90, AmountAfterTax wynosi 100, a fixed_amount wynosi 20, to

  cena promocyjna = AmountAfterTax – stały rabat

  80,00 = 100 – 20

• Jeśli wyceniamy pobyt na 1 noc, a AmountBeforeTax wynosi 100, fixed_amount wynosi 20, a w informacjach TaxFeeInfo podano podatek w wysokości 8%, to

  cena promocyjna = (AmountBeforeTax – stała zniżka) * (1 + podatek procentowy)

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

• Jeśli wyceniamy pobyt na 1 noc, a wartość AmountBeforeTax wynosi 50, wartość fixed_amount wynosi 60, a w elemencie TaxFeeInfo określono podatek w wysokości 10,

  stawka promocyjna = (AmountBeforeTax - stała zniżka) * podatek

  10,00 = 0 + 10

• Jeśli wyceniamy 3-dniowy pobyt, w którym wartości AmountAfterTax wynoszą 100, 110 i 120, a wartość fixed_amount to 150, to

  stawka promocyjna = suma(AmountAfterTax) – (stała zniżka)

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

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Stały rabat stosowany do każdej z AmountAfterTax cen za noc (lub do najtańszych N, jeśli określono applied_nights). Jeśli AmountAfterTax nie został określony, jest stosowany do AmountBeforeTax. Zakłada się, że jest ona podana w tej samej walucie co ceny za noc. Jeśli fixed_amount_per_night jest większa niż cena za noc, cena za noc jest zmniejszana do zera – rabat nie może spowodować, że cena za noc będzie ujemna.

Przykłady:

• Jeśli wyceniamy 3-dniowy pobyt, a wartości AmountAfterTax wynoszą 100, 110 i 120, a wartość fixed_amount_per_night wynosi 10, to

  stawka promocji = suma(AmountBeforeTax – stała kwota rabatu)

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

• Jeśli wyceniamy 3-dniowy pobyt, a wartości AmountAfterTax wynoszą 10, 50 i 100, a wartość fixed_amount_per_night to 20, to

  stawka promocji = suma(AmountAfterTax – stała kwota rabatu)

  110,00 zł = (0 zł + (50 zł – 20 zł) + (100 zł – 20 zł))

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Jeśli określono AmountAfterTax ceny za noc, ta wartość ustawia cenę pobytu, w tym podatki i opłaty, na podaną wartość. Jeśli podasz wartość AmountBeforeTax, cena pobytu przed opodatkowaniem zostanie ustawiona na podaną wartość, niezależnie od tego, czy podasz wartość AmountAfterTax. Zakłada się, że jest ona podana w tej samej walucie co ceny za noc.

Jeśli AmountAfterTax ma odzwierciedlać podatek procentowy, ustawienie stałej ceny dla AmountBeforeTax może spowodować nieprawidłowe obliczenie podatków i opłat. Zdecydowanie zalecamy używanie elementu TaxFeeInfo do określania podatków i opłat za obiekt.

Przykłady:

• Jeśli ustalamy cenę za 1 noc, a AmountBeforeTax wynosi 90, AmountAfterTax wynosi 100, a fixed_price wynosi 80, to cena promocyjna wynosi 80.
• Jeśli wyceniamy pobyt na 1 noc, a AmountBeforeTax wynosi 100, fixed_amount wynosi 80, a TaxFeeInfo określa podatek w wysokości 8%, to

  stawka promocyjna = stała cena * (1 + procent podatku)

  86,40 = 80 * 1,08

• Jeśli wyceniamy 3-dniowy pobyt, w którym wartości AmountAfterTax wynoszą 100, 110 i 120, a wartość fixed_amount wynosi 300, to

  promotion rate = 300

Wymagane jest podanie dokładnie jednej z tych wartości: percentage, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price lub fixed_price_per_night.

Jeśli określono AmountAfterTax cen za noc, cena za każdą noc pobytu, w tym podatki i opłaty, zostanie ustawiona na podaną wartość. Jeśli podasz wartość AmountBeforeTax, cena przed opodatkowaniem za każdą noc pobytu zostanie ustawiona na określoną wartość, niezależnie od tego, czy podasz wartość AmountAfterTax. Zakłada się, że jest ona podana w tej samej walucie co ceny za noc.

Jeśli AmountAfterTax ma odzwierciedlać podatek procentowy, ustawienie stałej ceny dla AmountBeforeTax może spowodować nieprawidłowe obliczenie podatków i opłat. Zdecydowanie zalecamy używanie elementu TaxFeeInfo do określania podatków i opłat za obiekt.

Jeśli określono parametr applied_nights, nowa cena zostanie zastosowana do najtańszych N nocy.

Przykłady:

• Jeśli ustalamy cenę za 2-nocny pobyt, a wartości AmountBeforeTax to 90, 90; wartości AmountAfterTax to 100, 100; a wartość fixed_price to 80, to cena promocyjna wynosi 80 + 80 = 160.
• Jeśli wyceniamy 2-nocny pobyt, w którym AmountBeforeTax wynosi 100, 100, fixed_amount wynosi 80, a TaxFeeInfo określa podatek w wysokości 8%, to cena promocyjna wynosi (80 + 80) * 1,08 = 172,8.
• Jeśli cena 3-dniowego pobytu, w którym wartości AmountAfterTax wynoszą 100, 110 i 120, a wartość fixed_amount wynosi 110, to cena promocyjna wynosi 110 * 3 = 330.

Ten atrybut powinien być używany tylko z atrybutami percentage lub fixed_amount_per_night.

Liczba nocy, do których stosowany jest rabat, począwszy od najtańszej. Musi być liczbą całkowitą z zakresu od 1 do 99. Jeśli nie zostanie określony, rabat zostanie zastosowany do wszystkich nocy.

Liczba wymaganych nocy, aby zastosować zniżkę. Każda zniżka jest stosowana do oddzielnego segmentu nocy pobytu.

Jeśli np. pobyt trwa 10 nocy, a wartość parametru stay_nights wynosi 4 (i repeats ma wartość „true”), to istnieją 2 segmenty nocy pobytu: od 1 do 4 nocy i od 5 do 8 nocy. 9 i 10 noc nie należą do segmentu nocy pobytu.

Informacja o tym, czy rabat można zastosować do wielu segmentów nocy pobytu. Jeśli false, rabat obejmuje tylko segment nocy pobytu na początku planu podróży. Jeśli true, rabat obejmuje każdy segment nocy pobytu.

Jeśli np. stay_nights to 4, a plan podróży obejmuje 10 nocy, to jeśli repeats to true, rabat obejmuje 2 segmenty (noce 1–4 i 5–8), ale jeśli repeats to false, rabat obejmuje tylko 1 segment (noce 1–4).

Należy podać dokładnie jedną z tych wartości: Discount lub BestDailyDiscount.

Określa dzienny rabat, który można zastosować do nocy pobytu. Różni się to od Discount, która stosuje rabaty do całych pobytów.

Każda usługa może mieć jedną grupę promocji, które są uznawane za „najlepsze codzienne”. Oznacza to, że w przypadku każdej nocy pobytu wybierana jest jedna „najlepsza dzienna” promocja, która kwalifikuje się do zastosowania i zapewnia największy rabat na tę noc.

Wartość Stacking można określić za pomocą parametru BestDailyDiscount. Musi mieć wartość base lub none. „Najlepsze dzienne” zniżki, które zapewniają największą zniżkę na każdą noc, są łączone i traktowane jako pojedyncza zniżka na pobyt (czyli Discount) z zachowaniem skonfigurowanego typu łączenia. Ten łączny rabat jest porównywany z innymi kwalifikującymi się promocjami <Discount> i można go z nimi łączyć, aby znaleźć jedną promocję lub kombinację promocji, która zapewnia największy rabat. Wybierana i stosowana jest kombinacja BestDailyDiscount lub pojedyncza Discount, w zależności od tego, która z nich daje niższą cenę, w przypadku typu łączenia base.

W przypadku tego typu rabatu można określić wartość StayDates, ale wartość application musi być ustawiona na overlap.

Wymagany jest dokładnie jeden z tych atrybutów: percentage, fixed_amount lub fixed_price.

Wartość dziesiętna z zakresu 0–100 określająca rabat procentowy. Jest on stosowany do elementu AmountAfterTax (lub AmountBeforeTax, jeśli element AmountAfterTax nie został określony).

Przykłady:

• Jeśli AmountAfterTax za nocleg wynosi 100, a percentage wynosi 20, to

  cena promocyjna = AmountAfterTax * (1 – rabat procentowy)

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

• Jeśli wartość AmountBeforeTax za nocleg wynosi 100, wartość percentage wynosi 20, a TaxFeeInfo określa podatek w wysokości 10, to

  cena promocyjna = AmountBeforeTax * (1 – rabat procentowy) + podatek

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

Wymagany jest dokładnie jeden z tych atrybutów: percentage, fixed_amount lub fixed_price.

Stała kwota do odjęcia od pojedynczej AmountAfterTax stawki za noc (lub AmountBeforeTax stawki za noc, jeśli AmountAfterTax nie jest określona). Zakłada się, że jest ona podana w tej samej walucie co ceny za noc. Jeśli jest ona większa niż suma cen za noc, wynikowa wartość wynosi zero.

Przykłady:

• Jeśli AmountBeforeTax za jedną noc wynosi 90, AmountAfterTax wynosi 100, a fixed_amount wynosi 20, to

  cena promocyjna = AmountAfterTax – stały rabat

  80,00 = 100 – 20

• Jeśli wartość AmountBeforeTax za jedną noc wynosi 100, wartość fixed_amount wynosi 20, a TaxFeeInfo określa podatek w wysokości 8%, to

  cena promocyjna = (AmountBeforeTax – stała zniżka) * (1 + podatek procentowy)

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

Wymagany jest dokładnie jeden z tych atrybutów: percentage, fixed_amount lub fixed_price.

Jeśli określono AmountAfterTax ceny za noc, cena za nocleg, w tym podatki i opłaty, zostanie ustawiona na podaną wartość. Jeśli podasz wartość AmountBeforeTax, cena pobytu przed opodatkowaniem zostanie ustawiona na podaną wartość, niezależnie od tego, czy podasz wartość AmountAfterTax. Zakłada się, że jest ona podana w tej samej walucie co ceny za noc.

Przykłady:

• Jeśli AmountBeforeTax za jedną noc wynosi 90, AmountAfterTax wynosi 100, a fixed_price wynosi 80, to cena promocyjna wynosi 80.
• Jeśli cena AmountBeforeTax za jedną noc wynosi 100, cena fixed_amount wynosi 80, a TaxFeeInfo określa podatek w wysokości 8%, to

  stawka promocyjna = stała cena * (1 + procent podatku)

  86,40 = 80 * 1,08

Kontener reguły stawki członkostwa, która wywołuje określony sposób wyświetlania interfejsu w przypadku powiązanej zniżki.

Tego elementu nie należy określać, chyba że podany jest też element <Discount>.

Identyfikator zasady cenowej powiązanej z programem członkostwa.

Promocje dotyczą ceny za plan podróży. Nie można ustawić maksymalnego rabatu na osobę.

Do jednej stawki można zastosować kilka promocji w zależności od tego ustawienia:

• any: można łączyć z innymi promocjami (z wyjątkiem none), ale nie gwarantujemy kolejności zastosowania promocji.
• base: Najlepsza kwalifikująca się base promocja jest wybierana i stosowana jako pierwsza, przed innymi promocjami. Wcześniej ta funkcja nosiła nazwę base_only.
• second: Najlepsza kwalifikująca się second promocja jest wybierana i stosowana po base promocji (jeśli ma zastosowanie) i przed any promocjami.
• none: Nie można łączyć z innymi promocjami.

Z dozwolonych kombinacji do stawki stosowany jest zestaw promocji, który zapewnia największy rabat.

Opisuje, jak należy zastosować promocję.

Prawidłowe wartości to:

• all: stosuje promocję do każdej nocy w planie podróży, jeśli wszystkie daty w planie podróży pokrywają się z datami pobytu.
• any: stosuje promocję do wszystkich nocy w planie podróży, jeśli jakakolwiek data w planie podróży pokrywa się z datą z zakresu dat pobytu.
• overlap: stosuje promocję tylko do tych nocy w planie podróży, które pokrywają się z datą z zakresu dat pobytu.

Ten atrybut musi być zawsze określony.

• Jeśli <Discount> określa percentage, a application ma wartość all lub any, rabat jest stosowany jako procent pełnego pobytu.
• Jeśli <Discount> ma wartość percentage, a application ma wartość overlap, rabat jest stosowany jako procent ceny za noc w przypadku nakładających się nocy.
• <Discount> z wartością fixed_amount i application ustawionym na overlap to nieprawidłowa kombinacja.
• <FreeNights> obsługuje wszystkie wartości application. Pamiętaj, że w przypadku overlap do wymagań dotyczących zniżki brane są pod uwagę tylko nakładające się noce pobytu.

Zakres dat, w których ma obowiązywać promocja.

Obsługiwany jest też format YearlessDate.

• Jeśli jedna z wartości start lub end jest datą bez roku, obie muszą być datami bez roku.
• Zakresy dat bez roku nie mogą obejmować nowego roku. Zamiast tego przedstaw zakres jako 2 sąsiadujące ze sobą zakresy dat. Na przykład {"12-29", "01-05"} można przedstawić jako {"12-29", "12-31"} i {"01-01", "01-05"}.

Jeśli chcesz ustawić StayDates zakres, aby zezwolić na promocję w określone dni tygodnia, ustaw start datę jako bieżącą datę bez end, aby promocja nie wygasła.

Jeśli nie podasz wartości end, musisz określić wartość start.

Jeśli nie podasz wartości start, musisz określić wartość end.

Dni tygodnia dozwolone w zakresie dat. Jeśli nie określisz dni, wszystkie dni w zakresie dat będą dozwolone. Każdy znak w ciągu określa dzień. Na przykład „MTWHF” oznacza, że w zakresie dat dozwolone są dni powszednie.

Prawidłowe znaki to:

• M w przypadku poniedziałku
• T – wtorek
• W na środę
• H w przypadku czwartku
• F w piątek
• S w sobotę
• U w niedzielę

Dowolna kombinacja znaków jest prawidłowa.

Prawidłowe wartości to include i exclude.

Jeśli parametr UserCountries type ma wartość include, promocja dotyczy użytkowników z wymienionych krajów.

Jeśli UserCountries type ma wartość exclude, promocja dotyczy użytkowników spoza wymienionych krajów.

Jeśli parametr UserCountries type nie jest ustawiony, jest traktowany jako include, a promocja jest stosowana do użytkowników z wymienionych krajów.

W każdej wiadomości występuje element <Success> lub <Issues>.

W każdej wiadomości występuje element <Success> lub <Issues>.

Rodzaj napotkanego problemu.

Prawidłowe wartości to warning, error i failure.