تبلیغات

نمای کلی

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

درخواست‌ها

نحو

پیام Promotions از ساختار نحوی زیر استفاده می‌کند:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner= "partner_key"
            id="message_ID"
            timestamp="timestamp">
  <HotelPromotions hotel_id="HotelID" action="[overlay]">
    <Promotion id="PromotionID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
        <DateRange start="YYYY-MM-DD[THH:mm:ss]" end="YYYY-MM-DD[THH:mm:ss]"
          days_of_week="MTWHFSU_or_subset"/>
      </BookingDates>
      <BookingWindow min="integer_or_duration" max="integer_or_duration"/>
      <Ceiling amount_per_night="float"/>
      <Floor amount_per_night="float"/>
      <CheckinDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </CheckoutDates>
      <!-- Specify only one of percentage, percentage_of_base, fixed_amount,
           fixed_amount_per_night, fixed_price, or fixed_price_per_night;
           applied_nights is only used with percentage, fixed_amount_per_night,
           and fixed_price_per_night. -->
      <Discount percentage="float" percentage_of_base="float"
                fixed_amount="float" fixed_amount_per_night="float"
                fixed_price="float" fixed_price_per_night="float"
                applied_nights="integer_1_to_99" rank="integer_1_to_99">
        <!-- FreeNights may not be used in conjunction with attributes on Discount -->
        <FreeNights stay_nights="integer" discount_nights="integer"
                    discount_percentage="float" night_selection="[cheapest|last]"
                    repeats="boolean"/>
      </Discount>
      <!-- Exactly one of Discount or BestDailyDiscount must be specified.
           Specify only one of percentage, fixed_amount, or fixed_price. -->
      <BestDailyDiscount percentage="float" fixed_amount="float" fixed_price="float"/>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <InventoryCount min="integer" max="integer"/>
      <LengthOfStay min="integer" max="integer"/>
      <MembershipRateRule id="RateRuleID"/>
      <MinimumAmount before_discount="integer"/>
      <Occupancy min="integer" max="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <Stacking type="[any|base|none|second]"/>
      <StayDates application="[all|any|overlap]">
        <DateRange start="[YYYY-]MM-DD" end="[YYYY-]MM-DD" days_of_week="MTWHFSU_or_subset"/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

عناصر و ویژگی‌ها

پیام تبلیغاتی دارای عناصر و ویژگی‌های زیر است:

عنصر / @Attribute رخدادها نوع توضیحات
Promotions 1 Complex element عنصر ریشه‌ای یک پیام تبلیغاتی.
Promotions / @partner 1 string حساب کاربری همکار برای این پیام. این مقدار رشته‌ای، مقدار «کلید همکار» است که در صفحه تنظیمات حساب کاربری در مرکز هتل فهرست شده است.

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

Promotions / @id 1 string یک شناسه منحصر به فرد برای این پیام درخواست. این مقدار در پیام پاسخ برگردانده می‌شود. کاراکترهای مجاز عبارتند از az، AZ، ​​0-9، _ (زیرخط) و - (خط تیره).
Promotions / @timestamp 1 DateTime تاریخ و زمان ایجاد این پیام.
Promotions / HotelPromotions 0..n HotelPromotions

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

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

Promotions / HotelPromotions / @hotel_id 1 string شناسه منحصر به فرد برای ملک. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید فهرست هتل مطابقت داشته باشد. شناسه هتل همچنین در مرکز هتل فهرست شده است.
Promotions / HotelPromotions / @action 0..1 enum

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

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

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

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

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

Promotions / HotelPromotions / Promotion / @id 1 string یک شناسه منحصر به فرد برای تبلیغ. حداکثر تعداد کاراکترهای مجاز ۴۰ است. کاراکترهای مجاز عبارتند از az، AZ، ​​۰-۹، _ (زیرخط)، - (خط تیره) و . (نقطه).
Promotions /HotelPromotions / Promotion / @action 0..1 enum

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

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

Promotions / HotelPromotions / Promotion / BookingDates 0..1 BookingDates برای اعمال این پیشنهاد، باید یک ظرف برای یک یا چند محدوده که زمان رزرو را مشخص می‌کنند، ایجاد شود.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange 1..99 DateRange برای اعمال این پیشنهاد، باید بازه زمانی مشخصی برای رزرو تعیین شود.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @start 0..1 Date یا DateTime

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

  • تاریخ یا تاریخ-زمان مشخص شده توسط start باید قبل از (یا برابر با) تاریخ یا تاریخ-زمان مشخص شده توسط end باشد.
  • اگر start مشخص نشده باشد، محدوده از نظر زمان شروع عملاً نامحدود است.
  • اگر تاریخ start به صورت "YYYY-MM-DD" تنظیم شود، به صورت تاریخ زمان "YYYY-MM-DDT00:00:00" تفسیر می‌شود.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @end 0..1 Date یا DateTime

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

  • تاریخ یا تاریخ-زمان مشخص شده توسط end باید بعد از (یا برابر با) تاریخ یا تاریخ-زمان مشخص شده توسط start باشد.
  • اگر end مشخص نشده باشد، محدوده عملاً از نظر زمان پایان نامحدود است.
  • اگر end به صورت تاریخ "YYYY-MM-DD" ارائه شود، به صورت تاریخ و زمان "YYYY-MM-DDT23:59:59" تفسیر می‌شود.
Promotions / HotelPromotions / Promotion / BookingDates / DateRange / @days_of_week 0..1 string

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

کاراکترهای معتبر عبارتند از:

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

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

