Promosi

Jika Anda memiliki backend yang menyediakan feed untuk beberapa akun, nilai ini harus cocok dengan nilai atribut ID yang ditentukan dalam elemen <RequestorID> dari pesan <OTA_HotelRateAmountNotifRQ> dan <OTA_HotelAvailNotifRQ> untuk akun yang sama.

Promosi untuk properti. Setiap promosi berlaku untuk satu properti.

Kecuali jika <Stacking> digunakan, promosi dengan diskon terbesar diterapkan ke pemesanan jika beberapa promosi memenuhi syarat.

Jika ditentukan, nilainya harus berupa "overlay". Jika bernilai "overlay", semua promosi yang disimpan akan dihapus sebelum menyimpan promosi yang ditentukan dalam pesan saat ini.

Jika tidak ditentukan, maka setiap promosi yang ditentukan dalam pesan saat ini akan:

• Added (jika tidak ada promosi tersimpan yang memiliki id yang sama)
• Updated (jika promosi yang disimpan memiliki id yang sama)
• Deleted (jika promosi yang disimpan memiliki id yang sama dan nilai atribut action untuk promosi yang ditentukan dalam pesan saat ini adalah "delete")

Promosi tunggal untuk sebuah properti. Perhatikan bahwa jika action="overlay" dan <Promotion> tidak ditentukan, semua promosi untuk properti akan dihapus.

Jika Anda perlu menggunakan lebih dari 99 promosi, hubungi Manajer Akun Teknis (TAM) Anda.

Jika ditentukan, nilainya harus delete. Jika tidak ditentukan dan promosi dengan id yang sama tidak disimpan, maka promosi ini akan disimpan. Atau, jika tidak ditentukan dan promosi dengan id yang sama disimpan, promosi yang ada akan diperbarui.

Jika delete ditentukan, promosi yang disimpan dengan id yang sama akan dihapus. Saat menggunakan delete, jangan sertakan elemen turunan apa pun di <Promotion>. Selain itu, delete tidak diizinkan bersama dengan <HotelPromotions action="overlay"/>.

Tanggal mulai atau datetime (berdasarkan zona waktu properti), termasuk rentang tanggal tersebut.

• Tanggal atau tanggal dan waktu yang ditentukan oleh start harus lebih awal dari (atau sama dengan) tanggal atau tanggal dan waktu yang ditentukan oleh end.
• Jika start tidak ditentukan, berarti rentang waktu mulai pada dasarnya tidak terbatas.
• Jika start diisi sebagai tanggal "YYYY-MM-DD", kolom ini akan ditafsirkan sebagai tanggal & waktu "YYYY-MM-DDT00:00:00".

Tanggal akhir atau datetime (berdasarkan zona waktu properti), termasuk rentang tanggal tersebut.

• Tanggal atau tanggal dan waktu yang ditentukan oleh end harus setelah (atau sama dengan) tanggal atau tanggal dan waktu yang ditentukan oleh start.
• Jika end tidak ditentukan, maka waktu berakhir rentangnya menjadi tidak terbatas.
• Jika end diberikan sebagai tanggal "YYYY-MM-DD", hal ini akan ditafsirkan sebagai tanggal dan waktu "YYYY-MM-DDT23:59:59".

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, semua hari diizinkan dalam rentang tanggal tersebut. Setiap karakter dalam string menentukan hari. Misalnya, "MTWHF" menentukan bahwa hari kerja diizinkan dalam rentang tanggal.

Karakter yang valid adalah:

• M untuk hari Senin
• T untuk hari Selasa
• W untuk hari Rabu
• H untuk Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Jenis nilai yang valid adalah:

• Integer: Jumlah hari sebelum tanggal check-in. Misalnya, nilai 30 menunjukkan bahwa promosi hanya berlaku untuk pemesanan minimal 30 hari sebelum tanggal check-in.
• Durasi ISO 8601 (hari, jam, dan menit): Jumlah hari (dan, jika perlu, jam/menit) sebelum tanggal check-in. Misalnya, nilai P30D menunjukkan bahwa promosi hanya berlaku untuk pemesanan setidaknya 30 hari sebelum tanggal check-in. Nilai P30DT6H mengharuskan pemesanan pada atau sebelum pukul 18.00 pada hari ke-30 sebelum kedatangan.

