टैक्सफ़ी

अनुरोध

सिंटैक्स

TaxFeeInfo मैसेज इस सिंटैक्स का इस्तेमाल करता है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <Rank>integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

एलिमेंट और एट्रिब्यूट

TaxFeeInfo मैसेज में ये एलिमेंट और एट्रिब्यूट शामिल हैं:

एलिमेंट / @एट्रिब्यूट दोहराए जाने की संख्या टाइप कंपनी का ब्यौरा
TaxFeeInfo 1 Complex element किसी एक प्रॉपर्टी के लिए टैक्स और शुल्क के बारे में बताने वाले मैसेज का रूट एलिमेंट.
TaxFeeInfo / @timestamp 1 DateTime यह मैसेज बनाए जाने की तारीख और समय.
TaxFeeInfo / @id 1 string अनुरोध वाले इस मैसेज के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू रिस्पॉन्स वाले मैसेज में दिखती है. a-z, A-Z, 0-9, _ (अंडरस्कोर), और - (डैश) वर्ण इस्तेमाल किए जा सकते हैं.
TaxFeeInfo / @partner 1 string इस मैसेज को भेजने के लिए पार्टनर का खाता. स्ट्रिंग की यह वैल्यू "पार्टनर कुंजी" की वैल्यू है. इसे Hotel Center में खाता सेटिंग पेज पर लिस्ट किया गया है.

ध्यान दें: अगर आपके पास ऐसा बैकएंड है जो कई खातों के लिए फ़ीड उपलब्ध कराता है, तो इस वैल्यू को उसी खाते के लिए, आपके <OTA_HotelRateAmountNotifRQ> के <RequestorID> एलिमेंट में बताए गए ID एट्रिब्यूट की वैल्यू और उसी खाते के <OTA_HotelAvailNotifRQ> मैसेज से मेल खाना चाहिए.

