OTA_HotelAvailNotifRQ

अनुरोध

सिंटैक्स

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 के लिए पहले से तय की गई वैल्यू को ओवरराइट नहीं करता.

Element / @Attribute आवृत्तियां टाइप ब्यौरा
OTA_HotelAvailNotifRQ 1 Complex element यह एक मैसेज का रूट एलिमेंट है. इससे कमरे के किराये की उपलब्धता के बारे में पता चलता है.
OTA_HotelAvailNotifRQ / @xmlns 0..1 string (URI) एक्सएमएल नेमस्पेस.
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 यह मैसेज किस पार्टनर खाते के लिए है. यह स्ट्रिंग वैल्यू, Hotel Center में खाते की सेटिंग वाले पेज पर दी गई Partner key वैल्यू होती है.

ध्यान दें: अगर आपके पास ऐसा बैकएंड है जो एक से ज़्यादा खातों के लिए फ़ीड उपलब्ध कराता है, तो यह वैल्यू आपके लेन-देन (प्रॉपर्टी डेटा) मैसेज के partner एट्रिब्यूट की वैल्यू से मेल खानी चाहिए. साथ ही, यह वैल्यू उसी खाते के लिए <OTA_HotelRateAmountNotifRQ> मैसेज के <RequestorID> एलिमेंट में मौजूद ID एट्रिब्यूट की वैल्यू से भी मेल खानी चाहिए.
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages एक या उससे ज़्यादा <AvailStatusMessage> एलिमेंट के लिए कंटेनर.
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 string प्रॉपर्टी के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू, होटल सूची फ़ीड में <id> का इस्तेमाल करके तय किए गए होटल आईडी से मेल खानी चाहिए. यह आईडी, <listing> एलिमेंट में मौजूद होता है. होटल आईडी, Hotel Center में भी दिखता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1..n AvailStatusMessage इस एट्रिब्यूट का इस्तेमाल करके, किसी एक प्रॉपर्टी के लिए अलग-अलग समयसीमाओं के हिसाब से, कमरे के किराये की उपलब्धता और पाबंदियों के बारे में बताया जा सकता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 integer ध्यान दें: इस एट्रिब्यूट को सेट करने के बजाय, OTA_HotelInvCountNotifRQ मैसेज का इस्तेमाल करना बेहतर होता है.

<StatusApplicationControl> में तारीख की सीमा के लिए बुक किए जा सकने वाले बचे हुए कमरों की संख्या. अगर BookingLimit की वैल्यू दी गई है, तो <StatusApplicationControl> की वैल्यू में InvTypeCode की वैल्यू देना ज़रूरी है. साथ ही, <AvailStatusMessage> की वैल्यू में <LengthOfStay> या <RestrictionStatus> की वैल्यू नहीं दी जा सकती.

यह वैल्यू 0 के बराबर या इससे ज़्यादा होनी चाहिए. अगर वैल्यू नेगेटिव है या नहीं दी गई है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू 0 होती है.

ध्यान दें: किसी <StatusApplicationControl> सेटिंग के लिए कमरे की उपलब्धता तय करने के लिए, BookingLimit एट्रिब्यूट को कम से कम एक बार सेट करना ज़रूरी है.
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 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर `true` पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें true में दी गई तारीखों से फ़िल्टर कर दिया जाता हैStart and End).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0..1 boolean मंगलवार को साफ़ तौर पर शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें Start और End के बीच की तारीखों से फ़िल्टर करके हटा दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0..1 boolean बुधवार को साफ़ तौर पर शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें Start और End के बीच की तारीखों से फ़िल्टर करके हटा दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0..1 boolean गुरुवार को शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें Start और End के बीच की तारीखों से फ़िल्टर करके हटा दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0..1 boolean शुक्रवार को शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें Start और End के बीच की तारीखों से फ़िल्टर करके हटा दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0..1 boolean शनिवार को शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें शुरू होने की तारीख और End के बीच की तारीखों से फ़िल्टर कर दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0..1 boolean रविवार को साफ़ तौर पर शामिल करने के लिए, इसे true या 1 पर सेट करें.