Jenis nilai yang valid adalah:

• Integer: Jumlah hari sebelum tanggal check-in. Misalnya, nilai 30 menunjukkan bahwa promosi hanya berlaku untuk pemesanan maksimal 30 hari sebelum tanggal check-in.
• Durasi ISO 8601 (hari, jam, dan menit): Jumlah hari (dan, jika perlu, jam/menit) sebelum tanggal check-in. Misalnya, nilai P30D menunjukkan bahwa promosi hanya berlaku untuk pemesanan maksimal 30 hari sebelum tanggal check-in. Nilai P30DT6H mengharuskan pemesanan pada atau setelah pukul 18.00 pada hari ke-30 sebelum kedatangan.

Menentukan batasan pada nilai maksimum tempat tarif dapat ditetapkan setelah promosi diterapkan.

Promosi harus selalu menentukan <Discount> atau <BestDailyDiscount>, jadi untuk membuat promosi yang hanya menerapkan <Ceiling>, salah satu opsinya adalah menetapkan <Discount> dengan percentage dari 0.

Jika penumpukan dikonfigurasi, beberapa promosi dengan <Ceiling> dapat diterapkan ke satu kunjungan. Setiap promosi akan menerapkan diskonnya, langsung diikuti dengan batas maksimalnya. Contoh berikut menunjukkan bagaimana setiap batas maksimal berkontribusi pada penghitungan promosi berikutnya dalam stack.

Contoh:

Harga menginap 1 malam dengan AmountBeforeTax 100 dan ada dua promosi:

1. Promosi dengan jenis tumpukan base, fixed_amount dari 25, dan batas maksimal amount_per_night 60
2. Promosi dengan jenis tumpukan second, fixed_amount dari 25, dan batas maksimal amount_per_night dari 90

Berikut adalah urutan perhitungannya:

1. Promosi base diterapkan terlebih dahulu dan memberikan diskon AmountBeforeTax menjadi 75, tetapi batas maksimal menurunkannya menjadi 60.
2. Promosi second memberikan diskon AmountBeforeTax dari 60 menjadi 35. Ini berada di bawah batas 90, sehingga batas kedua tidak diterapkan. Rasio akhirnya adalah 35.

Fakta bahwa 60 adalah batas keseluruhan yang lebih ketat tidak relevan karena hanya valid untuk promosinya sendiri, dan tidak mungkin ada batas tunggal yang mencakup seluruh stack promosi.

Jumlah maksimum tarif per malam yang dapat ditetapkan setelah diskon diterapkan.

Jika elemen <Floor> juga ditentukan, nilai ini harus ditetapkan ke nilai yang lebih besar dari atau sama dengan atribut amount_per_night di <Floor>.

amount_per_night diterapkan ke pajak dan biaya jika termasuk dalam tarif per malam menggunakan AmountAfterTax, tetapi tidak yang ditentukan menggunakan TaxFeeInfo.

Menentukan batasan pada nilai minimum tempat tarif dapat ditetapkan setelah promosi diterapkan.

Promosi harus selalu menentukan <Discount> atau <BestDailyDiscount>, jadi untuk membuat promosi yang hanya menerapkan <Floor>, salah satu opsinya adalah menetapkan <Discount> dengan percentage dari 0.

Logika <Floor> masih berlaku untuk diskon <FreeNights>, meskipun jika malam gratis memiliki diskon 100%.

Jika penumpukan dikonfigurasi, beberapa promosi dengan <Floor> dapat diterapkan ke satu kunjungan. Setiap promosi akan menerapkan diskonnya, langsung diikuti dengan harga minimumnya. Contoh berikut menunjukkan bagaimana kontribusi setiap harga minimum terhadap penghitungan promosi berikutnya di stack.

Contoh:

Harga menginap 1 malam dengan AmountBeforeTax 100 dan ada dua promosi:

1. Promosi dengan jenis tumpukan base, fixed_amount 25, dan lantai amount_per_night 90
2. Promosi dengan jenis tumpukan second, fixed_amount dari 25, dan lantai amount_per_night 60

Berikut adalah urutan perhitungannya:

1. Promosi base diterapkan terlebih dahulu dan memberikan diskon AmountBeforeTax menjadi 75, tetapi kemudian harga minimum menaikkannya menjadi 90.
2. Promosi second memberikan diskon AmountBeforeTax dari 90 menjadi 65. Ini berada di atas lantai 60 sehingga lantai dua tidak diterapkan. Rasio akhirnya adalah 65.

