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