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.

אלמנט / @מאפיין	אירועים	סוג	תיאור
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	המזהה הייחודי של הנכס. הערך הזה צריך להתאים למזהה המלון שצוין באמצעות <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. ערך ברירת המחדל הוא 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. הערך 'סגור' ב-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>

הערה: אם לא מציינים את Restriction, ערך ברירת המחדל הוא Master.

מגבלת הזמנה

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

הערה: מומלץ לשלוח את ההודעה 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 כוללת את הרכיבים ואת המאפיינים הבאים:

אלמנט / @מאפיין	אירועים	סוג	תיאור
OTA_HotelAvailNotifRS	1	Complex element	הרכיב הבסיסי (root) של תשובה להודעה בנושא זמינות.
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>