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 এই অনুরোধের মেসেজের জন্য একটি অনন্য শনাক্তকারী। এই ভ্যালু রেসপন্স মেসেজে ফেরত পাঠানো হয়। অনুমোদিত অক্ষরগুলি হল 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 অ্যাট্রিবিউট দ্বারা এর <RoomID> ভ্যালুও রেফার করা হয়।)
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 মেসেজে উল্লেখ করা থাকে এবং PackageID-এর মাধ্যমে শনাক্ত করা হয়।
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string রেট প্ল্যানের অনন্য শনাক্তকারী। এই ভ্যালু ট্রানজ্যাকশন (প্রপার্টি ডেটা) মেসেজের <PackageData>-এ PackageID ভ্যালু এবং <OTA_HotelRateAmountNotifRQ> ও <OTA_HotelAvailNotifRQ> মেসেজের <StatusApplicationControl> অ্যাট্রিবিউটের অধীনে সেট করা RatePlanCode ভ্যালুর সাথে ম্যাপ করে। সর্বাধিক ৫০টি অক্ষর লেখা যাবে।
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> এলিমেন্টের কন্টেনার। সংলগ্ন এবং ওভারল্যাপ না করা ট্যাক্স ব্র্যাকেটের একটি সেট নির্ধারণ করে। যেমন: ভারতীয় 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 ফিল্ড + ১-এ নির্দিষ্ট করা আছে। উচ্চ ও নিম্ন সীমা, দুটিই অন্তর্ভুক্ত। প্রথম ব্র্যাকেটের নিম্ন সীমা হল ০।

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 UserCountries-এর তালিকায় একটি দেশ নির্ধারণ করে।
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR দেশের কোড, যেমন DE বা FR। মনে রাখবেন, কিছু দেশের ক্ষেত্রে, CLDR দেশের কোড ২-অক্ষরের ISO দেশের কোডের মতো একই নয়। এছাড়াও, CLDR অঞ্চল কোড কাজ করে না।
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

ট্যাক্স বা ফি-এর জন্য আবেদনের ক্রম নির্দিষ্ট করে এমন একটি র‍্যাঙ্ক। যেমন, ২ ভ্যালুর অর্থ হল ট্যাক্স দ্বিতীয়বার প্রয়োগ করা হয়েছে। <Type>-এর মান cumulative_percent-এ সেট করা থাকলে, এই এলিমেন্টটি সবসময় উল্লেখ করতে হবে। সাধারণত, এই ক্রম ট্যাক্স ও ফি উভয়ের ক্ষেত্রেই প্রযোজ্য হয়।

<Rank>2</Rank>

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

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

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

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

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

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

র‍্যাঙ্ক করা হয়নি এমন ট্যাক্স ও ফি র‍্যাঙ্ক করা সব এন্ট্রির আগে প্রয়োগ করা হয়।

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

বয়সের ভিত্তিতে ট্যাক্স

অতিথিদের বয়সের ভিত্তিতে ট্যাক্স প্রযোজ্য:

  • প্রাপ্তবয়স্কদের জন্য $২০ ট্যাক্স।
  • ১১ থেকে ১৭ বছর বয়সী বাচ্চাদের জন্য $১০ ট্যাক্স।
  • ০ থেকে ১০ বছর বয়সী বাচ্চাদের জন্য $৫ ট্যাক্স।
<?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" ও র‍্যাঙ্ক ২ সহ ক্লিনিং ফি প্রয়োগ করা হয়।
  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>