उपलब्धता, किराये, और इन्वेंट्री (एआरआई) के लिए एक्सएमएल रेफ़रंस

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

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

उपलब्धता और इन्वेंट्री तय करने के लिए, एआरआई, OpenTravel Alliance (OTA) के स्टैंडर्ड प्रोटोकॉल का पालन करता है. ऐसा मुख्य मैसेज टाइप में से कुछ के लिए किया जाता है.

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

LOS-based की सुविधा की मदद से, चेक-इन करने की तारीख और ठहरने की अवधि के हिसाब से किराये तय किए जा सकते हैं. इसके लिए, ठहरने की तारीख के हिसाब से किराये तय करने की ज़रूरत नहीं होती. एलओएस के आधार पर कीमत तय करने के लिए <StatusApplicationControl> एलिमेंट की वैल्यू सेट करते समय, @Start और @End एट्रिब्यूट से चेक-इन की तारीखों की वह रेंज पता चलती है जिस पर एलओएस के हिसाब से तय की गई कीमतें लागू होती हैं.

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

अहम जानकारी: आपके खाते में मौजूद हर प्रॉपर्टी के लिए, एलओएस के आधार पर तय की गई दरों या हर तारीख के हिसाब से तय की गई दरों का इस्तेमाल किया जाना चाहिए.

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

अहम जानकारी: कीमत की जानकारी उपलब्ध कराने से पहले, आपको चार तरह के मैसेज (लेन-देन, किराया, इन्वेंट्री, और उपलब्धता) भेजने होंगे. हमारा सुझाव है कि एआरआई मैसेज का साइज़ <OTA_HotelRateAmountNotifRQ> से 5 एमबी तक सीमित रखें. साथ ही, हर सेकंड अपलोड की जाने वाली फ़ाइलों की संख्या 400 से ज़्यादा न हो. पिछले मैसेज के तीन सेकंड के अंदर, तारीख के हिसाब से यात्रा की योजना की एक से ज़्यादा मिलती-जुलती जानकारी न भेजें.

ARI, अनुरोध के लिए इन मैसेज का इस्तेमाल करता है:

• Transaction (प्रॉपर्टी का डेटा). इससे टाइप और पैकेज (किराया प्लान) की जानकारी मिलती है.

• OTA_HotelRateAmountNotifRQ. इससे, तारीख के हिसाब से या एलओएस के आधार पर, हर प्रॉडक्ट (कमरे का टाइप और किराये के प्लान का कॉम्बिनेशन) के लिए ऑक्यूपेंसी रेट की रकम तय की जाती है. यह रकम, तारीख की खास सीमाओं के लिए तय की जाती है.

• OTA_HotelAvailNotifRQ. यह मैसेज, कमरे के टाइप और किराये के प्लान के आधार पर उपलब्धता और पाबंदियों के बारे में बताता है. इस मैसेज का इस्तेमाल करके इन्वेंट्री को भी अपडेट किया जा सकता है. हालांकि, OTA_HotelInvCountNotifRQ का इस्तेमाल करना बेहतर होता है.

• OTA_HotelInvCountNotifRQ. इससे, कमरे की इन्वेंट्री या बिक्री के लिए उपलब्ध कमरों की संख्या तय होती है.

• TaxFeeInfo. (ज़रूरी नहीं) इससे प्रॉपर्टी के हिसाब से टैक्स और शुल्क तय किए जाते हैं. अगर OTA_HotelRateAmountNotifRQ मैसेज में AmountAfterTax की जानकारी दी गई है, तो इस मैसेज की ज़रूरत नहीं होती.

• Promotions. (ज़रूरी नहीं) यह टैग, कुछ बुकिंग, ठहरने, और उपयोगकर्ताओं के लिए प्रमोशनल किराये तय करता है.

• RateModifications. (ज़रूरी नहीं) यह कुछ बुकिंग, ठहरने, और उपयोगकर्ताओं के लिए, किराये में बदलाव करने के नियमों के बारे में बताता है.

• ExtraGuestCharges. (ज़रूरी नहीं) इससे यह तय किया जाता है कि बच्चों और अन्य वयस्कों के लिए, किराये कैसे कॉन्फ़िगर किए जाने चाहिए.

हर मैसेज में जानकारी का एक सबसेट होता है. Google इस जानकारी का इस्तेमाल करके, उपयोगकर्ताओं को किराये और उपलब्धता की जानकारी दिखाता है. यह जानकारी तब दिखती है, जब उपयोगकर्ता आपकी प्रॉपर्टी को किसी खास चेक-इन और चेक-आउट की तारीख और ऑक्यूपेंसी के हिसाब से खोजते हैं.

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

साथ ही, इन्वेंट्री और कीमत (एआरआई) के लिए एक्सएमएल रेफ़रंस में शामिल न किए गए अन्य लेन-देन के मैसेज वाले एलिमेंट, एआरआई फ़ीड टाइप का इस्तेमाल करते समय काम नहीं करते.

Google, एपीआई को लगातार अपडेट और बेहतर बनाता रहता है. अगर आपने अपने सिस्टम में कीमत से जुड़ी अन्य सुविधाएं इस्तेमाल की हैं, तो Technology Account Manager(TAM) को इसकी सूचना दें, ताकि इन सुविधाओं को प्राथमिकता दी जा सके. इसके अलावा, Technology Account Manager(TAM) आपको यह भी बता सकता है कि इन सुविधाओं को रिलीज़ करने की योजना है या नहीं.

ARI XML रेफ़रंस में हुए बदलावों का इतिहास

यहां दी गई टेबल में, सिर्फ़ सुविधाओं में हुए बदलावों के लिए दस्तावेज़ों से जुड़े अपडेट दिए गए हैं.

तारीख	बदलाव
14 अगस्त, 2020	शुरुआती रिलीज़.
21 अक्टूबर, 2020	प्रमोशन के मैसेज टाइप को जोड़ा गया.
17 नवंबर, 2020	लेन-देन (प्रॉपर्टी का डेटा) से जुड़े मैसेज के लिए, एंडपॉइंट को अपडेट किया गया है. साथ ही, PropertyDataSet एलिमेंट में action एट्रिब्यूट जोड़ा गया है.
24 नवंबर, 2020	लेन-देन (प्रॉपर्टी का डेटा) से जुड़े मैसेज के लिए, <AllowablePackageIDs> और <AllowableRoomIDs> एलिमेंट जोड़े गए हैं.
4 फ़रवरी, 2021	जवाब के मैसेज जोड़े गए.
25 फ़रवरी, 2021	OTA_HotelInvCountNotifRQ को जोड़ा गया.
21 अक्टूबर, 2020	किराये में बदलाव के बारे में जानकारी देने वाले मैसेज टाइप को जोड़ा गया.