Fakta bahwa 90 adalah nilai keseluruhan yang lebih ketat tidak relevan karena hanya valid untuk promosinya sendiri, dan tidak boleh ada satu lantai tunggal yang mencakup seluruh stack promosi.

Jumlah minimum yang dapat ditetapkan untuk tarif per malam setelah diskon diterapkan.

Jika elemen <Ceiling> juga ditentukan, nilai ini harus ditetapkan ke nilai yang lebih kecil dari atau sama dengan atribut amount_per_night di <Ceiling>.

amount_per_night diterapkan ke pajak dan biaya jika termasuk dalam tarif per malam menggunakan AmountAfterTax, tetapi tidak yang ditentukan menggunakan TaxFeeInfo.

Rentang tanggal yang menentukan kapan check in harus dilakukan agar promosi diterapkan. Elemen ini tidak diperlukan jika Anda menghapus satu atau beberapa promosi.

Format YearlessDate juga didukung.

• Jika salah satu dari start atau end adalah tanggal tidak tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh digabungkan dengan tahun baru. Sebagai gantinya, tampilkan rentang sebagai dua rentang tanggal yang berdekatan. Misalnya, {"12-29", "01-05"} dapat direpresentasikan sebagai {"12-29", "12-31"} dan {"01-01", "01-05"}.

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, semua hari diizinkan dalam rentang tanggal tersebut. Setiap karakter dalam string menentukan hari. Misalnya, "MTWHF" menentukan bahwa hari kerja diizinkan dalam rentang tanggal.

Karakter yang valid adalah:

• M untuk hari Senin
• T untuk hari Selasa
• W untuk hari Rabu
• H untuk Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Rentang tanggal yang menentukan kapan check out harus dilakukan agar promosi dapat diterapkan. Elemen ini tidak diperlukan jika Anda menghapus satu atau beberapa promosi.

Format YearlessDate juga didukung.

• Jika salah satu dari start atau end adalah tanggal tidak tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh digabungkan dengan tahun baru. Sebagai gantinya, tampilkan rentang sebagai dua rentang tanggal yang berdekatan. Misalnya, {"12-29", "01-05"} dapat direpresentasikan sebagai {"12-29", "12-31"} dan {"01-01", "01-05"}.

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, semua hari diizinkan dalam rentang tanggal tersebut. Setiap karakter dalam string menentukan hari. Misalnya, "MTWHF" menentukan bahwa hari kerja diizinkan dalam rentang tanggal.

Karakter yang valid adalah:

• M untuk hari Senin
• T untuk hari Selasa
• W untuk hari Rabu
• H untuk Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Hanya satu dari Discount atau BestDailyDiscount yang harus ditentukan.

Menentukan diskon yang akan diterapkan untuk promosi ini.

Salah satu dari percentage, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Nilai desimal dari 0-100 yang menentukan persentase diskon. Nilai ini diterapkan ke AmountAfterTax (atau AmountBeforeTax jika AmountAfterTax tidak ditentukan).

Contoh:

• Jika AmountAfterTax 100 dan percentage 20, maka

  tarif promosi = AmountAfterTax * (1 - diskon persentase)

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

• Jika AmountBeforeTax 100, percentage adalah 20, dan TaxFeeInfo menentukan pajak sebesar 10, maka

  tarif promosi = AmountBeforeTax * (1 - diskon persentase) + pajak

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

Salah satu dari percentage, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Jumlah tetap yang akan dikurangi dari jumlah tarif per malam AmountAfterTax (atau jumlah tarif per malam AmountBeforeTax jika AmountAfterTax tidak ditentukan). Diasumsikan dalam mata uang yang sama dengan tarif per malam. Jika ini lebih besar dari jumlah tarif per malam, nilai yang dihasilkan adalah nol.

Contoh:

• Jika kita menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 90, AmountAfterTax 100, dan fixed_amount 20, maka

  tarif promosi = AmountAfterTax - diskon tetap

  80,00 = 100 - 20

• Jika kita menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 100, fixed_amount 20, dan TaxFeeInfo menentukan pajak sebesar 8%, maka

  tarif promosi = (AmountBeforeTax - diskon tetap) * (1 + pajak persentase)

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

