Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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>`, והמאפיין `<AvailStatusMessage>` לא יכול להכיל את הערכים `<LengthOfStay>` או `<RestrictionStatus>`.`InvTypeCode` הערך חייב להיות גדול מ-0 או שווה ל-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 (נתוני נכס).
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	קונטיינר להגדרת הגבלות של 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"`, מותרות רק שהיות של יום אחד ושל 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>

משך הזמן של 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>

הסרת ההגבלות על 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>

OTA_HotelAvailNotifRQ קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

בקשות

תחביר

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

דוגמאות

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

משך הזמן של LoS

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

הגבלת יציאה

הגבלת הגעה

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

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

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

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

כמה סוגי הגבלות

מגבלת הזמנות

FullPatternLoS

תשובות

תחביר

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

דוגמאות

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

שגיאות

OTA_HotelAvailNotifRQ