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 מציין שסוג החדר אזל. A שלילי המערכת תתייחס לערך הזה כאפס.
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>