• Jika kita menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 50, fixed_amount 60, dan TaxFeeInfo menentukan pajak sebesar 10, maka

  tarif promosi = (AmountBeforeTax - diskon tetap) * pajak

  10,00 = 0 + 10

• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 100, 110, dan 120; serta fixed_amount 150, maka

  tarif promosi = total(AmountAfterTax) - (diskon tetap)

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

Salah satu dari percentage, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Diskon tetap yang diterapkan untuk setiap tarif per malam AmountAfterTax (atau N termurah jika applied_nights ditentukan). Jika AmountAfterTax tidak ditentukan, nilai tersebut akan diterapkan ke AmountBeforeTax. Diasumsikan dalam mata uang yang sama dengan tarif per malam. Jika fixed_amount_per_night lebih besar dari tarif per malam, tarif per malam tersebut dikurangi menjadi nol—diskon tidak dapat menyebabkan tarif per malam menjadi negatif.

Contoh:

• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 100, 110, dan 120; serta fixed_amount_per_night 10, maka

  tarif promosi = total(AmountBeforeTax - diskon jumlah tetap)

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

• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 10, 50, dan 100; serta fixed_amount_per_night 20, maka

  tarif promosi = total(AmountAfterTax - diskon jumlah tetap)

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

Salah satu dari percentage, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Jika tarif per malam AmountAfterTax ditentukan, maka tarif ini akan menetapkan harga menginap, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, lalu menentukan apakah AmountAfterTax ditentukan atau tidak, hal ini akan menetapkan harga sebelum pajak untuk masa inap ke nilai yang ditentukan. Diasumsikan dalam mata uang yang sama dengan tarif per malam.

Jika AmountAfterTax dimaksudkan untuk mencerminkan pajak persentase, menetapkan harga tetap untuk AmountBeforeTax dapat menyebabkan pajak dan biaya yang tidak akurat. Secara umum, sebaiknya gunakan TaxFeeInfo untuk menentukan pajak dan biaya properti.

Contoh:

• Jika kita menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 90, AmountAfterTax 100, dan fixed_price 80, maka tarif promosinya adalah 80.
• Jika kita menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 100, fixed_amount 80, dan TaxFeeInfo menentukan pajak sebesar 8%, maka

  tarif promosi = harga tetap * (1 + pajak persentase)

  86,40 = 80 * 1,08

• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 100, 110, dan 120; serta fixed_amount 300, maka

  tarif promosi = 300

Salah satu dari percentage, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Jika tarif per malam AmountAfterTax ditentukan, maka harga akan menetapkan harga untuk setiap malam menginap, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, lalu menentukan apakah AmountAfterTax ditentukan atau tidak, hal ini akan menetapkan harga sebelum pajak untuk setiap malam menginap ke nilai yang ditentukan. Diasumsikan menggunakan mata uang yang sama dengan tarif per malam.

Jika AmountAfterTax dimaksudkan untuk mencerminkan pajak persentase, menetapkan harga tetap untuk AmountBeforeTax dapat menyebabkan pajak dan biaya yang tidak akurat. Secara umum, sebaiknya gunakan TaxFeeInfo untuk menentukan pajak dan biaya properti.

Jika applied_nights ditentukan, maka harga baru akan diterapkan ke N malam termurah.

Contoh:

• Jika kita menetapkan harga untuk menginap 2 malam dengan nilai AmountBeforeTax 90, 90; nilai AmountAfterTax 100, 100; dan fixed_price 80, maka tarif promosinya adalah 80 + 80 = 160.
• Jika kita menetapkan harga untuk menginap 2 malam dengan AmountBeforeTax 100.100; fixed_amount 80, dan TaxFeeInfo menentukan pajak sebesar 8%, maka tarif promosinya adalah (80 + 80) * 1,08 = 172,8.
• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 100, 110, dan 120; dan fixed_amount adalah 110, maka tarif promosinya adalah 110 * 3 = 330.

Ini hanya boleh digunakan dengan percentage atau fixed_amount_per_night.

Jumlah malam saat diskon diterapkan, dimulai dari yang paling murah. Harus berupa bilangan bulat dari 1 sampai 99. Jika tidak ditentukan, diskon akan diterapkan ke semua malam.

