Promosi

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

Promosi untuk suatu properti. Setiap promosi berlaku untuk satu properti.

Kecuali jika <Stacking> digunakan, promosi dengan diskon terbesar berlaku untuk pemesanan saat beberapa promosi memenuhi syarat.

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

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

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

Satu promosi untuk suatu properti. Perhatikan bahwa jika action="overlay" dan <Promotion> tidak ditentukan, maka semua promosi untuk properti akan dihapus.

Jika 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. Sebaliknya, jika tidak ditentukan dan promosi dengan id yang sama disimpan, maka promosi yang sudah ada akan diperbarui.

Jika delete ditentukan, promosi yang tersimpan 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 tanggal waktu (berdasarkan zona waktu properti), inklusif, dari rentang.

• Tanggal atau waktu yang ditentukan oleh start harus lebih awal dari (atau sama dengan) tanggal atau waktu yang ditentukan oleh end.
• Jika start tidak ditentukan, rentang tersebut secara efektif tidak terbatas dalam hal waktu mulai.
• Jika start diisi sebagai tanggal "YYYY-MM-DD", tanggal tersebut akan ditafsirkan sebagai waktu "YYYY-MM-DDT00:00:00".

Tanggal akhir atau waktu tanggal akhir (berdasarkan zona waktu properti), inklusif, dari rentang.

• Tanggal atau waktu yang ditentukan oleh end harus lebih akhir dari (atau sama dengan) tanggal atau waktu yang ditentukan oleh start.
• Jika end tidak ditentukan, rentang tersebut secara efektif tidak terbatas dalam hal waktu berakhir.
• Jika end diberikan sebagai tanggal "YYYY-MM-DD", tanggal tersebut akan ditafsirkan sebagai waktu "YYYY-MM-DDT23:59:59".

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, maka semua hari diizinkan dalam rentang tanggal. 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 hari Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Jenis nilai yang valid adalah:

• Bilangan bulat: Jumlah hari sebelum tanggal check-in. Misalnya, nilai 30 menunjukkan bahwa promosi hanya berlaku untuk pemesanan minimal 30 hari sebelum tanggal check-in.
• ISO 8601 Duration (hari, jam, dan menit): Jumlah hari (dan jam/menit, opsional) sebelum tanggal check-in. Misalnya, nilai P30D menunjukkan bahwa promosi hanya berlaku untuk pemesanan minimal 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:

• Bilangan bulat: Jumlah hari sebelum tanggal check-in. Misalnya, nilai 30 menunjukkan bahwa promosi hanya berlaku untuk pemesanan paling lambat 30 hari sebelum tanggal check-in.
• ISO 8601 Duration (hari, jam, dan menit): Jumlah hari (dan jam/menit, opsional) sebelum tanggal check-in. Misalnya, nilai P30D menunjukkan bahwa promosi hanya berlaku untuk pemesanan paling lambat 30 hari sebelum tanggal check-in. Nilai P30DT6H mengharuskan pemesanan pada atau setelah pukul 18.00 pada hari ke-30 sebelum kedatangan.

Menentukan batasan nilai maksimum yang dapat ditetapkan untuk tarif setelah promosi diterapkan.

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

Jika penumpukan dikonfigurasi, beberapa promosi dengan <Ceiling> dapat diterapkan ke satu masa inap. Setiap promosi akan menerapkan diskonnya, yang segera diikuti dengan batasnya. Contoh berikut menunjukkan bagaimana setiap batas berkontribusi pada penghitungan promosi berikutnya dalam stack.

Contoh:

Menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 100 dan ada tumpukan dua promosi:

1. Promosi dengan jenis penumpukan base, fixed_amount 25, dan amount_per_night langit-langit 60
2. Promosi dengan jenis penumpuk second, fixed_amount 25, dan amount_per_night langit-langit 90

Berikut adalah urutan penghitungan:

1. Promosi base diterapkan terlebih dahulu dan memberikan diskon sebesar AmountBeforeTax menjadi 75, tetapi kemudian batas bawah menurunkannya menjadi 60.
2. Promosi second memberikan diskon AmountBeforeTax dari 60 menjadi 35. Nilai ini berada di bawah batas 90 sehingga batas kedua tidak diterapkan. Tarif akhir adalah 35.

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

Jumlah maksimum yang dapat ditetapkan untuk tarif per malam 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 disertakan dalam tarif per malam menggunakan AmountAfterTax, tetapi tidak termasuk yang ditentukan menggunakan TaxFeeInfo.

Menentukan batasan nilai minimum yang dapat ditetapkan untuk tarif setelah promosi diterapkan.

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

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

