मैसेज को रेटिंग दें

खास जानकारी

किराया मैसेज (OTA_HotelRateAmountNotifRQ) से, तारीख की खास सीमाओं के लिए, हर कमरे के टाइप और किराया प्लान के कॉम्बिनेशन के हिसाब से, रात के हिसाब से कमरे के किराये के बारे में पता चलता है. किराये के मैसेज के तौर पर, Google, ऑक्यूपेंसी के हिसाब से किराये तय करने की सुविधा देता है. इससे, एक रात ठहरने के लिए अलग-अलग किराये तय किए जा सकते हैं. ये किराये, होटल में ठहरने वाले लोगों की ज़्यादा से ज़्यादा संख्या के हिसाब से तय किए जाते हैं.

यहां दिए गए सेक्शन में, सामान्य दिशा-निर्देश, बुनियादी उदाहरण, और दरें जोड़ने और अपडेट करने के तरीके के बारे में बताया गया है. साथ ही, दर से जुड़ा मैसेज भेजने के तरीके के बारे में भी बताया गया है.

मैचिंग रेट का व्यवहार

उपयोगकर्ता, कमरे में रहने वाले लोगों की संख्या के हिसाब से अनुरोध करते हैं. इसलिए, उन्हें दिखने वाला किराया इस बात पर निर्भर करता है कि आपने Rate मैसेज में किराये को कैसे तय किया है. इस सेक्शन में बताया गया है कि उपयोगकर्ता के इन अनुरोधों को, आपके तय किए गए किराये से कैसे मैच किया जाता है. यह इस बात पर निर्भर करता है कि अनुरोध में बताई गई तारीखों के लिए, कमरे उपलब्ध हैं या नहीं. साथ ही, यह भी देखा जाता है कि आपने किराये क्या तय किए हैं.

मुख्य सिद्धांत

• किसी खास संख्या में लोगों के ठहरने के लिए तय किया गया किराया, उससे कम संख्या में लोगों के ठहरने पर भी लागू होता है. हालांकि, ऐसा तब तक होता है, जब तक कोई दूसरा किराया तय न किया गया हो.

• तय की गई संख्या से ज़्यादा लोगों के ठहरने के अनुरोधों को पूरा नहीं किया जा सकता.

• कमरे में रहने वाले लोगों की संख्या के हिसाब से तय की गई कीमत, तारीख के हिसाब से तय की गई कीमत और एलओएस के हिसाब से तय की गई कीमत, दोनों पर लागू होती है. इनके बारे में यहां बताया गया है. इसका मतलब है कि हर तरह के किरायेदार के लिए अलग-अलग किराया तय किया जा सकता है. अगर किसी खास संख्या में लोगों के ठहरने के लिए कोई किराया मौजूद नहीं है, तो उससे ज़्यादा संख्या में लोगों के ठहरने के लिए तय किए गए किराये का इस्तेमाल किया जाता है. AdditionalGuestAmounts या ExtraGuestCharges का इस्तेमाल करके, अतिरिक्त मेहमानों और बच्चों के लिए शुल्क भी तय किया जा सकता है. यह शुल्क, कमरे में रहने वाले लोगों की तय सीमा तक लागू होता है.

फ़ायदे और उदाहरण

क्षमता

अगर एक ही किराये में कई लोगों के ठहरने की सुविधा दी जा रही है, तो आपको हर व्यक्ति के हिसाब से किराया सेट करने की ज़रूरत नहीं है. कमरे के टाइप और किराये के प्लान के हिसाब से, सिर्फ़ सबसे ज़्यादा लोगों के रहने की वैल्यू सेट करके, अपने मैसेज को आसान बनाया जा सकता है. उपयोगकर्ताओं को, आपके सेट किए गए वैल्यू के बराबर या उससे कम ऑक्यूपेंसी के लिए, वही किराया दिखेगा.

उदाहरण: एक तरह के कमरे और किराया प्लान के लिए, एक से चार लोगों के लिए किराया एक जैसा है. ज़्यादा से ज़्यादा चार लोगों के लिए एक किराया सेट करने के लिए, Rate मैसेज का इस्तेमाल करें. एक, दो, और तीन लोगों के लिए बुकिंग करने वाले उपयोगकर्ताओं को एक ही किराया दिखेगा. पांच या इससे ज़्यादा लोगों के लिए खोज करने वाले उपयोगकर्ताओं को किराया नहीं दिखेगा.