Promotions / HotelPromotions / Promotion / BookingWindow 0..1 BookingWindow مدت زمانی را که رزرو باید نسبت به تاریخ ورود (بر اساس منطقه زمانی ملک) انجام شود، مشخص می‌کند. برای مثال، می‌توان بازه زمانی رزرو را حداقل ۷ روز و حداکثر ۱۸۰ روز قبل از ورود تنظیم کرد.
Promotions / HotelPromotions / Promotion / BookingWindow / @min 0..1 integer or duration برای اعمال این پیشنهاد، حداقل مدت زمان قبل از ورود به سیستم هنگام رزرو باید مشخص شود. اگر این مقدار مشخص نشده باشد یا مقدار آن 0 باشد، حداقل زمانی وجود ندارد.

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

  • عدد صحیح: تعداد روزهای قبل از تاریخ ورود. برای مثال، مقدار 30 نشان می‌دهد که این پیشنهاد ویژه فقط برای رزروهایی اعمال می‌شود که حداقل ۳۰ روز قبل از تاریخ ورود باشند.
  • مدت زمان (روز، ساعت و دقیقه) مطابق استاندارد ISO 8601: تعداد روزها (و به صورت اختیاری ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار P30D نشان می‌دهد که این پیشنهاد ویژه فقط برای رزروهایی اعمال می‌شود که حداقل 30 روز قبل از تاریخ ورود انجام شده باشند. مقدار P30DT6H مستلزم رزرو در ساعت 18:00 یا قبل از آن در سی‌امین روز قبل از ورود است.
Promotions / HotelPromotions / Promotion / BookingWindow / @max 0..1 integer or duration حداکثر تعداد روزهای قبل از ورود هنگام رزرو باید انجام شود تا این پیشنهاد اعمال شود. اگر این مقدار مشخص نشده باشد یا مقدار آن 0 باشد، حداکثری وجود ندارد.

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

  • عدد صحیح: تعداد روزهای قبل از تاریخ ورود. برای مثال، مقدار 30 نشان می‌دهد که این پیشنهاد ویژه فقط برای رزروهایی اعمال می‌شود که حداکثر ۳۰ روز قبل از تاریخ ورود باشند.
  • مدت زمان (روز، ساعت و دقیقه) مطابق استاندارد ISO 8601: تعداد روزها (و به صورت اختیاری ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار P30D نشان می‌دهد که این پیشنهاد ویژه فقط برای رزروهایی اعمال می‌شود که حداکثر 30 روز قبل از تاریخ ورود انجام شده باشند. مقدار P30DT6H مستلزم رزرو در ساعت 18:00 یا بعد از آن در سی‌امین روز قبل از ورود است.
Promotions / HotelPromotions / Promotion / Ceiling 0..1 Ceiling

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

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

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

مثال:

قیمت‌گذاری برای اقامت یک شبه که در آن AmountBeforeTax ۱۰۰ است و دو پیشنهاد ویژه وجود دارد:

  1. تبلیغات با base از نوع چیدمان روی هم، fixed_amount ۲۵ و سقف amount_per_night ۶۰
  2. تبلیغات با نوع انباشتگی second ، fixed_amount ۲۵ و سقف amount_per_night ۹۰

ترتیب محاسبه به این صورت است:

  1. ابتدا طرح تشویقی base اعمال می‌شود و AmountBeforeTax را به ۷۵ تخفیف می‌دهد، اما سپس سقف آن را به ۶۰ کاهش می‌دهد.
  2. طرح تشویقی second ، AmountBeforeTax را از ۶۰ به ۳۵ تخفیف می‌دهد. این مبلغ کمتر از سقف ۹۰ است، بنابراین سقف دوم اعمال نمی‌شود. نرخ نهایی ۳۵ است.

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

Promotions / HotelPromotions / Promotion / Ceiling / @amount_per_night 1 float

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

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

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

Promotions / HotelPromotions / Promotion / Floor 0..1 Floor

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

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

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

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

مثال:

قیمت‌گذاری برای اقامت یک شبه که در آن AmountBeforeTax ۱۰۰ است و دو پیشنهاد ویژه وجود دارد:

  1. تبلیغ با base از نوع چیدمان روی هم، fixed_amount ۲۵ و amount_per_night کف به ازای هر شب ۹۰
  2. تبلیغات با نوع انباشتگی second ، fixed_amount ۲۵ و amount_per_night حداقل برای هر شب ۶۰

ترتیب محاسبه به این صورت است:

  1. ابتدا طرح تشویقی base اعمال می‌شود و مبلغ AmountBeforeTax را به ۷۵ تخفیف می‌دهد، اما سپس حداقل آن را به ۹۰ افزایش می‌دهد.
  2. طرح تشویقی second ، AmountBeforeTax از ۹۰ به ۶۵ تخفیف می‌دهد. این مبلغ بالاتر از حداقل ۶۰ است، بنابراین حداقل دوم اعمال نمی‌شود. نرخ نهایی ۶۵ است.

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

Promotions / HotelPromotions / Promotion / Floor / @amount_per_night 1 float

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

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

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

Promotions / HotelPromotions / Promotion / CheckinDates 0..1 CheckinDates ظرفی برای یک یا چند محدوده تاریخ که مشخص می‌کند چه زمانی باید ورود انجام شود تا تخفیف اعمال شود.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange 1..20 DateRange

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

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

  • اگر یکی از start یا end یک تاریخ بدون سال باشد، هر دو باید به عنوان تاریخ بدون سال پر شوند.
  • محدوده‌های تاریخ بدون سال نباید دور سال جدید بپیچند. در عوض، محدوده را به صورت دو محدوده تاریخ مجاور نشان دهید. برای مثال، {"12-29", "01-05"} را می‌توان به صورت {"12-29", "12-31"} و {"01-01", "01-05"} نمایش داد.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @start 0..1 Date or YearlessDate تاریخ شروع (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید قبل یا همزمان با تاریخ end باشد. اگر start مشخص نشده باشد، محدوده تاریخ عملاً از نظر تاریخ شروع نامحدود است.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @end 0..1 Date or YearlessDate تاریخ پایان (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید برابر یا بعد از تاریخ start باشد. اگر end مشخص نشده باشد، محدوده تاریخ عملاً از نظر تاریخ پایان نامحدود است.
Promotions / HotelPromotions / Promotion / CheckinDates / DateRange / @days_of_week 0..1 string

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

کاراکترهای معتبر عبارتند از:

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

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

Promotions / HotelPromotions / Promotion / CheckoutDates 0..1 CheckoutDates یک ظرف برای یک یا چند محدوده تاریخ که مشخص می‌کند چه زمانی باید تسویه حساب انجام شود تا این پیشنهاد ویژه اعمال شود.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange 1..20 DateRange

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

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

  • اگر یکی از start یا end یک تاریخ بدون سال باشد، هر دو باید به عنوان تاریخ بدون سال پر شوند.
  • محدوده‌های تاریخ بدون سال نباید دور سال جدید بپیچند. در عوض، محدوده را به صورت دو محدوده تاریخ مجاور نشان دهید. برای مثال، {"12-29", "01-05"} را می‌توان به صورت {"12-29", "12-31"} و {"01-01", "01-05"} نمایش داد.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @start 0..1 Date or YearlessDate تاریخ شروع (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید قبل یا همزمان با تاریخ end باشد. اگر start مشخص نشده باشد، محدوده تاریخ عملاً از نظر تاریخ شروع نامحدود است.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @end 0..1 Date or YearlessDate تاریخ پایان (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید برابر یا بعد از تاریخ start باشد. اگر end مشخص نشده باشد، محدوده تاریخ عملاً از نظر تاریخ پایان نامحدود است.
Promotions / HotelPromotions / Promotion / CheckoutDates / DateRange / @days_of_week 0..1 string

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

کاراکترهای معتبر عبارتند از:

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

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

Promotions / HotelPromotions / Promotion / Devices 0..1 Devices محفظه‌ای برای فهرست کردن دستگاه‌های کاربرانی که واجد شرایط این طرح تشویقی هستند. در صورت مشخص شدن، فقط به کاربران واجد شرایط روی دستگاه‌های فهرست‌شده، نرخ تخفیف ارائه می‌شود. در صورت مشخص نشدن، به کاربران واجد شرایط روی هر دستگاهی، نرخ تخفیف ارائه می‌شود.
Promotions / HotelPromotions / Promotion / Devices / Device 1..3 Device یک نوع دستگاه کاربر را که واجد شرایط دریافت این پیشنهاد ویژه است، تعریف می‌کند.
Promotions / HotelPromotions / Promotion / Devices / Device / @type 1 enum نوع دستگاه. مقدار باید desktop ، tablet یا mobile باشد.
Promotions / HotelPromotions / Promotion / Discount 1 Discount

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

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

Promotions / HotelPromotions / Promotion / Discount / @percentage 0..1 float

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

یک مقدار اعشاری از ۰ تا ۱۰۰ که درصد تخفیف را مشخص می‌کند. این مقدار روی AmountAfterTax (یا AmountBeforeTax در صورت عدم تعیین AmountAfterTax ) اعمال می‌شود.

مثال‌ها:

  • اگر AmountAfterTax ۱۰۰ و percentage ۲۰ باشد، آنگاه

    نرخ تخفیف = AmountAfterTax * (۱ - درصد تخفیف)

    80.00 = 100 * (1 - 0.2)

  • اگر AmountBeforeTax برابر با ۱۰۰، percentage برابر با ۲۰ و TaxFeeInfo برابر با ۱۰ باشد، آنگاه

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

    ۹۰.۰۰ = ۱۰۰ * (۱ - ۰.۲) + ۱۰

Promotions / HotelPromotions / Promotion / Discount / @percentage_of_base 0..1 float

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

یک مقدار اعشاری از ۰ تا ۱۰۰ که درصد تخفیف پایه را مشخص می‌کند. مشابه percentage ، روی AmountAfterTax (یا AmountBeforeTax در صورت مشخص نشدن AmountAfterTax ) اعمال می‌شود.

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

مثال:

  • فرض کنید دو پیشنهاد ویژه داریم که به ترتیب برای یک شب اقامت با قیمت ۱۰۰ دلار اعمال می‌شوند. اولی یک تخفیف ۱۰٪ درصدی معمولی و دومی ۱۰٪ درصد از تخفیف پایه است. در این صورت نرخ تخفیف ۸۰ خواهد بود زیرا هر دو پیشنهاد ۱۰ دلار تخفیف می‌دهند. توجه داشته باشید که اگر پیشنهاد ویژه دوم نیز یک تخفیف درصدی معمولی باشد، نرخ تخفیف ۸۱ خواهد بود زیرا پیشنهاد ویژه دوم ۱۰٪ از ۹۰ دلار تخفیف می‌دهد.
Promotions / HotelPromotions / Promotion / Discount / @fixed_amount 0..1 float

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

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

مثال‌ها:

  • اگر ما برای اقامت یک شب قیمت‌گذاری کنیم که در آن AmountBeforeTax برابر با ۹۰، AmountAfterTax برابر با ۱۰۰ و fixed_amount برابر با ۲۰ باشد، آنگاه

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

    ۸۰.۰۰ = ۱۰۰ - ۲۰

  • اگر ما برای اقامت یک شب قیمت‌گذاری کنیم که در آن AmountBeforeTax برابر با ۱۰۰، fixed_amount برابر با ۲۰ و TaxFeeInfo مالیات را ۸٪ تعیین می‌کند، آنگاه

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

    ۸۶.۴۰ = (۱۰۰ - ۲۰) * ۱.۰۸

  • اگر ما برای اقامت یک شب قیمت‌گذاری کنیم که در آن AmountBeforeTax برابر با ۵۰، fixed_amount برابر با ۶۰ و TaxFeeInfo برابر با ۱۰ باشد، آنگاه

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

    ۱۰.۰۰ = ۰ + ۱۰

  • اگر ما یک اقامت ۳ شبه را قیمت‌گذاری کنیم که در آن مقادیر AmountAfterTax برابر با ۱۰۰، ۱۱۰ و ۱۲۰ باشند؛ و fixed_amount برابر با ۱۵۰ باشد، آنگاه

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

    ۱۸۰.۰۰ = (۱۰۰ + ۱۱۰ + ۱۲۰) - ۱۵۰

Promotions / HotelPromotions / Promotion / Discount / @fixed_amount_per_night 0..1 float

دقیقاً یکی از 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 بزرگتر از یک نرخ شبانه باشد، آن نرخ شبانه به صفر کاهش می‌یابد - تخفیف نمی‌تواند باعث منفی شدن نرخ شبانه شود.

مثال‌ها:

  • اگر ما برای اقامت ۳ شب قیمت‌گذاری کنیم که در آن مقادیر AmountAfterTax برابر با ۱۰۰، ۱۱۰ و ۱۲۰ باشد؛ و fixed_amount_per_night برابر با ۱۰ باشد، آنگاه

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

    ۳۰۰.۰۰ = ((۱۰۰ - ۱۰) + (۱۱۰ - ۱۰) + (۱۲۰ - ۱۰))

  • اگر ما برای اقامت ۳ شب قیمت‌گذاری کنیم که در آن مقادیر AmountAfterTax برابر با ۱۰، ۵۰ و ۱۰۰ باشد؛ و fixed_amount_per_night برابر با ۲۰ باشد، آنگاه

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

    ۱۱۰.۰۰ = (۰ + (۵۰ - ۲۰) + (۱۰۰ - ۲۰))

Promotions / HotelPromotions / Promotion / Discount / @fixed_price 0..1 float

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

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

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

مثال‌ها:

  • اگر قیمت اقامت یک شب را طوری تعیین کنیم که AmountBeforeTax ۹۰، AmountAfterTax ۱۰۰ و fixed_price ۸۰ باشد، نرخ تخفیف ۸۰ می‌شود.
  • اگر ما برای اقامت یک شب قیمت‌گذاری کنیم که در آن AmountBeforeTax برابر با ۱۰۰، fixed_amount برابر با ۸۰ و TaxFeeInfo مالیات را ۸٪ تعیین می‌کند، آنگاه

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

    ۸۶.۴۰ = ۸۰ * ۱.۰۸

  • اگر ما برای اقامت ۳ شب قیمت‌گذاری می‌کنیم که در آن مقادیر AmountAfterTax برابر با ۱۰۰، ۱۱۰ و ۱۲۰ و fixed_amount برابر با ۳۰۰ است، آنگاه

    نرخ ارتقاء = ۳۰۰

Promotions / HotelPromotions / Promotion / Discount / @fixed_price_per_night 0..1 float

دقیقاً یکی از 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 شب اعمال می‌شود.

مثال‌ها:

  • اگر ما برای اقامت دو شب قیمت‌گذاری کنیم که در آن مقادیر AmountBeforeTax برابر با ۹۰، ۹۰؛ مقادیر AmountAfterTax برابر با ۱۰۰، ۱۰۰؛ و fixed_price برابر با ۸۰ باشد، آنگاه نرخ تخفیف ۸۰ + ۸۰ = ۱۶۰ خواهد بود.
  • اگر ما برای اقامت دو شب قیمت‌گذاری کنیم که در آن AmountBeforeTax برابر با ۱۰۰، ۱۰۰؛ fixed_amount برابر با ۸۰ و TaxFeeInfo مالیات ۸٪ را مشخص می‌کند، آنگاه نرخ تخفیف (۸۰ + ۸۰) * ۱.۰۸ = ۱۷۲.۸ خواهد بود.
  • اگر ما برای اقامت ۳ شب قیمت‌گذاری کنیم که در آن مقادیر AmountAfterTax برابر با ۱۰۰، ۱۱۰ و ۱۲۰ و fixed_amount برابر با ۱۱۰ باشد، آنگاه نرخ تخفیف ۱۱۰ * ۳ = ۳۳۰ خواهد بود.
Promotions / HotelPromotions / Promotion / Discount / @applied_nights 0..1 integer

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

تعداد شب‌هایی که تخفیف به آنها اعمال می‌شود، از ارزان‌ترین شروع می‌شود. باید یک عدد صحیح از ۱ تا ۹۹ باشد. در صورت عدم مشخص کردن، تخفیف برای همه شب‌ها اعمال می‌شود.

Promotions / HotelPromotions / Promotion / Discount / FreeNights 0..1 FreeNights تخفیفی را برای شب‌های خاصی از اقامت، در صورت رعایت حداقل مدت اقامت، مشخص می‌کند. در صورت استفاده از این عنصر، ویژگی‌های عنصر والد Discount مجاز نیستند.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @stay_nights 1 integer

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

برای مثال، برای یک اقامت ۱۰ شبه که در آن stay_nights برابر با ۴ است (و repeats برابر با true است)، دو بخش شب اقامت وجود دارد: شب‌های اول تا چهارم و شب‌های پنجم تا هشتم؛ شب‌های نهم و دهم بخشی از یک بخش شب اقامت نیستند.

Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_nights 1 integer تعداد شب‌های تخفیف‌دار در هر بخش از شب‌های اقامت.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @discount_percentage 1 float تخفیفی که برای شب‌های تخفیف اعمال می‌شود. اگر این مقدار 50 باشد، هر شب انتخاب شده ۵۰٪ تخفیف دارد.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @night_selection 1 string باید یا cheapest باشد یا last . اگر last ، شب‌های انتهاییِ بخشِ شب‌های اقامت شامل تخفیف می‌شوند. اگر cheapest ، ارزان‌ترین شب‌های داخلِ بخشِ شب‌های اقامت شامل تخفیف می‌شوند.
Promotions / HotelPromotions / Promotion / Discount / FreeNights / @repeats 1 boolean

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

برای مثال، اگر stay_nights ۴ و برنامه سفر ۱۰ شب باشد، اگر repeats برابر با true باشد، ۲ بخش تخفیف داده می‌شود (شب‌های ۱ تا ۴ و شب‌های ۵ تا ۸)؛ اما اگر repeats false باشد، فقط ۱ بخش تخفیف داده می‌شود (شب‌های ۱ تا ۴).

Promotions / HotelPromotions / Promotion / Discount / @rank 0..1 integer به این ارتقاء یک رتبه اختصاص می‌دهد و آن را در انتخاب رتبه‌بندی‌شده قرار می‌دهد، که در آن فقط ارتقاء با کمترین رتبه برای اعمال انتخاب می‌شود. مقادیر باید بین ۱ تا ۹۹ باشند، شامل. اگر چندین ارتقاء رتبه یکسانی داشته باشند، یکی به طور دلخواه انتخاب و اعمال می‌شود.
Promotions / HotelPromotions / Promotion / BestDailyDiscount 1 Discount

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

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

هر هتل ممکن است یک گروه واحد از پیشنهادات ویژه داشته باشد که به عنوان «بهترین پیشنهاد روزانه» در نظر گرفته می‌شوند. این بدان معناست که برای هر شب اقامت، تنها پیشنهاد ویژه «بهترین پیشنهاد روزانه» که واجد شرایط است و بیشترین تخفیف را برای آن شب ارائه می‌دهد، انتخاب و اعمال می‌شود.

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

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

.
Promotions / HotelPromotions / Promotion / BestDailyDiscount / @percentage 0..1 float

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

یک مقدار اعشاری از ۰ تا ۱۰۰ که درصد تخفیف را مشخص می‌کند. این مقدار روی AmountAfterTax (یا AmountBeforeTax در صورت عدم تعیین AmountAfterTax ) اعمال می‌شود.

مثال‌ها:

  • اگر AmountAfterTax برای یک شب اقامت ۱۰۰ و percentage ۲۰ باشد، آنگاه

    نرخ تخفیف = AmountAfterTax * (۱ - درصد تخفیف)

    80.00 = 100 * (1 - 0.2)

  • اگر AmountBeforeTax برای یک شب اقامت ۱۰۰، percentage ۲۰ و TaxFeeInfo مالیات ۱۰ را مشخص کند، آنگاه

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

    ۹۰.۰۰ = ۱۰۰ * (۱ - ۰.۲) + ۱۰

Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_amount 0..1 float

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

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

مثال‌ها:

  • اگر AmountBeforeTax برای یک شب ۹۰، AmountAfterTax برابر با ۱۰۰ و fixed_amount برابر با ۲۰ باشد، آنگاه

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

    ۸۰.۰۰ = ۱۰۰ - ۲۰

  • اگر AmountBeforeTax برای یک شب ۱۰۰، fixed_amount برابر با ۲۰ و مقدار TaxFeeInfo برابر با ۸٪ باشد، آنگاه

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

    ۸۶.۴۰ = (۱۰۰ - ۲۰) * ۱.۰۸

Promotions / HotelPromotions / Promotion/ BestDailyDiscount / @fixed_price 0..1 float

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

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

مثال‌ها:

  • اگر AmountBeforeTax برای یک شب ۹۰، AmountAfterTax ۱۰۰ و fixed_price ۸۰ باشد، نرخ تخفیف ۸۰ است.
  • اگر AmountBeforeTax برای یک شب ۱۰۰، fixed_amount برابر با ۸۰ و مقدار TaxFeeInfo برابر با ۸٪ باشد، آنگاه

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

    ۸۶.۴۰ = ۸۰ * ۱.۰۸

Promotions / HotelPromotions / Promotion / InventoryCount 0..1 InventoryCount محدودیت‌هایی را در تعداد اتاق‌هایی که باید برای اعمال این پیشنهاد موجود باشند، تعریف می‌کند. تخفیف فقط برای شب‌هایی اعمال می‌شود که این محدودیت را برآورده می‌کنند. با تخفیف fixed_amount مجاز نیست. توجه داشته باشید که تعداد اتاق‌های موجود با OTA_HotelInvCountNotifRQ ( InvCount ) یا OTA_HotelAvailNotifRQ ( BookingLimit ) مشخص می‌شود.
Promotions / HotelPromotions / Promotion / InventoryCount / @min 0..1 integer حداقل تعداد اتاق‌هایی که باید برای اعمال تخفیف در نرخ هر شب موجود باشند. اگر این مورد مشخص نشده باشد، حداقلی وجود ندارد.
Promotions / HotelPromotions / Promotion / InventoryCount / @max 0..1 integer حداکثر تعداد اتاق‌هایی که باید برای اعمال تخفیف در نرخ هر شب موجود باشند. اگر این مورد مشخص نشده باشد، حداکثری وجود ندارد.
Promotions / HotelPromotions / Promotion / LengthOfStay 0..1 LengthOfStay محدودیت‌های مدت اقامت که این پیشنهاد می‌تواند در آن اعمال شود را تعریف می‌کند. اگر مدت اقامت خارج از محدودیت‌های حداقل و حداکثر باشد، این پیشنهاد اعمال نمی‌شود.
Promotions / HotelPromotions / Promotion / LengthOfStay / @min 0..1 integer حداقل تعداد شب‌های مجاز برای اقامت جهت اعمال این تخفیف. اگر این مورد مشخص نشده باشد، حداقلی وجود ندارد.
Promotions / HotelPromotions / Promotion / LengthOfStay / @max 0..1 integer حداکثر تعداد شب‌های مجاز برای اقامت جهت اعمال این تخفیف. اگر این مورد مشخص نشده باشد، حداکثری وجود ندارد.
Promotions / HotelPromotions / Promotion / MembershipRateRule 0..1 MembershipRateRule

محفظه‌ای برای قانون نرخ عضویت که یک رابط کاربری خاص را برای تخفیف مرتبط فعال می‌کند.

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

Promotions / HotelPromotions / Promotion / MembershipRateRule / @id 1 string

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

Promotions / HotelPromotions / Promotion / MinimumAmount 0..1 MinimumAmount حداقل مجموع نرخ‌های روزانه اتاق (با استفاده از AmountBeforeTax یا AmountAfterTax که بزرگتر هستند) را مشخص می‌کند که برای اعمال تخفیف باید از آن تجاوز شود.
Promotions / HotelPromotions / Promotion / MinimumAmount / @before_discount 1 integer مقداری که برای اعمال تخفیف باید از آن فراتر رود.
Promotions / HotelPromotions / Promotion / Occupancy 0..1 Occupancy محدودیت‌هایی را برای تعداد افرادی که این طرح تشویقی برای آنها اعمال می‌شود، تعریف می‌کند. این طرح تشویقی زمانی که تعداد افراد خارج از محدودیت‌های حداقل و حداکثر باشد، اعمال نمی‌شود.

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

Promotions / HotelPromotions / Promotion / Occupancy / @min 0..1 integer برای اعمال تخفیف، ظرفیت مشخص شده توسط کاربر باید حداقل این مقدار باشد.
Promotions / HotelPromotions / Promotion / Occupancy / @max 0..1 integer برای اعمال تخفیف، ظرفیت مشخص شده توسط کاربر باید حداکثر برابر با این مقدار باشد.
Promotions / HotelPromotions / Promotion / RatePlans 0..1 RatePlans محفظه‌ای برای فهرستی از طرح‌های نرخی که این تخفیف شامل آنها می‌شود. اگر <RatePlans> مشخص نشده باشد، این تخفیف برای همه طرح‌های نرخی اعمال می‌شود.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan 1..n RatePlan یک طرح نرخ را مشخص می‌کند. یک طرح نرخ با ترکیبی از بسته، نرخ‌ها و در دسترس بودن، همانطور که در پیام‌های Transaction (Property Data)، OTA_HotelRateAmountNotifRQ و OTA_HotelAvailNotifRQ تعریف شده و توسط PackageID شناسایی می‌شود، تعریف می‌شود.
Promotions / HotelPromotions / Promotion / RatePlans / RatePlan / @id 1 string شناسه منحصر به فرد برای طرح نرخ. این مقدار به مقدار PackageID در <PackageData> در یک پیام Transaction (Property Data) و در ویژگی RatePlanCode در <StatusApplicationControl> در هر دو پیام <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> نگاشت می‌شود. حداکثر تعداد کاراکتر مجاز ۵۰ است.
Promotions / HotelPromotions / Promotion / RoomTypes 0..1 RoomTypes محفظه‌ای برای فهرستی از انواع اتاق‌هایی که این تخفیف شامل آنها می‌شود. این تخفیف برای هر <RoomType> مشخص شده اعمال می‌شود. اگر <RoomTypes> مشخص نشده باشد، تخفیف برای همه اتاق‌ها اعمال می‌شود.
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType 1..n RoomType نوع اتاق را مشخص می‌کند. نوع اتاق در عنصر <RoomData> در یک پیام تراکنش (داده‌های ویژگی) تعریف می‌شود و با استفاده از مقدار <RoomID> آن ارجاع داده می‌شود. (مقدار <RoomID> آن همچنین توسط ویژگی InvTypeCode در پیام‌های OTA_HotelRateAmountNotifRQ ارجاع داده می‌شود.)
Promotions / HotelPromotions / Promotion / RoomTypes / RoomType / @id 1 string شناسه منحصر به فرد برای موجودی (نوع اتاق). این مقدار به <RoomID> در یک پیام تراکنش (داده‌های ویژگی) نگاشت می‌شود. حداکثر تعداد کاراکترهای مجاز ۵۰ است.
Promotions / HotelPromotions / Promotion / Stacking 0..1 Stacking نحوه ترکیب تبلیغات را مشخص می‌کند. اگر مشخص نشود، "نوع" به صورت base در نظر گرفته می‌شود.
Promotions / HotelPromotions / Promotion / Stacking / @type 1 enum

بسته به این تنظیمات، می‌توان چندین پیشنهاد ویژه را روی یک نرخ واحد اعمال کرد:

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

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

Promotions / HotelPromotions / Promotion / StayDates 0..1 StayDates ظرفی برای یک یا چند محدوده تاریخی که نحوه اعمال تبلیغات را تعیین می‌کند، مانند اعمال تخفیف‌های فصلی.
Promotions / HotelPromotions / Promotion / StayDates / @application 1 enum

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

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

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

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

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

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

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

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

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

Promotions / HotelPromotions / Promotion / StayDates / DateRange / @start 0..1 Date or YearlessDate تاریخ شروع (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید قبل یا همزمان با تاریخ end باشد. اگر start مشخص نشده باشد، محدوده تاریخ عملاً از نظر تاریخ شروع نامحدود است.

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

Promotions / HotelPromotions / Promotion / StayDates / DateRange / @end 0..1 Date or YearlessDate تاریخ پایان (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. این تاریخ باید برابر یا بعد از تاریخ start باشد. اگر end مشخص نشده باشد، محدوده تاریخ عملاً از تاریخ start به بعد نامحدود است.

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

Promotions / HotelPromotions / Promotion / StayDates / DateRange / @days_of_week 0..1 string

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

کاراکترهای معتبر عبارتند از:

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

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

Promotions / HotelPromotions / Promotion / UserCountries 0..1 UserCountries محفظه‌ای برای فهرست کردن مکان‌های کاربری (کشورهایی) که واجد شرایط دریافت پیشنهاد هستند. در صورت مشخص شدن، فقط به کاربران واجد شرایط در کشورهای ذکر شده، نرخ تخفیف ارائه می‌شود. در صورت مشخص نشدن، به کاربران واجد شرایط در هر کشوری، نرخ تخفیف ارائه می‌شود.
Promotions / HotelPromotions / Promotion / UserCountries / @type 0..1 enum نوع مشخصات UserCountries.

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

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

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

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

Promotions / HotelPromotions / Promotion / UserCountries / Country 1..300 Country کشوری را تعریف می‌کند که کاربران در آن واجد شرایط دریافت این پیشنهاد هستند.
Promotions / HotelPromotions / Promotion / UserCountries / Country / @code 1 string کد کشور CLDR ، مانند DE یا FR . توجه داشته باشید که برای برخی از کشورها، کد کشور CLDR با کد کشور ISO دو حرفی یکسان نیست. همچنین، کدهای منطقه CLDR پشتیبانی نمی‌شوند.

مثال‌ها

برای هر ملک محدودیت ۵۰۰ تبلیغ وجود دارد. برای حذف تبلیغات از یک ملک، به مثال «حذف یک تبلیغ» مراجعه کنید.

پیام پایه

مثال زیر یک پیام Promotions ساده را نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01" end="2020-07-31" days_of_week="MTWHF"/>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2020-10-01" end="2020-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2020-10-08" end="2020-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <Discount percentage="20" applied_nights="2"/>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <Stacking type="base"/>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
    </Promotion>
  </HotelPromotions>
</Promotions>

وضعیت موجودی

مثال زیر نحوه ایجاد تخفیف در صورت وجود موجودی اضافی نزدیک به تاریخ ورود را نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow max="7"/>
      <Discount percentage="10"/>
      <InventoryCount min="3"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

یک تبلیغ را حذف کنید

مثال زیر نحوه حذف یک تبلیغ برای یک ملک را نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1" action="delete"/>
  </HotelPromotions>
</Promotions>

حذف همه تبلیغات

مثال زیر نحوه حذف همه تبلیغات برای یک ملک را نشان می‌دهد:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay"/>
</Promotions>


همه تبلیغات را همپوشانی کنید

مثال زیر نحوه‌ی همپوشانی <HotelPromotions> را برای یک ملک با یک یا چند تبلیغ جدید نشان می‌دهد. وقتی action="overlay" ، تمام تبلیغات ذخیره شده قبل از ذخیره تبلیغات مشخص شده در پیام فعلی حذف می‌شوند:

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1" action="overlay">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-09-01" end="2020-09-30"/>
      </BookingDates>
      <Discount percentage="10"/>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <Stacking type="base"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

۳ نوع مختلف چیدمان

مثال زیر حالتی را نشان می‌دهد که در آن سه پیشنهاد مختلف اعمال می‌شود ( base ، second ، any ). توجه داشته باشید که پیشنهاد none اعمال نمی‌شود زیرا سایر پیشنهادها تخفیف بهتری ارائه می‌دهند. اگر قیمت اصلی ۱۰۰ دلار باشد، قیمت تخفیف خورده ۷۲.۹۰ دلار خواهد بود.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="second"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="4">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

نوع روی هم چیدن

مثال زیر موردی را نشان می‌دهد که در آن از none تخفیفی استفاده نمی‌شود زیرا ترکیب سایر تخفیف‌ها تخفیف کمتری ارائه می‌دهد. اگر قیمت اصلی ۱۰۰ دلار باشد، قیمت تخفیف خورده ۷۵ دلار خواهد بود.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="10"/>
      <Stacking type="base"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="10"/>
      <Stacking type="any"/>
    </Promotion>
    <Promotion id="3">
      <Discount percentage="25"/>
      <Stacking type="none"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


محدوده مدت زمان پنجره رزرو

مثال زیر موردی را نشان می‌دهد که در آن از عنصر BookingWindow با محدوده‌های شروع و پایان تعریف‌شده به عنوان نوع مدت زمان ISO 8601 استفاده شده است. این محدودیت پنجره رزرو مستلزم رزرو در ساعت ۱۸:۰۰ یا قبل از آن روز قبل از ورود، و در ساعت ۱۲:۰۰ یا بعد از آن در روز دوم قبل از ورود است.

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingWindow min="P1DT6H" max="P2DT12H"/>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

تاریخ‌های رزرو، محدوده‌های تاریخ و زمان

مثال زیر موردی را نشان می‌دهد که در آن از عنصر BookingDates با ویژگی‌های start و end به عنوان نوع DateTime استفاده می‌شود. این محدودیت تاریخ رزرو مستلزم آن است که رزرو بین ساعت 06:30 در تاریخ 2020-07-01 و 18:45 در تاریخ 2020-07-02 رخ دهد. 

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
         <DateRange start="2020-07-01T06:30:00" end="2020-07-02T18:45:00"/>
      </BookingDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

محدوده‌های تاریخ بدون سال

مثال زیر موردی را نشان می‌دهد که در آن عنصر CheckInDates شامل DateRanges است که فیلدهای start و end بدون سال دارند. در این مثال، این پیشنهاد صرف نظر از سال، برای تاریخ‌های ورود بین 12/29 و 1/2 اعمال می‌شود. محدوده‌های تاریخ بدون سال که از مرز سال جدید عبور می‌کنند نامعتبر هستند، بنابراین DateRange به صورت دو محدوده تاریخ مجاور بیان می‌شود. 

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <CheckInDates>
         <DateRange start="12-29" end="12-31"/>
         <DateRange start="01-01" end="01-02"/>
      </CheckInDates>
      <Discount percentage="20"/>
    </Promotion>
  </HotelPromotions>
</Promotions>


تخفیف شب‌های رایگان

مثال زیر به ازای هر چهار شب اقامت در محدوده تاریخ رزرو مشخص شده، دو شب تخفیف ۵۰٪ ارائه می‌دهد. برای یک برنامه سفر ده شبه، در مجموع چهار شب تخفیف ۵۰٪ اعمال می‌شود. 

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <BookingDates>
        <DateRange start="2022-01-01" end="2022-05-31"/>
      </BookingDates>
      <Discount>
        <FreeNights stay_nights="4" discount_nights="2" discount_percentage="50" night_selection="cheapest" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>

مثال بعدی، به ازای هر سه شب اقامت در محدوده‌های مشخص‌شده از تاریخ‌های اقامت، یک شب تخفیف ۵۰٪ ارائه می‌دهد. فقط شب‌های اقامتی که با هم همپوشانی دارند، برای دریافت تخفیف محاسبه می‌شوند. برای برنامه سفر زیر که ورود در تاریخ ۲۰۲۲-۰۱-۰۱ و خروج در تاریخ ۲۰۲۲-۰۱-۰۷ انجام می‌شود، تعداد شب‌های اقامت مجاز و تخفیف‌ها به شرح زیر اعمال می‌شوند.

  • ۲۰۲۲-۰۱-۰۱ (اقامت)
  • ۲۰۲۲-۰۱-۰۲ (اقامت)
  • ۲۰۲۲-۰۱-۰۳
  • ۲۰۲۲-۰۱-۰۴ (تخفیف خورده)
  • ۲۰۲۲-۰۱-۰۵ (اقامت)
  • ۲۰۲۲-۰۱-۰۶ (اقامت) 
<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <StayDates application="overlap">
        <DateRange start="2022-01-01" end="2022-01-02"/>
        <DateRange start="2022-01-04" end="2022-01-06"/>
      </StayDates>
      <Discount>
        <FreeNights stay_nights="3" discount_nights="1" discount_percentage="50" night_selection="last" repeats="true"/>
      </Discount>
    </Promotion>
  </HotelPromotions>
</Promotions>


انتخاب رتبه‌بندی‌شده

مثال زیر دو تخفیف ارائه می‌دهد، یکی ۲۰٪ تخفیف و دیگری ۱۵٪ تخفیف. در طول ارزیابی، فقط تخفیف ۱۵٪ اعمال می‌شود زیرا رتبه پایین‌تری دارد. 

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
  <HotelPromotions hotel_id="Property_1">
    <Promotion id="1">
      <Discount percentage="15" rank="25"/>
    </Promotion>
    <Promotion id="2">
      <Discount percentage="20" rank="50"/>
    </Promotion>
  </HotelPromotions>
</Promotions>

بهترین تخفیف روزانه

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

<?xml version="1.0" encoding="UTF-8"?>
<Promotions partner="account_xyz"
            id="123_abc"
            timestamp="2020-05-18T16:20:00-04:00">
 <HotelPromotions hotel_id="HotelID" action="overlay">
   <Promotion id="general">
     <BestDailyDiscount fixed_amount="20"/>
   </Promotion>
   <Promotion id="may">
     <BestDailyDiscount fixed_amount="50"/>
     <StayDates application="overlap">
        <DateRange start="2023-05-01" end="2023-05-31"/>
     </StayDates>
   </Promotion>
   <Promotion id="fiesta">
     <Discount fixed_amount_per_night="5"/>
     <Stacking type="any"/>
   </Promotion>
 </HotelPromotions>
</Promotions>

Consider a two night stay from April 30, 2023 to May 2, 2023 For calculation, the combination of best daily discounts that yields the deepest discount is found first.

For the first night, the "general" promotion is the only eligible amount with a fixed discount of 20.

For the second night, the "may" promotion offers a deeper discount than the "general" discount. So, when "may" is selected the fixed discount amount is 50.

Then for the stay, the "fiesta" promotion discounts to 5 per night, or 10 total. It can be stacked with the combination of best daily discounts because "fiesta" has stacking type set to any . If it were set to base , then only the combination of best daily discounts or the "fiesta" discount is applied. See description of Stacking for more information.

`Overall, the price of the stay receives a 20 + 50 + 10 = 80 fixed amount discount.

پاسخ‌ها

نحو

The PromotionsResponse message uses the following syntax: 

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues are populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code"
           status="issue_type">
      issue_description
    </Issue>
  </Issues>
</PromotionsResponse>

عناصر و ویژگی‌ها

The PromotionsResponse message has the following elements and attributes:

عنصر / @Attribute رخدادها نوع توضیحات
PromotionsResponse 1 Complex element The root element indicating the success or issues for a received Promotions request message.
PromotionsResponse / @timestamp 1 DateTime تاریخ و زمان ایجاد این پیام.
PromotionsResponse / @id 1 string The unique identifier from the associated Promotions message.
PromotionsResponse / @partner 1 string حساب کاربری شریک برای این پیام.
PromotionsResponse / Success 0..1 Success Indicates that the Promotions message was processed successfully without warnings, errors, or failures.

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

PromotionsResponse / Issues 0..1 Issues A container for one or more issues encountered while processing the Promotions message.

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

PromotionsResponse / Issues / Issue 1..n Issue The description of a warning, error, or failure encountered while processing the Promotions message. Details on these issues can be found in Feed Status Error Messages .
PromotionsResponse / Issues / Issue / @code 1 integer شناسه‌ی مسئله.
PromotionsResponse / Issues / Issue / @status 1 enum

نوع مشکلی که با آن مواجه شده‌اید.

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

مثال‌ها

موفقیت

The following is a response to a successfully processed Promotions message. 

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</PromotionsResponse>

مسائل

The following is a response to a Promotions message not processed due to errors. 

<?xml version="1.0" encoding="UTF-8"?>
<PromotionsResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</PromotionsResponse>