TaxFeeInfo / Property 1..n Property एक कंटेनर, जिसकी मदद से एक प्रॉपर्टी के लिए टैक्स और शुल्क की जानकारी दी जाती है.
TaxFeeInfo / Property / @action 0..1 string इससे पता चलता है कि अपडेट को कैसे लागू किया जाता है. सिर्फ़ overlay का इस्तेमाल किया जा सकता है और डिफ़ॉल्ट वैल्यू overlay है. यह अपडेट लागू होने से पहले, इस प्रॉपर्टी से जुड़े पिछले Taxes और Fees हटा दिए जाएंगे.
TaxFeeInfo / Property / ID 1 string प्रॉपर्टी के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू उस होटल आईडी से मेल खानी चाहिए जो होटल सूची फ़ीड के<listing> एलिमेंट में <id> का इस्तेमाल करके बताई गई है. होटल आईडी को Hotel Center में भी शामिल किया गया है.
TaxFeeInfo / Property / Taxes 0..1 Taxes एक या ज़्यादा <Tax> एलिमेंट के लिए कंटेनर.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax यह प्रॉपर्टी पर लागू होने वाला अलग-अलग टैक्स होता है.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes 0..1 RoomTypes कमरों के टाइप की सूची के लिए कंटेनर, जिस पर टैक्स लागू होता है. टैक्स, बताए गए हर <RoomType> पर लागू होता है. अगर <RoomTypes> तय नहीं किया गया है, तो सभी कमरों पर टैक्स लागू होगा.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType इससे पता चलता है कि कमरा किस तरह का है. रूम का टाइप, लेन-देन (प्रॉपर्टी का डेटा) मैसेज में मौजूद <RoomData> एलिमेंट में तय होता है. इसकी पहचान रूम आईडी का इस्तेमाल करके की जाती है. (OTA_HotelRateAmountNotifRQ मैसेज में, इसकी <RoomID> वैल्यू को InvTypeCode एट्रिब्यूट से भी पहचाना जाता है.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string इन्वेंट्री के लिए यूनीक आइडेंटिफ़ायर (कमरे का टाइप). यह वैल्यू, लेन-देन (प्रॉपर्टी का डेटा) मैसेज में मौजूद <RoomID> से मैप होती है. ज़्यादा से ज़्यादा 50 वर्ण इस्तेमाल किए जा सकते हैं.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans रेट प्लान की सूची के लिए कंटेनर, जिस पर टैक्स लागू होता है. अगर <RatePlans> नहीं बताई गई है, तो सभी रेट प्लान पर टैक्स लागू होगा.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan यह रेट प्लान बताता है. रेट प्लान को पैकेज, किराये, और उपलब्धता की जानकारी के हिसाब से बनाया जाता है. इसकी जानकारी लेन-देन (प्रॉपर्टी का डेटा), OTA_HotelRateAmountNotifRQ, और OTA_HotelAvailNotifRQ मैसेज में बताई गई है. इसकी पहचान PackageID से की जाती है.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string रेट प्लान के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू, लेन-देन (प्रॉपर्टी का डेटा) मैसेज में मौजूद <PackageData> में मौजूद PackageID की वैल्यू से मैप होती है. यह वैल्यू <OTA_HotelRateAmountNotifRQ> और <OTA_HotelAvailNotifRQ>, दोनों मैसेज के <StatusApplicationControl> की RatePlanCode एट्रिब्यूट में दिखती है. ज़्यादा से ज़्यादा 50 वर्ण डाले जा सकते हैं.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates एक या उससे ज़्यादा तारीख की सीमाओं के लिए कंटेनर, जिसमें यह जानकारी दी जाती है कि टैक्स लागू होने के लिए बुकिंग कब की जानी चाहिए.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange तारीख की वह सीमा जिससे तय होता है कि टैक्स लागू करने के लिए, बुकिंग कब करनी होगी.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date तारीख की सीमा के साथ शुरू होने की तारीख (प्रॉपर्टी के टाइम ज़ोन के हिसाब से). यह तारीख, end तारीख से पहले की होनी चाहिए या इसके बराबर होनी चाहिए. अगर start नहीं दिया गया है, तो शुरू होने की तारीख के हिसाब से तारीख की सीमा की कोई सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date प्रॉपर्टी के टाइम ज़ोन के आधार पर, खत्म होने की तारीख. इसमें तारीख की सीमा भी शामिल होती है. यह तारीख, start तारीख के बराबर या उसके बाद की होनी चाहिए. अगर end नहीं दिया गया है, तो खत्म होने की तारीख के हिसाब से तारीख की सीमा की सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

हफ़्ते के वे दिन जिन्हें तारीख की सीमा में अनुमति दी गई है. अगर इसके बारे में जानकारी नहीं दी गई है, तो तारीख की सीमा में सभी दिनों को शामिल किया जा सकता है. स्ट्रिंग में मौजूद हर वर्ण एक दिन के बारे में बताता है. उदाहरण के लिए, "MTWHF" से पता चलता है कि तारीख की सीमा में, सोमवार से शुक्रवार तक भी इसका इस्तेमाल किया जा सकता है.

मान्य वर्ण हैं:

  • सोमवार का किराया M
  • मंगलवार का T
  • बुधवार का W
  • गुरुवार का H
  • शुक्रवार का F
  • शनिवार का S
  • रविवार का किराया U

वर्णों का कोई भी कॉम्बिनेशन मान्य होता है.

TaxFeeInfo / Property / Taxes / Tax / CheckinDates 0..1 CheckinDates एक या उससे ज़्यादा तारीख की सीमाओं के लिए एक कंटेनर, जो तय करता है कि टैक्स लागू करने के लिए चेक-इन कब होना ज़रूरी है.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange तारीख की वह सीमा जिससे तय होता है कि टैक्स लागू करने के लिए, चेक-इन कब करना ज़रूरी है.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date तारीख की सीमा के साथ शुरू होने की तारीख (प्रॉपर्टी के टाइम ज़ोन के हिसाब से). यह तारीख, end तारीख से पहले की होनी चाहिए या इसके बराबर होनी चाहिए. अगर start नहीं दिया गया है, तो शुरू होने की तारीख के हिसाब से तारीख की सीमा की कोई सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date प्रॉपर्टी के टाइम ज़ोन के आधार पर, खत्म होने की तारीख. इसमें तारीख की सीमा भी शामिल होती है. यह तारीख, start तारीख के बराबर या उसके बाद की होनी चाहिए. अगर end नहीं दिया गया है, तो खत्म होने की तारीख के हिसाब से तारीख की सीमा की सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

हफ़्ते के वे दिन जिन्हें तारीख की सीमा में अनुमति दी गई है. अगर इसके बारे में जानकारी नहीं दी गई है, तो तारीख की सीमा में सभी दिनों को शामिल किया जा सकता है. स्ट्रिंग में मौजूद हर वर्ण एक दिन के बारे में बताता है. उदाहरण के लिए, "MTWHF" से पता चलता है कि तारीख की सीमा में, सोमवार से शुक्रवार तक भी इसका इस्तेमाल किया जा सकता है.

मान्य वर्ण हैं:

  • सोमवार का किराया M
  • मंगलवार का T
  • बुधवार का W
  • गुरुवार का H
  • शुक्रवार का F
  • शनिवार का S
  • रविवार का किराया U

वर्णों का कोई भी कॉम्बिनेशन मान्य होता है.

TaxFeeInfo / Property / Taxes / Tax / CheckoutDates 0..1 CheckoutDates एक या उससे ज़्यादा तारीख की सीमाओं के लिए एक कंटेनर, जो तय करता है कि टैक्स लागू करने के लिए चेक-आउट कब होना ज़रूरी है.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange तारीख की वह सीमा जिससे तय होता है कि टैक्स लागू करने के लिए, चेक-आउट कब करना ज़रूरी है.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date तारीख की सीमा के साथ शुरू होने की तारीख (प्रॉपर्टी के टाइम ज़ोन के हिसाब से). यह तारीख, end तारीख से पहले की होनी चाहिए या इसके बराबर होनी चाहिए. अगर start नहीं दिया गया है, तो शुरू होने की तारीख के हिसाब से तारीख की सीमा की कोई सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date प्रॉपर्टी के टाइम ज़ोन के आधार पर, खत्म होने की तारीख. इसमें तारीख की सीमा भी शामिल होती है. यह तारीख, start तारीख के बराबर या उसके बाद की होनी चाहिए. अगर end नहीं दिया गया है, तो खत्म होने की तारीख के हिसाब से तारीख की सीमा की सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

हफ़्ते के वे दिन जिन्हें तारीख की सीमा में अनुमति दी गई है. अगर इसके बारे में जानकारी नहीं दी गई है, तो तारीख की सीमा में सभी दिनों को शामिल किया जा सकता है. स्ट्रिंग में मौजूद हर वर्ण एक दिन के बारे में बताता है. उदाहरण के लिए, "MTWHF" से पता चलता है कि तारीख की सीमा में, सोमवार से शुक्रवार तक भी इसका इस्तेमाल किया जा सकता है.

मान्य वर्ण हैं:

  • सोमवार का किराया M
  • मंगलवार का T
  • बुधवार का W
  • गुरुवार का H
  • शुक्रवार का F
  • शनिवार का S
  • रविवार का किराया U

वर्णों का कोई भी कॉम्बिनेशन मान्य होता है.

TaxFeeInfo / Property / Taxes / Tax / StayDates 0..1 StayDates

एक या उससे ज़्यादा तारीख की सीमाओं के लिए कंटेनर, जिससे यह तय होता है कि टैक्स लागू है या नहीं. जैसे कि सीज़न के मुताबिक मिलने वाली छूट के ऑफ़र.

TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

यह बताता है कि टैक्स कैसे लागू किया जाना चाहिए.

मान्य मान हैं:

  • all: अगर यात्रा की योजना में सभी तारीखें और ठहरने की तारीखें एक साथ हैं, तो यात्रा की योजना में हर रात के हिसाब से टैक्स लागू होगा.
  • any: अगर यात्रा की योजना की कोई तारीख, ठहरने की तारीखों की सीमा में बताई गई तारीख से ओवरलैप करती है, तो यात्रा की योजना में शामिल सभी रातों के लिए टैक्स लागू होगा.
  • overlap: यात्रा की योजना में सिर्फ़ उन रातों पर टैक्स लागू होगा जो ठहरने की तारीखों की सीमा में एक तारीख से ओवरलैप हो रही है.

    ध्यान दें: overlap सिर्फ़ तब मान्य होता है, जब <Period> को night पर सेट किया गया हो.

इस एट्रिब्यूट की वैल्यू हमेशा बताना ज़रूरी है.

TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange 1..99 DateRange तारीख की वह सीमा जिसमें टैक्स लागू होने की तारीखें होती हैं.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start 0..1 Date तारीख की सीमा के साथ शुरू होने की तारीख (प्रॉपर्टी के टाइम ज़ोन के हिसाब से). यह तारीख, end तारीख से पहले की होनी चाहिए या इसके बराबर होनी चाहिए. अगर start नहीं दिया गया है, तो शुरू होने की तारीख के हिसाब से तारीख की सीमा की कोई सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date प्रॉपर्टी के टाइम ज़ोन के आधार पर, खत्म होने की तारीख. इसमें तारीख की सीमा भी शामिल होती है. यह तारीख, start तारीख के बराबर या उसके बाद की होनी चाहिए. अगर end नहीं दिया गया है, तो खत्म होने की तारीख के हिसाब से तारीख की सीमा की सीमा नहीं होती है.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

हफ़्ते के वे दिन जिन्हें तारीख की सीमा में अनुमति दी गई है. अगर इसके बारे में जानकारी नहीं दी गई है, तो तारीख की सीमा में सभी दिनों को शामिल किया जा सकता है. स्ट्रिंग में मौजूद हर वर्ण एक दिन के बारे में बताता है. उदाहरण के लिए, "MTWHF" से पता चलता है कि तारीख की सीमा में, सोमवार से शुक्रवार तक भी इसका इस्तेमाल किया जा सकता है.

मान्य वर्ण हैं:

  • सोमवार का किराया M
  • मंगलवार का T
  • बुधवार का W
  • गुरुवार का H
  • शुक्रवार का F
  • शनिवार का S
  • रविवार का किराया U

वर्णों का कोई भी कॉम्बिनेशन मान्य होता है.

TaxFeeInfo / Property / Taxes / Tax / Type 1 enum

मान्य मान हैं:

  • percent: कुल किराये का प्रतिशत
  • amount: फ़ाइनल रेट में जोड़ने के लिए तय रकम
  • cumulative_percent: इस टैक्स या शुल्क का हिसाब लगाने से पहले, जमा की गई कुल दर, टैक्स, और शुल्क का प्रतिशत. अगर यह वैल्यू बताई गई है, तो <Rank> भी बताना ज़रूरी है.
  • ऐसा हो सकता है कि <Brackets> और <AgeBrackets> के बारे में cumulative_percent के टाइप के तौर पर न बताया गया हो.

TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

मान्य मान हैं:

  • room: <Amount> को रूम पर लागू किया गया है.
  • person: <Amount> हर व्यक्ति के लिए लागू होता है. यह वैल्यू सिर्फ़ तब लागू होती है, जब <Type> को रकम पर सेट किया गया हो.
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

मान्य मान हैं:

  • stay: <Amount> को, ठहरने के कुल किराये में जोड़ा गया है.
  • night: ठहरने के लिए हर रात के हिसाब से <Amount> का शुल्क लिया जाता है.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string टैक्स के लिए तीन अक्षर वाला मुद्रा कोड (उदाहरण के लिए: डॉलर).
TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float टैक्स के प्रतिशत या रकम की वैल्यू.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights यह वैल्यू सिर्फ़ तब लागू होती है, जब <Type> को रकम पर और <Period> को रात पर सेट किया गया हो.

इससे उन रातों की संख्या तय होती है जिनके लिए टैक्स लागू किया जा सकता है.

max या excluded में से किसी एक के बारे में बताएं, लेकिन दोनों के लिए नहीं.

TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N"> से पता चलता है कि पहली N रातों के बाद की रातों को शामिल नहीं किया जाना चाहिए.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N"> से पता चलता है कि पहली N रातों को शामिल नहीं किया जाना चाहिए.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay इससे, ठहरने की उन सीमाओं के बारे में पता चलता है जिनमें यह टैक्स लागू हो सकता है. अगर ठहरने की कुल अवधि, कम से कम और ज़्यादा से ज़्यादा सीमा से ज़्यादा है, तो टैक्स लागू नहीं होता है.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min 0..1 integer होटल में ठहरने के लिए, तय की गई कम से कम रातों की जानकारी पर टैक्स लागू होगा. अगर इसका कोई मान तय नहीं किया गया है, तो कोई कम से कम सीमा तय नहीं होगी.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max 0..1 integer होटल में ज़्यादा से ज़्यादा रातों के लिए टैक्स लागू करना. अगर इसका कोई मान तय नहीं किया गया है, तो कोई भी सीमा तय नहीं होगी.
TaxFeeInfo / Property / Taxes / Tax / Brackets 0..1 Brackets एक या ज़्यादा <Bracket> एलिमेंट के लिए कंटेनर. एक साथ लगने वाले और ओवरलैप न होने वाले टैक्स ब्रैकेट के सेट के बारे में बताता है. जैसे, भारतीय जीएसटी स्लैब वाले टैक्स.

यह एलिमेंट सिर्फ़ तब मान्य होता है, जब <Period> को night पर सेट किया गया हो और <Amount> के बारे में नहीं बताया गया हो.

TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float पहले ब्रैकेट के starts_at की वैल्यू के नीचे, हर रात के लिए तय की गई दरों पर प्रतिशत या टैक्स की रकम की वैल्यू.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket एक रात के किराये के आधार पर टैक्स ब्रैकेट तय करता है.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

टैक्स ब्रैकेट की निचली सीमा के बारे में बताता है. ऊपरी सीमा की जानकारी अगले ब्रैकेट के starts_at फ़ील्ड में दी गई है. आखिरी ब्रैकेट के लिए कोई ऊपरी सीमा नहीं है.

कोई टैक्स ब्रैकेट तब चालू होता है, जब एक रात का किराया, ब्रैकेट की starts_at वैल्यू से ज़्यादा या उसके बराबर होता है. साथ ही, यह अगले ब्रैकेट की starts_at वैल्यू से भी कम होता है.

यह मान पूरी तरह से 0 से ज़्यादा होना चाहिए.

TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float इस टैक्स ब्रैकेट पर लागू किए गए टैक्स की रकम या प्रतिशत का मान.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets इससे लोगों की उम्र के आधार पर, टैक्स का एक सेट तय किया जा सकता है.

यह एलिमेंट सिर्फ़ तब मान्य होता है, जब <Brackets> और <Amount> के बारे में न बताया गया हो. <Basis> को person पर और <Type> को amount पर सेट किया गया हो.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge वयस्कों के लिए टैक्स तय करने वाला कंटेनर.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float वयस्कों पर लागू होने वाले टैक्स की एक तय रकम.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets एक या उससे ज़्यादा <ChildAgeBracket> एलिमेंट रखने वाला कंटेनर.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket बच्चों के लिए उम्र की सीमा और उससे जुड़े टैक्स की रकम के बारे में बताता है.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

इससे बच्चे की उम्र की ऊपरी सीमा के बारे में पता चलता है. निचली सीमा की जानकारी पिछले ब्रैकेट के max_age फ़ील्ड + 1 में दी गई है. ऊपरी और निचली सीमाएं, दोनों शामिल होती हैं. पहले ब्रैकेट के लिए निचली सीमा 0 है.

max_age, 0 से 17 के बीच की होनी चाहिए. इसमें ये दोनों भी शामिल हैं.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float टैक्स की एक तय रकम, जो इस उम्र सीमा के बच्चों पर लागू होती है.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries ऐसे उपयोगकर्ता देशों की सूची बनाने के लिए कंटेनर जिनके लिए टैक्स को शामिल किया गया है या बाहर रखा गया है. अगर यह टैक्स मौजूद है, तो इसे सिर्फ़ चुनिंदा देशों के उपयोगकर्ताओं के लिए शामिल किया जाएगा या बाहर रखा जाएगा.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum उपयोगकर्ता देश के स्पेसिफ़िकेशन का टाइप.

मान्य वैल्यू include और exclude हैं.

अगर उपयोगकर्ता के देश type को include के तौर पर सेट किया गया है, तो टैक्स सिर्फ़ सूची में शामिल देशों के उपयोगकर्ताओं पर लागू होगा.

वहीं, अगर उपयोगकर्ता देश का type exclude है, तो टैक्स सिर्फ़ सूची में शामिल देशों से बाहर के उपयोगकर्ताओं पर लागू होगा.

अगर उपयोगकर्ता देश type सेट नहीं है, तो हम इसे include मानेंगे. टैक्स, सिर्फ़ सूची में शामिल देशों के उपयोगकर्ताओं पर लागू होगा.

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country उपयोगकर्ता देशों की सूची में मौजूद एक देश के बारे में बताता है.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR देश का कोड, जैसे कि DE या FR. ध्यान दें कि कुछ देशों में, CLDR और देश का कोड, दो अक्षरों वाले आईएसओ देश के कोड से अलग है. इसके अलावा, CLDR क्षेत्र कोड का भी इस्तेमाल नहीं किया जा सकता.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

वह रैंक जो इस टैक्स या शुल्क के लिए आवेदन का क्रम तय करती है. उदाहरण के लिए, वैल्यू 2 होने का मतलब है कि यह टैक्स दूसरे बार लागू होगा. अगर <Type> को cumulative_percent पर सेट किया गया है, तो इस एलिमेंट के बारे में हमेशा बताया जाना चाहिए. आम तौर पर, यह क्रम टैक्स और शुल्क, दोनों के लिए लागू होता है. टैक्स और शुल्क के बीच, डुप्लीकेट रैंक की वैल्यू का इस्तेमाल किया जा सकता है. हालांकि, इसकी वजह से टैक्स और शुल्क के बारे में कोई तय जानकारी नहीं मिलती है. इनमें, टैक्स और शुल्क मनचाहे तरीके से लागू किए जाएंगे. बिना रैंक वाले टैक्स और शुल्क, रैंक की गई सभी एंट्री से पहले लागू होते हैं.

<Rank> को 1 से 99 के बीच की रेंज में होना चाहिए. इसमें ये दोनों भी शामिल हैं.

TaxFeeInfo / Property / Fees 0..1 Fees एक या ज़्यादा <Fee> एलिमेंट के लिए कंटेनर.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

प्रॉपर्टी पर लागू होने वाला अलग से शुल्क.

एक जैसे सिंटैक्स वाले <Fee> के लिए, <Tax> के सभी चाइल्ड एलिमेंट भी काम करते हैं.

उदाहरण

बुनियादी मैसेज

TaxFeeInfo का बुनियादी मैसेज:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16: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>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

टैक्स मिटाएं

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

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

स्लैब टैक्स

भारतीय जीएसटी स्लैब टैक्स, जो रात के समय के किराये के आधार पर लागू होता है. टैक्स ब्रैकेट ये हैं:

  • एक रात का किराया 1,000 या उससे कम होने पर, कोई टैक्स नहीं लगेगा.
  • एक रात का किराया 1,000 से ज़्यादा और 7,500 या उससे कम होने पर, 12% टैक्स.
  • एक रात का किराया 7,500 से ज़्यादा होने पर, 18% टैक्स.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16: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>

उम्र के हिसाब से टैक्स

लोगों की उम्र के हिसाब से लागू होने वाले टैक्स:

  • वयस्क लोगों के लिए 20 डॉलर का टैक्स.
  • 11 से 17 साल के बच्चों के लिए 10 डॉलर टैक्स.
  • 0 से 10 साल के बच्चों के लिए 5 डॉलर टैक्स.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <AgeBrackets>
          <AdultCharge amount="20"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="10" amount="5"/>
            <ChildAgeBracket max_age="17" amount="10"/>
          </ChildAgeBrackets>
        </AgeBrackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

जवाब

सिंटैक्स

TaxFeeInfoResponse मैसेज इस सिंटैक्स का इस्तेमाल करता है:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</TaxFeeInfoResponse>

एलिमेंट और एट्रिब्यूट

TaxFeeInfoResponse मैसेज में ये एलिमेंट और एट्रिब्यूट होते हैं:

एलिमेंट / @एट्रिब्यूट दोहराए जाने की संख्या टाइप कंपनी का ब्यौरा
TaxFeeInfoResponse 1 Complex element वह रूट एलिमेंट जो टैक्सFeeInfo के अनुरोध वाले मैसेज के कामयाब होने या समस्याओं के बारे में बताता है.
TaxFeeInfoResponse / @timestamp 1 DateTime यह मैसेज बनाए जाने की तारीख और समय.
TaxFeeInfoResponse / @id 1 string इससे जुड़े टैक्सFeeInfo मैसेज से मिला यूनीक आइडेंटिफ़ायर.
TaxFeeInfoResponse / @partner 1 string इस मैसेज को भेजने के लिए पार्टनर का खाता.
TaxFeeInfoResponse / Success 0..1 Success इससे पता चलता है कि टैक्सFeeInfo मैसेज को बिना किसी चेतावनी, गड़बड़ी या गड़बड़ी के प्रोसेस किया गया था.

हर मैसेज में <Success> या <Issues> मौजूद है.

TaxFeeInfoResponse / Issues 0..1 Issues TaxFeeInfo मैसेज को प्रोसेस करते समय एक या ज़्यादा समस्याओं का कंटेनर.

हर मैसेज में <Success> या <Issues> मौजूद है.

TaxFeeInfoResponse / Issues / Issue 1..n Issue टैक्सFeeInfo मैसेज को प्रोसेस करते समय मिली किसी चेतावनी, गड़बड़ी या गड़बड़ी की जानकारी. इन समस्याओं की जानकारी, फ़ीड की स्थिति से जुड़े गड़बड़ी के मैसेज में देखी जा सकती है.
TaxFeeInfoResponse / Issues / Issue / @code 1 integer समस्या का आइडेंटिफ़ायर.
TaxFeeInfoResponse / Issues / Issue / @status 1 enum

किस तरह की समस्या का सामना करना पड़ा.

मान्य वैल्यू warning, error, और failure हैं .

उदाहरण

पुष्टि हो गई

यह जवाब, पूरी तरह से प्रोसेस हो चुके टैक्सFeeInfo मैसेज का जवाब है.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

समस्याएंं

यह जवाब एक टैक्सFeeInfo मैसेज का है, जिसे गड़बड़ियों की वजह से प्रोसेस नहीं किया गया.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</TaxFeeInfoResponse>