דף זה תורגם על ידי Cloud Translation API.

הודעה לגבי המלאי

סקירה כללית

הודעת המלאי (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

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

ב-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>