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

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

סקירה כללית

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

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

בהדרכות מוצגות דוגמאות לתרחישים שונים שקשורים למלאי.

רכיבים נדרשים ואופציונליים

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

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

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

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

הנחיות

ההנחיות הבאות מיועדות להודעה על מלאי:

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

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

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

יכול להיות מצב של 'אין זמינות' גם כשיש מלאי, כי המלאי והזמינות לא תלויים זה בזה.

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

כדי להציג את מחיר המוצר, צריך לציין במלאי מספר שלם גדול מ-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>