درخواست‌ها
نحو
پیام 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 دارای عناصر و مشخصه‌های زیر است:
توجه: هر نوع محدودیت مدت اقامت به‌طور مستقل تنظیم می‌شود. برای مثال، پیامی که
SetMaxLOS را تنظیم می‌کند، مقدار قبلاً تعریف‌شده
برای SetForwardMaxStay را بازنویسی نمی‌کند.
| عنصر / @مشخصه | رویدادها | نوع | شرح |
|---|---|---|---|
| OTA_HotelAvailNotifRQ | 1 | Complex element | عنصر ریشه برای پیامی که دردسترس بودن نرخ اتاق را تعریف می‌کند. |
| OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | فضای نام XML. |
| OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | شناسه یکتای این پیام درخواست. این مقدار در پیام پاسخ برگردانده می‌شود. نویسه‌های مجاز عبارت‌اند از a-z،
A-Z، 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 است که در
صفحه تنظیمات حساب در Hotel Center فهرست شده است.
توجه: اگر باطن شما فیدهای چندین حساب را ارائه می‌دهد، این مقدار باید با مقدار مشخصه |
| 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> در پیام تراکنش‌ها (داده‌های ملک) نگاشت می‌شود. |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | شناسه یکتای طرح نرخ. این شناسه به مقدار <PackageID> در پیام «تراکنش (داده‌های دارایی)» نگاشت می‌شود. طرح نرخ در <StatusApplicationControl> در هر دو پیام <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> بیشتر تعریف شده و به آن ارجاع داده شده است.
مشخصه |
| OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | محتوی برای تعریف محدودیت‌های LOS. اگر <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>
برداشتن محدودیت‌های «طول اقامت»
تنظیم 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>
محدودیت خروج
محدودیت «بسته برای خروج» تنظیم کنید. (این کار از برنامه‌های سفر با تاریخ تصفیه‌حساب مشخص جلوگیری می‌کند.)
<?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 دارای عناصر و مشخصه‌های زیر است:
| عنصر / @مشخصه | رویدادها | نوع | شرح |
|---|---|---|---|
| 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 رخ داده است. جزئیات این خطاها را می‌توانید در
پیام‌های خطای وضعیت فید ببینید. |
| OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | EWT (نوع هشدار خطا) OpenTravel Alliance مرتبط با
خطا. فقط از مقدار 12 (Processing exception) استفاده می‌شود. |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | کد خطای OpenTravel Alliance (ERR) مرتبط با خطا.
فقط از مقدار 450 (Unable to process) استفاده می‌شود. |
| OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | وضعیت درخواست اصلی. فقط از مقدار
NotProcessed استفاده می‌شود. |
| OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | شناسه Google برای مشکل. جزئیات این خطاها را می‌توانید در پیام‌های خطای وضعیت فید پیدا کنید. |
مثال‌ها
موفقیت‌آمیز
در زیر پاسخی به پیام 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>