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

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

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

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

תמחור לפי LOS

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

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

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

כדי להפעיל תמחור מבוסס-LOS בחשבון, צריך לפנות למנהל החשבון הטכני (TAM) או לפנות אלינו.

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

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

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

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

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

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

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

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

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

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

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

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

כמו כן, אין תמיכה ברכיבי Transaction message אחרים שלא נכללים בחומר העזר בנושא XML Inventory & Pricing (ARI) הזה כשמשתמשים בסוג הפיד ARI.

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

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

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

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