تبلیغات

اگر پشتیبان دارید که برای چندین حساب فید ارائه می کند، این مقدار باید با مقدار مشخصه ID مشخص شده در عنصر <RequestorID> پیام های <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> برای یک حساب مطابقت داشته باشد.

تبلیغات برای یک ملک هر تبلیغی برای یک ملک خاص اعمال می شود.

مگر اینکه از <Stacking> استفاده شود، وقتی تبلیغات متعدد واجد شرایط هستند، تبلیغات با بیشترین تخفیف برای رزرو اعمال می شود.

اگر مشخص شده است، مقدار باید "overlay" باشد. وقتی مقدار "overlay" است، همه تبلیغات ذخیره شده قبل از ذخیره تبلیغات مشخص شده در پیام فعلی حذف می شوند.

اگر مشخص نشده باشد، هر تبلیغی که در پیام فعلی مشخص شده است:

• Added (اگر هیچ یک از تبلیغات ذخیره شده دارای id یکسانی نباشد)
• Updated (اگر تبلیغ ذخیره شده دارای همان id باشد)
• Deleted (اگر یک تبلیغ ذخیره شده دارای id یکسان باشد و مقدار مشخصه action برای تبلیغ مشخص شده در پیام فعلی "delete" باشد)

یک تبلیغ واحد برای یک ملک. توجه داشته باشید که اگر action="overlay" و یک <Promotion> مشخص نشده باشد، همه تبلیغات برای دارایی حذف می شوند.

اگر نیاز به استفاده از بیش از 99 تبلیغات دارید، با مدیر حساب فنی خود (TAM) تماس بگیرید.

اگر مشخص شده باشد، مقدار باید delete شود. اگر مشخص نشده باشد و تبلیغی با همان id ذخیره نشده باشد، این تبلیغات ذخیره می‌شود. در غیر این صورت، اگر مشخص نشده باشد و تبلیغی با همان id ذخیره شود، تبلیغات موجود به روز می شود.

اگر delete مشخص شده باشد، تبلیغات ذخیره شده با همان id حذف می شود. هنگام استفاده delete ، هیچ عنصر فرزندی را در <Promotion> وارد نکنید. همچنین، delete در ارتباط با <HotelPromotions action="overlay"/> مجاز نیست.

تاریخ شروع یا زمان تاریخ (بر اساس منطقه زمانی ملک)، شامل محدوده.

• تاریخ یا تاریخ مشخص شده توسط start باید زودتر از (یا همان) تاریخ یا تاریخ مشخص شده در end باشد.
• اگر start مشخص نشده باشد، محدوده عملاً از نظر زمان شروع نامحدود است.
• اگر start به عنوان تاریخ "YYYY-MM-DD" پر شود، به عنوان تاریخ "YYYY-MM-DDT00:00:00" تفسیر می شود.

تاریخ پایان یا زمان تاریخ (بر اساس منطقه زمانی دارایی)، شامل محدوده.

• تاریخ یا تاریخ مشخص شده در end باید دیرتر از (یا همان) تاریخ یا تاریخ مشخص شده توسط start باشد.
• اگر end مشخص نشده باشد، محدوده عملاً از نظر زمان پایان نامحدود است.
• اگر end به عنوان تاریخ "YYYY-MM-DD" ارائه شود، به عنوان تاریخ "YYYY-MM-DDT23:59:59" تفسیر می شود.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

انواع مقادیر معتبر عبارتند از:

