معلومات الضرائب

الطلبات

البنية

تستخدم الرسالة 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 معرّف فريد لرسالة الطلب هذه يتم عرض هذه القيمة في رسالة الرد. الأحرف المسموح بها هي a-z، A-Z و0-9 و_ (شرطة سفلية) و- (شرطة).
TaxFeeInfo / @partner 1 string حساب الشريك لهذه الرسالة قيمة السلسلة هذه هي "مفتاح الشريك" القيمة مدرجة في صفحة "إعدادات الحساب" في Hotel Center.

ملاحظة: إذا كانت لديك خلفية توفر خلاصات حسابات متعددة، يجب أن تتطابق هذه القيمة مع 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 messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string المعرّف الفريد للمستودع (نوع الغرفة) تحدد هذه القيمة إلى <RoomID> في معاملة (بيانات الموقع). الحد الأقصى لعدد الأحرف المسموح به هو 50-
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans حاوية لقائمة خطط الأسعار التي تنطبق عليها الضريبة إذا لم يتم تحديد <RatePlans>، سيتم تحصيل الضريبة. على جميع خطط الأسعار
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan تحدّد خطة أسعار. يتم تحديد خطة الأسعار من خلال مجموعة من الحزمة والأسعار والتوفّر، كما هو محدّد في المعاملة (بيانات الموقع) وOTA_HotelRateAmountNotifRQ وOTA_HotelAvailNotifRQ والرسائل كما هو محدد في PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string المعرّف الفريد لخطة الأسعار يتم تعيين هذه القيمة إلى قيمة PackageID في رسالة المعاملات (بيانات الموقع) <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).
TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float قيمة النسبة المئوية أو مبلغ الضريبة
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights لا تنطبق هذه القيمة إلا في حال ضبط <Type> على تم ضبط amount و<Period> على الليلة.

تفرض هذه السمة قيودًا على عدد الليالي التي يمكن تطبيق ضريبة عليها.

حدِّد إما max أو excluded ولكن ليس كليهما.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer تشير السمة <ApplicableNights max="N"> إلى أنّ الليالي بعد أن يتم استبعاد أول N من الليالي.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer تشير السمة <ApplicableNights excluded="N"> إلى أنّ ينبغي استبعاد أول N من الليالي.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay تحدِّد هذه السياسة حدود مدة الإقامة التي يمكن تطبيق هذه الضريبة ضمنها. لا تُطبق الضريبة عندما تتجاوز مدة الإقامة الحد الأدنى والأقصى. الحدود.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min 0..1 integer تمثّل هذه السمة الحدّ الأدنى لعدد الليالي المسموح به في الإقامة لتطبيق الضريبة. وإذا لم يتم تحديد قيمة الحقل، فلا يوجد حد أدنى.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max 0..1 integer تمثّل هذه السمة الحدّ الأقصى لعدد الليالي المسموح بها في الإقامة لتطبيق الضريبة. وإذا لم يتم تحديد قيمة السمة، لن يكون هناك حدّ أقصى.
TaxFeeInfo / Property / Taxes / Tax / Brackets 0..1 Brackets حاوية لعنصر <Bracket> واحد أو أكثر تحدد مجموعة من الأقواس الضريبية المتجاورة وغير المتداخلة. على سبيل المثال: ضرائب حصص ضريبة السلع والخدمات في الهند.

يكون هذا العنصر صالحًا فقط عند ضبط <Period> على لم يتم تحديد night و<Amount>.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float قيمة النسبة المئوية أو مبلغ الضريبة المطبَّقة على أسعار الإقامة في الليلة أسفل قيمة starts_at للقوس الأول.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket لتحديد شريحة ضريبية استنادًا إلى أسعار الإقامة في الليلة.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

وتحدد الحد الأدنى لفئة ضريبية. الحد الأعلى هو المحدد في الحقل starts_at للقوس اللاحق. ليس هناك حد أعلى للقوس الأخير.

يكون مستوى الضريبة نشطًا عندما يكون سعر الليلة أكبر من أو يساوي مع قيمة starts_at للقوس، وأقل من ذلك تمامًا قيمة starts_at للقوس اللاحق.

يجب أن تكون هذه القيمة أكبر من 0 تمامًا.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float قيمة النسبة المئوية أو مبلغ الضريبة المطبَّق على شريحة الضريبة هذه.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets السماح بتحديد مجموعة من الضرائب استنادًا إلى عدد النزلاء الأعمار.

يكون هذا العنصر صالحًا فقط في حالة وجود <Brackets> لم يتم تحديد <Amount>، تم ضبط <Basis> على person تم ضبط <Type> على amount.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge حاوية لتحديد الضرائب للبالغين
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float المبلغ الثابت للضريبة الذي ينطبق على البالغين.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets حاوية تحتوي على <ChildAgeBracket> واحد أو أكثر عناصر.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket تحدّد هذه السمة الفئة العمرية للأطفال ومبلغ الضريبة المرتبط بها.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

ويحدِّد الحدّ الأقصى لعمر الطفل. الحد الأدنى هو المحدد في الحقل max_age للقوس السابق + 1. كل من الحدين العلوي والسفلي شامل. الحد الأدنى القوس الأول هو 0.

يجب أن يكون max_age في النطاق الذي يتراوح بين 0 و17 (ضمنًا).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float المبلغ الثابت للضريبة المطبَّقة على الأطفال في هذه الفئة العمرية.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries حاوية تتضمّن بلدان المستخدمين حيث يتم تطبيق الضريبة متضمنة أو مستبعدة. وفي حال توفّرها، لن يتم تضمين الضريبة إلا أو المستبعدة للمستخدمين من البلدان المحدّدة.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum تمثّل هذه السمة نوع مواصفات Userالبُلدان.

القيمتان الصالحتان هما include exclude

في حال ضبط سمة "بلدان المستخدم type" على include، لن تسري الضريبة إلا على المستخدمين المقيمين في البلدان المدرجة في القائمة.

بينما إذا كانت سمة Userالبُلدان type هي exclude، لن يتم تطبيق الضريبة إلا على المستخدمين خارج البلدان المدرجة في القائمة.

وفي حال ترك سمة Userالبُلدان type بدون ضبط، سنتعامل معها على أنّها include ولن تُطبَّق الضريبة إلا على المستخدمين المقيمين في البلدان المدرجة في القائمة.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country تحدّد هذه العلامة بلدًا واحدًا في قائمة Userالبُلدان.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string رمز CLDR للبلد، مثل DE أو FR. لاحظ أنه بالنسبة لبعض فإن رمز CLDR للبلدان ليس هو نفسه رمز ISO المكون من حرفين رمز البلد. بالإضافة إلى ذلك، لا يمكن استخدام رموز 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="2020-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="2022-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key"
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

ضريبة الألواح

ضريبة GST في الهند، يتم تطبيقها استنادًا إلى أسعار الليلة. الفئات الضريبية هي:

  • لا يتم فرض ضريبة إذا كان سعر الليلة أقل من 1,000 أو مساوٍ له.
  • 12% ضريبة إذا كان سعر الليلة أكبر من 1000 وأقل من تساوي 7500.
  • 18% ضريبة إذا كان سعر الليلة أكبر من 7500.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-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="2020-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="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

المشاكل

في ما يلي رد على رسالة TaxFeeInfo التي لم تتم معالجتها بسبب الأخطاء.

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