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

الكائن Requests

البنية

تستخدم الرسالة 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]</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>
      </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]</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>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

العناصر والسمات

تحتوي الرسالة TaxFeeInfo على العناصر والسمات التالية:

العنصر / @Attribute عدد مرات الظهور Type الوصف
TaxFeeInfo 1 Complex element تمثّل هذه السمة العنصر الجذر لرسالة تحدِّد الضرائب والرسوم لموقع واحد.
TaxFeeInfo / @timestamp 1 DateTime تاريخ إنشاء هذه الرسالة ووقتها
TaxFeeInfo / @id 1 string معرِّف فريد لرسالة الطلب هذه يتم عرض هذه القيمة في رسالة الرد. الأحرف المسموح بها هي a-z وA-Z و0-9 و_ (شرطة سفلية) و- (شرطة).
TaxFeeInfo / @partner 1 string حساب الشريك لهذه الرسالة قيمة السلسلة هذه هي قيمة "مفتاح الشريك" المدرَجة في صفحة إعدادات الحساب في "مركز إدارة معلومات الفنادق".

ملاحظة: إذا كانت لديك خلفية تقدّم خلاصات لحسابات متعددة، يجب أن تتطابق هذه القيمة مع قيمة السمة 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> أيضًا من خلال السمة InvTypeCode في رسائل OTA_HotelRateAmountNotifRQ).
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_فندقAvailNotifRQ وحسبما تحدّده الحزمة.
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: مبلغ ثابت لإضافته إلى السعر النهائي
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> على night.

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

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

لا يكون هذا العنصر صالحًا إلا في حال ضبط <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 على أنه include، لن تسري الضريبة إلا على المستخدمين في البلدان المُدرجة.

أمّا في حال كانت قيمة type للمستخدم في البلد هي exclude، فتنطبق الضريبة فقط على المستخدمين خارج البلدان المُدرجة.

إذا لم يتم ضبط typeبلدان المستخدمين، سنتعامل مع include وسيتم تطبيق الضريبة فقط على المستخدمين في البلدان المُدرجة.
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 / Fees 0..1 Fees حاوية عنصر <Fee> واحد أو أكثر
TaxFeeInfo / Property / Fees / Fee 1..n Fee

رسوم فردية تنطبق على الموقع.

جميع العناصر الفرعية في <Tax> متوافقة أيضًا مع <Fee> بالبنية نفسها.

أمثلة

الرسالة الأساسية

رسالة 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) في الهند استنادًا إلى أسعار الإقامة في الليلة. الأقواس الضريبية هي:

  • بلا ضريبة إذا كان سعر الإقامة في الليلة أقل من أو يساوي 1000.
  • 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 عدد مرات الظهور Type الوصف
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>