অনুরোধ
সিনট্যাক্স
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 | এই বার্তার জন্য অংশীদার অ্যাকাউন্ট। এই স্ট্রিং ভ্যালুটি হলো হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "পার্টনার কী" ভ্যালু। দ্রষ্টব্য: যদি আপনার এমন কোনো ব্যাকএন্ড থাকে যা একাধিক অ্যাকাউন্টের জন্য ফিড সরবরাহ করে, তাহলে এই মানটিকে অবশ্যই একই অ্যাকাউন্টের জন্য আপনার |
| 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 মেসেজগুলিতে নির্ধারিত থাকে এবং প্যাকেজআইডি (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" দ্বারা বোঝানো হয় যে তারিখের পরিসরে সপ্তাহের কর্মদিবসগুলো অন্তর্ভুক্ত করা যাবে। বৈধ অক্ষরগুলো হলো:
যেকোনো অক্ষরের সংমিশ্রণ বৈধ। |
| 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" দ্বারা বোঝানো হয় যে তারিখের পরিসরে সপ্তাহের কর্মদিবসগুলো অন্তর্ভুক্ত করা যাবে। বৈধ অক্ষরগুলো হলো:
যেকোনো অক্ষরের সংমিশ্রণ বৈধ। |
| 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" দ্বারা বোঝানো হয় যে তারিখের পরিসরে সপ্তাহের কর্মদিবসগুলো অন্তর্ভুক্ত করা যাবে। বৈধ অক্ষরগুলো হলো:
যেকোনো অক্ষরের সংমিশ্রণ বৈধ। |
| TaxFeeInfo / Property / Taxes / Tax / StayDates | 0..1 | StayDates | এক বা একাধিক তারিখের পরিসরের জন্য একটি ধারক, যা কর প্রযোজ্য হবে কিনা তা নির্ধারণ করে, যেমন মৌসুমী ছাড়ের সুবিধা দেওয়ার জন্য। |
| TaxFeeInfo / Property / Taxes / Tax / StayDates / @application | 1 | enum | করটি কীভাবে প্রয়োগ করা উচিত তা বর্ণনা করে। বৈধ মানগুলি হলো:
এই অ্যাট্রিবিউটটি সর্বদা নির্দিষ্ট করতে হবে। |
| 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" দ্বারা বোঝানো হয় যে তারিখের পরিসরে সপ্তাহের কর্মদিবসগুলো অন্তর্ভুক্ত করা যাবে। বৈধ অক্ষরগুলো হলো:
যেকোনো অক্ষরের সংমিশ্রণ বৈধ। |
| TaxFeeInfo / Property / Taxes / Tax / Type | 1 | enum | বৈধ মানগুলি হলো:
|
| TaxFeeInfo / Property / Taxes / Tax / Basis | 1 | enum | বৈধ মানগুলি হলো:
|
| TaxFeeInfo / Property / Taxes / Tax / Period | 1 | enum | বৈধ মানগুলি হলো:
|
| 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> কে amount এবং <Period> কে night হিসেবে সেট করা থাকবে।যে ক'টি রাতের জন্য কর আরোপ করা যাবে, তার সংখ্যা সীমিত করে। হয় |
| 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> উপাদানের জন্য ধারক। এটি সন্নিহিত এবং পরস্পর-অসংলগ্ন কর স্তরগুলির একটি সেট নির্ধারণ করে। উদাহরণস্বরূপ: ভারতীয় জিএসটি স্ল্যাব কর। এই এলিমেন্টটি কেবল তখনই বৈধ যখন |
| 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 | একটি ট্যাক্স ব্র্যাকেটের নিম্ন সীমা নির্ধারণ করে। এর উচ্চ সীমা পরবর্তী ব্র্যাকেটের ' একটি ট্যাক্স ব্র্যাকেট তখনই সক্রিয় থাকে যখন প্রতি রাতের হার সেই ব্র্যাকেটের ' এই মানটি অবশ্যই ০ থেকে বড় হতে হবে। |
| TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount | 1 | float | এই ট্যাক্স ব্র্যাকেটে প্রযোজ্য করের শতাংশ বা পরিমাণের মান। |
| TaxFeeInfo / Property / Taxes / Tax / AgeBrackets | 0..1 | AgeBrackets | এর মাধ্যমে বাসিন্দাদের বয়সের ভিত্তিতে একগুচ্ছ কর নির্ধারণ করা যায়। এই উপাদানটি কেবল তখনই বৈধ যখন |
| 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 | একটি শিশুর বয়সের ঊর্ধ্বসীমা নির্ধারণ করে। নিম্নসীমাটি পূর্ববর্তী ব্র্যাকেটের |
| 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 স্পেসিফিকেশনের ধরণ। বৈধ মানগুলো হলো যদি UserCountries অন্যদিকে, যদি UserCountries যদি UserCountries |
| TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country | 1..n | Country | ব্যবহারকারী দেশগুলোর তালিকায় একটি দেশকে সংজ্ঞায়িত করে। |
| TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code | 1 | string | একটি CLDR কান্ট্রি কোড , যেমন DE বা FR । উল্লেখ্য যে, কিছু দেশের ক্ষেত্রে CLDR কান্ট্রি কোডটি ২-অক্ষরের ISO কান্ট্রি কোডের মতো নয়। এছাড়াও, CLDR রিজিওন কোড সমর্থিত নয়। |
| TaxFeeInfo / Property / Taxes / Tax / Rank | 1 | integer | একটি র্যাঙ্ক যা কোনো কর বা ফি প্রয়োগের ক্রম নির্দিষ্ট করে। উদাহরণস্বরূপ, ২-এর একটি মান মানে হলো করটি দ্বিতীয় ধাপে প্রয়োগ করা হবে। যদি <Rank>2</Rank> কর এবং ফি-এর ক্ষেত্রে একই র্যাঙ্ক মান ব্যবহারের অনুমতি আছে, কিন্তু এর ফলে অনির্ধারিত আচরণ দেখা দিতে পারে, যেখানে কর এবং ফি যথেচ্ছভাবে ও ক্রমবর্ধমানভাবে প্রয়োগ করা হয়। বিকল্পভাবে, একই র্যাঙ্কের সমস্ত কর ও ফি রেটের উপর প্রয়োগ করা হবে তা নির্দেশ করতে যদি <Rank exclusive="true">1</Rank> ফি-এর আগে ট্যাক্স প্রযোজ্য হয়; তাই, যদি কোনো ট্যাক্স এবং ফি-এর র্যাঙ্ক একই হয় এবং ফি-এর ক্ষেত্রে একই র্যাঙ্কের সমস্ত কর ও ফি অন্তর্ভুক্ত করতে, র্যাঙ্কবিহীন সকল এন্ট্রির পূর্বে কর ও ফি প্রযোজ্য হবে। |
| TaxFeeInfo / Property / Fees | 0..1 | Fees | এক বা একাধিক <Fee> উপাদানের জন্য ধারক। |
| TaxFeeInfo / Property / Fees / Fee | 1..n | 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> -এর ভিত্তিতে কর ও ফি প্রয়োগের কালানুক্রমিক ক্রমটি হলো:
-
exclusive="true"এবং rank 1 সহ অকুপেন্সি ট্যাক্সটি প্রথমে প্রয়োগ করা হয়। - র্যাঙ্ক ১-এর রুম সার্ভিস ট্যাক্স প্রযোজ্য হবে না, কারণ পূর্ববর্তী অকুপেন্সি ট্যাক্সটি এর অন্তর্ভুক্ত নয়।
-
exclusive="true"এবং rank 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 মেসেজটিতে নিম্নলিখিত উপাদান এবং অ্যাট্রিবিউটগুলো রয়েছে:
| এলিমেন্ট / @অ্যাট্রিবিউট | ঘটনা | প্রকার | বর্ণনা |
|---|---|---|---|
| TaxFeeInfoResponse | 1 | Complex element | প্রাপ্ত TaxFeeInfo অনুরোধ বার্তার সাফল্য বা সমস্যা নির্দেশকারী মূল উপাদান। |
| TaxFeeInfoResponse / @timestamp | 1 | DateTime | এই বার্তাটি তৈরির তারিখ ও সময়। |
| TaxFeeInfoResponse / @id | 1 | string | সংশ্লিষ্ট TaxFeeInfo বার্তা থেকে প্রাপ্ত অনন্য শনাক্তকারী। |
| TaxFeeInfoResponse / @partner | 1 | string | এই বার্তার জন্য অংশীদার অ্যাকাউন্ট। |
| TaxFeeInfoResponse / Success | 0..1 | Success | এটি নির্দেশ করে যে TaxFeeInfo বার্তাটি কোনো সতর্কতা, ত্রুটি বা ব্যর্থতা ছাড়াই সফলভাবে প্রক্রিয়াজাত করা হয়েছে। প্রতিটি বার্তায় হয় |
| TaxFeeInfoResponse / Issues | 0..1 | Issues | TaxFeeInfo বার্তাটি প্রক্রিয়াকরণের সময় উদ্ভূত এক বা একাধিক সমস্যার জন্য একটি ধারক। প্রতিটি বার্তায় হয় |
| TaxFeeInfoResponse / Issues / Issue | 1..n | Issue | TaxFeeInfo বার্তাটি প্রক্রিয়াকরণের সময় সম্মুখীন হওয়া কোনো সতর্কতা, ত্রুটি বা ব্যর্থতার বিবরণ। এই সমস্যাগুলির বিশদ বিবরণ ‘Feed Status Error Messages’- এ পাওয়া যাবে। |
| TaxFeeInfoResponse / Issues / Issue / @code | 1 | integer | সমস্যাটির শনাক্তকারী। |
| TaxFeeInfoResponse / Issues / Issue / @status | 1 | enum | সম্মুখীন হওয়া সমস্যার ধরণ। বৈধ মানগুলো হলো |
উদাহরণ
সাফল্য
নিম্নলিখিতটি একটি সফলভাবে প্রক্রিয়াকৃত 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>