درخواست ها
نحو
پیام 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 | یک شناسه منحصر به فرد برای این پیام درخواست. این مقدار در پیام پاسخ برگردانده می شود. کاراکترهای مجاز عبارتند از: az، AZ، 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 | حساب شریک برای این پیام. این مقدار رشته، مقدار کلید شریک لیست شده در صفحه تنظیمات حساب در مرکز هتل است. توجه: اگر یک Backend دارید که برای چندین حساب فید ارائه میدهد، این مقدار باید با مقدار ویژگی |
OTA_HotelInvCountNotifRQ / Inventories | 1 | Inventories | ظرفی برای یک یا چند عنصر <Inventory> . |
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode | 1 | string | شناسه منحصر به فرد ملک این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> فید لیست هتل مطابقت داشته باشد. شناسه هتل نیز در مرکز هتل درج شده است. |
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 | شناسه منحصر به فرد موجودی (نوع اتاق). این مقدار در پیام Transactions (Property Data) به <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 | تعداد اتاق های موجود که می توان برای نوع اتاق رزرو کرد. مقدار صفر نشان می دهد که نوع اتاق فروخته شده است. یک مقدار منفی به عنوان صفر در نظر گرفته می شود. |
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>