टैक्सफ़ी

अनुरोध

सिंटैक्स

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]</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>
      </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]</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>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

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

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

एलिमेंट / @एट्रिब्यूट गड़बड़ी कितनी बार हुई Type जानकारी
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> और <OTA_HotelAvailNotifRQ> मैसेज के <RequestorID> एलिमेंट में बताई गई ID एट्रिब्यूट वैल्यू से मेल खानी चाहिए.
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> के एलिमेंट में बताया जाता है और इसकी पहचान इसके रूम आईडी का इस्तेमाल करके की जाती है. (इसकी <RoomID> वैल्यू भी OTA_HotelRateAmountNotifRQ मैसेज में मौजूद 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 मैसेज में दी जाती है.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string रेट प्लान के लिए यूनीक आइडेंटिफ़ायर. यह वैल्यू, लेन-देन (प्रॉपर्टी डेटा) मैसेज में दिए पैकेज आईडी की वैल्यू और <OTA_HotelRateAmountNotifRQ> और <OTA_HotelAvailNotifRQ>, दोनों मैसेज के RatePlanCode एट्रिब्यूट में मैप की जाती है.<PackageData><StatusApplicationControl> ज़्यादा से ज़्यादा 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: फ़ाइनल रेट में जोड़ने के लिए एक तय रकम
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 टैक्स के लिए तीन अक्षर का मुद्रा कोड (उदाहरण के लिए: USD).
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 Usercountries की खास जानकारी का टाइप.

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

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

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

अगर उपयोगकर्ता वाला देश type सेट नहीं है, तो हम इसे include मानेंगे और यह टैक्स सिर्फ़ उन देशों के उपयोगकर्ताओं पर लागू होगा जहां यह सुविधा उपलब्ध है.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country Usercountries की सूची में से एक देश के बारे में बताता है.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR देश का कोड, जैसे कि DE या FR. ध्यान दें कि कुछ देशों के लिए, CLDR देश का कोड, दो अक्षरों वाले ISO देश कोड से अलग होता है. इसके अलावा, CLDR इलाके के कोड भी इस्तेमाल नहीं किए जा सकते.
TaxFeeInfo / Property / Fees 0..1 Fees एक या एक से ज़्यादा <Fee> एलिमेंट के लिए कंटेनर.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

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

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

उदाहरण

बेसिक मैसेज

बेसिक 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% टैक्स.
  • अगर एक रात का किराया 7500 से ज़्यादा है, तो 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 मैसेज में ये एलिमेंट और एट्रिब्यूट होते हैं:

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

हर मैसेज में <Success> या <Issues> मौजूद होता है.
TaxFeeInfoResponse / Issues 0..1 Issues TaxFeeInfo मैसेज को प्रोसेस करते समय, एक या एक से ज़्यादा समस्याओं के लिए एक कंटेनर मिला.

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

किस तरह की समस्या मिली.

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

उदाहरण

कार्रवाई सफल रही

नीचे, पूरी तरह से प्रोसेस किए गएtaxFeeInfo मैसेज का जवाब दिया गया है.

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

समस्याएं

गड़बड़ियों के कारण प्रोसेस नहीं हो रहे एक टैक्सएफ़ीआईओ मैसेज का जवाब यहां दिया गया है.

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