בקשות
תחביר
ההודעה 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
.
רכיב / @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> בקטע עסקאות
(נתוני נכס). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | מזהה ייחודי של תוכנית התמחור והתשלומים. המזהה הזה ממופה אל
של הערך
<PackageID> בעסקה (נתוני נכס)
הודעה. תוכנית התעריפים מוגדרת בצורה מפורטת יותר, ומופיעה כאן
ב-<StatusApplicationControl> בשני
<OTA_HotelRateAmountNotifRQ> והקבוצה
<OTA_HotelAvailNotifRQ> הודעות.
המאפיין |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | קונטיינר להגדרת הגבלות LOS. לא יכול להופיע אם
<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 פתוח או סגור. ערכים חוקיים
הן:
הערה:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | חובה לציין את המאפיין הזה אם הזנתם את הערכים החוקיים כוללים:
הערה: אם |
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>
משך זמן 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
עובדה בהצלחה.
|
OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | מאגר שמתאר בעיה אחת או יותר במהלך העיבוד של
הודעה אחת (OTA_HotelAvailNotifRQ ).
|
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>