Jika penumpukan dikonfigurasi, beberapa promosi dengan <Floor> dapat diterapkan ke satu masa inap. Setiap promosi akan menerapkan diskonnya, yang segera diikuti dengan harga minimumnya. Contoh berikut menunjukkan bagaimana setiap lantai berkontribusi pada penghitungan promosi berikutnya dalam stack.

Contoh:

Menetapkan harga untuk menginap 1 malam dengan AmountBeforeTax 100 dan ada tumpukan dua promosi:

1. Promosi dengan jenis penumpukan base, fixed_amount 25, dan amount_per_night lantai 90
2. Promosi dengan jenis penumpukan second, fixed_amount sebesar 25, dan nilai minimum amount_per_night sebesar 60

Berikut adalah urutan penghitungan:

1. Promosi base diterapkan terlebih dahulu dan memberikan diskon pada AmountBeforeTax menjadi 75, tetapi kemudian nilai minimum menaikkannya hingga 90.
2. Promosi second memberikan diskon AmountBeforeTax dari 90 menjadi 65. Nilai ini berada di atas nilai minimum 60 sehingga nilai minimum kedua tidak diterapkan. Tarif akhir adalah 65.

Fakta bahwa 90 adalah nilai minimum keseluruhan yang lebih ketat tidak relevan karena nilai tersebut hanya valid untuk promosinya sendiri, dan tidak boleh ada satu nilai minimum 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 kurang dari atau sama dengan atribut amount_per_night di <Ceiling>.

amount_per_night diterapkan ke pajak dan biaya jika disertakan dalam tarif per malam menggunakan AmountAfterTax, tetapi tidak termasuk 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 tanpa tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh mencakup 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, maka semua hari diizinkan dalam rentang tanggal. 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 hari 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 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 tanpa tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh mencakup 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, maka semua hari diizinkan dalam rentang tanggal. 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 hari Kamis
• F untuk hari Jumat
• S untuk hari Sabtu
• U untuk hari Minggu

Kombinasi karakter apa pun valid.

Tepat satu dari Discount atau BestDailyDiscount harus ditentukan.

Menentukan diskon yang akan diterapkan untuk promosi ini.

Salah satu dari percentage, percentage_of_base, 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 tersebut diterapkan ke AmountAfterTax (atau AmountBeforeTax jika AmountAfterTax tidak ditentukan).

Contoh:

• Jika AmountAfterTax 100 dan percentage adalah 20, maka

  tarif promosi = AmountAfterTax * (1 - diskon persentase)

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

• Jika AmountBeforeTax 100, percentage 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, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Nilai desimal dari 0-100 yang menentukan persentase diskon dasar. Serupa dengan percentage, nilai tersebut diterapkan ke AmountAfterTax (atau AmountBeforeTax jika AmountAfterTax tidak ditentukan).

Tidak seperti percentage, diskon ini selalu dihitung sebagai persentase tarif dasar, terlepas dari promosi sebelumnya yang telah diterapkan secara berurutan.

Contoh:

• Misalnya, kita memiliki dua promosi yang diterapkan secara berurutan untuk masa inap satu malam dengan harga 100. Yang pertama adalah diskon persentase reguler sebesar 10% dan yang kedua adalah diskon persentase dasar sebesar 10%. Kemudian, tarif diskonnya adalah 80 karena kedua promosi tersebut memberikan diskon 10%. Perhatikan bahwa jika promosi kedua juga merupakan diskon persentase reguler, tarif diskonnya adalah 81 karena promosi kedua memberikan diskon 10% dari 90.

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

Jumlah tetap yang akan dikurangi dari total tarif per malam AmountAfterTax (atau total tarif per malam AmountBeforeTax jika AmountAfterTax tidak ditentukan). Ini diasumsikan dalam mata uang yang sama dengan tarif per malam. Jika jumlah tersebut lebih besar dari total 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, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Diskon tetap yang berlaku untuk masing-masing tarif per malam AmountAfterTax (atau N termurah jika applied_nights ditentukan). Jika AmountAfterTax tidak ditentukan, maka diskon tersebut akan diterapkan ke AmountBeforeTax. Ini 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 akan 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, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Jika tarif per malam AmountAfterTax ditentukan, hal ini akan menetapkan harga untuk masa inap, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, baik AmountAfterTax ditentukan maupun tidak, hal ini akan menetapkan harga sebelum pajak untuk masa inap ke nilai yang ditentukan. Ini diasumsikan dalam mata uang yang sama dengan tarif per malam.

