OTA_HotelAearnNotifRQ

בקשות

תחביר

ההודעה OTA_HotelAvailNotifRQ מבוססת על התחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

כל הודעת <OTA_HotelAvailNotifRQ> מטופלת כעדכון דלתא. לכל נכס, תאריך, חדר וחבילה שצוינו <StatusApplicationControl>, עדכון לכל הגבלה שהוגדרה בעבר תחליף את הערך של אותה הגבלה בלבד, בזמן הוספת הגבלה חדשה אינה משפיעה על הגבלות אחרות שהוגדרו קודם לכן. לדוגמה, אם ערך המינימום משך השהייה למשך יומיים הוגדר קודם לכן, ואז נשלחה הודעה חדשה עודכנה ההגדרה של משך שהייה מקסימלי של 7 ימים בלבד. לאחר מכן הפעולה לא תמחק את הערך הקודם של משך השהייה המינימלי.

רכיבים ומאפיינים

הודעת OTA_HotelAvailNotifRQ כוללת את הרכיבים והמאפיינים הבאים:

הערה:כל סוג של הגבלה על משך השהייה הוא מוגדרים בנפרד. לדוגמה, הודעה שמגדירה SetMaxLOS לא מחליף ערך שהוגדר בעבר עבור SetForwardMaxStay.

רכיב / @Attribute מופעים סוג תיאור
OTA_HotelAvailNotifRQ 1 Complex element הרכיב הבסיסי של ההודעה שמגדיר את זמינות המחיר לחדרים.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) מרחב השמות של XML.
OTA_HotelAvailNotifRQ / @EchoToken 1 string מזהה ייחודי להודעת הבקשה הזו. הערך הזה מוחזר בהודעת התשובה. התווים המותרים הם a-z, A-Z, 0-9, _ (קו תחתון), ו-- (מקף).
OTA_HotelAvailNotifRQ / @TimeStamp 1 DateTime התאריך והשעה של יצירת ההודעה הזו.
OTA_HotelAvailNotifRQ / @Version 1 decimal גרסת ההודעה ב-OpenTravel.
OTA_HotelAvailNotifRQ / POS 0..1 POS מאגר לציון חשבון השותף עבור ההודעה הזו. זה כן משמשים בדרך כלל אם הקצה העורפי מספק פידים של מחירים חשבונות שותפים מרובים.
OTA_HotelAvailNotifRQ / POS/ Source 1 Source שדה חובה אם השדה <POS> קיים. קונטיינר של <RequestorID>
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID חובה אם השדה <POS> קיים. מגדיר את השותף חשבון.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 string חשבון השותף שאליו שייכת ההודעה הזו. ערך המחרוזת הזה הוא הערך Partner key רשום ב דף הגדרות החשבון ב-Hotel Center.

הערה:אם יש לכם קצה עורפי שמספק פידים של כמה חשבונות, ערך זה צריך להתאים לערך partner של ההודעה 'עסקה' (נתוני נכס) ערך המאפיין ID ב רכיב <RequestorID> מתוך הודעה <OTA_HotelRateAmountNotifRQ> לאותו פריט חשבון.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages מאגר תגים של <AvailStatusMessage> או יותר רכיבים.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string המזהה הייחודי של הנכס. הערך הזה חייב להתאים לערך מזהה המלון צוין באמצעות &lt;id&gt; ברכיב <listing> בפיד של רשימת המלונות. מזהה המלון מופיע גם ב-Hotel Center.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage הגדרת זמינות של תעריף לחדר והגבלות לפי זמנים שונים טווחים של נכס יחיד.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer הערה: עדיף לשלוח הודעה OTA_HotelInvCountNotifRQ על פני ההגדרה הזו .

מספר החדרים שנותרו שאפשר להזמין טווח התאריכים <StatusApplicationControl>. אם המיקום צוין BookingLimit, חובה לציין <StatusApplicationControl> InvTypeCode, וגם <AvailStatusMessage> לא יכול להכיל <LengthOfStay> או <RestrictionStatus>.

חייב להיות שווה ל- או גדול מ-0. אם הפרמטר שלילי או לא צוין, ערך ברירת המחדל שלו הוא 0.

