इस पेज का अनुवाद Cloud Translation API से किया गया है.

इन्वेंट्री से जुड़ा मैसेज

खास जानकारी

इन्वेंट्री मैसेज (OTA_HotelInvCountNotifRQ) में उन इन्वेंट्री की संख्या (कुल कमरों की संख्या) के बारे में बताया जाता है जिन्हें खास तरह के कमरों में बुक किया जा सकता है. इन्वेंट्री मैसेज भेजने पर, यह जानकारी दी जाती है कि किसी दी गई तारीख को उस तरह के कितने कमरे उपलब्ध हैं. अगर उस तरह का कोई कमरा उपलब्ध नहीं है, तो उस तरह के कमरे और तारीख वाले प्रॉडक्ट नहीं दिखाए जाएंगे.

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

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

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

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

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

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

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

दिशा-निर्देश

इन्वेंट्री मैसेज के लिए, इन दिशा-निर्देशों का पालन करें:

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

इन्वेंट्री बनाम खरीदारी के लिए उपलब्धता

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

इन्वेंट्री होने पर भी "उपलब्ध नहीं है" हो सकता है, क्योंकि इन्वेंट्री और उपलब्धता एक-दूसरे से अलग होती हैं.

उपलब्धता के दो सिद्धांत हैं. पहला, किसी ठहरने के लिए प्रॉडक्ट की उपलब्धता दूसरी, दी गई तारीख पर किसी प्रॉडक्ट पर खास पाबंदी होती है, जिसे OTA_HotelAvailNotifRQ में <RestrictionStatus Restriction="Master" Status="Open"/> से दिखाता है. इस उपलब्धता को बंद करना "बेचना बंद करें" कहा जाता है.

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

उदाहरण

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

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

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

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

इस उदाहरण में, दिसंबर के महीने में बुक किए जा सकने वाले 13 कमरों के लिए, इन्वेंट्री सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

ज़्यादा उदाहरणों के लिए, इन्वेंट्री के उदाहरण देखें.

कैसे करें

इस सेक्शन में एक ऐसी स्थिति दी गई है जो इन्वेंट्री मैसेज भेजते समय आपके सामने आ सकती है.

स्थिति: कमरों को बुक होने से कैसे रोकें

ब्यौरा

आपको यह बताना होगा कि कुछ खास तारीखों पर, इस तरह के कमरे के लिए कोई कमरा बुक नहीं किया जा सकता. ऐसा इसलिए होता है, क्योंकि आम तौर पर वे कमरे बिक चुके होते हैं.

समस्या का हल

<InvCount Count> को 0 वैल्यू पर सेट करते हैं और अपनी ज़रूरत के हिसाब से तारीख की सीमा जोड़ते हैं.

नमूना

यह नमूना बताता है कि बताए गए कमरे और तारीखों (उदाहरण के लिए, जनवरी के पहले कुछ हफ़्ते) के लिए इन्वेंट्री को 0 पर सेट करने के लिए, InvCount का इस्तेमाल कैसे करें.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>