खास जानकारी
TaxFeeInfo
मैसेज में, प्रॉपर्टी बुक करते समय उपयोगकर्ता पर लागू होने वाले टैक्स और शुल्कों के बारे में बताया जाता है. ये शुल्क, वेबसाइट पर बताए गए प्रॉपर्टी के टैक्स नियमों के आधार पर तय किए जाते हैं. टैक्स और शुल्क का डेटा जोड़ने के लिए, आपको OTA_HotelRateAmountNotifRQ
का इस्तेमाल करना होगा.
इस मैसेज के लिए सिर्फ़ overlay
कार्रवाई की जा सकती है. इसका इस्तेमाल, हर प्रॉपर्टी के लिए टैक्स और शुल्क के डेटा को बदलने के लिए किया जाता है. टैक्स और शुल्क में होने वाले हर बदलाव के बारे में अपडेट भेजना ज़रूरी है.
टैक्स और शुल्क जोड़ने के तरीके
टैक्स और शुल्क जोड़ने के दो सामान्य तरीके हैं:
पहले तरीके में, किराये के मैसेज में AmountAfterTax
डाला जाता है. इसके बाद, किराये के मैसेज भेजकर टैक्स और शुल्क जोड़े जाते हैं. इन मैसेज में, एक रात का मूल किराया (इसमें सभी टैक्स और शुल्क शामिल नहीं हैं) और एक रात का कुल किराया (इसमें सभी टैक्स और शुल्क शामिल हैं), दोनों शामिल होते हैं. किराये की ये दरें हर रात के हिसाब से तय की जाती हैं. इसलिए, यह तरीका सिर्फ़ प्रतिशत के हिसाब से तय किए गए टैक्स और शुल्कों या हर रात के हिसाब से तय किए गए शुल्कों के लिए काम करता है. हर ठहरने के हिसाब से तय किए गए टैक्स और शुल्कों का इस्तेमाल नहीं किया जा सकता.
दूसरा (प्राथमिक) तरीका यह है कि किराये के मैसेज में सिर्फ़ टैक्स और शुल्क के बिना, हर रात के लिए बुकिंग की बुनियादी दरें भेजें. साथ ही, प्रॉपर्टी के लेवल पर टैक्स और शुल्क की जानकारी देने के लिए, TaxFeeInfo
का इस्तेमाल करें. अलग-अलग टैक्स और शुल्क अब भी कुछ खास तरह के कमरों और किराये के प्लान के लिए तय किए जा सकते हैं. ये प्लान, तारीख की कुछ सीमाओं के लिए लागू होते हैं.
इस पेज पर, TaxFeeInfo
का इस्तेमाल करने के पसंदीदा तरीके के बारे में बताया गया है. इसमें, रेटिंग मैसेज (OTA_HotelRateAmountNotifRQ
) में AmountAfterTax
की जानकारी देने का तरीका नहीं बताया गया है.
टैक्स सेट करने के तरीके
टैक्स सेट करने के लिए, आपके पास ये विकल्प हैं:
- Basis = [room|person]
- Period = [stay|night]
- टाइप = [percent|amount]
अगर अवधि stay
और टाइप percent
है, तो Google पूरे ठहरने के लिए टैक्स और शुल्क लागू करता है. भले ही, यात्रा की योजना में दी गई कोई तारीख StayDates
की सीमा से ओवरलैप हो. टैक्स और शुल्क सिर्फ़ तब लागू नहीं किया जा सकता, जब यात्रा की योजना में दी गई सभी तारीखें, ठहरने की तारीखों की सीमा से ओवरलैप होती हों. अगर ठहरने की तारीख की कई सीमाएं एक-दूसरे से ओवरलैप होती हैं, तो StayDates
सीमाओं को एक खुली सीमा में तय किया जाता है. TaxFeeInfo
के उदाहरण देखें.
टैक्स से जुड़ी अलग-अलग स्थितियों के उदाहरणों के लिए, कैसे करें लेख पढ़ें. इन उदाहरणों में, टैक्स से जुड़ी कुछ मुख्य स्थितियों के बारे में बताया गया है. इनमें ये शामिल हैं:
- हर प्रॉपर्टी पर लागू होने वाला फ़्लैट टैक्स और प्रतिशत के हिसाब से टैक्स
- टैक्स का प्रतिशत, सिर्फ़ पहली रात के बाद की रातों पर लागू होता है
- पुराने टैक्स को नए टैक्स से बदलने का तरीका
- देशों के लिए टैक्स शामिल करना या बाहर रखना
- ब्रैकेट के साथ स्लैब टैक्स सेट करना
- टैक्स और टैक्स के दायरे में आने वाला शुल्क सेट करना
यहां दिए गए सेक्शन में, टैक्स की जानकारी जोड़ने और अपडेट करने के बारे में सामान्य दिशा-निर्देश, एक बुनियादी उदाहरण, और तरीका बताया गया है.
ज़रूरी और वैकल्पिक एलिमेंट
एक्सएमएल रेफ़रंस में, ज़रूरी और वैकल्पिक एलिमेंट के बारे में जानकारी दी जाती है. एट्रिब्यूट और चाइल्ड एलिमेंट के बारे में जानकारी पाने के लिए, 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>