פרטי מס

בקשות

תחביר

ההודעה 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> במלון הצגת רשימה של פידים. מזהה המלון מופיע גם ב-Hotel Center.
TaxFeeInfo / Property / Taxes 0..1 Taxes קונטיינר של רכיב <Tax> אחד או יותר.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax מס נפרד שחל על הנכס.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes 0..1 RoomTypes מאגר לרשימת סוגי החדרים שעליהם חל המס. המס חל על כל <RoomType> שצוין. אם לא צוין <RoomTypes>, המס חל על כל החדרים.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType מציין את סוג החדר. סוג חדר מוגדר רכיב <RoomData> בתוך עסקה (נתוני נכס), ובתור זוהה באמצעות RoomID שלו. ( גם לערך <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> אחד או יותר. מגדירה קבוצה של טווחי מס רציפים ולא חופפים. לדוגמה: מיסים על 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.

אם המדיניות UserCountries מוגדרת בתור type include, המס יחול רק על משתמשים במדינות הרשומות.

לעומת זאת אם מדינות המשתמש type הן exclude, המס יחול רק על משתמשים מחוץ במדינות הרשומות.

אם המדיניות type לא מוגדרת, נתייחס אליה בתור include והמס יחולו רק על משתמשים מ במדינות הרשומות.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country מגדירה מדינה אחת ברשימת UserCountry.
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="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>

מס Slab

מס GST בהודו, שחל על פי תעריפים ללילה. מדרגות המס הן:

  • ללא מס אם המחיר ללילה נמוך מ-1,000 או שווה לו.
  • 12% מס אם המחיר ללילה גבוה מ-1,000 ונמוך מ- או שווה ל-7,500.
  • 18% מס אם המחיר ללילה גבוה מ-7,500.
<?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>