این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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` پیام تراکنش (داده‌های ویژگی) و مقدار ویژگی `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	شناسه منحصر به فرد موجودی (نوع اتاق). این مقدار در پیام 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	نوع شمارش موجودی مشخص شده است. مقدار معتبر: `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` رخ داد. جزئیات مربوط به این خطاها را می‌توانید در پیام‌های خطای وضعیت فید مشاهده کنید.
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>