הערה: כדי לבדוק זמינות חדרים לחלק מסוים ההגדרה <StatusApplicationControl>, צריך להגדיר את המאפיין BookingLimit לפחות פעם אחת.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl הגדרת טווח התאריכים והמזהים של סוג החדר – InvTypeCode ותוכנית תעריפים – RatePlanCode.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date תאריך ההתחלה בהתאם לאזור הזמן של הנכס, שכולל של טווח התאריכים.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date תאריך הסיום (לפי אזור הזמן של הנכס), כולל טווח תאריכים. חייב להיות שווה לערך start או גדול ממנו. אם הערכים של start ושל end זהים, העדכון יחול עד לתאריך הזה.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול באופן מפורש את ימי שני.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש כ-'true' אינן נכללות (בפועל, סוננו מהתאריכים בתוך Start and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול באופן מפורש את ימי שלישי.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח Start End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול במפורש את ימי רביעי.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח Start End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול במפורש את ימי חמישי.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח Start End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול במפורש את ימי שישי.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח Start End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean צריך להגדיר את הערך true או 1 כדי לכלול את ימי שבת באופן מפורש.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח ההתחלה ו- End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean מגדירים את הערך true או 1 כדי לכלול באופן מפורש את ימי ראשון.

אם הערך הוא true, ימים אחרים בשבוע שלא הוגדרו מוגדרות במפורש ל-true אינן נכללות (בפועל, מסונן מתוך התאריכים בטווח Start End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string המזהה הייחודי של המלאי (סוג החדר). הערך הזה ממפה אל <RoomID> בקטע עסקאות (נתוני נכס).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string מזהה ייחודי של תוכנית התמחור והתשלומים. המזהה הזה ממופה אל של הערך <PackageID> בעסקה (נתוני נכס) הודעה. תוכנית התעריפים מוגדרת בצורה מפורטת יותר, ומופיעה כאן ב-<StatusApplicationControl> בשני <OTA_HotelRateAmountNotifRQ> והקבוצה <OTA_HotelAvailNotifRQ> הודעות.

המאפיין RatePlanCode לא רלוונטי וצריך לא יצוין, <AvailStatusMessage> מכיל את הערך מאפיין BookingLimit. יש לציין אם <RestrictionStatus> או השדה <LengthOfStay> צוין.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay קונטיינר להגדרת הגבלות LOS. לא יכול להופיע אם <AvailStatusMessage> כולל את BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer אורך הדפוס שהוגדר ב-FullPatternLOS.

הערה: חובה להגדיר את המאפיין הזה כשמשתמשים MinMaxMessageType="FullPatternLOS" והוא חסר אחרת.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay הגדרת הגבלות על משך השהייה. כשמשתמשים ביותר מאישור אחד רכיב <LengthOfStay>, בכל אחד מהם צריך לציין ערך שונה של MinMaxMessageType.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer ערך היחידה של מדידת משך השהייה. שימו לב שהערך של הפונקציה אפס נחשבת ללא הגבלה. לדוגמה, המשמעות של <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> היא שאין מקסימום משך השהייה.

הערה: חובה להגדיר את המאפיין הזה, אלא אם משתמשים MinMaxMessageType="FullPatternLOS".

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum יחידת הזמן. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא "Day". נתונים תקפים הוא:
  • Day
הערה: יחידה אחת בנפח "Day" שווה לשהייה של לילה אחד.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 enum סוגים שונים של הגבלות על משך השהייה. SetMaxLOS, SetMinLOS ועוד FullPatternLOS מגיעות מבוסס. SetForwardMinStay ו- SetForwardMaxStay מבוססים על צפיות המשך. הערכים המקסימליים חייבים להיות גדול מהערך המינימלי או שווה לו.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern 0..1 LOS_Pattern הגדרת דפוס ההגבלה של משך השהייה.

הערה: הרכיב הזה חייב להופיע כשמשתמשים MinMaxMessageType="FullPatternLOS" והוא חסר אחרת.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS 1 string רצף של Y ו-N תווים שמציין אם מותר להגדיר כל משך שהייה, מלילה אחד ועד לערך FixedPatternLength. כל משך שהייה ארוך מ- FixedPatternLength יורש את הערך במיקום הסופי. עבור לדוגמה, עם FixedPatternLength="4" ו- FullPatternLOS="YNYN", מותר להגדיר רק משך שהייה של 1 ו-3.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0..1 RestrictionStatus מגדיר הגבלות על מסלול נסיעה. לא צריך להופיע אם <AvailStatusMessage> כולל את BookingLimit.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0..1 enum מציין אם סוג ההגבלה שצוין על ידי המאפיין Restriction פתוח או סגור. ערכים חוקיים הן:
  • Open
  • Close

הערה:

  • כברירת מחדל, Google מניחה ההגדרה Master לכל המוצרים היא Close. אפשר להגדיר את הזמינות בקטע 'זמינות ברירת מחדל' באזור מלון מרכז הגדרות התמחור. הכרטיסייה 'סגורה' הערך ב-Hotel Center תואם לערך Close כאן.
  • ההגדרה של Master לערך Close נקראת "Stop למכור"
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

חובה לציין את המאפיין הזה אם הזנתם את Status.

הערכים החוקיים כוללים:

  • Arrival: הערך הזה מונע מסלולי נסיעה עם תאריך הצ'ק אין במהלך התאריך Start ו-End טווח, כולל.
  • Departure: הערך הזה מונע מסלולי נסיעה עם תאריך הצ'ק-אאוט במהלך Start ו-End טווח תאריכים, כולל.
  • Master: הערך הזה מציין אם החדר מחיר זמין להזמנה בתאריך הזה.

הערה: אם Restriction לא צוין, ערך ברירת המחדל הוא Master.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration משך הזמן המינימלי לפני תאריך ההגעה (באזור הזמן של הנכס) השעה שבה אפשר להזמין את המחיר הזה לחדר.

סוגי הערכים החוקיים הם:

  • Integer: מספר הימים לפני ההגעה תאריך. לדוגמה: הערך 1 מציין את המחיר לחדר. חובה להזמין יום אחד לפחות לפני תאריך ההגעה. ערך של 0 (ערך ברירת המחדל) מציין שאין הגבלה על המועד האחרון להזמנה.
  • ISO 8601 Duration (days, hours, and minutes): מספר הימים (וגם שעות/דקות) לפני ההגעה תאריך. לדוגמה: הערך P1D מציין את החדר. צריך להזמין את המחיר יום אחד לפני תאריך ההגעה. ערך של P0DT6H מציין שההזמנה חייבת להתבצע שש שעות לפני תאריך ההגעה (כלומר 18:00) או מוקדם יותר.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration משך הזמן המקסימלי לפני תאריך ההגעה (לפי האזור המקומי של הנכס) השעה שבה אפשר להזמין את המחיר הזה לחדר.

סוגי הערכים החוקיים הם:

  • Integer: מספר הימים לפני ההגעה תאריך. לדוגמה: הערך 30 מציין את המחיר לחדר. לא ניתן להזמין מקום לפני יותר מ-30 יום לפני תאריך ההגעה. א' הערך 0 (ערך ברירת המחדל) מציין שאין הגבלה במועד ההזמנה המוקדם ביותר.
  • ISO 8601 Duration (days, hours, and minutes): מספר הימים (וגם שעות או מנטה) לפני ההגעה תאריך. לדוגמה: הערך P30D מציין את החדר. לא ניתן להזמין את המחיר לפני יותר מ-30 יום לפני תאריך ההגעה. הערך P30DT6H מציין שלא ניתן לבצע הזמנה לפני 18:00, 30 ימים לפני תאריך ההגעה.

דוגמאות

תאריך ההגעה ל-LoS

מגדירים את משך השהייה המינימלי והמקסימלי (לפי תאריך ההגעה).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

משך זמן LoS

מגדירים את משך השהייה המינימלי והמקסימלי (על סמך השהייה).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

הגבלת יציאה

מגדירים הגבלה לזמן סגור ליציאה. (הפעולה הזו מונעת מסלולי נסיעה עם צ'ק-אאוט בתאריכים ספציפיים.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

הגבלת הגעה

מגדירים הגבלה של 'סגירה להגעה'. (הפעולה הזו מונעת מסלולי נסיעה עם ביצוע צ'ק-אין בתאריכים ספציפיים).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

פתיחת תאריכי הזמינות

פתיחת הזמינות של סוג חדר ותוכנית מחירים בתאריכים ספציפיים.

הערה: יש צורך גם בתעריפים ללילה אחד יחד עם מספר המלאי. גדול מ-0 לסוג החדר, לפני שהמחירים זמינים במלואם.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>


סגירת תאריכי הזמינות

סגירת הזמינות של סוג חדר ותוכנית מחירים בתאריכים ספציפיים. (ה נקראת גם "עצירת מכירה").

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

הגבלות על הזמנה מראש

הגדרת הגבלות על חלון ההזמנה המינימלי והמקסימלי, שחלות רק בסופי שבוע.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

מועד אחרון להזמנה

אפשר להחיל מועד אחרון להזמנה בתאריך ההגעה בשעה 18:00 במיקום המקומי של המלון בזמן האימון.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

הגבלות מרובות

אפשר להגדיר כמה הגבלות באותם תאריכים לכל סוג חדר ותוכנית מחירים.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>


מגבלת הזמנות

אפשר להגדיר את ספירת המלאי לסוג חדר מסוים בתאריכים שנבחרו.

הערה: הקישור OTA_HotelInvCountNotifRQ עדיף לשלוח הודעה על פני הגדרת המאפיין הזה.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

מגדירים הגבלה מלאה של משך השהייה בתבנית מלאה.

אם בוצע צ'ק-אין ב-26 ביולי 2023, השהייה היא רק משך השהייה של 2, 4 ו-6. מותר. טווחי השהייה הם 1, 3, 5 ו-7 ומעלה.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

תשובות

תחביר

ההודעה OTA_HotelAvailNotifRS מבוססת על התחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

רכיבים ומאפיינים

הודעת OTA_HotelAvailNotifRS כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @Attribute מופעים סוג תיאור
OTA_HotelAvailNotifRS 1 Complex element הרכיב הבסיסי של התשובה להודעת זמינות.
OTA_HotelAvailNotifRS / @TimeStamp 1 DateTime התאריך והשעה של יצירת ההודעה הזו.
OTA_HotelAvailNotifRS / @EchoToken 1 string המזהה הייחודי של האפליקציה הודעה אחת (OTA_HotelAvailNotifRQ).
OTA_HotelAvailNotifRS / Success 0..1 Success מציין שההודעה של OTA_HotelAvailNotifRQ עובדה בהצלחה.

<Success> או <Errors> הם שנמצא בכל הודעה.
OTA_HotelAvailNotifRS / Errors 0..1 Errors מאגר שמתאר בעיה אחת או יותר במהלך העיבוד של הודעה אחת (OTA_HotelAvailNotifRQ).

<Success> או <Errors> הם שנמצא בכל הודעה.
OTA_HotelAvailNotifRS / Errors / Error 1..n Error תיאור של שגיאה שאירעה במהלך עיבוד הודעה אחת (OTA_HotelAvailNotifRQ). פרטים על השגיאות האלה יכולים ניתן למצוא ב הודעות שגיאה לגבי סטטוס הפיד.
OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer OpenTravel Alliance EWT (סוג אזהרת שגיאה) המשויך אל שגיאה. נעשה שימוש רק בערך 12 (Processing exception).
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer קוד השגיאה OpenTravel Alliance ERR (קוד השגיאה) שמשויך לשגיאה. נעשה שימוש רק בערך 450 (Unable to process).
OTA_HotelAvailNotifRS / Errors / Error / @Code 1 enum סטטוס הבקשה המקורית. רק הערך נעשה שימוש ב-NotProcessed.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText 1 string המזהה של Google לבעיה. פרטים על השגיאות האלה יכולים להיות נמצא ב- הודעות שגיאה לגבי סטטוס הפיד.

דוגמאות

הפעולה הצליחה

התגובה הבאה נשלחה בהצלחה הודעת OTA_HotelAvailNotifRQ.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

שגיאות

התשובה הבאה היא תשובה להודעת OTA_HotelAvailNotifRQ שלא עובדה בגלל שגיאות.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>