टैक्स और शुल्क वाला मैसेज

खास जानकारी

TaxFeeInfo मैसेज में उन टैक्स और शुल्कों के बारे में बताया गया है जो उपयोगकर्ता पर प्रॉपर्टी बुक करते समय लागू होते हैं. साथ ही, ये शुल्क, वेबसाइट पर बताए गए प्रॉपर्टी के टैक्स नियमों पर भी लागू होते हैं. टैक्स और शुल्क का डेटा जोड़ने के लिए, OTA_HotelRateAmountNotifRQ का इस्तेमाल करें.

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

टैक्स और शुल्क जोड़ने के तरीके

टैक्स और शुल्क जोड़ने के दो सामान्य तरीके हैं:

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

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

यह पेज सिर्फ़ TaxFeeInfo को इस्तेमाल करने के पसंदीदा तरीके के बारे में बताता है और इसे इस्तेमाल करने के पसंदीदा तरीके के बारे में बताता है. दर वाले मैसेज (OTA_HotelRateAmountNotifRQ) में AmountAfterTax की जानकारी देने का तरीका नहीं बताया गया है.

टैक्स सेट करने के तरीके

टैक्स सेट करने के लिए, आपके पास ये विकल्प हैं:

  • Basis = [room|person]
  • Period = [stay|night]
  • टाइप = [percent|amount]

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

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

  • टैक्स का प्रतिशत
  • हर प्रॉपर्टी पर एक जैसा टैक्स लागू होता है
  • टैक्स का प्रतिशत, सिर्फ़ पहली रात के बाद की रातों पर लागू होता है
  • पुराने टैक्स को नए टैक्स से बदलने का तरीका
  • देशों के लिए कर शामिल करें या बाहर रखें
  • ब्रैकेट के साथ स्लैब टैक्स सेट करना
  • टैक्स और टैक्स लगाने लायक शुल्क सेट करें

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

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

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

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

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

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

इस सेक्शन में, टैक्स और शुल्क सेट करने के लिए सामान्य दिशा-निर्देश और खास निर्देश दिए गए हैं.

कार्रवाइयां

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

सामान्य

  • हर Tax का आकलन किया जाता है. अगर लागू हो, तो BaseByGuestAmt में बताई गई AmountBeforeTax रकम के आधार पर हिसाब लगाया जाता है.

  • लागू होने वाले सभी टैक्स और शुल्क का हिसाब लगाने के बाद, उन्हें मूल कीमत में जोड़कर कुल कीमत तय की जाती है.

  • <Tax> और <Fee> के लिए सिंटैक्स एक जैसे हैं.

  • टैक्स और शुल्कों पर कुछ पाबंदियां हो सकती हैं. जैसे:

    • यह सिर्फ़ कुछ खास तरह के कमरों और किराये के प्लान पर लागू होता है.
    • यह सिर्फ़ ठहरने की चुनिंदा तारीखों पर लागू होता है.

    ये कंस्ट्रेंट वैकल्पिक हैं और आपको हर तरह की कंस्ट्रेंट सेट करने की ज़रूरत नहीं है; अगर ये सभी पर लागू होते हैं, तो इन्हें खाली छोड़ा जा सकता है.

  • टैक्स या शुल्क में बदलाव होने पर, TaxFeeInfo को अपडेट भेजें.

उदाहरण

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

https://www.google.com/travel/hotels/uploads/taxes

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

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

इस उदाहरण में, ठहरने की कुल अवधि (हर रात के हिसाब से नहीं) के लिए, 10% टैक्स का प्रतिशत और 50 डॉलर शुल्क की रकम सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

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

कैसे करें

इस सेक्शन में, उन स्थितियों के समाधान दिए गए हैं जिनका आपको टैक्स और शुल्क सेट करते समय सामना करना पड़ सकता है.

पहली स्थिति: फ़्लैट टैक्स जोड़ने का तरीका

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

ब्यौरा

आपको कमरे के लिए फ़्लैट टैक्स लागू करना है या प्रतिशत टैक्स के बजाय हर प्रॉपर्टी के हिसाब से टैक्स देना है.

समाधान

फ़्लैट टैक्स का विकल्प जोड़ने के लिए, percentage के बजाय amount का इस्तेमाल करें.

नमूना

इस सैंपल में, percentage के बजाय amount का इस्तेमाल करके, फ़्लैट टैक्स जोड़ने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

दूसरी स्थिति: ApplicableNights का इस्तेमाल करके टैक्स को टारगेट करने का तरीका

ब्यौरा

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

समाधान

<ApplicableNights excluded="1"/> का इस्तेमाल करके, यह कंट्रोल करें कि किन रातों के लिए टैक्स लागू किए जाएं.

नमूना

इस सैंपल में ApplicableNights का इस्तेमाल करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

