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

סקירה כללית

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