कंट्रोल

अलग-अलग लोगों के हिसाब से, अलग-अलग किराये की जानकारी साफ़ तौर पर दी जा सकती है. अगर आपको यह बेहतर तरीके से कंट्रोल करना है कि Google, अनुरोधों को ऑक्यूपेंसी रेट से कैसे मैच करता है, तो ऑक्यूपेंसी की हर वैल्यू के लिए अलग-अलग किराया भेजें.

उदाहरण: अगर तीन और एक लोगों के लिए किराया तय किया गया है, तो एक व्यक्ति के लिए की गई खोज में एक व्यक्ति के लिए तय किया गया किराया दिखेगा. दो लोगों के लिए की गई खोज में तीन लोगों के लिए तय किया गया किराया दिखेगा. वहीं, चार या इससे ज़्यादा लोगों के लिए की गई खोज में किराया नहीं दिखेगा.

किराये से जुड़े अलग-अलग उदाहरणों के बारे में ज़्यादा जानने के लिए, तरीके देखें.

ज़रूरी और वैकल्पिक एलिमेंट

एक्सएमएल रेफ़रंस में, ज़रूरी और वैकल्पिक एलिमेंट के बारे में जानकारी दी गई है. एट्रिब्यूट और चाइल्ड एलिमेंट के बारे में जानकारी के लिए, किराये के एलिमेंट और एट्रिब्यूट देखें.

सिंटैक्स और स्कीमा

किराये के मैसेज बनाते समय, किराये के सिंटैक्स के उदाहरण को रेफ़रंस के तौर पर इस्तेमाल करें. इससे यह पक्का किया जा सकेगा कि आपने सही फ़ॉर्मैट का इस्तेमाल किया है.

Google को फ़ीड सबमिट करने से पहले, पब्लिश किए गए स्कीमा के हिसाब से उनकी पुष्टि करने के लिए, तीसरे पक्ष के एक्सएमएल टूल का इस्तेमाल किया जा सकता है. जैसे, xmllint. किराये के मैसेज के स्कीमा के लिए, होटल विज्ञापनों के स्कीमा देखें.

प्राइसिंग मॉडल

तारीख के हिसाब से कीमत

यह स्टैंडर्ड प्राइसिंग मॉडल है. इसका इस्तेमाल ज़्यादातर प्रॉपर्टी के लिए किया जाता है. per-date के लिए, कीमत तय करने का मॉडल इस तरह काम करता है: इसमें ठहरने की हर तारीख के लिए किराया तय किया जाता है. इसके बाद, सभी तारीखों के किराये को जोड़कर कुल किराया तय किया जाता है. इस मॉडल में, Rate एलिमेंट के तहत सभी किराये को, <StatusApplicationControl> में बताई गई तारीखों की सीमा के लिए लागू माना जाता है.

एलओएस के आधार पर कीमत तय करना

एलओएस (ठहरने की अवधि) के आधार पर तय किए जाने वाले किराये का मॉडल, होटल में पहुंचने की तारीख और ठहरने की अवधि के कॉम्बिनेशन के लिए तय किए गए किराये पर आधारित होता है. एलओएस पर आधारित कीमत तय करने वाले मॉडल के तहत बताई गई कीमतें, हर दिन के हिसाब से होती हैं. उदाहरण के लिए, अगर आपने तीन दिनों के लिए 100 डॉलर का किराया भेजा है, तो कुल किराया 3x100 डॉलर=300 डॉलर के तौर पर कैलकुलेट किया जाएगा.

