درخواستها
نحو
پیام OTA_HotelAvailNotifRQ از سینتکس زیر استفاده میکند:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<AvailStatusMessages HotelCode="HotelID">
<AvailStatusMessage BookingLimit="integer">
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"
RatePlanCode="PackageID"/>
<LengthsOfStay FixedPatternLength="integer">
<LengthOfStay Time="integer"
TimeUnit="[Day]"
MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
SetForwardMinStay|FullPatternLOS]">
<LOS_Pattern FullPatternLOS="pattern"/>
</LengthOfStay>
</LengthsOfStay>
<RestrictionStatus Status="[Close|Open]"
Restriction="[Arrival|Departure|Master]"
MaxAdvancedBookingOffset="integer_or_duration"
MinAdvancedBookingOffset="integer_or_duration"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
هر پیام <OTA_HotelAvailNotifRQ> به عنوان یک بهروزرسانی دلتا در نظر گرفته میشود. برای هر ملک، تاریخ، اتاق و بسته مشخص شده در <StatusApplicationControl> ، بهروزرسانی هر محدودیت تعریفشده قبلی فقط مقدار همان محدودیت را جایگزین میکند، در حالی که اضافه کردن محدودیت جدید بر سایر محدودیتهای تعریفشده قبلی تأثیری ندارد. به عنوان مثال، اگر حداقل مدت اقامت قبلاً ۲ روز تعریف شده باشد و سپس یک پیام جدید حاوی حداکثر مدت اقامت ۷ روز بهروزرسانی شود، این اقدام مقدار حداقل مدت اقامت قبلی را پاک نمیکند.
عناصر و ویژگیها
پیام OTA_HotelAvailNotifRQ دارای عناصر و ویژگیهای زیر است:
| عنصر / @Attribute | رخدادها | نوع | توضیحات |
|---|---|---|---|
| OTA_HotelAvailNotifRQ | 1 | Complex element | عنصر ریشه برای پیامی که نرخ اتاق در دسترس را تعریف میکند. |
| OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | فضای نام XML. |
| OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | یک شناسه منحصر به فرد برای این پیام درخواست. این مقدار در پیام پاسخ برگردانده میشود. کاراکترهای مجاز عبارتند از az ، AZ ، 0-9 ، _ (زیرخط) و - (خط تیره). |
| OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | تاریخ و زمان ایجاد این پیام. |
| OTA_HotelAvailNotifRQ / @Version | 1 | decimal | نسخه پیام OpenTravel. |
| OTA_HotelAvailNotifRQ / POS | 0..1 | POS | یک محفظه برای مشخص کردن حساب همکار برای این پیام. معمولاً اگر بکاند شما فیدهای قیمت را برای چندین حساب همکار ارائه میدهد، از آن استفاده میشود. |
| OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | در صورت وجود <POS> الزامی است. یک ظرف برای <RequestorID> . |
| OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | در صورت وجود <POS> الزامی است. حساب همکار را تعریف میکند. |
| OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | string | حساب کاربری همکار برای این پیام. این مقدار رشتهای، مقدار Partner key است که در صفحه تنظیمات حساب کاربری در مرکز هتل فهرست شده است. توجه: اگر یک backend دارید که برای چندین حساب فید ارائه میدهد، این مقدار باید با مقدار ویژگی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | یک ظرف برای یک یا چند عنصر <AvailStatusMessage> . |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | string | شناسه منحصر به فرد برای ملک. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید فهرست هتل مطابقت داشته باشد. شناسه هتل همچنین در مرکز هتل فهرست شده است. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | نرخ اتاقهای در دسترس و محدودیتهای آن را برای بازههای زمانی مختلف برای یک ملک واحد تعریف میکند. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer | توجه: پیام OTA_HotelInvCountNotifRQ نسبت به تنظیم این ویژگی ارجحیت دارد. تعداد اتاقهای باقیمانده که میتوانند برای محدوده تاریخ در باید مساوی یا بزرگتر از ۰ باشد. اگر منفی باشد یا ارائه نشود، پیشفرض ۰ است. نکته: برای تعیین در دسترس بودن اتاق برای یک تنظیم |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | محدوده تاریخ و همچنین شناسههای نوع اتاق — InvTypeCode و طرح نرخ — RatePlanCode را تعریف میکند. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Date | تاریخ شروع بر اساس منطقه زمانی ملک که شامل محدوده تاریخ نیز میشود. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | تاریخ پایان (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. باید برابر یا بزرگتر از مقدار start باشد. اگر start و end برابر باشند، بهروزرسانی برای آن تاریخ اعمال میشود. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | boolean | برای اینکه دوشنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | برای اینکه سهشنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | برای اینکه چهارشنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | برای اینکه پنجشنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | برای اینکه جمعهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | برای اینکه صریحاً شنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | برای اینکه یکشنبهها را هم شامل شود، روی true یا 1 تنظیم کنید. اگر روی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | string | شناسه منحصر به فرد برای موجودی (نوع اتاق). این مقدار به <RoomID> در یک پیام Transactions (Property Data) نگاشت میشود. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | یک شناسه منحصر به فرد برای طرح نرخ. این شناسه به مقدار <PackageID> در یک پیام تراکنش (دادههای ویژگی) نگاشت میشود. طرح نرخ در <StatusApplicationControl> در هر دو پیام <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> بیشتر تعریف و به آن اشاره میشود. ویژگی |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | یک ظرف برای تعریف محدودیتهای سطح سرویس. اگر <AvailStatusMessage> شامل ویژگی BookingLimit باشد، نباید وجود داشته باشد. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | طول الگوی تعریف شده در FullPatternLOS . نکته: این ویژگی باید هنگام استفاده از |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | محدودیتهایی را برای مدت زمان اقامت تعریف میکند. هنگام استفاده از بیش از یک عنصر <LengthOfStay> ، هر کدام باید مقدار MinMaxMessageType متفاوتی را مشخص کنند. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 0..1 | integer | مقدار واحد اندازهگیری مدت زمان اقامت. توجه داشته باشید که مقدار صفر به عنوان بدون محدودیت در نظر گرفته میشود. برای مثال، <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> به معنی بدون حداکثر مدت اقامت است. توجه: این ویژگی باید تنظیم شود، مگر اینکه از |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | واحد زمان. در صورت عدم ارائه، به صورت پیشفرض روی "Day" تنظیم میشود. مقدار معتبر:
"Day" معادل ۱ شب اقامت است. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | enum | انواع مختلف محدودیتهای مدت اقامت. SetMaxLOS ، SetMinLOS و FullPatternLOS مبتنی بر ورود هستند. SetForwardMinStay و SetForwardMaxStay مبتنی بر ماندن در طول مسیر هستند. حداکثر مقادیر باید بزرگتر یا مساوی حداقل مقادیر باشند. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern | 0..1 | LOS_Pattern | الگوی محدودیت طول مدت اقامت را تعریف میکند. نکته: این عنصر باید هنگام استفاده از |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | دنبالهای از Y و N کاراکتر که نشان میدهد آیا هر مدت اقامت مجاز است یا خیر، از یک شب تا مقداری که در FixedPatternLength قرار دارد. هر مدت اقامتی که بزرگتر از FixedPatternLength باشد، مقدار را در موقعیت نهایی به ارث میبرد. برای مثال، با FixedPatternLength="4" و FullPatternLOS="YNYN" ، فقط مدت اقامتهای ۱ و ۳ مجاز هستند. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | محدودیتهای مسیر سفر را تعریف میکند. اگر <AvailStatusMessage> شامل ویژگی BookingLimit باشد، نباید وجود داشته باشد. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | enum | نشان میدهد که آیا نوع محدودیت مشخص شده توسط ویژگی Restriction باز است یا بسته. مقادیر معتبر عبارتند از:
مقادیر Open و Close با Arrival : این ترکیب مشخص میکند که کدام تاریخها در برنامه سفر برای ورود در دسترس هستند.Open و Close با Departure : این ترکیب مشخص میکند که کدام تاریخها در برنامه سفر برای خروج در دسترس هستند. تاریخ برای مثال، برای اقامت از ۱ تا ۴ آوریل که ۲ تا ۴ آوریل به دلیل بسته بودن ورودیها، هنوز قابل رزرو است. توجه:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | این ویژگی در صورت ارائه مقادیر معتبر عبارتند از:
هر دو برای مثال، برای اقامت سه شبه با تاریخ ورود ۱ آوریل، برنامه کامل سفر ۱ تا ۴ آوریل است. برای اقامت شبانه از ۱ تا ۳ آوریل، مقدار توجه: اگر |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | حداقل مدت زمان قبل از تاریخ ورود (به وقت محلی هتل) که میتوان این نرخ اتاق را رزرو کرد. انواع مقادیر معتبر عبارتند از:
|
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | حداکثر مدت زمان قبل از تاریخ ورود (به وقت محلی هتل) که میتوان این نرخ اتاق را رزرو کرد. انواع مقادیر معتبر عبارتند از:
|
مثالها
تاریخ ورود LoS
حداقل و حداکثر مدت اقامت (بر اساس تاریخ ورود) را تعیین کنید.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
<LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
مدت زمان LoS
حداقل و حداکثر مدت اقامت (بر اساس مدت اقامت) را تعیین کنید.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
<LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیتهای LoS را حذف کنید
تنظیم Time="0" در <LengthOfStay> نشان میدهد که هیچ محدودیتی برای مدت زمان مشخص شده برای اقامت وجود ندارد. برای مثال، <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> به این معنی است که هیچ محدودیتی برای حداکثر مدت اقامت وجود ندارد.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2024-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2024-07-26"
End="2024-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیت خروج
محدودیت خروج از هتل (closed-to-go) تعیین کنید. (این کار از برنامههای سفری که در تاریخهای مشخصشده، امکان خروج وجود ندارد، جلوگیری میکند.)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیت ورود
محدودیت ورود بدون محدودیت تعیین کنید. (این کار از ورود برنامههای سفر با تاریخهای مشخصشده جلوگیری میکند.)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
تاریخهای در دسترس بودن باز
امکان رزرو اتاق با نوع و نرخ مشخص در تاریخهای مشخص شده.
توجه: قبل از اینکه قیمتها بهطور کامل در دسترس قرار گیرند، نرخهای هر شب به همراه تعداد موجودی بیشتر از ۰ برای نوع اتاق نیز مورد نیاز است.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
تاریخهای موجود را ببندید
در تاریخهای مشخصشده، موجودی یک نوع اتاق و طرح نرخ را ببندید. (این روش به عنوان "توقف فروش" نیز شناخته میشود.)
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیتهای رزرو از قبل
محدودیتهای حداقل و حداکثر پنجره رزرو پیشرفته را تنظیم کنید، که فقط در آخر هفتهها اعمال میشود.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
Mon=”false”
Tue=”false”
Weds=”false”
Thur=”false”
Fri=”false”
Sat=”true”
Sun=”true”
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MaxAdvancedBookingOffset="30"
MinAdvancedBookingOffset="2"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
رزرو قطعی
برای رزرو، در تاریخ ورود ساعت ۱۸:۰۰ به وقت محلی هتل، آخرین مهلت را اعمال کنید.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیتهای متعدد
برای یک نوع اتاق و طرح نرخ، چندین محدودیت در تاریخهای یکسان تعیین کنید.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
محدودیت رزرو
تعداد موجودی را برای یک نوع اتاق در تاریخهای مشخصشده تنظیم کنید.
توجه: پیام OTA_HotelInvCountNotifRQ نسبت به تنظیم این ویژگی ارجحیت دارد.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage BookingLimit="5">
<!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
FullPatternLoS
یک محدودیت کامل برای مدت اقامت تعیین کنید.
برای ورود به هتل در تاریخ ۲۶ جولای ۲۰۲۳، فقط مدت اقامتهای ۲، ۴ و ۶ روز مجاز است. مدت اقامتهای ۱، ۳، ۵ و ۷+ روز در دسترس نیست.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-26"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay FixedPatternLength="7">
<LengthOfStay MinMaxMessageType="FullPatternLOS">
<LOS_Pattern FullPatternLOS="NYNYNYN"/>
</LengthOfStay>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
پاسخها
نحو
پیام OTA_HotelAvailNotifRS از سینتکس زیر استفاده میکند:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS 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_HotelAvailNotifRS>
عناصر و ویژگیها
پیام OTA_HotelAvailNotifRS دارای عناصر و ویژگیهای زیر است:
| عنصر / @Attribute | رخدادها | نوع | توضیحات |
|---|---|---|---|
| OTA_HotelAvailNotifRS | 1 | Complex element | عنصر ریشه برای پاسخ به پیام در دسترس بودن. |
| OTA_HotelAvailNotifRS / @TimeStamp | 1 | DateTime | تاریخ و زمان ایجاد این پیام. |
| OTA_HotelAvailNotifRS / @EchoToken | 1 | string | شناسه منحصر به فرد از پیام مرتبط OTA_HotelAvailNotifRQ . |
| OTA_HotelAvailNotifRS / Success | 0..1 | Success | نشان میدهد که پیام OTA_HotelAvailNotifRQ با موفقیت پردازش شده است. در هر پیام یا |
| OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | یک محفظه برای یک یا چند مشکل پیش آمده هنگام پردازش پیام OTA_HotelAvailNotifRQ . در هر پیام یا |
| OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | شرح خطایی که هنگام پردازش پیام OTA_HotelAvailNotifRQ رخ داده است. جزئیات مربوط به این خطاها را میتوانید در پیامهای خطای وضعیت فید (Feed Status Error Messages) بیابید. |
| OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | نوع هشدار خطا (EWT) اتحاد OpenTravel که با خطا مرتبط است. فقط از مقدار 12 (Processing exception) استفاده میشود. |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | کد خطای (ERR) مربوط به خطای OpenTravel Alliance. فقط از مقدار 450 (Unable to process) استفاده میشود. |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | وضعیت درخواست اصلی. فقط مقدار NotProcessed استفاده میشود. |
| OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | شناسه گوگل برای این مشکل. جزئیات مربوط به این خطاها را میتوانید در پیامهای خطای وضعیت فید (Feed Status Error Messages) بیابید. |
مثالها
موفقیت
در ادامه پاسخی به پیام OTA_HotelAvailNotifRQ که با موفقیت پردازش شده است، آمده است.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Success/>
</OTA_HotelAvailNotifRS>
خطاها
پاسخ زیر به پیام OTA_HotelAvailNotifRQ است که به دلیل خطا پردازش نشده است.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Errors>
<Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
</Errors>
</OTA_HotelAvailNotifRS>