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> به‌عنوان به‌روزرسانی هم‌پوشانی درنظر گرفته می‌شود. برای هر دارایی، تاریخ، و اتاق مشخص‌شده در <StatusApplicationControl>، هر تعداد موجودی که قبلاً تعریف شده است با مقدار جدید جایگزین می‌شود.

عناصر و مشخصه‌ها

پیام 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 فهرست شده است. توجه: اگر باطن شما فیدهای چندین حساب را ارائه می‌دهد، این مقدار باید با مقدار مشخصه partner پیام «تراکنش» (داده‌های دارایی) شما و مقدار مشخصه 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> در پیام تراکنش‌ها (داده‌های ملک) نگاشت می‌شود.
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: دردسترس بودن قطعی.

مثال‌ها

فضای آگهی باقی‌مانده

‫۵ اتاق برای 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 باموفقیت پردازش شده است. <Success> یا <Errors> در هر پیام وجود دارد.
OTA_HotelInvCountNotifRS / Errors	0..1	Errors	ظرفی برای یک یا چند مشکل که هنگام پردازش پیام OTA_HotelInvCountNotifRQ با آن مواجه شده‌اید. <Success> یا <Errors> در هر پیام وجود دارد.
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	کد خطای 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>