StatusApplicationControl एलिमेंट पर RatePlanType="26" एट्रिब्यूट की वैल्यू सेट करके, एलओएस के आधार पर तय किए गए किराये वाले मॉडल का इस्तेमाल किया जा सकता है. आपको अपनी एक्सएमएल फ़ाइल में मौजूद Rate एलिमेंट के लिए, RateTimeUnit और UnitMultiplier एट्रिब्यूट भी सेट करने होंगे. इसकी वजह से, दिए गए Rate एलिमेंट के तहत आने वाले सभी किराये, उन ठहरने पर लागू होते हैं जिनके लिए <StatusApplicationControl> में दी गई तारीखों पर चेक इन किया गया है. साथ ही, UnitMultiplier में दी गई एलओएस वैल्यू के हिसाब से चेक आउट किया गया है.

एक ही खाते में, हर दिन के हिसाब से और एलओएस के आधार पर तय की गई कीमत वाले दोनों मॉडल का इस्तेमाल किया जा सकता है. हालांकि, हर प्रॉपर्टी के लिए सिर्फ़ एक प्राइसिंग मॉडल का इस्तेमाल किया जाना चाहिए. एलओएस के आधार पर किराये तय करने की सुविधा लागू करते समय, इन बातों का ध्यान रखें:

• एलओएस के आधार पर तय की जाने वाली कीमत का इस्तेमाल करते समय, ठहरने की अलग-अलग अवधि के लिए तय की गई कीमतों को एक साथ नहीं जोड़ा जाता. उदाहरण के लिए, चार दिनों के लिए कमरे का किराया तय करने के लिए, तीन दिनों के लिए कमरे के किराये को एक दिन के लिए कमरे के किराये के साथ नहीं जोड़ा जाता. चार दिनों के लिए रुकने का किराया साफ़ तौर पर बताया गया हो.
• एलओएस के आधार पर तय की गई कीमत में, एक रात के लिए तय की गई कीमत का इस्तेमाल, हर तारीख के हिसाब से तय की गई कीमत में एक रात के लिए तय की गई कीमत के तौर पर नहीं किया जाता.
• हर प्रॉपर्टी को सिर्फ़ एलओएस के आधार पर तय किया गया किराया या हर तारीख के हिसाब से तय किया गया किराया इस्तेमाल करना चाहिए. यह इस बात पर निर्भर करता है कि आपके सिस्टम में किराया कैसे दिखाया जाता है.

अपने खाते में एलओएस के आधार पर कीमत तय करने की सुविधा चालू करने के लिए, अपने टीएएम के ज़रिए अनुरोध करें या हमसे संपर्क करें.

दिशा-निर्देश या कार्रवाइयां

तारीख के हिसाब से कीमत

Delta: <StatusApplicationControl> में बताए गए, कमरे के टाइप, किराया प्लान, और ठहरने की तारीखों के सिर्फ़ चुनिंदा कॉम्बिनेशन के लिए, हर व्यक्ति के हिसाब से किराया जोड़ें या अपडेट करें.

• किराये के अपडेट के लिए, डिफ़ॉल्ट रूप से Delta कार्रवाई का इस्तेमाल किया जाता है.
• Delta अपडेट करने से, अन्य लोगों के लिए पहले से सेव किए गए किराये में कोई बदलाव नहीं होता. उदाहरण के लिए, अगर आपने एक और दो लोगों के लिए कमरों का किराया तय किया है और एक व्यक्ति के लिए कमरे के किराये की जानकारी अपडेट करने का अनुरोध भेजा है, तो दो लोगों के लिए कमरे के किराये में कोई बदलाव नहीं होगा.Delta

Overlay: <StatusApplicationControl> में बताए गए कमरे के टाइप, किराये के प्लान, और तारीखों के लिए, मौजूदा सभी दरें मिटाएं और उन्हें नई दरों से बदलें. उदाहरण के लिए, अगर आपने एक और दो लोगों के लिए कमरे के किराये की जानकारी दी है और आपने एक व्यक्ति के लिए कमरे के किराये की Overlay जानकारी भेजी है, तो Google, एक और दो लोगों के लिए कमरे के किराये की पिछली सभी जानकारी हटा देगा. अपडेट के बाद, सिर्फ़ एक व्यक्ति के लिए कमरे के किराये की जानकारी दिखेगी.

Remove: <StatusApplicationControl> में बताए गए कमरे के टाइप, किराये के प्लान, और तारीखों के लिए, मौजूदा किराये को मिटाएं.

OverlayRemove

