הודעה בנושא מלאי

סקירה כללית

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

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

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

רכיבי חובה ורכיבים אופציונליים

בהפניה ל-XML מופיעים תיאורים של הרכיבים הנדרשים והאופציונליים. פרטים על מאפיינים ורכיבי צאצא זמינים במאמר מאפיינים ורכיבי מלאי.

תחביר וסכימות

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

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

הנחיות

ההנחיות הבאות מתייחסות להודעות לגבי מלאי שטחי פרסום:

  • המלאי ממופתח לפי מלון, תאריך וסוג חדר.

  • כדי שהמחיר יוצג עבור תוכנית המחירים והתפוסה המשויכות, מספר החדרים הפנויים צריך להיות גדול מ-0 בכל הלילות של השהייה.

  • אם מספר החדרים הפנויים שווה ל-0, אי אפשר יהיה להזמין חדרים עם מזהה החדר וטווח התאריכים שצוינו.

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

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

מלאי לעומת זמינות

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

יכול להיות שאין זמינות גם אם יש מלאי, כי המלאי והזמינות הם נתונים נפרדים.

יש שני מושגים שקשורים לזמינות. קודם כל, יש את הזמינות הכוללת של מוצר לשהייה מסוימת, שמושפעת מגורמים כמו האם לכל לילה מוגדר מחיר, המלאי של סוג החדר המשויך והאם הגבלת הזמינות פתוחה. בנוסף, יש הגבלה ספציפית על מוצר בתאריך מסוים, שמיוצגת על ידי <RestrictionStatus Restriction="Master" Status="Open"/> ב-OTA_HotelAvailNotifRQ. סגירת הזמינות הזו נקראת 'הפסקת מכירה'.

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

דוגמה

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

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

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

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

בדוגמה הזו מוסבר איך להגדיר מלאי של 13 חדרים שניתנים להזמנה לחודש דצמבר:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

דוגמאות נוספות מופיעות במאמר דוגמאות למלאי שטחי פרסום.

מדריכים

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

תרחיש: איך חוסמים הזמנות של חדרים

תיאור

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

פתרון

מגדירים את <InvCount Count> לערך 0 ומוסיפים את טווח התאריכים הרצוי.

דוגמה

בדוגמה הזו מוסבר איך להשתמש ב-InvCount כדי להגדיר את מלאי החדרים ל-0 עבור החדר והתאריכים שצוינו (לדוגמה, השבועות הראשונים בינואר).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>