דף זה תורגם על ידי Cloud Translation API.

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

הערה: כל סוג של הגבלת משך השהייה מוגדר בנפרד. לדוגמה, הודעה שבה מוגדר 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	המזהה הייחודי של הנכס. הערך הזה חייב להתאים למזהה המלון שצוין באמצעות <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. הערך 'Closed' ב-Hotel Center תואם לערך של `Close` כאן. הגדרה של `Master` לערך `Close` נקראת 'הפסקת מכירה'.
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` מציין שההזמנה צריכה להתבצע 6 שעות לפני סוף תאריך ההגעה (כלומר 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>