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 বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

এলিমেন্ট / @অ্যাট্রিবিউট ঘটনা আদর্শ বিবরণ
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 প্রপার্টির জন্য অনন্য শনাক্তকারী। এই মানটি হোটেল তালিকা ফিডে <listing> উপাদানে <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> -এ ম্যাপ করে। অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা ৫০টি।
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> এবং <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 করের জন্য তিন-অক্ষরের মুদ্রা কোড (উদাহরণস্বরূপ: USD)।

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

TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float করের শতাংশ বা পরিমাণের মূল্য।
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights এই মানটি শুধুমাত্র তখনই প্রযোজ্য হবে যখন <Type> কে amount এ সেট করা থাকে এবং <Period> night এ সেট করা থাকে।

কত রাতের জন্য কর প্রযোজ্য হতে পারে তা সীমাবদ্ধ করে।

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> উপাদানের জন্য ধারক। সংলগ্ন এবং অ-ওভারল্যাপিং কর বন্ধনীর একটি সেট সংজ্ঞায়িত করে। উদাহরণস্বরূপ: ভারতীয় GST স্ল্যাব কর।

এই উপাদানটি কেবল তখনই বৈধ যখন <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 মানের চেয়ে কঠোরভাবে কম হয়।

এই মানটি অবশ্যই ০ এর চেয়ে বেশি হতে হবে।

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 অবশ্যই ০ থেকে ১৭ (সমেত) এর মধ্যে হতে হবে।

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 সেট করা থাকে, তবুও করটি প্রথমে প্রযোজ্য হবে। সর্বোত্তম পদ্ধতি হল কর এবং ফি'গুলিকে যে ক্রমে প্রয়োগ করা উচিত সেই ক্রমে তালিকাভুক্ত করা।

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

র‍্যাঙ্ক ছাড়া কর এবং ফি সকল র‍্যাঙ্ক করা এন্ট্রির আগে প্রযোজ্য হবে।

<Rank> অবশ্যই ১ থেকে ৯৯ (সমেত) এর মধ্যে হতে হবে।

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="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>

স্ল্যাব কর

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

  • রাতের ভাড়া ১০০০ টাকার কম বা সমান হলে কোন কর নেই।
  • রাতের ভাড়া ১০০০ এর বেশি এবং ৭৫০০ এর কম বা সমান হলে ১২% কর।
  • রাতের ভাড়া ৭৫০০ টাকার বেশি হলে ১৮% কর। 
<?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 কর।
  • ১১ থেকে ১৭ বছর বয়সী শিশুদের জন্য ১০ ডলার কর।
  • ০ থেকে ১০ বছর বয়সী শিশুদের জন্য ৫ ডলার কর। 
<?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" এবং বিভিন্ন র‍্যাঙ্ক সহ একাধিক কর এবং ফি সহ একটি উদাহরণ দেওয়া হল। রেটে প্রযোজ্য নিম্নলিখিত কর এবং ফি বিবেচনা করুন:

  • ৫% দখল কর, যার র‍্যাঙ্ক ১ exclusive="true" ।
  • ১ নম্বর স্থানের জন্য ১০ মার্কিন ডলার রুম সার্ভিস ট্যাক্স।
  • র‍্যাঙ্ক ২ exclusive="true" সহ ৫০ মার্কিন ডলার পরিষ্কারের ফি।
  • ৩য় স্থানের জন্য ২% সুযোগ-সুবিধা ফি।

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

  1. প্রথমে exclusive="true" এবং র‍্যাঙ্ক ১ সহ অকুপেন্সি ট্যাক্স প্রয়োগ করা হয়।
  2. ১ নম্বর র‍্যাঙ্কের রুম সার্ভিস ট্যাক্স প্রযোজ্য হবে না কারণ পূর্ববর্তী অকুপেন্সি ট্যাক্স এক্সক্লুসিভ।
  3. exclusive="true" এবং rank 2 সহ পরিষ্কারের ফি পরবর্তীতে প্রযোজ্য হবে।
  4. ৩য় স্থানের সুযোগ-সুবিধা ফি ২য় স্থানের পরিষ্কারের ফি-এর পরে প্রযোজ্য হবে। 

<?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 বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

এলিমেন্ট / @অ্যাট্রিবিউট ঘটনা আদর্শ বিবরণ
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>