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 כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @מאפיין מופעים סוג תיאור
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 (Property Data).
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 כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @מאפיין מופעים סוג תיאור
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>