Jika AmountAfterTax dimaksudkan untuk mencerminkan pajak persentase, menetapkan harga tetap untuk AmountBeforeTax dapat mengakibatkan pajak dan biaya yang tidak akurat. Secara umum, sangat disarankan untuk menggunakan TaxFeeInfo guna 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, percentage_of_base, fixed_amount, fixed_amount_per_night, fixed_price, atau fixed_price_per_night harus ada.

Jika tarif per malam AmountAfterTax ditentukan, hal ini akan menetapkan harga untuk setiap malam menginap, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, baik AmountAfterTax ditentukan maupun tidak, tindakan ini akan menetapkan harga sebelum pajak untuk setiap malam menginap ke nilai yang ditentukan. Ini diasumsikan dalam mata uang yang sama dengan tarif per malam.

Jika AmountAfterTax dimaksudkan untuk mencerminkan pajak persentase, menetapkan harga tetap untuk AmountBeforeTax dapat mengakibatkan pajak dan biaya yang tidak akurat. Secara umum, sangat disarankan untuk menggunakan TaxFeeInfo guna menentukan pajak dan biaya properti.

Jika applied_nights ditentukan, 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 adalah 80, dan TaxFeeInfo menentukan pajak sebesar 8%, maka tarif promosi adalah (80 + 80) * 1,08 = 172,8.
• Jika kita menetapkan harga untuk menginap 3 malam dengan nilai AmountAfterTax 100, 110, dan 120; serta fixed_amount 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 berlaku untuk semua malam.

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

Misalnya, untuk masa inap 10 malam dengan stay_nights 4 (dan repeats 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, hanya segmen malam menginap di awal itinerari yang akan mendapatkan diskon. Jika true, setiap segmen malam menginap akan mendapatkan diskon.

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

Tepat satu dari Discount atau BestDailyDiscount harus ditentukan.

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

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

Stacking dapat ditentukan dengan BestDailyDiscount. Nilainya harus ditetapkan ke base atau none. Diskon "harian terbaik" yang memberikan diskon terdalam untuk setiap malam digabungkan dan diperlakukan sebagai diskon satu masa inap (yaitu Discount) dengan tetap mengikuti jenis penumpukan yang dikonfigurasi. Diskon gabungan ini dibandingkan dengan, dan dapat digabungkan dengan, promosi <Diskon> lainnya yang memenuhi syarat untuk menemukan satu atau kombinasi yang memberikan diskon terdalam. Kombinasi BestDailyDiscount atau satu Discount, mana saja yang menghasilkan harga lebih rendah, dipilih dan diterapkan untuk jenis penumpukan 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 tersebut diterapkan ke AmountAfterTax (atau AmountBeforeTax jika AmountAfterTax tidak ditentukan).

Contoh:

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

  tarif promosi = AmountAfterTax * (1 - diskon persentase)

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

• Jika AmountBeforeTax untuk satu malam 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). Ini diasumsikan dalam mata uang yang sama dengan tarif per malam. Jika jumlah tersebut lebih besar dari total 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, hal ini akan menetapkan harga untuk malam menginap, termasuk pajak dan biaya, ke nilai yang ditentukan. Jika AmountBeforeTax ditentukan, baik AmountAfterTax ditentukan maupun tidak, hal ini akan menetapkan harga sebelum pajak untuk masa inap ke nilai yang ditentukan. Ini 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 promosinya 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

Penampung untuk aturan tarif langganan 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. Sebelumnya, ini 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 promosi diterapkan.

Nilai yang valid adalah:

• all: Menerapkan promosi ke setiap malam di itinerari jika semua tanggal di itinerari tumpang-tindih dengan tanggal menginap.
• any: Menerapkan promosi ke semua malam di itinerari jika 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 lama menginap keseluruhan.
• 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 menetapkan 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 promosi diterapkan.

Format YearlessDate juga didukung.

• Jika salah satu dari start atau end adalah tanggal tanpa tahun, keduanya harus diisi sebagai tanggal tanpa tahun.
• Rentang tanggal tanpa tahun tidak boleh mencakup 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"}.

Jika ingin menetapkan rentang StayDates untuk mengizinkan promosi pada hari tertentu dalam seminggu, Anda harus menetapkan tanggal start sebagai tanggal saat ini tanpa end sehingga promosi tidak berakhir masa berlakunya.

Anda harus menentukan nilai start jika nilai end tidak diberikan.

Anda harus menentukan nilai end jika nilai start tidak diberikan.

Hari yang diizinkan dalam rentang tanggal. Jika tidak ditentukan, maka semua hari diizinkan dalam rentang tanggal. 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 hari 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 berlaku untuk pengguna dari negara yang tercantum.

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

Jika type UserCountries tidak ditetapkan, type akan diperlakukan sebagai include dan promosi akan diterapkan kepada 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.