OTA_HotelAvailNotifRQ

בקשות

תחביר

ההודעה 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.

רכיב / @מאפיין מופעים סוג תיאור
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 מאגר שבו מציינים את חשבון השותף שאליו משויכת ההודעה. בדרך כלל משתמשים באפשרות הזו אם ה-Backend שלכם מספק פידים של מחירים לכמה חשבונות שותפים.
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 בהודעה מסוג Transaction (נתוני נכס) ולערך המאפיין ID ברכיב <RequestorID> של ההודעה <OTA_HotelRateAmountNotifRQ> עבור אותו חשבון.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages קונטיינר של רכיב <AvailStatusMessage> אחד או יותר.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string המזהה הייחודי של הנכס. הערך הזה צריך להיות זהה לערך של מזהה המלון שצוין באמצעות <id> בתג <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> בהודעה Transactions (Property Data).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string מזהה ייחודי של תוכנית המחירים. המזהה הזה ממופה לערך של <PackageID> בהודעה מסוג Transaction (נתוני נכס). תוכנית התמחור מוגדרת ומפורטת ב-<StatusApplicationControl> בהודעות <OTA_HotelRateAmountNotifRQ> וגם בהודעות <OTA_HotelAvailNotifRQ>.

המאפיין RatePlanCode לא רלוונטי ואסור לציין אותו אם המאפיין <AvailStatusMessage> מכיל את המאפיין BookingLimit. חובה לציין את הערך הזה אם מציינים את <RestrictionStatus> או את <LengthOfStay>.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay קונטיינר להגדרת הגבלות על רמת השירות. אסור להשתמש במאפיין הזה אם במאפיין <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

הערכים Open ו-Close תואמים לכל הערכים של רכיב <Restriction>. כשמשתמשים בערכים Open ו-Close עם הערכים Arrival ו-Departure, הם מגבילים תאריכים ספציפיים במסלול הנסיעה לצ'ק-אין ולצ'ק-אאוט בהתאמה.

  • ‫Open ו-Close עם Arrival: השילוב הזה מציין אילו תאריכים במסלול הנסיעה זמינים לצ'ק-אין
  • ‫Open ו-Close עם Departure: השילוב הזה מציין אילו תאריכים במסלול הנסיעה זמינים לצ'ק-אאוט

    • התאריך Arrival לא מגביל את הזמינות ללילות השהייה אחרי תאריך הצ'ק-אין.

    לדוגמה, אם השהייה היא מ-1 באפריל עד 4 באפריל, והתאריכים 2 באפריל עד 4 באפריל סגורים להגעה, עדיין אפשר להזמין את השהייה.

    הערה:

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

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

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

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

    הערכים של Arrival ושל Departure צריכים להיות זמינים במסלול הנסיעה. ערך ברירת המחדל של Arrival ושל Departure הוא Open, אלא אם נשלחה הודעה קודמת שמציינת שהחלון נסגר. בנוסף, השילוב של החדר/החבילה צריך להיות זמין לכל התאריכים של מסלול הנסיעה, למעט היום האחרון של השהייה. אפשר להגדיר את הזמינות הזו באמצעות הגדרות ברירת המחדל ב-Hotel Center או באמצעות <Status> או רכיב <Restriction>. אם הגדרת ברירת המחדל היא Close, צריך לשלוח את הערך Status של Open ואת הערך restriction של Master לתאריכים הרלוונטיים כדי לפתוח מחדש את הזמינות לתאריכי המסלול.

    לדוגמה, אם מגיעים ב-1 באפריל ושוהים שלושה לילות, התאריכים המלאים של השהייה הם 1 באפריל עד 4 באפריל. הערך של Status צריך להיות Open והערך של Restriction צריך להיות Master לשהייה הלילית מ-1 באפריל עד 3 באפריל. היום האחרון של השהות (4 באפריל) סגור, כי רק התאריכים של השהייה הלילית צריכים להיות בסטטוס Open.

    הערה: אם לא מציינים את 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>

    משך השהייה

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

    <?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>

    הסרת הגבלות על LoS

    הגדרת הערך Time="0" במאפיין <LengthOfStay> מציינת שאין הגבלות על משך השהייה שצוין. לדוגמה, ‫<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> מציין שאין הגבלה על השהייה המקסימלית.

    <?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2024-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2024-07-26"
                                End="2024-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
      </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 לילות בלבד. משך השהייה של יום אחד, 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 כוללת את הרכיבים והמאפיינים הבאים:

    רכיב / @מאפיין מופעים סוג תיאור
    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 ה-EWT (סוג האזהרה על שגיאה) של OpenTravel Alliance שמשויך לשגיאה. הערך היחיד שבו אפשר להשתמש הוא 12 (Processing exception).
    OTA_HotelAvailNotifRS / Errors / Error / @Code 1 integer קוד השגיאה (ERR) של OpenTravel Alliance שמשויך לשגיאה. הערך היחיד שבו אפשר להשתמש הוא 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>