एलओएस के आधार पर कीमत तय करना

Delta: सिर्फ़ <StatusApplicationControl> में दिए गए, कमरे के टाइप, किराया प्लान, और चेक-इन की तारीखों के कॉम्बिनेशन के लिए, एलओएस के हिसाब से किराये जोड़ें या अपडेट करें. इससे, अपडेट की गई एलओएस वैल्यू से जुड़े सभी ऑक्यूपेंसी रेट बदल जाते हैं.

• किराये के अपडेट के लिए, डिफ़ॉल्ट रूप से Delta कार्रवाई का इस्तेमाल किया जाता है.
• Delta अपडेट करने से, ठहरने की अन्य अवधियों के लिए पहले से सेव किए गए किसी भी किराये में बदलाव नहीं होता. उदाहरण के लिए, अगर आपने एलओएस 1 और 2 के लिए कीमतें तय की हैं और एलओएस 1 के लिए Delta कीमत अपडेट भेजी है, तो एलओएस 2 के लिए, हर व्यक्ति के हिसाब से तय की गई कीमतों में कोई बदलाव नहीं होगा.
• Delta अपडेट करने पर, ठहरने की अवधि के हिसाब से, पहले से सेव किए गए सभी किराये ओवरराइट हो जाते हैं. उदाहरण के लिए, अगर आपने एक रात के लिए, एक और दो लोगों के हिसाब से किराया तय किया है और सिर्फ़ एक व्यक्ति के हिसाब से किराया अपडेट किया है, तो दो लोगों के हिसाब से तय किया गया किराया हटा दिया जाएगा.Delta

Overlay: <StatusApplicationControl> में बताई गई एलओएस, कमरे के टाइप, किराया प्लान, और चेक-इन करने की तारीखों के लिए, हर व्यक्ति के हिसाब से तय किए गए मौजूदा सभी किराये मिटाएं और उन्हें नए किराये से बदलें. उदाहरण के लिए, अगर आपने एलओएस 1 और 2 के लिए किराये तय किए हैं और आपने एलओएस 1 के लिए Overlay अपडेट भेजा है, तो Google, एलओएस 1 और 2, दोनों के पिछले सभी किराये हटा देगा. अपडेट के बाद, सिर्फ़ एलओएस 1 का किराया दिखेगा.

Remove: <StatusApplicationControl> में बताए गए कमरे के टाइप, रेट प्लान, और चेक-इन की तारीखों के लिए, हर व्यक्ति के हिसाब से तय किए गए मौजूदा सभी किराये मिटाएं.

टैक्स से जुड़ी समस्या

अगर टैक्स और शुल्क सामान्य हैं, तो AmountAfterTax का इस्तेमाल करके कुल रकम बताई जा सकती है. जटिल टैक्स, जैसे कि हर रात के बजाय पूरे स्टे पर लागू होने वाले टैक्स और शुल्क, AmountAfterTax में नहीं दिखाए जा सकते.

आम तौर पर, Google का सुझाव है कि AmountAfterTax के बजाय TaxFeeInfo का इस्तेमाल करें.

अगर हो सके, तो आपको AmountBeforeTax एट्रिब्यूट की वैल्यू शामिल करनी चाहिए. भले ही, आपने AmountAfterTax एट्रिब्यूट की वैल्यू दी हो. ऐसा इसलिए, क्योंकि कुछ स्थान-भाषाओं (उदाहरण के लिए, अमेरिका) में डिफ़ॉल्ट रूप से टैक्स से पहले की कीमत दिखती है.

उपयोगकर्ता को चुकाए जाने वाले सभी टैक्स और शुल्क (वैट, स्टे टैक्स, साफ़-सफ़ाई का शुल्क, सिटी टैक्स वगैरह) शामिल होने चाहिए. भले ही, बुकिंग के समय इनका पेमेंट न किया गया हो या सीधे तौर पर प्रॉपर्टी को इनका पेमेंट न किया गया हो.

उदाहरण

