TaxFeeInfo

অনুরোধ

সিনট্যাক্স

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>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">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>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

উপাদান এবং বৈশিষ্ট্য

TaxFeeInfo বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
TaxFeeInfo 1 Complex element একটি একক সম্পত্তির জন্য ট্যাক্স এবং ফি নির্ধারণকারী একটি বার্তার মূল উপাদান৷
TaxFeeInfo / @timestamp 1 DateTime এই বার্তা তৈরির তারিখ এবং সময়।
TaxFeeInfo / @id 1 string এই অনুরোধ বার্তার জন্য একটি অনন্য শনাক্তকারী৷ এই মান প্রতিক্রিয়া বার্তা ফেরত দেওয়া হয়. অনুমোদিত অক্ষর হল az , AZ , 0-9 , _ (আন্ডারস্কোর), এবং - (ড্যাশ)।
TaxFeeInfo / @partner 1 string এই বার্তার জন্য অংশীদার অ্যাকাউন্ট. এই স্ট্রিং মান হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "অংশীদার কী" মান।

দ্রষ্টব্য: আপনার যদি একটি ব্যাকএন্ড থাকে যা একাধিক অ্যাকাউন্টের জন্য ফিড প্রদান করে, তাহলে এই মানটিকে একই অ্যাকাউন্টের জন্য আপনার <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 সম্পত্তির অনন্য শনাক্তকারী। এই মানটি অবশ্যই হোটেল তালিকা ফিডে <লিস্টিং> এলিমেন্টে <id> ব্যবহার করে নির্দিষ্ট হোটেল আইডির সাথে মিলতে হবে। হোটেল আইডিটি হোটেল সেন্টারেও তালিকাভুক্ত করা হয়েছে।
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 ব্যবহার করে চিহ্নিত করা হয়েছে। (এর <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 রেট প্ল্যানের অনন্য শনাক্তকারী। এই মানটি লেনদেনের (প্রপার্টি ডেটা) বার্তার <PackageData> এবং RatePlanCode মান যা <OTA_HotelRateAmountNotifRQ> এবং <OTA_HotelAvailNotifRQ> উভয় বার্তায় <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: চূড়ান্ত হারে যোগ করার জন্য একটি সমতল পরিমাণ
  • 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 করের জন্য তিন-অক্ষরের মুদ্রা কোড (উদাহরণস্বরূপ: USD)।

দ্রষ্টব্য: যদি <Currency> নির্দিষ্ট করা না থাকে কিন্তু <Amount> নির্দিষ্ট করা থাকে তাহলে <Currency> মানটি বেস রেট কারেন্সিতে ডিফল্ট হয়।

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 ।

যদি UserCountries type include হিসেবে সেট করা থাকে, তাহলে ট্যাক্স শুধুমাত্র তালিকাভুক্ত দেশগুলির ব্যবহারকারীদের জন্য প্রযোজ্য হবে।

যেখানে UserCountries type exclude , ট্যাক্স শুধুমাত্র তালিকাভুক্ত দেশের বাইরের ব্যবহারকারীদের জন্য প্রযোজ্য হবে।

UserCountries type সেট না থাকলে, আমরা এটিকে include হিসাবে বিবেচনা করব এবং ট্যাক্স শুধুমাত্র তালিকাভুক্ত দেশগুলির ব্যবহারকারীদের জন্য প্রযোজ্য হবে।

TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country ব্যবহারকারী দেশের তালিকায় একটি দেশকে সংজ্ঞায়িত করে।
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string একটি CLDR দেশের কোড , যেমন DE বা FR । মনে রাখবেন, কিছু দেশের জন্য, CLDR দেশের কোড 2-অক্ষরের ISO দেশের কোডের মতো নয়। এছাড়াও, CLDR অঞ্চল কোড সমর্থিত নয়।
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

একটি র্যাঙ্ক যা ট্যাক্স বা ফি এর জন্য আবেদনের ক্রম নির্দিষ্ট করে। উদাহরণস্বরূপ, 2 এর মান মানে কর দ্বিতীয়টি প্রয়োগ করা হয়েছে। <Type> cumulative_percent এ সেট করা থাকলে এই উপাদানটি সর্বদা নির্দিষ্ট করা উচিত। সাধারণভাবে, এই আদেশটি কর এবং ফি উভয় ক্ষেত্রেই প্রয়োগ করা হয়।

<Rank>2</Rank>

ট্যাক্স এবং ফিগুলির মধ্যে ডুপ্লিকেট র্যাঙ্ক মানগুলি অনুমোদিত কিন্তু এর ফলে অনির্ধারিত আচরণ হতে পারে যেখানে কর এবং ফিগুলি নির্বিচারে এবং ক্রমবর্ধমান পদ্ধতিতে প্রয়োগ করা হয়।

বিকল্পভাবে, <Rank> -এর মধ্যে "exclusive" প্যারামিটার ব্যবহার করুন যে একই র‍্যাঙ্কের সমস্ত ট্যাক্স এবং ফি হারে প্রযোজ্য। ডিফল্ট মান false এবং একই র‍্যাঙ্ক সহ সমস্ত কর এবং ফি একটি নির্বিচারে হারে প্রয়োগ করা হয়৷ "exclusive" ঐচ্ছিক।

যদি exclusive প্যারামিটারটি true সেট করা হয়, শুধুমাত্র <Tax> এর মধ্যে তালিকাভুক্ত প্রথম ট্যাক্স বা <Fee> এর মধ্যে তালিকাভুক্ত প্রথম ফি হারে প্রয়োগ করা হয়।

<Rank exclusive="true">1</Rank>

শুল্কের আগে কর প্রথমে প্রয়োগ করা হয়; তাই, যদি একটি ট্যাক্স এবং ফি একই র‍্যাঙ্ক থাকে এবং ফি "exclusive" true সেট করা থাকে, তাহলেও ট্যাক্স প্রথমে প্রযোজ্য হবে। কর এবং ফি যে ক্রমানুসারে প্রয়োগ করা উচিত সেই ক্রমে তালিকাভুক্ত করা সর্বোত্তম অনুশীলন।

একই র‌্যাঙ্কের সমস্ত ট্যাক্স এবং ফি অন্তর্ভুক্ত করতে exclusive সেটিং এড়িয়ে চলুন true

র‌্যাঙ্ক ছাড়াই ট্যাক্স এবং ফি সমস্ত র‌্যাঙ্ক করা এন্ট্রির আগে প্রয়োগ করা হয়।

<Rank> অবশ্যই 1 থেকে 99 (অন্তর্ভুক্ত) রেঞ্জের মধ্যে হতে হবে।

TaxFeeInfo / Property / Fees 0..1 Fees এক বা একাধিক <Fee> উপাদানের জন্য ধারক।
TaxFeeInfo / Property / Fees / Fee 1..n Fee

সম্পত্তিতে প্রযোজ্য একটি পৃথক ফি।

<Tax> এর সমস্ত চাইল্ড উপাদান একই সিনট্যাক্স সহ <Fee> জন্য সমর্থিত।

উদাহরণ

সম্পত্তি প্রতি 300 ট্যাক্স এবং ফি একটি সীমা আছে. একটি সম্পত্তি থেকে ট্যাক্স এবং ফি সরাতে "কর মুছুন" উদাহরণ পড়ুন।

মৌলিক বার্তা

একটি মৌলিক TaxFeeInfo বার্তা:

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

স্ল্যাব ট্যাক্স

ভারতীয় জিএসটি স্ল্যাব ট্যাক্স, রাতের হারের উপর ভিত্তি করে প্রযোজ্য। ট্যাক্স বন্ধনী হল:

  • রাত্রিকালীন হার 1000 এর কম বা সমান হলে কোন কর নেই।
  • 12% ট্যাক্স যদি রাতের হার 1000 এর বেশি এবং 7500 এর কম বা সমান হয়।
  • রাতের হার 7500-এর বেশি হলে 18% ট্যাক্স। 
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-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="2024-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>

থাকার তারিখের রেঞ্জ ওভারল্যাপিং

যখন একাধিক থাকার তারিখের ব্যাপ্তিগুলিকে সংজ্ঞায়িত করা হয় যেগুলি একে অপরের সাথে ওভারল্যাপ করা হয়, তখন প্রদত্ত থাকার তারিখটি শুধুমাত্র সেই ব্যাপ্তিগুলির একটিকে সন্তুষ্ট করতে হবে এবং সেগুলিকে নয়। থাকার তারিখের ব্যাপ্তি একটি একক শুরু এবং শেষ পরিসরে নির্দিষ্ট করতে হবে।

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2025-03-12T10:59:49+01:00"
            id="12345678"
            partner="partner_key">
  <Property action="overlay">
    <ID>987654</ID>
      <Taxes>
        <Tax>
          <Type>amount</Type>
          <Basis>person</Basis>
          <Period>night</Period>
          <RoomTypes>
            <RoomType id="RoomID_1"/>
            <RoomType id="RoomID_2"/>
          </RoomTypes>
          <StayDates application="any">
            <DateRange start="2025-06-16"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>50</Amount>
        </Tax>
      </Taxes>
      <Fees>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-12" end="2025-03-18"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>200</Amount>
        </Fee>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-19"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>300</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

একচেটিয়া র্যাঙ্ক সহ একাধিক ট্যাক্স এবং ফি

exclusive="true" এবং বিভিন্ন র‌্যাঙ্ক সহ একাধিক ট্যাক্স এবং ফি সহ নিম্নলিখিত একটি উদাহরণ। নিম্নলিখিত ট্যাক্স এবং ফি বিবেচনা করুন যা হারে প্রয়োগ করা উচিত:

  • র্যাঙ্ক 1 exclusive="true" সহ একটি 5% দখল কর৷
  • র্যাঙ্ক 1 সহ একটি 10 USD রুম সার্ভিস ট্যাক্স৷
  • র‍্যাঙ্ক 2 exclusive="true" সহ 50 USD ক্লিনিং ফি।
  • র‍্যাঙ্ক 3 সহ একটি 2% সুবিধার ফি।

<Rank> এর উপর ভিত্তি করে যে কালানুক্রমিক ক্রমে কর এবং ফি প্রয়োগ করা হয় তা হল:

  1. exclusive="true" এবং র‍্যাঙ্ক 1 সহ দখল কর প্রথমে প্রয়োগ করা হয়৷
  2. র‍্যাঙ্ক 1 সহ রুম সার্ভিস ট্যাক্স প্রযোজ্য হবে না কারণ পূর্ববর্তী দখল কর একচেটিয়া।
  3. exclusive="true" এবং র‍্যাঙ্ক 2 সহ পরিচ্ছন্নতার ফি পরবর্তীতে প্রয়োগ করা হয়।
  4. র‍্যাঙ্ক 3 সহ সুবিধার ফি র‍্যাঙ্ক 2 এর সাথে পরিচ্ছন্নতার ফি পরে প্রয়োগ করা হয়। 

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-02-29T12:00:00Z"
            id="tax-fee-id"
            partner="partner_key">
  <Property action="overlay">
    <ID>765432</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Amount>5</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank exclusive="true">1</Rank>
      </Tax>
      <Tax>
        <Type>amount</Type>
        <Amount>10</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank>1</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Amount>50</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank exclusive="true">2</Rank>
      </Fee>
      <Fee>
        <Type>percent</Type>
        <Amount>2</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank>3</Rank>
      </Fee>
    </Fees>
  </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 বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
TaxFeeInfoResponse 1 Complex element একটি প্রাপ্ত TaxFeeInfo অনুরোধ বার্তার সাফল্য বা সমস্যা নির্দেশ করে মূল উপাদান।
TaxFeeInfoResponse / @timestamp 1 DateTime এই বার্তা তৈরির তারিখ এবং সময়।
TaxFeeInfoResponse / @id 1 string সংশ্লিষ্ট TaxFeeInfo বার্তা থেকে অনন্য শনাক্তকারী।
TaxFeeInfoResponse / @partner 1 string এই বার্তার জন্য অংশীদার অ্যাকাউন্ট.
TaxFeeInfoResponse / Success 0..1 Success নির্দেশ করে যে TaxFeeInfo বার্তাটি সতর্কতা, ত্রুটি বা ব্যর্থতা ছাড়াই সফলভাবে প্রক্রিয়া করা হয়েছে।

হয় <Success> বা <Issues> প্রতিটি বার্তায় উপস্থিত থাকে।

TaxFeeInfoResponse / Issues 0..1 Issues TaxFeeInfo বার্তা প্রক্রিয়া করার সময় এক বা একাধিক সমস্যার সম্মুখীন হওয়ার জন্য একটি ধারক।

হয় <Success> বা <Issues> প্রতিটি বার্তায় উপস্থিত থাকে।

TaxFeeInfoResponse / Issues / Issue 1..n Issue TaxFeeInfo বার্তা প্রক্রিয়া করার সময় একটি সতর্কতা, ত্রুটি বা ব্যর্থতার বিবরণ। এই বিষয়গুলির বিশদ বিবরণ ফিড স্ট্যাটাস ত্রুটি বার্তাগুলিতে পাওয়া যাবে।
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="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

ইস্যু

নিম্নলিখিত একটি TaxFeeInfo বার্তার একটি প্রতিক্রিয়া যা ত্রুটির কারণে প্রক্রিয়া করা হয়নি৷ 

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