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

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` של ההודעה בנושא העסקה (נתוני הנכס) ולערך המאפיין `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>` בהודעת עסקאות (נתוני נכס).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts	1	InvCounts	מאגר להגדרת ספירת מלאי אחת.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount	1	InvCount	ההגדרה הזו מגדירה את מספר החדרים הזמינים שאפשר להזמין.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count	1	integer	מספר החדרים הזמינים שאפשר להזמין לפי סוג החדר. הערך 0 מציין שסוג החדר אזל. ערך שלילי נחשב כאפס.
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	כרטיס OpenTravel Alliance EWT (סוג אזהרת שגיאה) המשויך לשגיאה. נעשה שימוש רק בערך `12 (Processing exception)`.
OTA_HotelInvCountNotifRS / Errors / Error / @Code	1	integer	קוד השגיאה OpenTravel Alliance ERR (קוד השגיאה) שמשויך לשגיאה. נעשה שימוש רק בערך `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>