בקשות
תחביר
התחביר של ההודעה 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>, עדכון של הגבלה שהוגדרה בעבר מחליף רק את הערך של אותה הגבלה, ואילו הוספה של הגבלה חדשה לא משפיעה על הגבלות אחרות שהוגדרו בעבר. לדוגמה, אם הגדרתם בעבר משך שהייה מינימלי של 2 ימים, ולאחר מכן עדכנתם הודעה חדשה שמכילה רק משך שהייה מקסימלי של 7 ימים, הפעולה הזו לא תמחק את הערך הקודם של משך השהייה המינימלי.
רכיבים ומאפיינים
להודעה OTA_HotelAvailNotifRQ יש את הרכיבים והמאפיינים הבאים:
הערה: כל סוג של הגבלת משך השהייה מוגדר בנפרד. לדוגמה, הודעה שמגדירה את SetMaxLOS לא מחליפה ערך שהוגדר קודם לכן ל-SetForwardMaxStay.
| רכיב / @Attribute | מופעים | סוג | תיאור |
|---|---|---|---|
| OTA_HotelAvailNotifRQ | 1 | Complex element | רכיב הבסיס של הודעה שמגדירה את הזמינות של מחירי החדרים. |
| OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | מרחב השמות של ה-XML. |
| OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | מזהה ייחודי של הודעת הבקשה הזו. הערך הזה מוחזר בהודעת התגובה. התווים המותרים הם a-z, A-Z, 0-9, _ (קו תחתון) ו-- (מקף). |
| OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | התאריך והשעה שבהם נוצרה ההודעה הזו. |
| OTA_HotelAvailNotifRQ / @Version | 1 | decimal | גרסת ההודעה ב-OpenTravel. |
| OTA_HotelAvailNotifRQ / POS | 0..1 | POS | מאגר לציון חשבון השותף של ההודעה הזו. בדרך כלל משתמשים בו אם הקצה העורפי מספק פידים של מחירים למספר חשבונות שותפים. |
| OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | חובה אם השדה <POS> קיים. מאגר של <RequestorID>. |
| OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | חובה אם השדה <POS> קיים. מגדיר את חשבון השותף. |
| OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | string | חשבון השותף של ההודעה הזו. ערך המחרוזת הזה הוא הערך של Partner key שמופיע ב
דף 'הגדרות חשבון' ב-Hotel Center.
הערה: אם יש לכם קצה עורפי שמספק פידים לכמה חשבונות, הערך הזה צריך להיות זהה לערך של המאפיין |
| 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 במקום להגדיר את המאפיין הזה. מספר החדרים שנותרו שאפשר להזמין בטווח התאריכים ב- הערך חייב להיות שווה ל-0 או גדול ממנו. אם הערך של הפרמטר שלילי או לא צוין, ערך ברירת המחדל שלו הוא 0. הערה: כדי לקבוע את זמינות החדרים בהגדרה נתונה של |
| 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 כדי לכלול באופן מפורש את ימי שני.
אם הערך של |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול במפורש את ימי שלישי.
אם הערך מוגדר כ- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש את ימי רביעי.
אם הערך מוגדר כ- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי חמישי.
אם הערך מוגדר כ- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול במפורש את ימי שישי.
אם הערך מוגדר כ- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי שבת.
אם הערך של השדה מוגדר כ- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי ראשון.
אם הערך מוגדר כ- |
| 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>.
המאפיין |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | מאגר להגדרת הגבלות קו ראייה. לא חייב להופיע אם השדה <AvailStatusMessage> כולל את המאפיין BookingLimit. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | אורך הדפוס שמוגדר ב-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"> מציין שאין אורך מקסימלי של השהייה.
הערה: חובה להגדיר את המאפיין הזה, אלא אם משתמשים ב- |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | יחידת הזמן. אם לא מציינים ערך, ברירת המחדל היא "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 | הגדרת התבנית של הגבלת משך השהייה.
הערה: האלמנט הזה חייב להופיע כשמשתמשים ב- |
| 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 עם Arrival: השילוב הזה מציין אילו תאריכים במסלול הנסיעה זמינים לצ'ק-אין.Open ו-Close עם Departure: השילוב הזה מציין אילו תאריכים במסלול הנסיעה זמינים לביצוע הזמנההתאריך לדוגמה, עדיין אפשר להזמין שהייה מ-1 באפריל עד 4 באפריל, אם 2 עד 4 באפריל סגורים לקבלת אורחים. הערה:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | המאפיין הזה נדרש אם צוין הערכים החוקיים כוללים:
צריכה להיות זמינות פנויה ב- לדוגמה, אם השהייה היא ל-3 לילות ומועד ההגעה הוא 1 באפריל, מסלול הנסיעה המלא הוא 1-4 באפריל. הערך של הערה: אם לא מציינים את |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | משך הזמן המינימלי לפני תאריך ההגעה (לפי השעון המקומי של המלון) שאפשר להזמין בו את מחיר החדר הזה.
סוגי הערכים החוקיים הם:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | משך הזמן המקסימלי לפני תאריך ההגעה (לפי השעון המקומי של המלון) שאפשר להזמין בו את מחיר החדר הזה.
סוגי הערכים החוקיים הם:
|
דוגמאות
תאריך ההגעה של 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 לילות. לא ניתן להזמין חדרים למשך 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 טופלה בהצלחה.
השדה |
| OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | מאגר של בעיה אחת או יותר שנתקלו בהן במהלך עיבוד ההודעה OTA_HotelAvailNotifRQ.
השדה |
| 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>