Requests
תחביר
ההודעה 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.
הערה: אם יש לכם קצה עורפי שמספק פידים למספר חשבונות, הערך הזה צריך להיות זהה לערך המאפיין |
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 כדי לכלול במפורש את ימי שני.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | יש להגדיר כ-true או כ-1 כדי לכלול במפורש את ימי שלישי.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | יש להגדיר כ-true או כ-1 כדי לכלול במפורש את ימי רביעי.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | צריך להגדיר את הערך true או 1 כדי לכלול את ימי חמישי באופן מפורש.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | יש להגדיר כ-true או כ-1 כדי לכלול במפורש את ימי שישי.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | צריך להגדיר את הערך true או 1 כדי לכלול מפורשות את ימי שבת.
אם המדיניות מוגדרת לערך |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | צריך להגדיר כ-true או כ-1 כדי לכלול במפורש את ימי ראשון.
אם המדיניות מוגדרת לערך |
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 | הסוג של ספירת המלאי שצוינה. הערך החוקי הוא:
|
דוגמאות
מלאי שטחי הפרסום שנותר
מגדיר 5
rooms left for
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 | הרכיב הבסיסי (root) של תשובה להודעת זמינות. | |
OTA_HotelInvCountNotifRS / @TimeStamp | 1 | DateTime | התאריך והשעה שבהם ההודעה נוצרה. |
OTA_HotelInvCountNotifRS / @EchoToken | 1 | string | המזהה הייחודי מהודעת OTA_HotelInvCountNotifRQ המשויכת. |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | מציין שההודעה OTA_HotelInvCountNotifRQ עובדה בהצלחה.
בכל הודעה יש את |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | מאגר של בעיה אחת או יותר שזוהו במהלך עיבוד ההודעה
OTA_HotelInvCountNotifRQ .
בכל הודעה יש את |
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>