• عدد صحیح: تعداد روزهای قبل از تاریخ ورود. به عنوان مثال، مقدار 30 نشان می‌دهد که تبلیغات فقط برای رزروهایی که حداقل 30 روز قبل از تاریخ ورود انجام می‌شود اعمال می‌شود.
• مدت زمان ISO 8601 (روز، ساعت و دقیقه): تعداد روزها (و در صورت تمایل ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار P30D نشان می‌دهد که این تبلیغات فقط برای رزروهایی که حداقل 30 روز قبل از تاریخ اعلام حضور دارند اعمال می‌شود. مقدار P30DT6H مستلزم رزرو در یا قبل از ساعت 18:00 30 روز قبل از ورود است.

انواع مقادیر معتبر عبارتند از:

• عدد صحیح: تعداد روزهای قبل از تاریخ ورود. به عنوان مثال، مقدار 30 نشان می دهد که تبلیغات فقط برای رزرو حداکثر 30 روز قبل از تاریخ ورود اعمال می شود.
• مدت زمان ISO 8601 (روز، ساعت و دقیقه): تعداد روزها (و در صورت تمایل ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار P30D نشان می‌دهد که تبلیغات فقط برای رزرو حداکثر 30 روز قبل از تاریخ ورود اعمال می‌شود. مقدار P30DT6H مستلزم رزرو در ساعت 18:00 یا بعد از 30 روز قبل از ورود است.

محدودیت‌هایی را بر روی حداکثر مقداری که پس از اعمال تبلیغات می‌توان روی آن تنظیم کرد، تعریف می‌کند.

تبلیغات همیشه باید یک <Discount> یا یک <BestDailyDiscount> را مشخص کنند، بنابراین برای ایجاد تبلیغاتی که فقط از یک <Ceiling> استفاده می کند، یک گزینه تنظیم <Discount> با percentage 0 است.

اگر انباشتگی پیکربندی شده باشد، تبلیغات متعدد با <Ceiling> می‌تواند برای یک اقامت اعمال شود. هر تبلیغی تخفیف خود را اعمال می کند و بلافاصله سقف آن را اعمال می کند. مثال زیر نشان می دهد که چگونه هر سقف در محاسبه ارتقاء بعدی در پشته کمک می کند.

مثال:

قیمت گذاری یک شب اقامت که در آن AmountBeforeTax 100 است و مجموعه ای از دو تبلیغ وجود دارد:

1. تبلیغات با base نوع انباشته، مبلغ fixed_amount 25 و سقف amount_per_night 60
2. تبلیغ با نوع انباشته second ، fixed_amount 25، و سقف amount_per_night 90

ترتیب محاسبه به شرح زیر است:

1. تبلیغات base ابتدا اعمال می شود و AmountBeforeTax را به 75 تخفیف می دهد، اما سپس سقف آن را به 60 کاهش می دهد.
2. تبلیغ second AmountBeforeTax از 60 به 35 تخفیف می دهد. این زیر سقف 90 است بنابراین سقف دوم اعمال نمی شود. نرخ نهایی 35 است.

این واقعیت که 60 یک سقف کلی سخت‌گیرانه‌تر است، بی‌ربط است، زیرا فقط برای ارتقای خودش معتبر است، و نمی‌تواند سقف واحدی وجود داشته باشد که کل پشته تبلیغات را در بر بگیرد.

حداکثر مقداری که پس از اعمال تخفیف می توان نرخ شبانه را روی آن تنظیم کرد.

اگر یک عنصر <Floor> نیز مشخص شده باشد، باید مقداری بزرگتر یا مساوی با ویژگی amount_per_night در <Floor> تنظیم شود.

amount_per_night وقتی در نرخ شبانه با استفاده از AmountAfterTax گنجانده شود، برای مالیات‌ها و کارمزدها اعمال می‌شود، اما نه مواردی که با استفاده از TaxFeeInfo مشخص شده‌اند.

محدودیت‌هایی را بر روی حداقل مقداری که پس از اعمال تبلیغات می‌توان روی آن تنظیم کرد، تعریف می‌کند.

تبلیغات همیشه باید یک <Discount> یا یک <BestDailyDiscount> را مشخص کنند، بنابراین برای ایجاد تبلیغاتی که فقط یک <Floor> اعمال می کند، یک گزینه تنظیم <Discount> با percentage 0 است.

منطق <Floor> همچنان در مورد تخفیف های <FreeNights> صدق می کند، حتی اگر شب رایگان 100% تخفیف برای آن اعمال شود.

اگر انباشتگی پیکربندی شده باشد، تبلیغات متعدد با <Floor> می‌تواند برای یک اقامت اعمال شود. هر تبلیغی تخفیف خود را اعمال می کند، و بلافاصله پس از آن طبقه آن. مثال زیر نشان می‌دهد که چگونه هر طبقه به محاسبه ارتقای بعدی در پشته کمک می‌کند.

مثال:

قیمت گذاری یک شب اقامت که در آن AmountBeforeTax 100 است و مجموعه ای از دو تبلیغ وجود دارد:

1. تبلیغات با base نوع انباشته، مبلغ fixed_amount 25، و amount_per_night کف برای هر شب 90
2. تبلیغ با نوع انباشته second ، fixed_amount 25، و amount_per_night کف برای هر شب 60

ترتیب محاسبه به شرح زیر است:

1. تبلیغات base ابتدا اعمال می شود و AmountBeforeTax را به 75 تخفیف می دهد، اما سپس کف آن را تا 90 افزایش می دهد.
2. تبلیغ second AmountBeforeTax از 90 به 65 تخفیف می دهد. این بالاتر از طبقه 60 است بنابراین طبقه دوم اعمال نمی شود. نرخ نهایی 65 است.

این واقعیت که 90 یک طبقه کلی سخت‌گیرانه‌تر است، بی‌ربط است، زیرا فقط برای تبلیغ خودش معتبر است، و نمی‌تواند طبقه‌ای وجود داشته باشد که کل پشته تبلیغاتی را در بر گیرد.

حداقل مبلغی که پس از اعمال تخفیف می توان نرخ شبانه را تعیین کرد.

اگر یک عنصر <Ceiling> نیز مشخص شده باشد، باید مقداری کمتر یا مساوی با ویژگی amount_per_night در <Ceiling> تنظیم شود.

amount_per_night وقتی در نرخ شبانه با استفاده از AmountAfterTax گنجانده شود، برای مالیات‌ها و کارمزدها اعمال می‌شود، اما نه مواردی که با استفاده از TaxFeeInfo مشخص شده‌اند.

یک محدوده تاریخی که مشخص می‌کند چه زمانی باید ثبت نام انجام شود تا تبلیغات اعمال شود. اگر در حال حذف یک یا چند تبلیغ هستید، این عنصر ضروری نیست.

فرمت YearlessDate نیز پشتیبانی می شود.

• اگر یکی از تاریخ های start یا end یک تاریخ بدون سال باشد، هر دو باید به عنوان تاریخ های بدون سال پر شوند.
• محدوده تاریخ بدون سال نباید در سال جدید باشد. در عوض، محدوده را به عنوان دو محدوده تاریخ مجاور نشان دهید. برای مثال، {"12-29", "01-05"} می توان به صورت {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

یک محدوده تاریخی که مشخص می‌کند برای اعمال تبلیغات باید چه زمانی تسویه حساب انجام شود. اگر در حال حذف یک یا چند تبلیغ هستید، این عنصر ضروری نیست.

فرمت YearlessDate نیز پشتیبانی می شود.

• اگر یکی از تاریخ های start یا end یک تاریخ بدون سال باشد، هر دو باید به عنوان تاریخ های بدون سال پر شوند.
• محدوده تاریخ بدون سال نباید در سال جدید باشد. در عوض، محدوده را به عنوان دو محدوده تاریخ مجاور نشان دهید. برای مثال، {"12-29", "01-05"} می توان به صورت {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

دقیقاً یکی از Discount یا BestDailyDiscount باید مشخص شود.

تخفیفی که برای این تبلیغات اعمال می شود را مشخص می کند.

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

یک مقدار اعشاری از 0-100 که درصد تخفیف را مشخص می کند. برای AmountAfterTax (یا AmountBeforeTax اگر AmountAfterTax مشخص نشده باشد) اعمال می شود.

مثال ها:

• اگر AmountAfterTax 100 و percentage 20 باشد، پس

  نرخ تبلیغات = AmountAfterTax * (1 - درصد تخفیف)

  80.00 = 100 * (1 - 0.2)

• اگر AmountBeforeTax 100 است، percentage 20 است و TaxFeeInfo مالیات 10 را مشخص می کند، سپس

  نرخ ارتقاء = AmountBeforeTax * (1 - درصد تخفیف) + مالیات

  90.00 = 100 * (1 - 0.2) + 10

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

یک مقدار اعشاری از 0-100 که درصد تخفیف پایه را مشخص می کند. مشابه percentage ، برای AmountAfterTax (یا AmountBeforeTax اگر AmountAfterTax مشخص نشده باشد) اعمال می شود.

برخلاف percentage ، این تخفیف همیشه به عنوان درصدی از نرخ های پایه بدون توجه به تبلیغات قبلی که به ترتیب اعمال شده اند محاسبه می شود.

مثال:

• فرض کنید ما دو تبلیغ داریم که به ترتیب برای یک شب اقامت با قیمت 100 اعمال می شود. اولی 10 درصد تخفیف معمولی و دومی 10 درصد درصد تخفیف پایه است. سپس نرخ تخفیف 80 خواهد بود زیرا هر دو تبلیغات 10 تخفیف دارند. توجه داشته باشید که اگر تبلیغ دوم نیز یک درصد تخفیف معمولی بود، نرخ تخفیف 81 خواهد بود زیرا تخفیف دوم 10٪ از 90 است.

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

مبلغ ثابتی که باید از مجموع نرخ‌های شبانه AmountAfterTax (یا مجموع نرخ‌های شبانه AmountBeforeTax در صورتی که AmountAfterTax مشخص نشده باشد) کم شود. فرض بر این است که به همان ارز نرخ شبانه است. اگر این بزرگتر از مجموع نرخ های شبانه باشد، مقدار حاصل صفر است.

مثال ها:

• اگر برای اقامت 1 شب قیمت گذاری کنیم که در آن AmountBeforeTax 90، AmountAfterTax 100، و fixed_amount 20 است، پس

  نرخ ارتقاء = AmountAfterTax - تخفیف ثابت

  80.00 = 100 - 20

• اگر برای اقامت 1 شب قیمت گذاری کنیم که در آن AmountBeforeTax 100، fixed_amount 20 است، و TaxFeeInfo مالیات 8٪ را مشخص می کند، پس

  نرخ ارتقاء = ( AmountBeforeTax - تخفیف ثابت) * (1 + درصد مالیات)

  86.40 = (100 - 20) * 1.08

• اگر برای اقامت 1 شب قیمت گذاری کنیم که در آن AmountBeforeTax 50، fixed_amount 60 است، و TaxFeeInfo مالیات 10 را مشخص می کند، پس

  نرخ ارتقاء = ( AmountBeforeTax - تخفیف ثابت) * مالیات

  10.00 = 0 + 10

• اگر برای اقامت 3 شب قیمت گذاری کنیم که مقادیر AmountAfterTax 100، 110 و 120 باشد. و fixed_amount 150 است، پس

  نرخ تبلیغات = جمع ( AmountAfterTax ) - (تخفیف ثابت)

  180.00 = (100 + 110 + 120) - 150

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

یک تخفیف ثابت برای هر یک از نرخ‌های شبانه AmountAfterTax اعمال می‌شود (یا ارزان‌ترین N اگر applied_nights مشخص شده باشد). اگر AmountAfterTax مشخص نشده باشد، برای AmountBeforeTax اعمال می شود. فرض بر این است که به همان ارز نرخ شبانه است. اگر fixed_amount_per_night بزرگتر از نرخ شبانه باشد، آن نرخ شبانه به صفر کاهش می یابد—تخفیف نمی تواند باعث منفی شدن نرخ شبانه شود.

مثال ها:

• اگر برای اقامت 3 شب قیمت گذاری کنیم که مقادیر AmountAfterTax 100، 110 و 120 باشد. و fixed_amount_per_night 10 است، پس

  نرخ تبلیغات = جمع ( AmountBeforeTax - تخفیف مبلغ ثابت)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• اگر برای اقامت 3 شب قیمت گذاری کنیم که مقادیر AmountAfterTax 10، 50 و 100 باشد. و fixed_amount_per_night 20 است، پس

  نرخ تبلیغات = جمع ( AmountAfterTax - تخفیف مقدار ثابت)

  110.00 = (0 + (50 - 20) + (100 - 20))

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

اگر نرخ‌های شبانه AmountAfterTax مشخص شده باشد، آنگاه قیمت اقامت، از جمله مالیات و هزینه‌ها، به مقدار مشخص شده تعیین می‌شود. اگر AmountBeforeTax مشخص شده باشد، چه AmountAfterTax مشخص شده باشد یا خیر، این قیمت قبل از مالیات را برای اقامت روی مقدار مشخص شده تنظیم می کند. فرض بر این است که به همان ارز نرخ شبانه است.

اگر قرار است AmountAfterTax منعکس کننده درصدی از مالیات باشد، تعیین قیمت ثابت برای AmountBeforeTax می تواند منجر به مالیات و هزینه های نادرست شود. به طور کلی، اکیداً توصیه می شود از TaxFeeInfo برای تعیین مالیات و هزینه های ملک استفاده کنید.

مثال ها:

• اگر برای اقامت 1 شب قیمت گذاری کنیم که در آن AmountBeforeTax 90، AmountAfterTax 100، و fixed_price 80 است، نرخ تبلیغات 80 است.
• اگر یک شب اقامت را قیمت گذاری کنیم که در آن AmountBeforeTax 100، fixed_amount 80 است، و TaxFeeInfo مالیات 8٪ را مشخص می کند.

  نرخ تبلیغات = قیمت ثابت * (1 + درصد مالیات)

  86.40 = 80 * 1.08

• اگر برای اقامت 3 شب قیمت گذاری کنیم که مقادیر AmountAfterTax 100، 110 و 120 باشد. و fixed_amount 300 است، پس

  نرخ ارتقاء = 300

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price ، یا fixed_price_per_night مورد نیاز است.

اگر نرخ‌های شبانه AmountAfterTax مشخص شده باشد، آنگاه قیمت هر شب اقامت، از جمله مالیات و هزینه‌ها، به مقدار مشخص شده تعیین می‌شود. اگر AmountBeforeTax مشخص شده باشد، آیا AmountAfterTax مشخص شده است یا خیر، این قیمت قبل از مالیات را برای هر شب اقامت روی مقدار مشخص شده تنظیم می کند. فرض بر این است که به همان ارز نرخ شبانه است.

اگر قرار است AmountAfterTax منعکس کننده درصدی از مالیات باشد، تعیین قیمت ثابت برای AmountBeforeTax می تواند منجر به مالیات و هزینه های نادرست شود. به طور کلی، اکیداً توصیه می شود از TaxFeeInfo برای تعیین مالیات و هزینه های ملک استفاده کنید.

اگر applied_nights مشخص شده باشد، قیمت جدید برای ارزان‌ترین N شب اعمال می‌شود.

مثال ها:

• اگر برای اقامت 2 شب قیمت گذاری کنیم که مقادیر AmountBeforeTax 90، 90 باشد. مقادیر AmountAfterTax 100، 100 است. و fixed_price 80 است، سپس نرخ ارتقاء 80 + 80 = 160 است.
• اگر ما برای اقامت 2 شب قیمت گذاری کنیم که در آن AmountBeforeTax 100، 100 است. fixed_amount 80 است، و TaxFeeInfo مالیات 8٪ را مشخص می کند، سپس نرخ ارتقاء (80 + 80) * 1.08 = 172.8 است.
• اگر برای اقامت 3 شب قیمت گذاری کنیم که مقادیر AmountAfterTax 100، 110 و 120 باشد. و fixed_amount 110 است، سپس نرخ ارتقاء 110 * 3 = 330 است.

این فقط باید با percentage یا fixed_amount_per_night استفاده شود.

تعداد شب هایی که برای آن تخفیف اعمال می شود، با کمترین هزینه شروع می شود. باید یک عدد صحیح از 1 تا 99 باشد. اگر مشخص نشده باشد، برای تمام شب ها تخفیف اعمال می شود.

تعداد شب های لازم برای اعمال تخفیف. هر تخفیف برای بخش جداگانه ای از شب های اقامت اعمال می شود.

به عنوان مثال، برای اقامت 10 شب که stay_nights 4 است (و repeats درست است)، پس دو بخش شب اقامت وجود دارد: شب 1 تا 4 و شب 5 تا 8. شب های 9 و 10 بخشی از بخش شب اقامت نیستند.

آیا ممکن است تخفیف برای چندین بخش اقامت شبانه اعمال شود یا خیر. اگر false ، فقط بخش شب های اقامت در ابتدای برنامه سفر تخفیف داده می شود. اگر true ، هر بخش از شب های اقامت تخفیف داده می شود.

به عنوان مثال، اگر stay_nights 4 و برنامه سفر 10 شب باشد، اگر repeats true باشد، 2 بخش تخفیف داده می شود (شب 1-4 و شب 5-8). اما، اگر repeats false باشد، فقط 1 بخش تخفیف داده می شود (شب های 1-4).

دقیقاً یکی از Discount یا BestDailyDiscount باید مشخص شود.

تخفیف روزانه را مشخص می کند که ممکن است برای یک شب اقامت اعمال شود. این برخلاف Discount است که برای کل اقامت‌ها تخفیف اعمال می‌کند.

هر ملک ممکن است دارای یک گروه از تبلیغات باشد که "بهترین روزانه" در نظر گرفته می شوند. این بدان معناست که برای هر شب اقامت، تبلیغات تکی "بهترین روزانه" که واجد شرایط است و عمیق ترین تخفیف را برای آن شب به همراه دارد انتخاب شده و ممکن است اعمال شود.

Stacking ممکن است با BestDailyDiscount مشخص شود. باید روی base یا none تنظیم شود. تخفیف‌های «بهترین روزانه» که عمیق‌ترین تخفیف را برای هر شب ارائه می‌کنند، با هم ترکیب می‌شوند و به عنوان یک تخفیف اقامت (یعنی Discount ) در نظر گرفته می‌شوند، در حالی که نوع انباشتگی پیکربندی شده رعایت می‌شود. این تخفیف ترکیبی با سایر تبلیغات واجد شرایط <تخفیف> مقایسه می‌شود و می‌توان آن‌ها را برای یافتن یک یا ترکیبی که عمیق‌ترین تخفیف را ارائه می‌دهد، انباشته کرد. یا ترکیبی از BestDailyDiscount یا یک Discount واحد، هر کدام که قیمت کمتری را به همراه داشته باشد، برای نوع انباشته base انتخاب و اعمال می شود.

StayDates می توان با این نوع تخفیف مشخص کرد، اما application باید روی overlap تنظیم شود

دقیقاً یکی از percentage ، fixed_amount ، یا fixed_price مورد نیاز است.

یک مقدار اعشاری از 0-100 که درصد تخفیف را مشخص می کند. برای AmountAfterTax (یا AmountBeforeTax اگر AmountAfterTax مشخص نشده باشد) اعمال می شود.

مثال ها:

• اگر AmountAfterTax برای یک شب اقامت 100 و percentage 20 باشد، پس

  نرخ تبلیغات = AmountAfterTax * (1 - درصد تخفیف)

  80.00 = 100 * (1 - 0.2)

• اگر AmountBeforeTax برای یک هفته اقامت 100 است، percentage 20 است و TaxFeeInfo مالیات 10 را مشخص می کند، پس

  نرخ ارتقاء = AmountBeforeTax * (1 - درصد تخفیف) + مالیات

  90.00 = 100 * (1 - 0.2) + 10

دقیقاً یکی از percentage ، fixed_amount ، یا fixed_price مورد نیاز است.

مبلغ ثابتی که باید از یک نرخ شبانه AmountAfterTax (یا نرخ شبانه AmountBeforeTax در صورتی که AmountAfterTax مشخص نشده است) کم شود. فرض بر این است که به همان ارز نرخ شبانه است. اگر این بزرگتر از مجموع نرخ های شبانه باشد، مقدار حاصل صفر است.

مثال ها:

• اگر AmountBeforeTax برای یک شب 90، AmountAfterTax 100 و fixed_amount 20 باشد، پس

  نرخ ارتقاء = AmountAfterTax - تخفیف ثابت

  80.00 = 100 - 20

• اگر AmountBeforeTax برای یک شب 100 باشد، fixed_amount 20 باشد و TaxFeeInfo مالیات 8٪ را مشخص کند، پس

  نرخ ارتقاء = ( AmountBeforeTax - تخفیف ثابت) * (1 + درصد مالیات)

  86.40 = (100 - 20) * 1.08

دقیقاً یکی از percentage ، fixed_amount ، یا fixed_price مورد نیاز است.

اگر نرخ‌های شبانه AmountAfterTax مشخص شده باشد، قیمت شب اقامت شامل مالیات و هزینه‌ها را به مقدار مشخص تعیین می‌کند. اگر AmountBeforeTax مشخص شده باشد، چه AmountAfterTax مشخص شده باشد یا خیر، این قیمت قبل از مالیات را برای اقامت روی مقدار مشخص شده تنظیم می کند. فرض بر این است که به همان ارز نرخ شبانه است.

مثال ها:

• اگر AmountBeforeTax برای یک شب 90، AmountAfterTax 100 و fixed_price 80 باشد، نرخ تبلیغات 80 است.
• اگر AmountBeforeTax برای یک شب 100 باشد، fixed_amount 80 باشد و TaxFeeInfo مالیات 8٪ را مشخص کند، پس

  نرخ تبلیغات = قیمت ثابت * (1 + درصد مالیات)

  86.40 = 80 * 1.08

کانتینری برای قانون نرخ عضویت که باعث ایجاد یک درمان UI خاص برای تخفیف مرتبط می شود.

این عنصر نباید مشخص شود مگر اینکه <Discount> نیز مشخص شده باشد.

شناسه قانون نرخ مرتبط با برنامه عضویت.

بسته به این تنظیم، تبلیغات چندگانه را می توان برای یک نرخ اعمال کرد:

• any : را می توان با هر تبلیغ دیگری ترکیب کرد (به جز none )، اما ترتیبی که تبلیغات باید اعمال شوند تضمین نمی شود.
• base : بهترین تبلیغ base واجد شرایط ابتدا قبل از سایر تبلیغات انتخاب و اعمال می شود. این قبلا base_only نام داشت.
• second : بهترین تبلیغ second واجد شرایط پس از ارتقای base (در صورت وجود) و قبل از any تبلیغات انتخاب و اعمال می شود.
• none : نمی توان آن را با تبلیغات دیگر ترکیب کرد.

از میان ترکیب‌های مجاز، مجموعه تبلیغاتی که بیشترین تخفیف را به همراه دارد، روی نرخ اعمال می‌شود.

توضیح می دهد که چگونه تبلیغات باید اعمال شود.

مقادیر معتبر عبارتند از:

• all : اگر همه تاریخ‌های برنامه سفر با تاریخ‌های اقامت همپوشانی داشته باشند، تبلیغ را برای هر شب در برنامه سفر اعمال می‌کند.
• any : اگر تاریخی در برنامه سفر با تاریخی در محدوده تاریخ اقامت همپوشانی داشته باشد، تبلیغ را برای تمام شب‌های برنامه سفر اعمال می‌کند.
• overlap : تبلیغات را فقط برای شب‌هایی در برنامه سفر اعمال می‌کند که با تاریخی در محدوده تاریخ اقامت همپوشانی دارند.

این ویژگی همیشه باید مشخص شود.

• اگر <Discount> percentage مشخص کند و application روی all یا any تنظیم شود، تخفیف به عنوان درصدی از اقامت کامل اعمال می شود.
• اگر <Discount> percentage مشخص کند و application روی overlap تنظیم شده باشد، تخفیف به عنوان درصدی از نرخ های شبانه برای شب های همپوشانی اعمال می شود.
• <Discount> تعیین fixed_amount و تنظیم application روی overlap ترکیبی نامعتبر است.
• <FreeNights> از تمام مقادیر application پشتیبانی می کند. توجه داشته باشید که برای overlap ، تنها شب‌های اقامت با هم تداخل دارند برای شرایط تخفیف.

یک محدوده تاریخی که تاریخ هایی را که قرار است تبلیغات اعمال شود را مشخص می کند.

فرمت YearlessDate نیز پشتیبانی می شود.

• اگر یکی از تاریخ های start یا end یک تاریخ بدون سال باشد، هر دو باید به عنوان تاریخ های بدون سال پر شوند.
• محدوده تاریخ بدون سال نباید در سال جدید باشد. در عوض، محدوده را به عنوان دو محدوده تاریخ مجاور نشان دهید. برای مثال، {"12-29", "01-05"} می توان به صورت {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

اگر می خواهید محدوده StayDates را تنظیم کنید تا تبلیغات در روزهای خاصی از هفته مجاز باشد، باید تاریخ start را به عنوان تاریخ فعلی بدون end تنظیم کنید تا تبلیغات منقضی نشود.

اگر مقدار end ارائه نشده باشد، باید مقدار start مشخص کنید.

اگر مقدار start ارائه نشده باشد، باید مقدار end را مشخص کنید.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

مقادیر معتبر include و exclude .

اگر type UserCountries به عنوان include تنظیم شده باشد، این تبلیغ برای کاربران کشورهای فهرست شده اعمال می شود.

اگر type UserCountries exclude باشد، این تبلیغ برای کاربران خارج از کشورهای فهرست شده اعمال می شود.

اگر type UserCountries تنظیم نشده باشد، به عنوان include تلقی می شود و تبلیغات برای کاربران کشورهای فهرست شده اعمال می شود.

یا <Success> یا <Issues> در هر پیام وجود دارد.

یا <Success> یا <Issues> در هر پیام وجود دارد.

نوع مشکل مواجه شده

مقادیر معتبر warning ، error و failure هستند.

اگر یک باطن دارید که فید برای چندین حساب <OTA_HotelRateAmountNotifRQ> ارائه می دهد ، این مقدار باید با مقدار ویژگی ID مشخص شده در عنصر <RequestorID> و <OTA_HotelAvailNotifRQ> برای همان حساب مطابقت داشته باشد.

تبلیغات برای یک ملک. هر تبلیغ برای یک ملک واحد اعمال می شود.

مگر در مواردی که از <Stacking> استفاده شود ، در صورت واجد شرایط بودن تبلیغات متعدد ، از تبلیغات با بزرگترین تخفیف برای رزرو استفاده می شود.

در صورت مشخص شدن ، مقدار باید "overlay" باشد. هنگامی که مقدار "overlay" است ، تمام تبلیغات ذخیره شده قبل از ذخیره تبلیغات مشخص شده در پیام فعلی حذف می شوند.

اگر مشخص نشده باشد ، پس از آن هر تبلیغی که در پیام فعلی مشخص شده است نیز است:

• Added (اگر هیچ یک از تبلیغات ذخیره شده دارای یک id یکسان نیست)
• Updated (اگر یک تبلیغ ذخیره شده دارای همان id باشد)
• Deleted (اگر یک تبلیغ ذخیره شده دارای همان id باشد و مقدار ویژگی action برای تبلیغ مشخص شده در پیام فعلی "delete" است)

یک تبلیغ واحد برای یک ملک. توجه داشته باشید که اگر action="overlay" و A <Promotion> مشخص نشده باشد ، تمام تبلیغات مربوط به این ملک حذف می شوند.

اگر نیاز به استفاده از بیش از 99 تبلیغ دارید ، با مدیر حساب فنی خود (TAM) تماس بگیرید.

در صورت مشخص شدن ، مقدار باید delete شود. اگر مشخص نشده باشد و ارتقاء با همان id ذخیره نمی شود ، این تبلیغات ذخیره می شود. در غیر این صورت ، اگر مشخص نشده باشد و ارتقاء با همان id ذخیره شود ، تبلیغات موجود به روز می شود.

در صورت مشخص شدن delete ، تبلیغات ذخیره شده با همان id حذف می شود. هنگام استفاده از delete ، هیچ عنصر کودک را در <Promotion> قرار ندهید. همچنین ، delete در رابطه با <HotelPromotions action="overlay"/> مجاز نیست.

تاریخ شروع یا DateTime (بر اساس منطقه زمانی خاصیت) ، شامل محدوده.

• تاریخ یا DateTime که توسط start مشخص شده است باید زودتر از (یا همانند) باشد که تاریخ یا DateTime تا end مشخص شده است.
• اگر start مشخص نشده باشد ، دامنه از نظر زمان شروع به طور نامحدودی نامحدود است.
• اگر start به عنوان تاریخ "yyyy-mm-dd" جمع شود ، به عنوان dateTime "yyyy-mm-ddt00: 00: 00" تعبیر می شود.

تاریخ پایان یا DateTime (بر اساس منطقه زمانی خاصیت) ، شامل محدوده.

• تاریخ یا DateTime مشخص شده تا end باید حداکثر (یا همانند) باشد که تاریخ یا DateTime توسط start مشخص شده است.
• اگر end مشخص نشده باشد ، دامنه از نظر زمان پایان به طور نامحدودی نامحدود است.
• اگر end به عنوان تاریخ "yyyy-mm-dd" ارائه شود ، به عنوان dateTime "yyyy-mm-ddt23: 59: 59" تعبیر می شود.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

انواع ارزش معتبر عبارتند از:

• عدد صحیح: تعداد روزهای قبل از تاریخ ورود. به عنوان مثال ، یک مقدار 30 نشان می دهد که تبلیغات فقط در مورد رزرو حداقل 30 روز قبل از تاریخ ورود اعمال می شود.
• مدت زمان ISO 8601 (روز ، ساعت و دقیقه): تعداد روزها (و ساعتهای اختیاری ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال ، مقدار P30D نشان می دهد که تبلیغات فقط در مورد رزرو حداقل 30 روز قبل از تاریخ چک اعمال می شود. مقدار P30DT6H نیاز به رزرو در تاریخ یا قبل از ساعت 18:00 در روز 30 روز قبل از ورود دارد.

انواع ارزش معتبر عبارتند از:

• عدد صحیح: تعداد روزهای قبل از تاریخ ورود. به عنوان مثال ، مقدار 30 نشان می دهد که ارتقاء فقط در 30 روز قبل از تاریخ ورود به سیستم مربوط می شود.
• مدت زمان ISO 8601 (روز ، ساعت و دقیقه): تعداد روزها (و ساعتهای اختیاری ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال ، مقدار P30D نشان می دهد که این ارتقاء فقط در مورد رزروهای حداکثر 30 روز قبل از تاریخ ورود به کار اعمال می شود. مقدار P30DT6H نیاز به رزرو در تاریخ یا بعد از 18:00 در روز 30 روز قبل از ورود دارد.

محدودیت هایی را در حداکثر مقدار که می توان نرخ را پس از اعمال تبلیغات تعیین کرد ، تعریف می کند.

تبلیغات همیشه باید یک <Discount> یا یک <BestDailyDiscount> را مشخص کنند ، بنابراین برای ایجاد تبلیغی که فقط یک <Ceiling> را اعمال می کند ، یک گزینه تنظیم <Discount> با percentage 0 است.

اگر انباشت پیکربندی شده باشد ، چندین تبلیغ با <Ceiling> می توانند برای یک اقامت واحد اعمال شوند. هر تبلیغی تخفیف خود را اعمال می کند ، بلافاصله پس از سقف آن. مثال زیر نشان می دهد که چگونه هر سقف به محاسبه ارتقاء بعدی در پشته کمک می کند.

مثال:

قیمت یک شب اقامت در جایی که AmountBeforeTax 100 است و پشته ای از دو تبلیغ وجود دارد:

1. ارتقا با base انباشته شده ، یک fixed_amount 25 و یک amount_per_night سقف_پر_ شب 60
2. ارتقا با نوع انباشته second ، fixed_amount 25 و یک amount_per_night سقف_پر_ شب 90

در اینجا ترتیب محاسبه است:

1. ارتقاء base ابتدا اعمال می شود و AmountBeforeTax به 75 تخفیف می دهد ، اما سپس سقف آن را به 60 کاهش می دهد.
2. ارتقاء second از AmountBeforeTax از 60 تا 35 تخفیف می دهد. این زیر سقف 90 است بنابراین سقف دوم اعمال نمی شود. نرخ نهایی 35 است.

این واقعیت که 60 یک سقف کلی سخت تر است ، بی ربط است زیرا فقط برای ارتقاء خاص خود معتبر است و هیچ سقف منفرد وجود ندارد که کل پشته تبلیغاتی را در بر بگیرد.

حداکثر مبلغی که می توان نرخ شبانه را پس از اعمال تخفیف تعیین کرد.

اگر یک عنصر <Floor> نیز مشخص شده باشد ، این باید روی مقداری بیشتر از یا مساوی با ویژگی amount_per_night در <Floor> تنظیم شود.

amount_per_night در هنگام قرار گرفتن در نرخ شبانه با استفاده از AmountAfterTax ، به مالیات و هزینه اعمال می شود ، اما مواردی که با استفاده از TaxFeeInfo مشخص نشده اند.

محدودیت هایی را در حداقل مقدار که می توان نرخ را پس از اعمال تبلیغات تعیین کرد ، تعریف می کند.

تبلیغات همیشه باید یک <Discount> یا یک <BestDailyDiscount> را مشخص کنند ، بنابراین برای ایجاد تبلیغی که فقط یک <Floor> را اعمال می کند ، یک گزینه تنظیم <Discount> با percentage 0 است.

<Floor> منطق هنوز هم در مورد تخفیف های <FreeNights> اعمال می شود ، حتی اگر شب رایگان دارای 100% تخفیف برای آن باشد.

اگر انباشت پیکربندی شده باشد ، چندین تبلیغ با <Floor> می توانند برای یک اقامت واحد اعمال شوند. هر تبلیغی تخفیف خود را اعمال می کند ، بلافاصله پس از آن کف آن. مثال زیر نشان می دهد که چگونه هر طبقه به محاسبه ارتقاء بعدی در پشته کمک می کند.

مثال:

قیمت یک شب اقامت در جایی که AmountBeforeTax 100 است و پشته ای از دو تبلیغ وجود دارد:

1. ارتقا با base انباشته شده ، یک fixed_amount 25 و یک amount_per_night کف_پر_ شب 90
2. ارتقا با نوع انباشته second ، fixed_amount از 25 و یک amount_per_night کف_پر_ شب 60

در اینجا ترتیب محاسبه است:

1. ارتقاء base ابتدا اعمال می شود و AmountBeforeTax به 75 تخفیف می دهد ، اما سپس کف آن را تا 90 بالا می برد.
2. second ارتقاء AmountBeforeTax از 90 تا 65 تخفیف می دهد. این بالاتر از کف 60 است بنابراین طبقه دوم اعمال نمی شود. نرخ نهایی 65 است.

این واقعیت که 90 یک طبقه سخت تر است ، بی ربط است زیرا فقط برای ارتقاء خاص خود معتبر است ، و هیچ طبقه ای وجود ندارد که کل پشته تبلیغاتی را در بر بگیرد.

حداقل مبلغی که می توان نرخ شبانه را پس از اعمال تخفیف تعیین کرد.

اگر یک عنصر <Ceiling> نیز مشخص شده باشد ، این باید روی یک مقدار کمتر یا مساوی با ویژگی amount_per_night در <Ceiling> تنظیم شود.

amount_per_night در هنگام قرار گرفتن در نرخ شبانه با استفاده از AmountAfterTax ، به مالیات و هزینه اعمال می شود ، اما مواردی که با استفاده از TaxFeeInfo مشخص نشده اند.

محدوده تاریخ مشخص می کند که چه زمانی باید ورود به سیستم انجام شود تا ارتقاء اعمال شود. در صورت حذف یک یا چند تبلیغ ، این عنصر لازم نیست.

فرمت بی سال نیز پشتیبانی می شود.

• اگر یکی از start یا end یک تاریخ بی سال باشد ، هر دو باید به عنوان تاریخ های بی سال جمع شوند.
• محدوده تاریخ بی سال نباید در سال جدید پیچیده شود. در عوض ، دامنه را به عنوان دو محدوده تاریخ مجاور معرفی کنید. به عنوان مثال ، {"12-29", "01-05"} می توان به عنوان {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

محدوده تاریخ مشخص می شود که باید در هنگام استفاده از آن ، اقدام به انجام شود. در صورت حذف یک یا چند تبلیغ ، این عنصر لازم نیست.

فرمت بی سال نیز پشتیبانی می شود.

• اگر یکی از start یا end یک تاریخ بی سال باشد ، هر دو باید به عنوان تاریخ های بی سال جمع شوند.
• محدوده تاریخ بی سال نباید در سال جدید پیچیده شود. در عوض ، دامنه را به عنوان دو محدوده تاریخ مجاور معرفی کنید. به عنوان مثال ، {"12-29", "01-05"} می توان به عنوان {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

دقیقاً یکی از Discount یا BestDailyDiscount باید مشخص شود.

تخفیف مورد استفاده برای این تبلیغ را مشخص می کند.

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

مقدار اعشاری از 0-100 که درصد تخفیف را مشخص می کند. این مورد به AmountAfterTax اعمال می شود (یا در صورت مشخص کردن AmountAfterTax یا AmountBeforeTax ).

مثال ها:

• اگر AmountAfterTax 100 و percentage 20 باشد ، پس

  نرخ ارتقاء = AmountAfterTax * (1 - درصد تخفیف)

  80.00 = 100 * (1 - 0.2)

• اگر AmountBeforeTax 100 باشد ، percentage 20 است و Taxfeeinfo مالیات 10 را مشخص می کند.

  نرخ ارتقاء = AmountBeforeTax * (1 - درصد تخفیف) + مالیات

  90.00 = 100 * (1 - 0.2) + 10

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

مقدار اعشاری از 0-100 که درصد تخفیف پایه را مشخص می کند. مشابه percentage ، آن را به AmountAfterTax (یا در صورت مشخص شدن AmountAfterTax ) به AmountBeforeTax اعمال می شود.

بر خلاف percentage ، این تخفیف همیشه به عنوان درصد از نرخ پایه صرف نظر از تبلیغات قبلی که به صورت توالی اعمال شده اند محاسبه می شود.

مثال:

• فرض کنید ما دو تبلیغ داریم که به ترتیب در یک شب اقامت یک شب اعمال می شود که قیمت آن 100 است. اولی تخفیف 10 ٪ درصد و دوم 10 ٪ از تخفیف پایه است. سپس نرخ تخفیف 80 خواهد بود زیرا هر دو تبلیغ 10 نفر را از دست می دهند. توجه داشته باشید اگر ارتقاء دوم نیز تخفیف درصدی منظم داشته باشد ، از آنجا که دومین تخفیف ارتقاء 10 ٪ از 90 تخفیف می یابد ، نرخ تخفیف 81 خواهد بود.

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

مبلغ مشخصی که باید از مبلغ مبلغ AmountAfterTax (یا مبلغ مبلغ AmountBeforeTax شبانه در صورت مشخص شدن AmountAfterTax ) جمع شود. فرض بر این است که در همان ارز با نرخ شبانه قرار دارد. اگر این بزرگتر از مجموع نرخ شبانه باشد ، مقدار حاصل صفر است.

مثال ها:

• اگر ما یک اقامت 1 شب را که در آن AmountBeforeTax 90 است ، AmountAfterTax 100 و fixed_amount 20 است ، پس از آن 20 ، پس از آن

  نرخ ارتقا = AmountAfterTax - تخفیف ثابت

  80.00 = 100 - 20

• اگر ما یک اقامت 1 شب را که در آن AmountBeforeTax 100 موردی است ، قیمت گذاری می کنیم ، fixed_amount 20 است ، و Taxfeeinfo مالیات 8 ٪ را مشخص می کند ، پس از آن

  نرخ ارتقا = ( AmountBeforeTax - تخفیف ثابت) * (1 + درصد مالیات)

  86.40 = (100 - 20) * 1.08

• اگر ما یک اقامت 1 شب را که در آن AmountBeforeTax 50 است ، قیمت گذاری می کنیم ، 60 fixed_amount است و Taxfeeinfo مالیات 10 را مشخص می کند ، پس از آن

  نرخ ارتقا = ( AmountBeforeTax - تخفیف ثابت) * مالیات

  10.00 = 0 + 10

• اگر ما یک اقامت 3 شبانه را در آن قرار دهیم که مقادیر AmountAfterTax 100 ، 110 و 120 باشد. و fixed_amount 150 است ، پس

  نرخ ارتقاء = مبلغ ( AmountAfterTax ) - (تخفیف ثابت)

  180.00 = (100 + 110 + 120) - 150

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

یک تخفیف ثابت برای هر یک از نرخ های شبانه AmountAfterTax اعمال می شود (یا ارزان ترین n در صورت مشخص applied_nights مشخص شده است). اگر AmountAfterTax مشخص نشده باشد ، به AmountBeforeTax اعمال می شود. فرض بر این است که در همان ارز با نرخ شبانه قرار دارد. اگر fixed_amount_per_night از نرخ شبانه بزرگتر باشد ، آن نرخ شبانه به صفر کاهش می یابد - تخفیف نمی تواند باعث شود نرخ شبانه منفی شود.

مثال ها:

• اگر ما یک اقامت 3 شبانه را در آن قرار دهیم که مقادیر AmountAfterTax 100 ، 110 و 120 باشد. و fixed_amount_per_night 10 است ، پس

  نرخ ارتقاء = مبلغ ( AmountBeforeTax - تخفیف مبلغ ثابت)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• اگر ما یک اقامت 3 شبانه را در آن قرار دهیم که مقادیر AmountAfterTax 10 ، 50 و 100 باشد. و fixed_amount_per_night 20 است ، پس

  نرخ ارتقاء = مبلغ ( AmountAfterTax - تخفیف مبلغ ثابت)

  110.00 = (0 + (50 - 20) + (100 - 20))

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

اگر نرخ های شبانه AmountAfterTax مشخص شده باشد ، این قیمت برای اقامت ، از جمله مالیات و هزینه ، به ارزش مشخص شده تعیین می کند. اگر AmountBeforeTax مشخص شده باشد ، پس از آن که AmountAfterTax مشخص شده است یا خیر ، این قیمت قبل از مالیات را برای ماندن به مقدار مشخص شده تعیین می کند. فرض بر این است که در همان ارز با نرخ شبانه قرار دارد.

اگر AmountAfterTax برای منعکس کننده درصدی مالیات در نظر گرفته شود ، تعیین قیمت ثابت برای AmountBeforeTax می تواند منجر به مالیات و هزینه های نادرست شود. به طور کلی ، به شدت توصیه می شود از TaxFeeInfo برای مشخص کردن مالیات و هزینه های یک ملک استفاده کنید.

مثال ها:

• اگر ما یک اقامت 1 شب را که در آن AmountBeforeTax 90 است ، AmountAfterTax 100 و fixed_price 80 است ، پس از آن نرخ ارتقاء 80 است.
• اگر ما یک اقامت 1 شب را که در آن AmountBeforeTax 100 موردی است ، قیمت گذاری می کنیم ، fixed_amount 80 است ، و Taxfeeinfo مالیات 8 ٪ را مشخص می کند ، پس از آن

  نرخ تبلیغ = قیمت ثابت * (1 + درصد مالیات)

  86.40 = 80 * 1.08

• اگر ما یک اقامت 3 شبانه را در آن قرار دهیم که مقادیر AmountAfterTax 100 ، 110 و 120 باشد. و fixed_amount 300 است ، پس

  نرخ ارتقا = 300

دقیقاً یکی از percentage ، percentage_of_base ، fixed_amount ، fixed_amount_per_night ، fixed_price یا fixed_price_per_night لازم است.

اگر نرخ های شبانه AmountAfterTax مشخص شده باشد ، این قیمت برای هر شب اقامت ، از جمله مالیات و هزینه ، به ارزش مشخص شده تعیین می کند. اگر AmountBeforeTax مشخص شده باشد ، پس از آن که AmountAfterTax مشخص شده است ، این قیمت قبل از مالیات را برای هر شب اقامت به مقدار مشخص شده تعیین می کند. فرض بر این است که در همان ارز با نرخ شبانه قرار دارد.

اگر AmountAfterTax برای منعکس کننده درصدی مالیات در نظر گرفته شود ، تعیین قیمت ثابت برای AmountBeforeTax می تواند منجر به مالیات و هزینه های نادرست شود. به طور کلی ، به شدت توصیه می شود از TaxFeeInfo برای مشخص کردن مالیات و هزینه های یک ملک استفاده کنید.

اگر applied_nights مشخص شده باشد ، قیمت جدید برای ارزانترین شب N اعمال می شود.

مثال ها:

• اگر ما یک اقامت 2 شبانه را در آن قیمت گذاری کنیم که مقادیر AmountBeforeTax 90 ، 90 باشد. مقادیر مقدار AmountAfterTax 100 ، 100 است. و fixed_price 80 است ، سپس نرخ ارتقاء 80 + 80 = 160 است.
• اگر ما یک اقامت 2 شبانه را در آن قرار دهیم که AmountBeforeTax 100 ، 100 باشد. fixed_amount 80 است ، و Taxfeeinfo مالیات 8 ٪ را مشخص می کند ، سپس نرخ ارتقاء (80 + 80) * 1.08 = 172.8 است.
• اگر ما یک اقامت 3 شبانه را در آن قرار دهیم که مقادیر AmountAfterTax 100 ، 110 و 120 باشد. و fixed_amount 110 است ، سپس نرخ ارتقاء 110 * 3 = 330 است.

این فقط باید با percentage یا fixed_amount_per_night استفاده شود.

تعداد شبهایی که تخفیف در آن اعمال می شود ، با کمترین هزینه شروع می شود. باید یک عدد صحیح از 1 تا 99 باشد. اگر مشخص نشده باشد ، تخفیف در تمام شبها اعمال می شود.

تعداد شبهای مورد نیاز برای اعمال تخفیف. هر تخفیف در یک بخش جداگانه از شب های اقامت اعمال می شود.

به عنوان مثال ، برای یک اقامت 10 شب که در آن stay_nights 4 است (و repeats درست است) ، سپس دو بخش شب اقامت وجود دارد: شبهای 1 تا 4 و شبهای 5 تا 8. شبهای نهم و دهم بخشی از بخش اقامت شب نیست.

این که آیا تخفیف ممکن است برای چند بخش شب اقامت اعمال شود. اگر false ، پس از آن فقط بخش شب اقامت در ابتدای برنامه سفر تخفیف می یابد. اگر true ، پس هر بخش از شب اقامت تخفیف می یابد.

به عنوان مثال ، اگر stay_nights 4 باشد و برنامه سفر 10 شب باشد ، اگر repeats true باشد ، 2 بخش تخفیف می شوند (شبهای 1-4 و شب 5-8). اما ، اگر repeats false باشد ، فقط 1 بخش تخفیف می یابد (شب 1-4).

دقیقاً یکی از Discount یا BestDailyDiscount باید مشخص شود.

تخفیف روزانه را مشخص می کند که ممکن است برای یک شب اقامت اعمال شود. این برخلاف Discount است که تخفیف در کل اقامت را اعمال می کند.

هر ملک ممکن است یک گروه واحد از تبلیغات داشته باشد که "بهترین روزانه" در نظر گرفته می شود. این بدان معناست که برای هر شب اقامت ، تک آهنگ "بهترین روزانه" که واجد شرایط است و عمیق ترین تخفیف را برای آن شب انتخاب می کند و ممکن است اعمال شود.

Stacking ممکن است با BestDailyDiscount مشخص شود. باید روی base یا none تنظیم شود. تخفیف های "بهترین روزانه" که به اعماق تخفیف برای هر شب منجر می شود ، ضمن احترام به نوع انباشت پیکربندی شده ، به عنوان یک تخفیف اقامت واحد (یعنی Discount ) ترکیب و تحت درمان قرار می گیرند. این تخفیف ترکیبی در مقابل مقایسه می شود و می توان آن را با سایر تبلیغات واجد شرایط <frivation> برای یافتن یک یا ترکیبی که عمیق ترین تخفیف را پیدا می کند ، جمع کرد. یا ترکیبی از BestDailyDiscount یا یک Discount واحد ، هر کدام از قیمت های پایین تر باشد ، برای نوع انباشت base انتخاب و درخواست می شود.

StayDates می توان با این نوع تخفیف مشخص کرد ، اما application باید با overlap داشته باشد

دقیقاً یکی از percentage ، fixed_amount یا fixed_price لازم است.

مقدار اعشاری از 0-100 که درصد تخفیف را مشخص می کند. این مورد به AmountAfterTax اعمال می شود (یا در صورت مشخص کردن AmountAfterTax یا AmountBeforeTax ).

مثال ها:

• اگر AmountAfterTax برای یک شب اقامت 100 و percentage 20 باشد ، پس

  نرخ ارتقاء = AmountAfterTax * (1 - درصد تخفیف)

  80.00 = 100 * (1 - 0.2)

• اگر AmountBeforeTax برای اقامت 100 100 باشد ، percentage 20 است و Taxfeeinfo مالیات 10 را مشخص می کند ، پس از آن

  نرخ ارتقاء = AmountBeforeTax * (1 - درصد تخفیف) + مالیات

  90.00 = 100 * (1 - 0.2) + 10

دقیقاً یکی از percentage ، fixed_amount یا fixed_price لازم است.

مبلغ مشخصی که باید از نرخ شبانه یک AmountAfterTax کم شود (یا در صورت مشخص کردن AmountAfterTax ، نرخ شبانه AmountBeforeTax . فرض بر این است که در همان ارز با نرخ شبانه قرار دارد. اگر این بزرگتر از مجموع نرخ شبانه باشد ، مقدار حاصل صفر است.

مثال ها:

• اگر AmountBeforeTax برای یک شب 90 باشد ، AmountAfterTax 100 است و fixed_amount 20 است ، پس از آن

  نرخ ارتقا = AmountAfterTax - تخفیف ثابت

  80.00 = 100 - 20

• اگر AmountBeforeTax برای یک شب تنها 100 باشد ، fixed_amount 20 است ، و مالیات بر 8 ٪ مالیات 8 ٪ را مشخص می کند.

  نرخ ارتقا = ( AmountBeforeTax - تخفیف ثابت) * (1 + درصد مالیات)

  86.40 = (100 - 20) * 1.08

دقیقاً یکی از percentage ، fixed_amount یا fixed_price لازم است.

اگر نرخ های شبانه AmountAfterTax مشخص شده باشد ، این قیمت برای شب اقامت ، از جمله مالیات و هزینه ، به ارزش مشخص شده تعیین می کند. اگر AmountBeforeTax مشخص شده باشد ، پس از آن که AmountAfterTax مشخص شده است یا خیر ، این قیمت قبل از مالیات را برای ماندن به مقدار مشخص شده تعیین می کند. فرض بر این است که در همان ارز با نرخ شبانه قرار دارد.

مثال ها:

• اگر AmountBeforeTax برای یک شب واحد 90 باشد ، AmountAfterTax 100 و fixed_price 80 است ، پس نرخ ارتقاء 80 است.
• اگر AmountBeforeTax برای یک شب تنها 100 باشد ، fixed_amount 80 است ، و Taxfeeinfo مالیات 8 ٪ را مشخص می کند.

  نرخ تبلیغ = قیمت ثابت * (1 + درصد مالیات)

  86.40 = 80 * 1.08

کانتینر برای یک قانون نرخ عضویت که باعث ایجاد یک UI خاص برای تخفیف مرتبط می شود.

این عنصر نباید مشخص شود مگر اینکه <Discount> نیز مشخص شود.

شناسه قانون نرخ مرتبط با یک برنامه عضویت.

بسته به این تنظیم ، تبلیغات چندگانه را می توان با یک نرخ واحد اعمال کرد:

• any : می تواند با هر تبلیغ دیگری (به جز none ) ترکیب شود ، اما ترتیب استفاده از تبلیغات باید تضمین شود.
• base : بهترین ارتقاء base واجد شرایط قبل از سایر تبلیغات ، ابتدا انتخاب و اعمال می شود. این قبلاً base_only نامگذاری شده بود.
• second : بهترین ارتقاء second واجد شرایط پس از ارتقاء base (در صورت وجود) و قبل از any تبلیغ انتخاب و اعمال می شود.
• none : نمی توان با سایر تبلیغات ترکیب شد.

از ترکیبات مجاز ، مجموعه تبلیغاتی که بیشترین تخفیف را به دست می آورد ، به نرخ اعمال می شود.

نحوه استفاده از ارتقاء را توصیف می کند.

مقادیر معتبر عبارتند از:

• all : اگر همه تاریخ های برنامه سفر با تاریخ اقامت همپوشانی داشته باشند ، ارتقاء هر شب در برنامه سفر را اعمال می کند.
• any : در صورت هرگونه تاریخ در برنامه سفر با تاریخ در محدوده Dates Dates ، تبلیغات را برای همه شبهای برنامه سفر اعمال می کند.
• overlap : ارتقاء را فقط برای آن شبهای برنامه سفر که با تاریخ در محدوده Dates Dates همپوشانی دارند ، اعمال می کند.

این ویژگی همیشه باید مشخص شود.

• اگر <Discount> percentage مشخص می کند و application به all یا any تنظیم شده است ، تخفیف به عنوان درصدی از اقامت کامل اعمال می شود.
• اگر <Discount> percentage مشخص کند و application با overlap دارد ، تخفیف به عنوان درصد نرخ شبانه برای شبهای همپوشانی اعمال می شود.
• <Discount> مشخص کردن fixed_amount و تنظیم application برای overlap ، ترکیبی نامعتبر است.
• <FreeNights> از تمام مقادیر application پشتیبانی می کند. توجه داشته باشید که برای overlap ، فقط شبهای اقامت همپوشانی برای نیازهای تخفیف در نظر گرفته می شوند.

یک محدوده تاریخی که تاریخ هایی را که قرار است تبلیغات اعمال شود را مشخص می کند.

فرمت بی سال نیز پشتیبانی می شود.

• اگر یکی از start یا end یک تاریخ بی سال باشد ، هر دو باید به عنوان تاریخ های بی سال جمع شوند.
• محدوده تاریخ بی سال نباید در سال جدید پیچیده شود. در عوض ، دامنه را به عنوان دو محدوده تاریخ مجاور معرفی کنید. به عنوان مثال ، {"12-29", "01-05"} می توان به عنوان {"12-29", "12-31"} و {"01-01", "01-05"} نشان داد.

اگر می خواهید محدوده StayDates را تنظیم کنید تا در روزهای خاص هفته به ارتقاء برسد ، باید تاریخ start را به عنوان تاریخ فعلی بدون end تنظیم کنید تا ارتقاء منقضی نشود.

اگر مقدار end ارائه نشده باشد ، باید مقدار start مشخص کنید.

اگر مقدار start ارائه نشده باشد ، باید مقدار end را مشخص کنید.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

مقادیر معتبر include و exclude .

اگر type UserCountries به صورت include تنظیم شود ، این تبلیغ برای کاربران کشورهای ذکر شده اعمال می شود.

اگر type UserCountries exclude باشد ، این تبلیغ برای کاربران خارج از کشورهای ذکر شده اعمال می شود.

اگر type UserCountries غیرقانونی باشد ، به صورت include رفتار می شود و ارتقاء برای کاربران کشورهای ذکر شده اعمال می شود.

یا <Success> یا <Issues> در هر پیام وجود دارد.

یا <Success> یا <Issues> در هر پیام وجود دارد.

نوع مشکل مواجه شده

مقادیر معتبر warning ، error و failure هستند.

If you have a backend that provides feeds for multiple accounts, this value needs to match the ID attribute value specified in the <RequestorID> element of your <OTA_HotelRateAmountNotifRQ> and <OTA_HotelAvailNotifRQ> messages for the same account.

Promotions for a property. Each promotion applies to a single property.

Unless <Stacking> is used, the promotion with the biggest discount is applied to the booking when multiple promotions are eligible.

If specified, the value must be "overlay" . When the value is "overlay" , all stored promotions are deleted prior to storing the promotions specified in the current message.

If not specified, then each promotion specified in the current message is either:

• Added (if none of the stored promotions has the same id )
• Updated (if a stored promotion has the same id )
• Deleted (if a stored promotion has the same id and the value of the action attribute for the promotion specified in the current message is "delete" )

A single promotion for a property. Note that if action="overlay" and a <Promotion> is not specified, all promotions for the property are deleted.

If you need to use more than 99 promotions, contact your Technical Account Manager (TAM).

If specified, the value must be delete . If not specified and a promotion with the same id isn't stored, then this promotion is stored. Otherwise, if not specified and a promotion with the same id is stored, then the existing promotion is updated.

If delete is specified, the stored promotion with the same id is deleted. When using delete , don't include any child elements in <Promotion> . Also, delete is not allowed in conjunction with <HotelPromotions action="overlay"/> .

The starting date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by start must be earlier than (or the same as) the date or datetime specified by end .
• If start isn't specified, the range is effectively unlimited in terms of a start time.
• If start is populated as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT00:00:00".

The ending date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by end must be later than (or the same as) the date or datetime specified by start .
• If end isn't specified, the range is effectively unlimited in terms of an end time.
• If end is provided as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT23:59:59".

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at least 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at least 30 days before the check-in date. A value of P30DT6H requires booking on or before 18:00 on the 30th day before arrival.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at most 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at most 30 days before the check-in date. A value of P30DT6H requires booking on or after 18:00 on the 30th day before arrival.

Defines restrictions on the maximum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Ceiling> , one option is to set a <Discount> with a percentage of 0 .

If stacking is configured, then multiple promotions with <Ceiling> could apply to a single stay. Each promotion would apply its discount, immediately followed by its ceiling. The following example demonstrates how each ceiling contributes to the next promotion calculation in the stack.

مثال:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a ceiling amount_per_night of 60
2. Promotion with stacking type second , fixed_amount of 25, and a ceiling amount_per_night of 90

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the ceiling lowers it to 60 .
2. The second promotion discounts the AmountBeforeTax from 60 to 35. This is below the ceiling of 90 so the second ceiling is not applied. The final rate is 35 .

The fact that 60 is a stricter overall ceiling is irrelevant since it is valid only for its own promotion, and there can be no single ceiling that spans the entire promotion stack.

The maximum amount that a nightly rate can be set to after the discount is applied.

If a <Floor> element is also specified, this must be set to a value greater than or equal to the amount_per_night attribute in <Floor> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

Defines restrictions on the minimum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Floor> , one option is to set a <Discount> with a percentage of 0 .

<Floor> logic still applies to <FreeNights> discounts, even if the free night has a 100% discount applied to it.

If stacking is configured, then multiple promotions with <Floor> could apply to a single stay. Each promotion would apply its discount, immediately followed by its floor. The following example demonstrates how each floor contributes to the next promotion calculation in the stack.

مثال:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a floor amount_per_night of 90
2. Promotion with stacking type second , fixed_amount of 25, and a floor amount_per_night of 60

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the floor raises it up to 90 .
2. The second promotion discounts the AmountBeforeTax from 90 to 65. This is above the floor of 60 so the second floor is not applied. The final rate is 65 .

The fact that 90 is a stricter overall floor is irrelevant since it is valid only for its own promotion, and there can be no single floor that spans the entire promotion stack.

The minimum amount that a nightly rate can be set to after the discount is applied.

If a <Ceiling> element is also specified, this must be set to a value less than or equal to the amount_per_night attribute in <Ceiling> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

A date range specifying when check-in must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

A date range specifying when check-out must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies the discount to be applied for this promotion.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

مثال ها:

• If AmountAfterTax is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage of base discount. Similar to percentage , it is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Unlike percentage , this discount is always calculated as a percentage of base rates regardless of prior promotions that have been applied in sequence.

مثال:

• Suppose we have two promotions that are applied in sequence to a one night stay that is priced at 100. The first is a regular 10% percentage discount and the second is a 10% percentage of base discount. Then the discounted rate will be 80 since both promotions take 10 off. Note if the second promotion were also a regular percentage discount, then the discounted rate will be 81 since the second promotion discounts 10% of 90.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed amount to be subtracted from the sum of the AmountAfterTax nightly rates (or sum of AmountBeforeTax nightly rates if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

مثال ها:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

• If we're pricing a 1-night stay where AmountBeforeTax is 50, fixed_amount is 60, and TaxFeeInfo specifies a tax of 10, then

  promotion rate = ( AmountBeforeTax - fixed discount) * tax

  10.00 = 0 + 10

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 150, then

  promotion rate = sum( AmountAfterTax ) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed discount applied to each of the AmountAfterTax nightly rates (or the cheapest N if applied_nights is specified). If AmountAfterTax isn't specified, it is applied to AmountBeforeTax . It is assumed to be in the same currency as nightly rates. If fixed_amount_per_night is larger than a nightly rate, that nightly rate is reduced to as zero—the discount cannot cause a nightly rate to become negative.

مثال ها:

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and the fixed_amount_per_night is 10, then

  promotion rate = sum( AmountBeforeTax - fixed amount discount)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• If we're pricing a 3-night stay where the AmountAfterTax values are 10, 50, and 100; and the fixed_amount_per_night is 20, then

  promotion rate = sum( AmountAfterTax - fixed amount discount)

  110.00 = (0 + (50 - 20) + (100 - 20))

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

مثال ها:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 300, then

  promotion rate = 300

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for each night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for each night of stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

If applied_nights is specified, then the new price is applied to the cheapest N nights.

مثال ها:

• If we're pricing a 2-night stay where AmountBeforeTax values are 90, 90; AmountAfterTax values are 100, 100; and fixed_price is 80, then the promotion rate is 80 + 80 = 160.
• If we're pricing a 2-night stay where AmountBeforeTax is 100, 100; fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then the promotion rate is (80 + 80) * 1.08 = 172.8.
• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 110, then the promotion rate is 110 * 3 = 330.

This should only be used with percentage or fixed_amount_per_night .

The number of nights to which the discount is applied, starting with the least expensive. Must be an integer from 1 to 99. If not specified, discount is applied to all nights.

Number of required nights for the discount to be applied. Each discount is applied to a separate segment of stay nights.

For example, for a 10-night stay where stay_nights is 4 (and repeats is true), then there are two stay night segments: the 1st through 4th nights and the 5th through 8th nights; the 9th and 10th nights are not part of a stay night segment.

Whether the discount may be applied to multiple stay night segments. If false , then only the segment of stay nights at the beginning of the itinerary is discounted. If true , then any segment of stay nights is discounted.

For example, if stay_nights is 4 and the itinerary is 10 nights, then, if repeats is true , then 2 segments are discounted (nights 1-4 and nights 5-8); but, if repeats is false , then only 1 segment is discounted (nights 1-4).

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies a daily discount which may be applied to a night of stay. This is in contrast with Discount , which applies discounts to entire stays.

Each property may have a single group of promotions that are considered "best daily." This means that for each night of stay, the single "best daily" promotion that is eligible and yields the deepest discount for that night is selected and may be applied.

Stacking may be specified with BestDailyDiscount . It must be set to either base or none . The "best daily" discounts yielding the deepest discount for each night are combined and treated as a single stay discount (ie Discount ) while respecting the configured stacking type. This combined discount is compared against, and can be stacked with, other eligible <Discount> promotions to find the one or combination that provides the deepest discount. Either the combination of BestDailyDiscount or a single Discount , whichever yields the lower price, is selected and applied for the base stacking type.

StayDates can be specified with this type of discount, but the application must be set to overlap

Exactly one of percentage , fixed_amount , or fixed_price is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

مثال ها:

• If AmountAfterTax for a night of stay is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax for an ight of stay is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , fixed_amount , or fixed_price is required.

A fixed amount to be subtracted from a single AmountAfterTax nightly rate (or AmountBeforeTax nightly rate if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

مثال ها:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If AmountBeforeTax for a single night is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

Exactly one of percentage , fixed_amount , or fixed_price is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

مثال ها:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If AmountBeforeTax for a single night is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

Container for a membership rate rule that triggers a specific UI treatment for the associated discount.

This element should not be specified unless <Discount> is also specified.

ID of the rate rule associated with a membership program.

Multiple promotions can be applied to a single rate depending on this setting:

• any : Can be combined with any other promotion (except none ), but the order in which the promotions should be applied is not guaranteed.
• base : The best eligible base promotion is selected and applied first, before other promotions. This was previously named base_only .
• second : The best eligible second promotion is selected and applied after a base promotion (if applicable) and before any promotions.
• none : Can not be combined with other promotions.

Of the allowed combinations, the set of promotions which yields the largest discount are applied to the rate.

Describes how the promotion should be applied.

مقادیر معتبر عبارتند از:

• all : Applies the promotion to each night in the itinerary if all dates in the itinerary overlap with the stay dates.
• any : Applies the promotion to all nights in the itinerary if any date in the itinerary overlaps with a date in the stay dates range.
• overlap : Applies the promotion only to those nights in the itinerary that overlap with a date in the stay dates range.

This attribute must always be specified.

• If <Discount> specifies percentage and application is set to all or any , the discount is applied as a percentage of the full stay.
• If <Discount> specifies percentage and application is set to overlap , the discount is applied as a percentage of nightly rates for overlapping nights.
• <Discount> specifying fixed_amount and application set to overlap is an invalid combination.
• <FreeNights> supports all application values. Note that for overlap , only overlapping nights of stay are considered for the discount requirements.

یک محدوده تاریخی که تاریخ هایی را که قرار است تبلیغات اعمال شود را مشخص می کند.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

If you want to set StayDates range to allow the promotion on specific days of the week, you should set the start date as the current date with no end so that the promotion doesn't expire.

You should specify start value if the end value isn't provided.

You should specify end value if the start value isn't provided.

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

Valid values are include and exclude .

If the UserCountries type is set as include , the promotion applies to users from the listed countries.

If the UserCountries type is exclude , the promotion applies to users from outside the listed countries.

If the UserCountries type is unset, it is treated as include and the promotion is applied to users from the listed countries.

یا <Success> یا <Issues> در هر پیام وجود دارد.

یا <Success> یا <Issues> در هر پیام وجود دارد.

نوع مشکل مواجه شده

مقادیر معتبر warning ، error و failure هستند.

If you have a backend that provides feeds for multiple accounts, this value needs to match the ID attribute value specified in the <RequestorID> element of your <OTA_HotelRateAmountNotifRQ> and <OTA_HotelAvailNotifRQ> messages for the same account.

Promotions for a property. Each promotion applies to a single property.

Unless <Stacking> is used, the promotion with the biggest discount is applied to the booking when multiple promotions are eligible.

If specified, the value must be "overlay" . When the value is "overlay" , all stored promotions are deleted prior to storing the promotions specified in the current message.

If not specified, then each promotion specified in the current message is either:

• Added (if none of the stored promotions has the same id )
• Updated (if a stored promotion has the same id )
• Deleted (if a stored promotion has the same id and the value of the action attribute for the promotion specified in the current message is "delete" )

A single promotion for a property. Note that if action="overlay" and a <Promotion> is not specified, all promotions for the property are deleted.

If you need to use more than 99 promotions, contact your Technical Account Manager (TAM).

If specified, the value must be delete . If not specified and a promotion with the same id isn't stored, then this promotion is stored. Otherwise, if not specified and a promotion with the same id is stored, then the existing promotion is updated.

If delete is specified, the stored promotion with the same id is deleted. When using delete , don't include any child elements in <Promotion> . Also, delete is not allowed in conjunction with <HotelPromotions action="overlay"/> .

The starting date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by start must be earlier than (or the same as) the date or datetime specified by end .
• If start isn't specified, the range is effectively unlimited in terms of a start time.
• If start is populated as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT00:00:00".

The ending date or datetime (based on the property's time zone), inclusive, of the range.

• The date or datetime specified by end must be later than (or the same as) the date or datetime specified by start .
• If end isn't specified, the range is effectively unlimited in terms of an end time.
• If end is provided as date "YYYY-MM-DD", it is interpreted as datetime "YYYY-MM-DDT23:59:59".

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at least 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at least 30 days before the check-in date. A value of P30DT6H requires booking on or before 18:00 on the 30th day before arrival.

Valid value types are:

• Integer: The number of days before the check-in date. For example, a value of 30 indicates the promotion only applies to bookings at most 30 days before the check-in date.
• ISO 8601 Duration (days, hours, and minutes): The number of days (and optionally hours/minutes) before the check-in date. For example, a value of P30D indicates the promotion only applies to bookings at most 30 days before the check-in date. A value of P30DT6H requires booking on or after 18:00 on the 30th day before arrival.

Defines restrictions on the maximum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Ceiling> , one option is to set a <Discount> with a percentage of 0 .

If stacking is configured, then multiple promotions with <Ceiling> could apply to a single stay. Each promotion would apply its discount, immediately followed by its ceiling. The following example demonstrates how each ceiling contributes to the next promotion calculation in the stack.

مثال:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a ceiling amount_per_night of 60
2. Promotion with stacking type second , fixed_amount of 25, and a ceiling amount_per_night of 90

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the ceiling lowers it to 60 .
2. The second promotion discounts the AmountBeforeTax from 60 to 35. This is below the ceiling of 90 so the second ceiling is not applied. The final rate is 35 .

The fact that 60 is a stricter overall ceiling is irrelevant since it is valid only for its own promotion, and there can be no single ceiling that spans the entire promotion stack.

The maximum amount that a nightly rate can be set to after the discount is applied.

If a <Floor> element is also specified, this must be set to a value greater than or equal to the amount_per_night attribute in <Floor> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

Defines restrictions on the minimum value that a rate can be set to after promotions are applied.

Promotions must always specify a <Discount> or a <BestDailyDiscount> , so to create a promotion that only applies a <Floor> , one option is to set a <Discount> with a percentage of 0 .

<Floor> logic still applies to <FreeNights> discounts, even if the free night has a 100% discount applied to it.

If stacking is configured, then multiple promotions with <Floor> could apply to a single stay. Each promotion would apply its discount, immediately followed by its floor. The following example demonstrates how each floor contributes to the next promotion calculation in the stack.

مثال:

Pricing a 1-night stay where AmountBeforeTax is 100 and there is a stack of two promotions:

1. Promotion with stacking type base , a fixed_amount of 25, and a floor amount_per_night of 90
2. Promotion with stacking type second , fixed_amount of 25, and a floor amount_per_night of 60

Here is the order of calculation:

1. The base promotion is applied first and discounts the AmountBeforeTax to 75, but then the floor raises it up to 90 .
2. The second promotion discounts the AmountBeforeTax from 90 to 65. This is above the floor of 60 so the second floor is not applied. The final rate is 65 .

The fact that 90 is a stricter overall floor is irrelevant since it is valid only for its own promotion, and there can be no single floor that spans the entire promotion stack.

The minimum amount that a nightly rate can be set to after the discount is applied.

If a <Ceiling> element is also specified, this must be set to a value less than or equal to the amount_per_night attribute in <Ceiling> .

amount_per_night is applied to taxes and fees when they are included in the nightly rate using AmountAfterTax , but not those specified using TaxFeeInfo.

A date range specifying when check-in must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

A date range specifying when check-out must occur for the promotion to be applied. This element is not required if you're deleting one or more promotions.

The YearlessDate format is also supported.

• If one of start or end is a yearless date, both must be populated as yearless dates.
• Yearless date ranges must not wrap around the new year. Instead, represent the range as two adjacent date ranges. For example, {"12-29", "01-05"} can be represented as {"12-29", "12-31"} and {"01-01", "01-05"} .

روزهایی از هفته که در محدوده تاریخ مجاز هستند. اگر مشخص نشده باشد، همه روزها در محدوده تاریخ مجاز هستند. هر کاراکتر در رشته یک روز را مشخص می کند. به عنوان مثال، "MTWHF" مشخص می کند که روزهای هفته در محدوده تاریخ مجاز هستند.

شخصیت های معتبر عبارتند از:

• M برای دوشنبه
• T برای سه شنبه
• W برای چهارشنبه
• H برای پنجشنبه
• F برای جمعه
• S برای شنبه
• U برای یکشنبه

هر ترکیب کاراکتری معتبر است.

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies the discount to be applied for this promotion.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

مثال ها:

• If AmountAfterTax is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A decimal value from 0-100 which specifies the percentage of base discount. Similar to percentage , it is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

Unlike percentage , this discount is always calculated as a percentage of base rates regardless of prior promotions that have been applied in sequence.

مثال:

• Suppose we have two promotions that are applied in sequence to a one night stay that is priced at 100. The first is a regular 10% percentage discount and the second is a 10% percentage of base discount. Then the discounted rate will be 80 since both promotions take 10 off. Note if the second promotion were also a regular percentage discount, then the discounted rate will be 81 since the second promotion discounts 10% of 90.

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed amount to be subtracted from the sum of the AmountAfterTax nightly rates (or sum of AmountBeforeTax nightly rates if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

مثال ها:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

• If we're pricing a 1-night stay where AmountBeforeTax is 50, fixed_amount is 60, and TaxFeeInfo specifies a tax of 10, then

  promotion rate = ( AmountBeforeTax - fixed discount) * tax

  10.00 = 0 + 10

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 150, then

  promotion rate = sum( AmountAfterTax ) - (fixed discount)

  180.00 = (100 + 110 + 120) - 150

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

A fixed discount applied to each of the AmountAfterTax nightly rates (or the cheapest N if applied_nights is specified). If AmountAfterTax isn't specified, it is applied to AmountBeforeTax . It is assumed to be in the same currency as nightly rates. If fixed_amount_per_night is larger than a nightly rate, that nightly rate is reduced to as zero—the discount cannot cause a nightly rate to become negative.

مثال ها:

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and the fixed_amount_per_night is 10, then

  promotion rate = sum( AmountBeforeTax - fixed amount discount)

  300.00 = ((100 - 10) + (110 - 10) + (120 - 10))

• If we're pricing a 3-night stay where the AmountAfterTax values are 10, 50, and 100; and the fixed_amount_per_night is 20, then

  promotion rate = sum( AmountAfterTax - fixed amount discount)

  110.00 = (0 + (50 - 20) + (100 - 20))

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

مثال ها:

• If we're pricing a 1-night stay where AmountBeforeTax is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If we're pricing a 1-night stay where AmountBeforeTax is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08

• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 300, then

  promotion rate = 300

Exactly one of percentage , percentage_of_base , fixed_amount , fixed_amount_per_night , fixed_price , or fixed_price_per_night is required.

If AmountAfterTax nightly rates are specified, then this sets the price for each night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for each night of stay to the specified value. It is assumed to be in the same currency as nightly rates.

If AmountAfterTax is intended to reflect a percentage tax, then setting a fixed price for AmountBeforeTax can result in inaccurate taxes and fees. In general, it is strongly recommended to use TaxFeeInfo to specify a property's taxes and fees.

If applied_nights is specified, then the new price is applied to the cheapest N nights.

مثال ها:

• If we're pricing a 2-night stay where AmountBeforeTax values are 90, 90; AmountAfterTax values are 100, 100; and fixed_price is 80, then the promotion rate is 80 + 80 = 160.
• If we're pricing a 2-night stay where AmountBeforeTax is 100, 100; fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then the promotion rate is (80 + 80) * 1.08 = 172.8.
• If we're pricing a 3-night stay where the AmountAfterTax values are 100, 110, and 120; and fixed_amount is 110, then the promotion rate is 110 * 3 = 330.

This should only be used with percentage or fixed_amount_per_night .

The number of nights to which the discount is applied, starting with the least expensive. Must be an integer from 1 to 99. If not specified, discount is applied to all nights.

Number of required nights for the discount to be applied. Each discount is applied to a separate segment of stay nights.

For example, for a 10-night stay where stay_nights is 4 (and repeats is true), then there are two stay night segments: the 1st through 4th nights and the 5th through 8th nights; the 9th and 10th nights are not part of a stay night segment.

Whether the discount may be applied to multiple stay night segments. If false , then only the segment of stay nights at the beginning of the itinerary is discounted. If true , then any segment of stay nights is discounted.

For example, if stay_nights is 4 and the itinerary is 10 nights, then, if repeats is true , then 2 segments are discounted (nights 1-4 and nights 5-8); but, if repeats is false , then only 1 segment is discounted (nights 1-4).

Exactly one of Discount or BestDailyDiscount must be specified.

Specifies a daily discount which may be applied to a night of stay. This is in contrast with Discount , which applies discounts to entire stays.

Each property may have a single group of promotions that are considered "best daily." This means that for each night of stay, the single "best daily" promotion that is eligible and yields the deepest discount for that night is selected and may be applied.

Stacking may be specified with BestDailyDiscount . It must be set to either base or none . The "best daily" discounts yielding the deepest discount for each night are combined and treated as a single stay discount (ie Discount ) while respecting the configured stacking type. This combined discount is compared against, and can be stacked with, other eligible <Discount> promotions to find the one or combination that provides the deepest discount. Either the combination of BestDailyDiscount or a single Discount , whichever yields the lower price, is selected and applied for the base stacking type.

StayDates can be specified with this type of discount, but the application must be set to overlap

Exactly one of percentage , fixed_amount , or fixed_price is required.

A decimal value from 0-100 which specifies the percentage discount. It is applied to AmountAfterTax (or AmountBeforeTax if AmountAfterTax isn't specified).

مثال ها:

• If AmountAfterTax for a night of stay is 100 and percentage is 20, then

  promotion rate = AmountAfterTax * (1 - percentage discount)

  80.00 = 100 * (1 - 0.2)

• If AmountBeforeTax for an ight of stay is 100, percentage is 20 and TaxFeeInfo specifies a tax of 10, then

  promotion rate = AmountBeforeTax * (1 - percentage discount) + tax

  90.00 = 100 * (1 - 0.2) + 10

Exactly one of percentage , fixed_amount , or fixed_price is required.

A fixed amount to be subtracted from a single AmountAfterTax nightly rate (or AmountBeforeTax nightly rate if AmountAfterTax isn't specified). It is assumed to be in the same currency as nightly rates. If this is larger than the sum of nightly rates, the resulting value is zero.

مثال ها:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_amount is 20, then

  promotion rate = AmountAfterTax - fixed discount

  80.00 = 100 - 20

• If AmountBeforeTax for a single night is 100, fixed_amount is 20, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = ( AmountBeforeTax - fixed discount) * (1 + percentage tax)

  86.40 = (100 - 20) * 1.08

Exactly one of percentage , fixed_amount , or fixed_price is required.

If AmountAfterTax nightly rates are specified, then this sets the price for the night of stay, including taxes and fees, to the specified value. If AmountBeforeTax is specified, then whether or not AmountAfterTax is specified, this sets the pre-tax price for the stay to the specified value. It is assumed to be in the same currency as nightly rates.

مثال ها:

• If AmountBeforeTax for a single night is 90, AmountAfterTax is 100, and fixed_price is 80, then the promotion rate is 80.
• If AmountBeforeTax for a single night is 100, fixed_amount is 80, and TaxFeeInfo specifies a tax of 8%, then

  promotion rate = fixed price * (1 + percentage tax)

  86.40 = 80 * 1.08