तीसरी स्थिति: पुराने की जगह नए टैक्स और शुल्क कैसे डालें

ब्यौरा

मौजूदा टैक्स और शुल्क में बदलाव किया गया है. इनकी जगह नए टैक्स लागू किए जाएंगे.

समाधान

सभी मौजूदा टैक्स और शुल्क हटाने के लिए, overlay कार्रवाई का इस्तेमाल करें.

नमूना

यहां दिए गए सैंपल में, किसी प्रॉपर्टी के लिए सभी टैक्स और शुल्क हटाने का तरीका बताया गया है:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

चौथी स्थिति: देशों के लिए टैक्स को शामिल या बाहर करने का तरीका

ब्यौरा

आपको कुछ देशों के लिए टैक्स शामिल करना होगा और किसी दूसरे देश के लिए टैक्स शामिल नहीं करना होगा. उदाहरण के लिए, आपको अन्य सभी देशों पर टैक्स लगाते समय, छोटे संघीय देश के लिए, यूरोपीय संघ के बाहर के टैक्स को शामिल नहीं करना होगा.

समाधान

UserCountries type के लिए, include या exclude विकल्पों का इस्तेमाल करें. सिर्फ़ सूची में शामिल देश पर टैक्स लागू करने के लिए, include का इस्तेमाल करें. इसके अलावा, सूची में शामिल देश को छोड़कर बाकी सभी देशों पर टैक्स लागू करने के लिए, exclude का इस्तेमाल करें.

नमूना

यहां दिए गए सैंपल में, होटल के देश (इज़रायल) से बाहर के उपयोगकर्ताओं के लिए टैक्स सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

पांचवीं स्थिति: ब्रैकेट के साथ स्लैब टैक्स सेट करने का तरीका

ब्यौरा

आपको रात के किराये के आधार पर लागू होने वाला जीएसटी स्लैब जोड़ना है.

समाधान

इस स्थिति के लिए, मान लें कि टारगेट किए गए देश के जीएसटी टैक्स ब्रैकेट ये हैं:

  • एक रात का किराया 1,000 या उससे कम होने पर, कोई टैक्स नहीं लगेगा.
  • अगर रात का किराया 1,000 से ज़्यादा और 7,500 या उससे कम है, तो 12% टैक्स.
  • अगर रात भर के ठहरने की कीमत 7,500 से ज़्यादा है, तो 18% टैक्स.

नमूना

यहां दिए गए सैंपल में, ब्रैकेट के साथ टैक्स स्लैब सेट करने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

छठी स्थिति: टैक्स और टैक्स के दायरे में आने वाला शुल्क सेट करने का तरीका

ब्यौरा

आपको वैट जैसे टैक्स के साथ-साथ, सेवा शुल्क भी जोड़ना है. यह शुल्क, टैक्स पर भी लागू होगा.

समाधान

इस स्थिति में, टैक्स के दायरे में आने वाले शुल्कों के इस्तेमाल के दो उदाहरणों पर विचार किया गया है:

  • टैक्स और टैक्स के दायरे में आने वाला शुल्क, दोनों को प्रतिशत के तौर पर तय किया जाता है.
  • टैक्स, प्रतिशत के तौर पर लिया जाता है, जबकि हर होटल में ठहरने पर लगने वाला टैक्स एक तय शुल्क होता है.

उदाहरण

टैक्स के दायरे में आने वाला शुल्क, प्रतिशत के तौर पर

इस उदाहरण में AmountBeforeTax के तौर पर 100 डॉलर, 18% जीएसटी, और 5% का अतिरिक्त सेवा शुल्क शामिल है. इस तरह के शुल्क की कुल दर 5.9% (5*1.18), और कुल दर 123.90 डॉलर [= 118 (18% जीएसटी) + 5.9 (5.9% सर्विस शुल्क)].

इस स्निपेट में, टैक्स (जीएसटी) और टैक्स के दायरे में आने वाले शुल्क (सेवा शुल्क) को प्रतिशत के तौर पर दिखाया गया है:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

टैक्स की रकम

इस उदाहरण में, AmountBeforeTax 100 डॉलर है, जीएसटी टैक्स 18% है, और 20 डॉलर का एक और शुल्क है. इसलिए, टैक्स के दायरे में आने वाला कुल शुल्क 23.60 डॉलर ($20*1.18) है और कुल रकम 141.60 डॉलर [= 118 डॉलर (18% जीएसटी) + 23.60 डॉलर ($20 फ़्लैट रेट)] है.

इस स्निपेट में, टैक्स (जीएसटी) को प्रतिशत में और टैक्स के दायरे में आने वाले शुल्क (सेवा शुल्क) को एक तय रकम के तौर पर दिखाया गया है:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>