הודעה על זמינות

סקירה כללית

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

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

הגבלת זמינות בלילה

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

הגדרות הגבלה

כברירת מחדל, RestrictionStatus עבור Restriction="Master" סגור. במילים אחרות, כברירת מחדל, יש 'הפסקת מכירה' בכל לילה.

כדי שמוצר יהיה זמין למכירה, צריך לציין את המחיר <RestrictionStatus Restriction="Master" Status="Open"> לכל שילובי המוצרים בכל הלילות של השהייה. אתם צריכים לשלוח ל-Google Open לכל מוצר או לשנות את ברירת המחדל ב-Hotel Center. כדי לעשות את זה, עוברים לדף Pricing > Settings (תמחור > הגדרות) ב-Hotel Center ועורכים את השדה default availability (זמינות ברירת מחדל).

הגבלות נוספות

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

הנחיות כלליות

  • הגבלות הזמינות מוגדרות לפי מלון, תאריך, סוג חדר ותוכנית מחירים.

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

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

דוגמה

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

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

מידע נוסף על שליחת ההודעה באמצעות push או POST זמין במאמר שליחת הודעות באמצעות push.

במאפיין HotelCode, משתמשים במזהה המלון הייחודי שבו השתמשתם במערכת שלכם כדי לזהות את הנכס. הערך הזה צריך להיות זהה למזהה המלון שצוין באמצעות התג <id> ברכיב <listing> בפיד רשימת המלונות. חשוב מאוד שהנתונים יהיו עקביים עם הנתונים במערכת שלכם כדי לוודא ש-Google מציגה את הנתונים בצורה נכונה.

בדוגמה הזו מוסבר איך להגדיר הגבלות על זמינות:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

דוגמאות נוספות מופיעות במאמר דוגמאות לזמינות.

מדריכים

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

תרחיש 1: איך מוכרים מוצרים בתאריכים ספציפיים

תיאור

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

.

פתרון

מגדירים את ההגבלה Master לערך Open ומציינים את התאריכים.

דוגמה

בדוגמה הזו אנחנו מראים איך לפתוח את הזמינות הלילית של מוצר למשך כמה שבועות בחודש מרץ.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

מידע נוסף על הגדרת תמחור זמין במאמר פתרון בעיות שקשורות לתמחור חסר או לא מלא.

תרחיש 2: איך מפסיקים למכור מוצרים בתאריכים ספציפיים

תיאור

אתם רוצים להפסיק את המכירה של מוצר מסוים בתאריכים ספציפיים (ולא רק לציין שהוא לא במלאי).

פתרון

מגדירים את ההגבלה Master לערך Close ומציינים את התאריכים.

דוגמה

בדוגמה הזו מוסבר איך להפסיק את המכירה של מוצר או לסגור את הזמינות שלו ללילה בתאריכים ספציפיים.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>