קובץ XML של זמינות, מחירים ומלאי (ARI)

מדריך העיון הזה ב-XML כולל תוכן עיון מפורט ודוגמאות קוד להודעות, לרכיבים ולמאפיינים השונים שזמינים בפידים של זמינות, מחירים ומלאי (ARI).

ממשק ARI הוא מצב העברת מחירים ששולט בתעריפים ללילה, בזמינות ובמלאי, ומספק אילוצים לגבי האופן שבו אפשר לשלב בין הנתונים האלה. בנוסף, ARI מאפשרת לכם לכלול מיסים, עמלות ומבצעים.

‫ARI פועל לפי הפרוטוקולים הסטנדרטיים של OpenTravel Alliance ‏ (OTA) עבור חלק מסוגי ההודעות העיקריים להגדרת זמינות ומלאי.

תמחור לפי משך השהייה

תמחור לפי תאריך הצ'ק-אין מאפשר לכם לציין מחירים לפי תאריך הצ'ק-אין ומשך השהייה, ולא לפי תאריך השהייה.LOS-based כשמציינים רכיב <StatusApplicationControl> לתמחור לפי משך השהייה, המאפיינים @Start ו-@End מציינים טווח של תאריכי צ'ק-אין שעליהם חלים המחירים לפי משך השהייה.

למרות שכשמשתמשים בתמחור לפי משך השהייה אין יותר תעריפים ללילה, עדיין אפשר להחיל על התעריפים האלה את כל התכונות האחרות של ARI (מלאי, זמינות, כללים, מבצעים וכו'), והן מוגדרות ברמת הלילה. המשמעות היא שאם המערכות שלכם תואמות יותר למערכת תמחור שמבוססת על משך השהייה, אתם עדיין יכולים ליהנות ממערך התכונות העשיר של ARI, בנוסף לרוחב הפס היעיל שמתקבל משימוש בעדכוני הזמינות וההגבלות הליליים.

נקודה חשובה: בכל נכס בחשבון צריך להשתמש בתעריפים לפי משך השהייה או בתעריפים לפי תאריך.

כדי להפעיל בחשבון שלכם תמחור לפי משך השהייה, פנו למנהל החשבונות הטכני או צרו איתנו קשר.

נקודה חשובה: כדי שהתמחור יהיה זמין, אתם צריכים לשלוח את ארבעת סוגי ההודעות (עסקה, מחיר, מלאי וזמינות). מומלץ להגביל את הגודל של הודעות ARI ספציפיות <OTA_HotelRateAmountNotifRQ> ל-5MB, עם מגבלה של 400 קבצים לשנייה בקצב ההעלאה. אל תשלחו כמה פעמים מידע על מסלול נסיעה בתאריך מסוים, עם חפיפה בין התאריכים, בהפרש של 3 שניות מההודעה האחרונה.

ב-ARI נעשה שימוש בהודעות הבקשה הבאות:

• Transaction (נתוני הנכס). הגדרת סוג המידע והחבילה (תוכנית התמחור).

• ‫OTA_HotelRateAmountNotifRQ. מגדיר את שיעורי התפוסה לכל מוצר (שילוב של סוג חדר ותוכנית מחירים) לפי תאריך או לפי משך השהייה, לטווחי תאריכים ספציפיים.

• ‫OTA_HotelAvailNotifRQ. מגדיר את הזמינות וההגבלות על סמך סוג החדר ותוכניות המחירים. אפשר גם לעדכן את מלאי החדרים באמצעות ההודעה הזו, אבל עדיף להשתמש ב-OTA_HotelInvCountNotifRQ.

• ‫OTA_HotelInvCountNotifRQ. מגדיר את המלאי הפיזי של החדרים או את מספר החדרים שזמינים למכירה.

• ‫TaxFeeInfo. (אופציונלי) הגדרת מיסים ועמלות לפי נכס. ההודעה הזו לא נדרשת אם AmountAfterTax מצוין בהודעה OTA_HotelRateAmountNotifRQ.

• ‫Promotions. (אופציונלי) מגדיר מחירים מבצעים להזמנות, לשהיות ולמשתמשים מסוימים.

• ‫RateModifications. (אופציונלי) הגדרה של כללים לשינוי מחירים להזמנות, לשהיות ולמשתמשים מסוימים.

• ‫ExtraGuestCharges. (אופציונלי) מגדיר איך צריך להגדיר את המחירים לילדים ולמבוגרים נוספים.

כל הודעה מכילה קבוצת משנה של מידע ש-Google משתמשת בו כדי לחשב את המחירים והזמינות שמוצגים למשתמשים כשהם מחפשים את הנכסים שלכם עם תאריכי צ'ק-אין וצ'ק-אאוט ספציפיים ותפוסה מסוימת.

נקודה חשובה: התכונות של ARI מוגבלות להודעות ולרכיבים שמתוארים במסמך הזה של הפניה ל-XML של מלאי ושל תמחור (ARI) ובמדריך ARI. כל הודעה, רכיב או מאפיין של OTA שלא מתועדים כאן באופן ספציפי לא נתמכים בהטמעה של ARI.

בנוסף, אין תמיכה ברכיבים אחרים של הודעות על עסקאות שלא נכללים בקובץ ה-XML הזה לעיון בנושא נתוני תמחור וחדרים פנויים (ARI), כשמשתמשים בפיד מסוג ARI.

‫Google ממשיכה לעדכן ולשפר את ה-API. אם אתם משתמשים בתכונות נוספות של תמחור במערכת שלכם, עליכם להודיע על כך לTechnology Account Manager(TAM) כדי שיוכל לתת עדיפות לתכונות האלה או ליידע אתכם אם יש תוכניות להוסיף אותן לגרסה.

היסטוריית הגרסאות של ARI XML Reference

בטבלה הבאה מפורטים עדכוני התיעוד שקשורים רק לשינויים בתכונות.

תאריך	השינויים
‫14 באוגוסט 2020	זו הגרסה הראשונה.
21 באוקטובר 2020	נוסף סוג ההודעה 'מבצעים'.
17 בנובמבר 2020	בהודעות על עסקאות (נתוני מלונות), עודכן endpoint והמאפיין action נוסף לרכיבי PropertyDataSet.
‫24 בנובמבר 2020	בהודעות על עסקאות (נתוני נכס), נוספו הרכיבים <AllowablePackageIDs> ו-<AllowableRoomIDs>.
4 בפברואר 2021	הוספנו הודעות תגובה.
25 בפברואר 2021	ההוספה של OTA_HotelInvCountNotifRQ בוצעה בהצלחה.
21 באוקטובר 2020	נוסף סוג ההודעה 'שינויים במחירים'.