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

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

खास जानकारी

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

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

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

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

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

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

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

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

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

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

Basis = [room|person]
अवधि = [stay|night]
टाइप = [percent|amount]

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

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

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

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

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

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

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

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

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

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

कार्रवाइयां

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

सामान्य

हर Tax का आकलन किया जाता है. अगर लागू हो, तो इसकी गणना AmountBeforeTax की उस रकम के आधार पर की जाती है जो BaseByGuestAmt में दी गई थी.
लागू होने वाले सभी टैक्स और शुल्क का हिसाब लगाने के बाद, उन्हें मूल कीमत में जोड़ दिया जाता है. इससे कुल कीमत तय होती है.
<Tax> और <Fee> के लिए सिंटैक्स एक ही है.
टैक्स और शुल्क पर ये पाबंदियां लागू हो सकती हैं:
- यह सिर्फ़ कुछ खास तरह के कमरों और किराये के प्लान पर लागू होता है.
- यह सिर्फ़ ठहरने की कुछ तारीखों पर लागू होता है.
ये शर्तें वैकल्पिक हैं. आपको हर तरह की शर्त सेट करने की ज़रूरत नहीं है. अगर ये सभी पर लागू होती हैं, तो इन्हें खाली छोड़ा जा सकता है.
टैक्स या शुल्क में बदलाव होने पर, TaxFeeInfo अपडेट भेजें.

उदाहरण

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

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

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

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

खास जानकारी

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

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

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

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

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

कार्रवाइयां

सामान्य

उदाहरण

कैसे करें

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

ब्यौरा

समाधान

नमूना

दूसरा उदाहरण: ApplicableNights का इस्तेमाल करके टैक्स को कैसे टारगेट करें

ब्यौरा

समाधान

नमूना

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

ब्यौरा

समाधान

नमूना

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

ब्यौरा

समाधान

नमूना

पांचवां उदाहरण: ब्रैकेट के साथ स्लैब टैक्स सेट करने का तरीका

ब्यौरा

समाधान

नमूना

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

ब्यौरा

समाधान

उदाहरण

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

टैक्स के लिए शुल्क की रकम

दूसरा उदाहरण: `ApplicableNights` का इस्तेमाल करके टैक्स को कैसे टारगेट करें