इस सेक्शन में, ज़रूरी और वैकल्पिक एलिमेंट का इस्तेमाल करके, रेट मैसेज का एक बुनियादी उदाहरण दिया गया है. फ़ाइल तैयार करने के बाद, आपको इसे Google को भेजना होगा. इसके लिए, नीचे दिए गए एंडपॉइंट पर POST मैसेज का इस्तेमाल करें: https://www.google.com/travel/hotels/uploads/property_data

मैसेज को पुश/पोस्ट करने के तरीके के बारे में ज़्यादा जानने के लिए, मैसेज पुश करना लेख पढ़ें.

HotelCode के लिए, वह यूनीक होटल आईडी इस्तेमाल करें जिसका इस्तेमाल आपने अपनी प्रॉपर्टी की पहचान करने के लिए अपने सिस्टम में किया था. यह वैल्यू, होटल सूची वाले फ़ीड में <listing> एलिमेंट में <id> का इस्तेमाल करके तय किए गए होटल आईडी से मेल खानी चाहिए. <PackageID> और <RoomID> के लिए, उन आईडी का इस्तेमाल करें जिनका इस्तेमाल, अपने सिस्टम में रेट प्लान और कमरों के टाइप के लिए किया जाता है. यह पक्का करने के लिए कि Google आपकी कीमतों और डेटा को सही तरीके से दिखा रहा है, यह ज़रूरी है कि आपके सिस्टम में मौजूद डेटा और Google को भेजे गए डेटा में एकरूपता हो.

इस उदाहरण में, Delta कार्रवाई का इस्तेमाल करके किराये सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

कैसे करें

इस सेक्शन में, रेटिंग वाले मैसेज भेजने के दौरान आने वाली समस्याओं के समाधान दिए गए हैं.

किराये जोड़ने, हटाने, और अपडेट करने के उदाहरण देखने के लिए, किराये के उदाहरण देखें.

पहली स्थिति: हर व्यक्ति के हिसाब से तय की गई कीमत को बदलने का तरीका

ब्यौरा

पहले, एक रात का किराया सिर्फ़ दो लोगों के लिए तय किया जाता था. यह किराया, एक व्यक्ति के लिए भी लागू होता था. हालांकि, अब एक व्यक्ति के लिए कम किराया उपलब्ध है.

समाधान

डिफ़ॉल्ट Delta स्कोप किए गए अपडेट का इस्तेमाल करके, ऑक्यूपेंसी 1 के लिए नया किराया भेजें. इस नई वैल्यू से, ऑक्यूपेंसी 2 रेट पर कोई असर नहीं पड़ता.

दूसरी स्थिति: किसी प्रॉपर्टी के लिए, हर व्यक्ति के हिसाब से तय किए गए किराये को कैसे बदलें

ब्यौरा

आपने पहले एक से चार लोगों के लिए किराया तय किया था. हालांकि, अब सिर्फ़ एक और दो लोगों के लिए किराया मान्य है.

समाधान

किसी प्रॉपर्टी, कमरे के टाइप, किराया प्लान, और तारीख के लिए, ऑक्यूपेंसी रेट बदलने के लिए NotifType="Overlay" का इस्तेमाल करें. इस उदाहरण में, Overlay कार्रवाई में एक और दो लोगों के लिए किराया दिखाया जाएगा.

तीसरा उदाहरण: एक से ज़्यादा लोगों के लिए एक ही किराया कैसे सेट करें

ब्यौरा

किसी ग्रुप को, कम लोगों के लिए तय किया गया किराया भी दिया जा सकता है. इस स्थिति में, ज़्यादा से ज़्यादा लोगों के हिसाब से लागू होने वाले किराये में बदलाव की जानकारी भेजकर, अपने मैसेज को आसान बनाया जा सकता है.

समाधान

अगर एक से ज़्यादा लोगों के लिए एक ही किराया है, तो कमरे के टाइप और किराये के प्लान के हिसाब से, सबसे ज़्यादा लोगों की संख्या सेट करें. इसके बाद, कम लोगों की संख्या के लिए यह वैल्यू अपने-आप इस्तेमाल हो जाएगी. इसका मतलब है कि अगर एक से छह लोगों के लिए रात का किराया एक जैसा है, तो उसे दोहराने की ज़रूरत नहीं है. बस छह लोगों के लिए किराया सेट करें.