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>
        <Rank>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>
        <Rank>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 حساب شریک برای این پیام. این مقدار رشته، مقدار «کلید شریک» است که در صفحه تنظیمات حساب در مرکز هتل فهرست شده است.

توجه: اگر یک Backend دارید که برای چندین حساب فید ارائه می‌دهد، این مقدار باید با مقدار مشخصه ID مشخص شده در عنصر <RequestorID> پیام‌های <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> برای یک حساب مطابقت داشته باشد.

TaxFeeInfo / Property 1..n Property ظرفی برای تعیین مالیات و عوارض برای یک ملک واحد.
TaxFeeInfo / Property / @action 0..1 string نحوه اعمال به روز رسانی را مشخص می کند. فقط overlay پشتیبانی می‌شود و پیش‌فرض overlay است. هر گونه Taxes و Fees قبلی برای این دارایی قبل از اعمال این به روز رسانی پاک می شود.
TaxFeeInfo / Property / ID 1 string شناسه منحصر به فرد ملک این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید لیست هتل مطابقت داشته باشد. شناسه هتل نیز در مرکز هتل درج شده است.
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> آن نیز توسط ویژگی InvTypeCode در پیام های OTA_HotelRateAmountNotifRQ ارجاع داده می شود.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string شناسه منحصر به فرد موجودی (نوع اتاق). این مقدار در پیام Transaction (Property Data) به <RoomID> نشان داده می شود. حداکثر تعداد کاراکترهای مجاز 50 کاراکتر است.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans ظرفی برای فهرستی از طرح‌های نرخی که مالیات بر آنها اعمال می‌شود. اگر <RatePlans> مشخص نشده باشد، مالیات بر همه طرح‌های نرخ اعمال می‌شود.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan یک طرح نرخ را مشخص می کند. طرح نرخ با ترکیبی از بسته، نرخ‌ها و در دسترس بودن تعریف می‌شود، همانطور که در پیام‌های Transaction (Property Data)، OTA_HotelRateAmountNotifRQ، و OTA_HotelAvailNotifRQ تعریف شده است، و توسط PackageID مشخص شده است.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string شناسه منحصر به فرد برای طرح نرخ. این مقدار به مقدار PackageID در پیام Transaction (Property Data) <PackageData> و مقدار RatePlanCode که تحت ویژگی <StatusApplicationControl> در هر دو پیام <OTA_HotelRateAmountNotifRQ> و <OTA_HotelAvailNotifRQ> تنظیم شده است، منطبق می شود. حداکثر تعداد کاراکترهای مجاز 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> . مجموعه ای از براکت های مالیاتی پیوسته و غیر همپوشانی را تعریف می کند. به عنوان مثال: مالیات اسلب 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 براکت بعدی باشد.

این مقدار باید به شدت بیشتر از 0 باشد.

TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float ارزش درصد یا مقدار مالیات اعمال شده در این گروه مالیاتی.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets تعیین مجموعه ای از مالیات بر اساس سن ساکنان را امکان پذیر می کند.

این عنصر فقط زمانی معتبر است که <Brackets> و <Amount> مشخص نشده باشند، <Basis> روی person و <Type> روی amount تنظیم شده باشد.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge ظرفی برای تعیین مالیات برای بزرگسالان.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float مقدار ثابت مالیات اعمال شده برای بزرگسالان.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets ظرفی برای نگهداری یک یا چند عنصر <ChildAgeBracket> .
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket محدوده سنی کودکان و مقدار مالیات مربوطه را تعریف می کند.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

حد بالایی را در سن کودک تعریف می کند. کران پایین در قسمت max_age + 1 براکت قبلی مشخص شده است. کران بالا و پایین هر دو شامل می شوند. کران پایین برای اولین براکت 0 است.

max_age باید در محدوده 0 تا 17 (شامل) باشد.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float مقدار ثابت مالیاتی که برای کودکان در این محدوده سنی اعمال می شود.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries کانتینری برای فهرست کردن کشورهای کاربری که مالیات برای آنها شامل یا مستثنی شده است. در صورت وجود، مالیات فقط برای کاربران کشورهای مشخص شده شامل یا مستثنی می شود.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum نوع مشخصات UserCountries.

مقادیر معتبر include و exclude می شوند.

اگر type UserCountries به عنوان include تنظیم شود، مالیات فقط برای کاربران کشورهای فهرست شده اعمال می شود.

در حالی که اگر type UserCountries exclude باشد، مالیات فقط برای کاربران خارج از کشورهای فهرست شده اعمال خواهد شد.

اگر type UserCountries تنظیم نشده باشد، آن را به‌عنوان 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 2 حرفی یکسان نیست. همچنین، کدهای منطقه CLDR پشتیبانی نمی شوند.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

رتبه ای که ترتیب درخواست این مالیات یا هزینه را مشخص می کند. به عنوان مثال، مقدار 2 به این معنی است که این مالیات در مرحله دوم اعمال خواهد شد. اگر <Type> روی cumulative_percent تنظیم شده باشد، همیشه باید این عنصر مشخص شود. به طور کلی، این سفارش برای هر دو مالیات و هزینه اعمال می شود. مقادیر تکراری رتبه‌ای بین مالیات‌ها و هزینه‌ها مجاز است، اما این می‌تواند منجر به رفتار نامشخصی شود که در آن مالیات‌ها و هزینه‌ها به صورت دلخواه و انباشته اعمال می‌شوند. مالیات ها و هزینه های بدون رتبه قبل از همه ورودی های رتبه بندی شده اعمال می شود.

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

مالیات اسلب

مالیات اسلب GST هند، بر اساس نرخ شبانه اعمال می شود. دسته های مالیاتی عبارتند از:

  • اگر نرخ شبانه کمتر یا مساوی 1000 باشد، بدون مالیات.
  • 12% مالیات اگر نرخ شبانه بیشتر از 1000 و کمتر یا مساوی 7500 باشد.
  • 18% مالیات اگر نرخ شبانه بیشتر از 7500 باشد. 
<?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 دلار مالیات برای سرنشینان بزرگسال.
  • 10 دلار مالیات برای کودکان بین 11 تا 17 سال.
  • مالیات 5 دلاری برای کودکان بین 0 تا 10 سال. 
<?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>

پاسخ ها

نحو

پیام 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>