במדריך הזה ל-XML מופיע תוכן מפורט ודוגמאות קוד להודעות, לרכיבים ולמאפיינים השונים שזמינים בפידים של זמינות, מחירים ומלאי (ARI).
ARI הוא מצב העברת מחירים ששולט בתעריפים ללילה, בזמינות ובמלאי, ומספק הגבלות על האופן שבו אפשר לשלב בין הנתונים האלה. בנוסף, ARI מאפשרת לכם לכלול מיסים, עמלות ומבצעים.
ממשק ה-ARI פועל לפי הפרוטוקולים הסטנדרטיים של OpenTravel Alliance (OTA) עבור חלק מסוגי ההודעות העיקריים להגדרת זמינות ומלאי.
תמחור לפי משך השהייה
התמחור לפי LOS-based מאפשר לכם לציין מחירים לפי תאריך הצ'ק-אין ומשך השהייה, ולא לפי תאריך השהייה. כשמציינים רכיב <StatusApplicationControl> לתמחור לפי משך השהייה, המאפיינים @Start ו-@End מציינים טווח של תאריכי צ'ק-אין שעליהם חלים המחירים לפי משך השהייה.
למרות שכשמשתמשים בתמחור לפי משך השהייה אין יותר תעריפים ללילה, עדיין אפשר להחיל על התעריפים האלה את כל התכונות האחרות של ARI (מלאי, זמינות, כללים, מבצעים וכו'), והן מוגדרות ברמת הלילה. המשמעות היא שאם המערכות שלכם תואמות יותר למערכת תמחור שמבוססת על משך השהייה, אתם עדיין יכולים ליהנות ממערך התכונות העשיר של ARI, בנוסף לרוחב הפס היעיל שמתקבל משימוש בעדכוני הזמינות וההגבלות הליליים.
כדי להפעיל בחשבון שלכם תמחור לפי משך השהייה, פנו למנהל החשבונות הטכני או צרו איתנו קשר.
ב-ARI נעשה שימוש בהודעות הבקשה הבאות:
Transaction(נתוני הנכס). הגדרת סוג המידע והחבילה (תוכנית התמחור).
OTA_HotelRateAmountNotifRQ. מגדיר את שיעורי התפוסה לכל מוצר (שילוב של סוג חדר ותוכנית מחירים) לפי תאריך או לפי משך השהייה, לטווחי תאריכים ספציפיים.
OTA_HotelAvailNotifRQ. מגדיר את הזמינות וההגבלות על סמך סוג החדר ותוכניות המחירים. אפשר גם לעדכן את מלאי החדרים באמצעות ההודעה הזו, אבל עדיף להשתמש ב-OTA_HotelInvCountNotifRQ.
OTA_HotelInvCountNotifRQ. מגדיר את המלאי הפיזי של החדרים או את מספר החדרים שזמינים למכירה.
TaxFeeInfo. (אופציונלי) הגדרת מיסים ועמלות לפי נכס. ההודעה הזו לא נדרשת אםAmountAfterTaxמצוין בהודעהOTA_HotelRateAmountNotifRQ.
Promotions. (אופציונלי) מגדיר מחירים מיוחדים לקידום מכירות להזמנות, לשהיות ולמשתמשים מסוימים.
RateModifications. (אופציונלי) הגדרת כללים לשינוי מחירים להזמנות, לשהיות ולמשתמשים מסוימים.
ExtraGuestCharges. (אופציונלי) מגדיר איך צריך להגדיר את המחירים לילדים ולמבוגרים נוספים.
כל הודעה מכילה קבוצת משנה של מידע ש-Google משתמשת בו כדי לחשב את המחירים והזמינות שמוצגים למשתמשים כשהם מחפשים את הנכסים שלכם עם תאריכי צ'ק-אין וצ'ק-אאוט ספציפיים ותפוסה מסוימת.
היסטוריית הגרסאות של ARI XML Reference
בטבלה הבאה מפורטים עדכונים במאמרי העזרה שקשורים רק לשינויים בתכונות.
| תאריך | השינויים |
|---|---|
| 14 באוגוסט 2020 | זו הגרסה הראשונה. |
| 21 באוקטובר 2020 | נוסף סוג ההודעה 'מבצעים'. |
| 17 בנובמבר 2020 | עבור הודעות על עסקאות (נתוני מלונות), עודכן endpoint והוסף המאפיין action לרכיבי PropertyDataSet.
|
| 24 בנובמבר 2020 | בהודעות על עסקאות (נתוני נכס), נוספו הרכיבים <AllowablePackageIDs> ו-<AllowableRoomIDs>. |
| 4 בפברואר 2021 | הוספנו הודעות תגובה. |
| 25 בפברואר 2021 | OTA_HotelInvCountNotifRQ נוסף. |
| 21 באוקטובר 2020 | נוסף סוג ההודעה 'שינויים במחיר'. |