OTA_HotelInvCountNotifRQ

בקשות

תחביר

התחביר של ההודעה OTA_HotelInvCountNotifRQ הוא:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

רכיבים ומאפיינים

להודעה OTA_HotelInvCountNotifRQ יש את המאפיינים והרכיבים הבאים:

רכיב / @Attribute מופעים סוג תיאור
OTA_HotelInvCountNotifRQ 1 Complex element רכיב הבסיס של הודעה שמגדירה את הזמינות של מחירי החדרים.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) מרחב השמות של ה-XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string מזהה ייחודי של הודעת הבקשה הזו. הערך הזה מוחזר בהודעת התגובה. התווים המותרים הם a-z,‏ A-Z,‏ 0-9,‏ ‎_ (קו תחתון) ו-‎- (מקף).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime התאריך והשעה שבהם נוצרה ההודעה הזו.
OTA_HotelInvCountNotifRQ / @Version 1 decimal גרסת ההודעה ב-OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS מאגר לציון חשבון השותף של ההודעה הזו (בדרך כלל משמש אם הקצה העורפי מספק פידים של מחירים לכמה חשבונות שותפים).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source חובה אם השדה <POS> קיים. מאגר של <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID חובה אם השדה <POS> קיים. מגדיר את חשבון השותף.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string חשבון השותף של ההודעה הזו. ערך המחרוזת הזה הוא הערך של מפתח השותף שמופיע ב דף הגדרות החשבון ב-Hotel Center.

הערה: אם יש לכם קצה עורפי שמספק פידים לכמה חשבונות, הערך הזה צריך להיות זהה לערך של המאפיין partner בהודעה Transaction (נתוני הנכס) ולערך של המאפיין ID ברכיב <RequestorID> בהודעה <OTA_HotelRateAmountNotifRQ> באותו חשבון.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories קונטיינר של רכיב <Inventory> אחד או יותר.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string המזהה הייחודי של הנכס. הערך הזה צריך להתאים למזהה המלון שצוין באמצעות <id> ברכיב <listing> בפיד רשימת המלונות. מזהה המלון מופיע גם ב-Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory הגדרת מספר החדרים הזמינים בטווחי זמן שונים בנכס יחיד.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl מגדיר את טווח התאריכים ואת המזהה של סוג החדר (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date תאריך ההתחלה (על סמך אזור הזמן של הנכס), כולל, של טווח התאריכים.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date תאריך הסיום (לפי אזור הזמן של הנכס), כולל טווח התאריכים. הערך חייב להיות שווה לערך של start או גדול ממנו. אם הערכים של start ו-end זהים, העדכון יחול על התאריך הזה.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש את ימי שני.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול במפורש את ימי שלישי.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש את ימי רביעי.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי חמישי.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול במפורש את ימי שישי.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי שבת.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean מגדירים את הערך כ-true או כ-1 כדי לכלול באופן מפורש ימי ראשון.

אם הערך מוגדר כ-true, ימים אחרים בשבוע שלא מוגדרים במפורש כ-true יוצאו משיקול (למעשה, הם מסוננים מהתאריכים ב-Start וב-End).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string המזהה הייחודי של מלאי שטחי הפרסום (סוג החדר). הערך הזה ממופה לערך <RoomID> בהודעה Transactions (נתוני נכס).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts מאגר להגדרת מספר מלאי יחיד.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount מגדיר את מספר החדרים הזמינים שאפשר להזמין.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer מספר החדרים הזמינים שאפשר להזמין לפי סוג החדר. ערך אפס מציין שסוג החדר אזל. ערך שלילי מטופל כאפס.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

סוג הספירה של מלאי שטחי הפרסום שצוין. הערך החוקי הוא:

  • 2: זמינות מובטחת.

דוגמאות

מלאי שטחי הפרסום שנותר

מגדיר 5 חדרים שנותרו ל-RoomID_1 בתאריכים שצוינו.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

מלאי שטחי פרסום שמוצגים כמלאי אזל

סימון RoomID_1 כמלאי אזל בתאריכים שצוינו.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

תשובות

תחביר

התחביר של ההודעה OTA_HotelInvCountNotifRS הוא:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

רכיבים ומאפיינים

להודעה OTA_HotelInvCountNotifRS יש את המאפיינים והרכיבים הבאים:

רכיב / @Attribute מופעים סוג תיאור
1 Complex element רכיב הבסיס של תשובה להודעת זמינות.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime התאריך והשעה שבהם נוצרה ההודעה הזו.
OTA_HotelInvCountNotifRS / @EchoToken 1 string המזהה הייחודי מההודעה המשויך OTA_HotelInvCountNotifRQ.
OTA_HotelInvCountNotifRS / Success 0..1 Success הקוד הזה מציין שההודעה OTA_HotelInvCountNotifRQ טופלה בהצלחה.

השדה <Success> או השדה <Errors> נמצאים בכל הודעה.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors מאגר של בעיה אחת או יותר שנתקלו בהן במהלך עיבוד ההודעה OTA_HotelInvCountNotifRQ.

השדה <Success> או השדה <Errors> נמצאים בכל הודעה.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error תיאור השגיאה שנתקלו בה במהלך עיבוד ההודעה OTA_HotelInvCountNotifRQ. פרטים על השגיאות האלה מופיעים במאמר הודעות שגיאה לגבי סטטוס הפיד.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer סוג האזהרה על השגיאה (EWT) של OpenTravel Alliance שמשויכת לשגיאה. המערכת משתמשת רק בערך 12 (Processing exception).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer קוד השגיאה (ERR) של OpenTravel Alliance שמשויך לשגיאה. המערכת משתמשת רק בערך 450 (Unable to process).
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum הסטטוס של הבקשה המקורית. המערכת משתמשת רק בערך NotProcessed.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string המזהה של Google לבעיה. פרטים על השגיאות האלה מופיעים במאמר הודעות שגיאה לגבי סטטוס הפיד.

דוגמאות

הפעולה הצליחה

זוהי תגובה להודעת OTA_HotelInvCountNotifRQ שעברה עיבוד בהצלחה.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

שגיאות

זוהי תגובה להודעת OTA_HotelInvCountNotifRQ שלא טופלה בגלל שגיאות.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>