OTA_HotelInvCountNotifRQ

درخواست‌ها

نحو

پیام 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 دارید که برای چندین حساب فید ارائه می‌دهد، این مقدار باید با مقدار ویژگی partner در پیام Transaction (Property Data) و مقدار ویژگی ID در عنصر <RequestorID> در پیام <OTA_HotelRateAmountNotifRQ> برای همان حساب مطابقت داشته باشد.

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 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean برای اینکه سه‌شنبه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean برای اینکه چهارشنبه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean برای اینکه پنجشنبه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean برای اینکه جمعه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean برای اینکه صریحاً شنبه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean برای اینکه یکشنبه‌ها را هم شامل شود، روی true یا 1 تنظیم کنید.

اگر روی true تنظیم شود، سایر روزهای هفته که صریحاً روی true تنظیم نشده‌اند، حذف می‌شوند (در واقع، آنها از تاریخ‌های داخل Start و End فیلتر می‌شوند).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string شناسه منحصر به فرد برای موجودی (نوع اتاق). این مقدار به <RoomID> در یک پیام Transactions (Property Data) نگاشت می‌شود.
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

نوع شمارش موجودی مشخص شده است. مقدار معتبر:

  • 2 : موجود بودن قطعی.

مثال‌ها

موجودی باقی مانده

در تاریخ‌های داده شده، 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 با موفقیت پردازش شده است.

در هر پیام یا <Success> یا <Errors> وجود دارد.

OTA_HotelInvCountNotifRS / Errors 0..1 Errors یک محفظه برای یک یا چند مشکل پیش آمده هنگام پردازش پیام OTA_HotelInvCountNotifRQ .

در هر پیام یا <Success> یا <Errors> وجود دارد.

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error شرح خطایی که هنگام پردازش پیام OTA_HotelInvCountNotifRQ رخ داده است. جزئیات مربوط به این خطاها را می‌توانید در پیام‌های خطای وضعیت فید (Feed Status Error Messages) بیابید.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer نوع هشدار خطا (EWT) اتحاد OpenTravel که با خطا مرتبط است. فقط از مقدار 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 شناسه گوگل برای این مشکل. جزئیات مربوط به این خطاها را می‌توانید در پیام‌های خطای وضعیت فید (Feed Status Error Messages) بیابید.

مثال‌ها

موفقیت

در ادامه پاسخی به پیام 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>