अगर इसे true पर सेट किया जाता है, तो हफ़्ते के उन दिनों को शामिल नहीं किया जाता जिन्हें साफ़ तौर पर true पर सेट नहीं किया गया है. इसका मतलब है कि उन्हें Start और End के बीच की तारीखों से फ़िल्टर करके हटा दिया जाता है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 string इन्वेंट्री (कमरे का टाइप) के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू, Transactions (Property Data) मैसेज में <RoomID> पर मैप करती है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0..1 string किराया प्लान के लिए यूनीक आइडेंटिफ़ायर. यह आइडेंटिफ़ायर, लेन-देन (प्रॉपर्टी का डेटा) मैसेज में मौजूद <PackageID> की वैल्यू पर मैप करता है. रेट प्लान के बारे में ज़्यादा जानकारी दी गई है और <StatusApplicationControl> में इसका रेफ़रंस दिया गया है. यह जानकारी <OTA_HotelRateAmountNotifRQ> और <OTA_HotelAvailNotifRQ>, दोनों तरह के मैसेज में दी गई है.

RatePlanCode एट्रिब्यूट लागू नहीं होता. साथ ही, जब <AvailStatusMessage> में BookingLimit एट्रिब्यूट शामिल हो, तब इसकी वैल्यू सबमिट नहीं की जानी चाहिए. अगर <RestrictionStatus> या <LengthOfStay> की जानकारी दी गई है, तो इसे शामिल करना ज़रूरी है.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0..1 LengthsOfStay एलओएस की पाबंदियां तय करने के लिए एक कंटेनर. अगर <AvailStatusMessage> में BookingLimit एट्रिब्यूट शामिल है, तो यह मौजूद नहीं होना चाहिए.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength 0..1 integer FullPatternLOS में तय किए गए पैटर्न की लंबाई.

ध्यान दें: MinMaxMessageType="FullPatternLOS" का इस्तेमाल करते समय, इस एट्रिब्यूट को सेट करना ज़रूरी है. ऐसा न करने पर, इसे शामिल न करें.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1..n LengthOfStay यह कुकी, होटल में ठहरने की अवधि से जुड़ी पाबंदियों के बारे में बताती है. एक से ज़्यादा <LengthOfStay> एलिमेंट का इस्तेमाल करते समय, हर एलिमेंट में <LengthOfStay> की अलग वैल्यू होनी चाहिए.MinMaxMessageType
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 0..1 integer ठहरने की कुल अवधि के मेज़रमेंट की यूनिट वैल्यू. ध्यान दें कि शून्य की वैल्यू को कोई पाबंदी नहीं माना जाता. उदाहरण के लिए, <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"> का मतलब है कि ठहरने की कोई ज़्यादा से ज़्यादा अवधि नहीं है.

ध्यान दें: MinMaxMessageType="FullPatternLOS" का इस्तेमाल न करने पर, इस एट्रिब्यूट को सेट करना ज़रूरी है.

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0..1 enum समय की इकाई. अगर वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट रूप से इसकी वैल्यू "Day" होती है. मान्य वैल्यू:
  • 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 इससे ठहरने की अवधि से जुड़ी पाबंदी के पैटर्न के बारे में पता चलता है.

ध्यान दें: MinMaxMessageType="FullPatternLOS" का इस्तेमाल करते समय, इस एलिमेंट का मौजूद होना ज़रूरी है. हालांकि, इसका इस्तेमाल न करने पर, यह एलिमेंट मौजूद नहीं होना चाहिए.

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

