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

खास जानकारी

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

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

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

टैक्स और शुल्क जोड़ने के दो सामान्य तरीके हैं: पहले तरीके में, 'किराये की जानकारी' मैसेज में AmountAfterTax बताया जाता है; किराये के बारे में मैसेज भेजकर, टैक्स/शुल्क की जानकारी जोड़ी जाती है. इसमें रात की बुनियादी दरें (सभी टैक्स/शुल्क शामिल नहीं) और हर रात की कुल दरें (सभी टैक्स/शुल्क भी शामिल होते हैं) शामिल होती हैं. ये दरें रात के हिसाब से ली जाती हैं. इसलिए, यह तरीका सिर्फ़ प्रतिशत पर आधारित टैक्स/शुल्क या एक तय रकम के लिए ही काम करता है. होटल में हर रात के हिसाब से लगने वाले टैक्स/शुल्क का इस्तेमाल नहीं किया जा सकता.

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

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

टैक्स सेट करने के लिए आपके पास नीचे दिए गए विकल्प हैं:

  • आधार = [room|person]
  • माहवारी = [ठहरना|रात]
  • टाइप = [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>

छठा स्थिति: टैक्स और टैक्स के हिसाब से शुल्क सेट करने का तरीका

ब्यौरा

आप वैट जैसा टैक्स और कोई दूसरा सेवा शुल्क जोड़ना चाहते हैं, जो उस टैक्स पर भी लागू होता है.

समस्या का हल

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

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

उदाहरण

प्रतिशत के तौर पर टैक्स लगता है

इस उदाहरण में, असे पहले टैक्स 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>

रकम के तौर पर टैक्स लगता है

जैसे

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

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