בקשות
תחביר
ההודעה 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 חדרים פנויים ל-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 עובדה בהצלחה.
הערך |
| OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | גורם מכיל לבעיה אחת או יותר שזוהו במהלך העיבוד של ההודעה OTA_HotelInvCountNotifRQ.
הערך |
| 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>