खास जानकारी
TaxFeeInfo मैसेज में, टैक्स और शुल्क की जानकारी होती है. ये टैक्स और शुल्क, किसी प्रॉपर्टी की बुकिंग करने पर उपयोगकर्ता पर लागू होते हैं. साथ ही, ये प्रॉपर्टी की वेबसाइट पर बताए गए टैक्स के नियमों के आधार पर तय किए जाते हैं. टैक्स और शुल्क का डेटा जोड़ने के लिए, रेट मैसेज (OTA_HotelRateAmountNotifRQ) का इस्तेमाल करें.
इस मैसेज के लिए, सिर्फ़ overlay कार्रवाई की जा सकती है. इसका इस्तेमाल, हर प्रॉपर्टी के लिए टैक्स और शुल्क के डेटा को बदलने के लिए किया जाता है. टैक्स और शुल्क में बदलाव होने पर, इनकी जानकारी अपडेट करना ज़रूरी है.
टैक्स और शुल्क की जानकारी भेजने के तरीके के साथ-साथ, अपनी दरों की कीमत से जुड़ी खास जानकारी पाने के लिए, टैक्स और शुल्क की नीति देखें.
टैक्स और शुल्क जोड़ने के तरीके
टैक्स और शुल्क जोड़ने के दो सामान्य तरीके हैं:
पहले तरीके में, रेट मैसेज में AmountAfterTax की जानकारी दी जाती है. इसमें टैक्स और शुल्क जोड़ने के लिए, रेट मैसेज भेजे जाते हैं. इन मैसेज में, हर रात के लिए तय की गई मूल दरें (इनमें सभी टैक्स और शुल्क शामिल नहीं होते) और हर रात के लिए तय की गई कुल दरें (इनमें सभी टैक्स और शुल्क शामिल होते हैं), दोनों शामिल होती हैं. ये दरें, हर रात के हिसाब से तय की जाती हैं. इसलिए, यह तरीका सिर्फ़ प्रतिशत के आधार पर तय किए जाने वाले टैक्स और शुल्क या हर रात के हिसाब से तय की गई फ़्लैट रकम के लिए काम करता है. इसमें, हर बार रुकने पर लगने वाले टैक्स और शुल्क का इस्तेमाल नहीं किया जा सकता.
दूसरे (सुझाए गए) तरीके में, रेट मैसेज में सिर्फ़ टैक्स और शुल्क के बिना, हर रात के हिसाब से तय की गई मूल दरें भेजी जाती हैं. साथ ही, किसी प्रॉपर्टी के लिए टैक्स और शुल्क की जानकारी देने के लिए, TaxFeeInfo का इस्तेमाल किया जाता है. अलग-अलग टैक्स और शुल्क, अब भी खास तरह के कमरों और रेट प्लान के हिसाब से तय किए जा सकते हैं. ये टैक्स और शुल्क, तारीख की कुछ सीमाओं पर लागू होते हैं.
इस पेज पर, TaxFeeInfo का इस्तेमाल करने के सुझाए गए तरीके के बारे में बताया गया है. साथ ही, इस तरीके का रेफ़रंस दिया गया है. इसमें, रेट मैसेज (OTA_HotelRateAmountNotifRQ) में AmountAfterTax की जानकारी देने के तरीके के बारे में नहीं बताया गया है.
टैक्स सेट करने के तरीके
टैक्स सेट करने के लिए, आपके पास ये विकल्प हैं:
- Basis = [room|person]
- Period = [stay|night]
- Type = [percent|amount]
अगर Period की वैल्यू stay और Type की वैल्यू percent है, तो Google, पूरे स्टे के लिए टैक्स और शुल्क लागू करता है. भले ही, यात्रा कार्यक्रम में शामिल कोई तारीख, StayDates की सीमा से मेल खाती हो. ऐसा नहीं किया जा सकता कि टैक्स और शुल्क सिर्फ़ तब लागू हो, जब यात्रा कार्यक्रम में शामिल सभी तारीखें, स्टे-डेट की तारीख की सीमा से मेल खाती हों. अगर स्टे की तारीख की एक से ज़्यादा सीमाएं एक-दूसरे से मेल खाती हैं, तो StayDates की सीमाओं को एक ही खुली सीमा में तय किया जाता है. TaxFeeInfo उदाहरण देखें.
टैक्स से जुड़े अलग-अलग परिदृश्यों के उदाहरण देखने के लिए, इस्तेमाल के तरीके देखें. इन उदाहरणों में, टैक्स से जुड़े कुछ अहम परिदृश्यों के बारे में बताया गया है. इनमें, इन परिदृश्यों के लिए इस्तेमाल के तरीके भी शामिल हैं:
- हर प्रॉपर्टी के लिए, फ़्लैट टैक्स और प्रतिशत के हिसाब से टैक्स लागू करना
- पहले दिन के बाद की रातों के लिए, सिर्फ़ प्रतिशत के हिसाब से टैक्स लागू करना
- पुराने टैक्स को नए टैक्स से बदलने का तरीका
- देशों के लिए टैक्स शामिल करना या बाहर रखना
- स्लैब टैक्स को ब्रैकेट के साथ सेट करना
- टैक्स और टैक्स देने लायक शुल्क सेट करना
इन सेक्शन में, सामान्य दिशा-निर्देश, एक बुनियादी उदाहरण, और इस्तेमाल के तरीके वाले परिदृश्यों के बारे में बताया गया है. इनकी मदद से, टैक्स की जानकारी जोड़ने और अपडेट करने की शुरुआत की जा सकती है.
ज़रूरी और वैकल्पिक एलिमेंट
एक्सएमएल रेफ़रंस
में, ज़रूरी और वैकल्पिक एलिमेंट के बारे में बताया गया है. एट्रिब्यूट और चाइल्ड एलिमेंट के बारे में जानने के लिए, TaxFeeInfo के एलिमेंट और एट्रिब्यूट देखें.
सिंटैक्स और स्कीमा
TaxFeeInfo सिंटैक्स
उदाहरण का इस्तेमाल, मैसेज बनाते समय रेफ़रंस के तौर पर करें. इससे यह पक्का किया जा सकेगा कि आपने सही फ़ॉर्मैट का इस्तेमाल किया है.
Google को फ़ीड सबमिट करने से पहले, पब्लिश किए गए स्कीमा की मदद से उन्हें मान्य करने के लिए, xmllint जैसे तीसरे पक्ष के एक्सएमएल टूल का इस्तेमाल किया जा सकता है. TaxFeeinfo मैसेज के स्कीमा के लिए, होटल के विज्ञापनों के स्कीमा देखें.
दिशा-निर्देश
इस सेक्शन में, टैक्स और शुल्क सेट करने के सामान्य दिशा-निर्देशों और खास निर्देशों के बारे में बताया गया है.
कार्रवाइयां
- ओवरले
- किसी प्रॉपर्टी के सभी टैक्स को बदलने के लिए,
overlayकार्रवाई का इस्तेमाल करें.overlayकार्रवाई, डिफ़ॉल्ट कार्रवाई है और सिर्फ़ यही कार्रवाई की जा सकती है. यह अपडेट लागू होने के बाद, इस प्रॉपर्टी के लिए पहले से मौजूद सभी टैक्स और शुल्क हटा दिए जाएंगे.
सामान्य
हर
Taxका आकलन किया जाता है. अगर यह लागू होता है, तो इसकी गिनतीBaseByGuestAmtमें तय की गईAmountBeforeTaxके आधार पर की जाती है.लागू होने वाले सभी टैक्स और शुल्क की गिनती करने के बाद, इन्हें मूल कीमत में जोड़ा जाता है. इससे कुल कीमत तय होती है.
<Tax>और<Fee>के लिए सिंटैक्स एक ही होते हैं.टैक्स और शुल्क पर ये पाबंदियां लगाई जा सकती हैं:
- सिर्फ़ खास तरह के कमरों और रेट प्लान पर लागू होता है.
- सिर्फ़ स्टे की खास तारीखों पर लागू होता है.
ये पाबंदियां वैकल्पिक हैं. हर तरह की पाबंदी सेट करना ज़रूरी नहीं है. अगर ये सभी पर लागू होती हैं, तो इन्हें खाली छोड़ा जा सकता है.
टैक्स या शुल्क में बदलाव होने पर,
TaxFeeInfoका अपडेट भेजें.
उदाहरण
इस सेक्शन में, ज़रूरी और वैकल्पिक एलिमेंट का इस्तेमाल करके, TaxFeeInfo मैसेज का एक बुनियादी उदाहरण दिया गया है. फ़ाइल तैयार करने के बाद, आपको इसे Google को भेजना होगा. इसके लिए, इस एंडपॉइंट पर POST मैसेज का इस्तेमाल करें:
https://www.google.com/travel/hotels/uploads/taxes
मैसेज को पुश/POST करने के बारे में ज़्यादा जानने के लिए, मैसेज पुश करना लेख पढ़ें.
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>