Open और Close वैल्यू, <Restriction> एलिमेंट की सभी वैल्यू के साथ काम करती हैं. Arrival और Departure वैल्यू के साथ Open और Close वैल्यू का इस्तेमाल करने पर, ये वैल्यू चेक-इन और चेक-आउट के लिए, यात्रा कार्यक्रम की कुछ तारीखों को सीमित कर देती हैं.

  • Open और Close के साथ Arrival: इस कॉम्बिनेशन से यह पता चलता है कि यात्रा की योजना में चेक-इन के लिए कौनसी तारीखें उपलब्ध हैं
  • Open और Close के साथ Departure: इस कॉम्बिनेशन से यह पता चलता है कि यात्रा की योजना में चेक-आउट के लिए कौनसी तारीखें उपलब्ध हैं

    • Arrival तारीख से, चेक-इन की तारीख के बाद ठहरने की रातों के लिए उपलब्धता पर कोई पाबंदी नहीं लगती.

    उदाहरण के लिए, 1 से 4 अप्रैल तक ठहरने के लिए बुकिंग की जा सकती है. हालांकि, 2 से 4 अप्रैल तक चेक-इन करने की सुविधा उपलब्ध नहीं है.

    ध्यान दें:

    • डिफ़ॉल्ट रूप से, Google यह मानता है कि सभी प्रॉडक्ट के लिए Master सेटिंग Close पर सेट है. इसे Hotel Center में किराये की सेटिंग में जाकर, "डिफ़ॉल्ट उपलब्धता" के ज़रिए कॉन्फ़िगर किया जा सकता है. Hotel Center में "बंद है" वैल्यू, यहां दी गई Close वैल्यू से मेल खाती है.
    • Master को Close पर सेट करने को "स्टॉप सेल" कहा जाता है.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0..1 enum

    अगर Status की वैल्यू दी गई है, तो इस एट्रिब्यूट को शामिल करना ज़रूरी है.

    मान्य मान हैं:

    • Arrival: इस वैल्यू से, Start और End तारीख की सीमा के दौरान चेक-इन करने की तारीख वाली यात्राओं को रोका जाता है.
    • Departure: इस वैल्यू से, उन यात्रा योजनाओं को रोका जाता है जिनमें चेक-आउट करने की तारीख, Start और End तारीख की सीमा के बीच होती है.
    • Master: इस वैल्यू से पता चलता है कि तारीख के हिसाब से कमरे का किराया बुकिंग के लिए उपलब्ध है या नहीं.

    Arrival और Departure, दोनों के लिए यह ज़रूरी है कि वे यात्रा की दी गई योजना के लिए उपलब्ध हों. Arrival और Departure, दोनों के लिए डिफ़ॉल्ट वैल्यू Open होती है. हालांकि, अगर पहले कोई ऐसा मैसेज भेजा गया है जिसमें यह बताया गया है कि अनुरोध बंद कर दिया गया है, तो डिफ़ॉल्ट वैल्यू Open नहीं होगी. इसके अलावा, कमरे/पैकेज का कॉम्बिनेशन, यात्रा कार्यक्रम की सभी तारीखों के लिए उपलब्ध होना चाहिए. हालांकि, इसमें ठहरने के आखिरी दिन को शामिल नहीं किया जाता. कमरे की उपलब्धता की जानकारी, Hotel Center की डिफ़ॉल्ट सेटिंग से सेट की जा सकती है. इसके अलावा, <Status> या <Restriction> एलिमेंट का इस्तेमाल करके भी यह जानकारी सेट की जा सकती है. अगर डिफ़ॉल्ट सेटिंग Close है, तो आपको Open की Status वैल्यू और Master की restriction वैल्यू भेजनी होगी. इससे यात्रा की तारीखों के लिए, उपलब्धता की जानकारी फिर से दिखाई जा सकेगी.

    उदाहरण के लिए, अगर किसी व्यक्ति को तीन रातों के लिए होटल में ठहरना है और उसके पहुंचने की तारीख 1 अप्रैल है, तो उसके ठहरने की पूरी अवधि 1 से 4 अप्रैल तक होगी. 1 से 3 अप्रैल तक रात में ठहरने के लिए, Status की वैल्यू Open और Restriction की वैल्यू Master पर सेट होनी चाहिए. ठहरने का आखिरी दिन (4 अप्रैल) बंद है, क्योंकि सिर्फ़ रात में ठहरने की तारीखों के लिए Open स्टेटस ज़रूरी है.

    ध्यान दें: अगर Restriction की वैल्यू नहीं दी जाती है, तो डिफ़ॉल्ट वैल्यू के तौर पर Master को चुना जाता है.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0..1 integer or duration कम से कम कितने समय पहले तक, कमरे का यह किराया बुक किया जा सकता है. यह समय, प्रॉपर्टी के स्थानीय समय के हिसाब से, पहुंचने की तारीख से पहले का होना चाहिए.

    मान्य वैल्यू टाइप ये हैं:

    • Integer: यात्रा की तारीख से पहले के दिनों की संख्या. उदाहरण के लिए, 1 वैल्यू का मतलब है कि कमरे का किराया, होटल में पहुंचने की तारीख से कम से कम एक दिन पहले बुक किया जाना चाहिए. 0 (डिफ़ॉल्ट वैल्यू) वैल्यू का मतलब है कि बुकिंग के लिए आखिरी समय पर कोई पाबंदी नहीं है.
    • ISO 8601 Duration (days, hours, and minutes): यह, यात्रा की तारीख से पहले के दिनों (और चाहें, तो घंटों/मिनटों) की संख्या होती है. उदाहरण के लिए, P1D वैल्यू का मतलब है कि कमरे का किराया, होटल पहुंचने की तारीख से एक दिन पहले बुक किया जाना चाहिए. P0DT6H वैल्यू से पता चलता है कि बुकिंग, पहुंचने की तारीख के खत्म होने से छह घंटे पहले (यानी कि शाम 6 बजे) या उससे पहले होनी चाहिए.
    OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0..1 integer or duration यह कमरे के किराये के हिसाब से बुकिंग करने की ज़्यादा से ज़्यादा अवधि है. यह अवधि, प्रॉपर्टी के स्थानीय समय के हिसाब से, मेहमान के पहुंचने की तारीख से पहले की होनी चाहिए.

    मान्य वैल्यू टाइप ये हैं:

    • Integer: यात्रा की तारीख से पहले के दिनों की संख्या. उदाहरण के लिए, 30 की वैल्यू से पता चलता है कि कमरे का किराया, मेहमान के पहुंचने की तारीख से 30 दिन पहले बुक नहीं किया जा सकता. 0 (डिफ़ॉल्ट वैल्यू) वैल्यू का मतलब है कि बुकिंग के लिए कम से कम समय की कोई पाबंदी नहीं है.
    • ISO 8601 Duration (days, hours, and minutes): यह यात्रा की तारीख से पहले के दिनों (और वैकल्पिक तौर पर घंटों/मिनटों) की संख्या होती है. उदाहरण के लिए, P30D की वैल्यू से पता चलता है कि कमरे का किराया, मेहमान के पहुंचने की तारीख से 30 दिन पहले बुक नहीं किया जा सकता. P30DT6H वैल्यू से पता चलता है कि बुकिंग, पहुंचने की तारीख से 30 दिन पहले शाम 6 बजे से पहले नहीं की जा सकती.

    उदाहरण

    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>

    LoS से जुड़ी पाबंदियां हटाना

    <LengthOfStay> पर Time="0" सेट करने का मतलब है कि ठहरने की तय अवधि के लिए कोई पाबंदी नहीं है. उदाहरण के लिए, <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>


    उपलब्धता की तारीखें

    तय की गई तारीखों पर, किसी कमरे के टाइप और किराये के प्लान के लिए उपलब्धता की जानकारी खोलें.

    ध्यान दें: किराये की पूरी जानकारी उपलब्ध कराने से पहले, रात के किराये के साथ-साथ कमरे के टाइप के लिए इन्वेंट्री की संख्या 0 से ज़्यादा होनी चाहिए.

    <?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>

    कटऑफ़ बुकिंग

    होटल के स्थानीय समय के हिसाब से, पहुंचने की तारीख को शाम 6 बजे के बाद बुकिंग नहीं की जा सकती.

    <?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

    पूरी अवधि के लिए, ठहरने की अवधि से जुड़ी पाबंदी सेट करें.

    26 जुलाई, 2023 को चेक-इन करने के लिए, सिर्फ़ दो, चार, और छह दिनों के लिए बुकिंग की जा सकती है. एक, तीन, पांच, और सात या उससे ज़्यादा दिनों के लिए ठहरने की सुविधा उपलब्ध नहीं है.

    <?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 मैसेज में ये एलिमेंट और एट्रिब्यूट शामिल होते हैं:

    Element / @Attribute आवृत्तियां टाइप ब्यौरा
    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 मैसेज को प्रोसेस कर लिया गया है.

    हर मैसेज में <Success> या <Errors> मौजूद है.
    OTA_HotelAvailNotifRS / Errors 0..1 Errors यह एक कंटेनर है. इसमें OTA_HotelAvailNotifRQ मैसेज को प्रोसेस करते समय हुई एक या उससे ज़्यादा समस्याओं की जानकारी होती है.

    हर मैसेज में <Success> या <Errors> मौजूद है.
    OTA_HotelAvailNotifRS / Errors / Error 1..n Error OTA_HotelAvailNotifRQ मैसेज को प्रोसेस करते समय हुई गड़बड़ी की जानकारी. इन गड़बड़ियों के बारे में जानकारी, फ़ीड की स्थिति से जुड़ी गड़बड़ी के मैसेज में देखी जा सकती है.
    OTA_HotelAvailNotifRS / Errors / Error / @Type 1 integer गड़बड़ी से जुड़ा OpenTravel Alliance EWT (Error Warning Type). सिर्फ़ 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>