בקשות
תחביר
ההודעה 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.
הערה: אם יש לכם קצה עורפי שמספק פידים לכמה חשבונות, הערך הזה צריך להתאים לערך המאפיין |
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> בהודעת עסקאות
(נתוני נכס). |
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 | הסוג של ספירת המלאי שצוין. הערך החוקי הוא:
|
דוגמאות
מלאי שנותר
ההגדרה הזו מגדירה 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
עובדה בהצלחה.
כל הודעה כוללת את |
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>