Jumlah malam yang diperlukan agar diskon dapat diterapkan. Setiap diskon diterapkan ke segmen malam menginap terpisah.

Misalnya, untuk menginap 10 malam dengan stay_nights adalah 4 (dan repeats adalah benar), maka ada dua segmen malam menginap: malam ke-1 hingga ke-4 dan malam ke-5 hingga ke-8; malam ke-9 dan ke-10 bukan bagian dari segmen malam menginap.

Apakah diskon dapat diterapkan ke beberapa segmen malam menginap. Jika false, maka hanya segmen malam menginap di awal itinerari yang didiskon. Jika true, maka semua segmen masa inap akan didiskon.

Misalnya, jika stay_nights adalah 4 dan itinerari adalah 10 malam, maka, jika repeats adalah true, maka 2 segmen akan didiskon (malam 1-4 dan malam 5-8); tetapi, jika repeats adalah false, maka hanya 1 segmen yang didiskon (malam 1-4).

Hanya satu dari Discount atau BestDailyDiscount yang harus ditentukan.

Menentukan diskon harian yang dapat diterapkan ke satu malam menginap. Hal ini berbeda dengan Discount, yang menerapkan diskon untuk seluruh masa inap.

Setiap properti dapat memiliki satu grup promosi yang dianggap "hari terbaik". Artinya, untuk setiap malam menginap, satu promosi "harian terbaik" yang memenuhi syarat dan menghasilkan diskon terbesar untuk malam tersebut akan dipilih dan dapat diterapkan.

Stacking mungkin tidak ditetapkan dengan BestDailyDiscount. Diskon "harian terbaik" yang menghasilkan diskon terbesar untuk setiap malam digabungkan dan diperlakukan sebagai diskon menginap tunggal (yaitu Discount) dengan jenis tumpukan yang ditetapkan ke base. Diskon gabungan ini dibandingkan, dan dapat digabungkan dengan, promosi <Discount> lainnya yang memenuhi syarat untuk menemukan satu atau kombinasi diskon yang memberikan diskon terbesar. Kombinasi BestDailyDiscount atau satu Discount, mana pun yang menghasilkan harga yang lebih rendah, akan dipilih dan diterapkan untuk jenis tumpukan base.

StayDates dapat ditentukan dengan jenis diskon ini, tetapi application harus ditetapkan ke overlap

Salah satu dari percentage, fixed_amount, atau fixed_price harus ada.

Nilai desimal dari 0-100 yang menentukan persentase diskon. Nilai ini diterapkan ke AmountAfterTax (atau AmountBeforeTax jika AmountAfterTax tidak ditentukan).

Contoh:

• Jika AmountAfterTax untuk satu malam menginap adalah 100 dan percentage 20, maka

  tarif promosi = AmountAfterTax * (1 - diskon persentase)

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

• Jika AmountBeforeTax untuk satu menginap adalah 100, percentage adalah 20, dan TaxFeeInfo menentukan pajak sebesar 10, maka

  tarif promosi = AmountBeforeTax * (1 - diskon persentase) + pajak

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

Salah satu dari percentage, fixed_amount, atau fixed_price harus ada.

Jumlah tetap yang akan dikurangi dari satu tarif per malam AmountAfterTax (atau tarif per malam AmountBeforeTax jika AmountAfterTax tidak ditentukan). Diasumsikan dalam mata uang yang sama dengan tarif per malam. Jika ini lebih besar dari jumlah tarif per malam, nilai yang dihasilkan adalah nol.

Contoh:

• Jika AmountBeforeTax untuk satu malam adalah 90, AmountAfterTax adalah 100, dan fixed_amount adalah 20, maka

  tarif promosi = AmountAfterTax - diskon tetap

  80,00 = 100 - 20

• Jika AmountBeforeTax untuk satu malam adalah 100, fixed_amount adalah 20, dan TaxFeeInfo menentukan pajak sebesar 8%, maka

  tarif promosi = (AmountBeforeTax - diskon tetap) * (1 + pajak persentase)

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

Salah satu dari percentage, fixed_amount, atau fixed_price harus ada.

Jika tarif per malam AmountAfterTax ditentukan, maka harga untuk malam menginap akan ditetapkan, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, lalu menentukan apakah AmountAfterTax ditentukan atau tidak, hal ini akan menetapkan harga sebelum pajak untuk masa inap ke nilai yang ditentukan. Diasumsikan dalam mata uang yang sama dengan tarif per malam.

Contoh:

• Jika AmountBeforeTax untuk satu malam adalah 90, AmountAfterTax adalah 100, dan fixed_price adalah 80, maka tarif promosi adalah 80.
• Jika AmountBeforeTax untuk satu malam adalah 100, fixed_amount adalah 80, dan TaxFeeInfo menentukan pajak sebesar 8%, maka

  tarif promosi = harga tetap * (1 + pajak persentase)

  86,40 = 80 * 1,08

Container untuk aturan tarif keanggotaan yang memicu perlakuan UI tertentu untuk diskon terkait.

Elemen ini tidak boleh ditentukan kecuali jika <Discount> juga ditentukan.

ID aturan tarif yang terkait dengan program keanggotaan.

Beberapa promosi dapat diterapkan ke satu tarif bergantung pada setelan ini:

• any: Dapat digabungkan dengan promosi lainnya (kecuali none), tetapi urutan penerapan promosi tidak dijamin.
• base: Promosi base terbaik yang memenuhi syarat dipilih dan diterapkan terlebih dahulu sebelum promosi lainnya. ID ini sebelumnya bernama base_only.
• second: Promosi second terbaik yang memenuhi syarat dipilih dan diterapkan setelah promosi base (jika berlaku) dan sebelum promosi any.
• none: Tidak dapat digabungkan dengan promosi lainnya.

Dari kombinasi yang diizinkan, kumpulan promosi yang menghasilkan diskon terbesar akan diterapkan ke tarif.

Menjelaskan cara penerapan promosi.

Nilai yang valid adalah:

• all: Menerapkan promosi ke setiap malam di itinerari jika semua tanggal dalam itinerari tumpang-tindih dengan tanggal menginap.
• any: Menerapkan promosi ke semua malam di itinerari jika salah satu tanggal dalam itinerari tumpang-tindih dengan tanggal dalam rentang tanggal menginap.
• overlap: Menerapkan promosi hanya ke malam tertentu di itinerari yang tumpang-tindih dengan tanggal dalam rentang tanggal menginap.

Atribut ini harus selalu ditentukan.

• Jika <Discount> menentukan percentage dan application ditetapkan ke all atau any, maka diskon akan diterapkan sebagai persentase masa inap penuh.
• Jika <Discount> menentukan percentage dan application ditetapkan ke overlap, maka diskon akan diterapkan sebagai persentase tarif per malam untuk malam yang tumpang-tindih.
• <Discount> yang menentukan fixed_amount dan application yang ditetapkan ke overlap adalah kombinasi yang tidak valid.
• <FreeNights> mendukung semua nilai application. Perhatikan bahwa untuk overlap, hanya malam menginap yang tumpang-tindih yang dipertimbangkan untuk persyaratan diskon.

Rentang tanggal yang menentukan tanggal saat promosi diterapkan.

Format YearlessDate juga didukung.

• Jika salah satu dari start atau end adalah tanggal tidak tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh digabungkan dengan tahun baru. Sebagai gantinya, tampilkan rentang sebagai dua rentang tanggal yang berdekatan. Misalnya, {"12-29", "01-05"} dapat direpresentasikan sebagai {"12-29", "12-31"} dan {"01-01", "01-05"}.

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, semua hari diizinkan dalam rentang tanggal tersebut. Setiap karakter dalam string menentukan hari. Misalnya, "MTWHF" menentukan bahwa hari kerja diizinkan dalam rentang tanggal.

Karakter yang valid adalah:

• M untuk hari Senin
• T untuk hari Selasa
• W untuk hari Rabu
• H untuk Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Nilai yang valid adalah include dan exclude.

Jika type UserCountries ditetapkan sebagai include, promosi akan berlaku untuk pengguna dari negara yang tercantum.

Jika type UserCountry adalah exclude, promosi berlaku untuk pengguna dari luar negara yang tercantum.

Jika type UserCountries tidak disetel, nilai tersebut akan diperlakukan sebagai include dan promosi diterapkan untuk pengguna dari negara yang tercantum.

<Success> atau <Issues> ada di setiap pesan.

<Success> atau <Issues> ada di setiap pesan.

Jenis masalah yang dialami.

Nilai yang valid adalah warning, error, dan failure.