פרטי מס

בקשות

תחביר

ההודעה TaxFeeInfo משתמשת בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">integer</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>
TaxFeeInfo

רכיבים ומאפיינים

ההודעה TaxFeeInfo כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @מאפיין מופעים סוג תיאור
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> בהודעה Transaction (Property Data), ומזוהה באמצעות RoomID. (הערך <RoomID> שלו משמש גם כהפניה למאפיין InvTypeCode בהודעות OTA_HotelRateAmountNotifRQ).
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string המזהה הייחודי של מלאי שטחי הפרסום (סוג החדר). הערך הזה ממופה ל-<RoomID> בהודעה מסוג Transaction (Property Data). מספר התווים המקסימלי המותר הוא 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> מוגדר ל-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> אחד או יותר. הגדרת קבוצה של מדרגות מס רציפות שלא חופפות. לדוגמה: מיסים לפי מדרגות מס של 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, המס יחול רק על משתמשים מהמדינות שמופיעות ברשימה.

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

אם המאפיין UserCountries type לא מוגדר, המערכת תתייחס אליו כאל include והמס יחול רק על משתמשים מהמדינות שמופיעות ברשימה.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country המדיניות הזו מגדירה מדינה אחת ברשימה UserCountries.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string קוד מדינה בפורמט CLDR, למשל DE או FR. שימו לב שבמדינות מסוימות, קוד המדינה במאגר CLDR לא זהה לקוד המדינה בן 2 האותיות לפי תקן ISO. בנוסף, אין תמיכה בקודים של אזורים ממאגר ה-CLDR.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

דירוג שמציין את סדר ההחלה של מס או עמלה. לדוגמה, ערך של 2 מציין שהמס יחול שני. תמיד צריך לציין את הרכיב הזה אם <Type> מוגדר ל-cumulative_percent. באופן כללי, הסדר הזה חל על מיסים ועל עמלות.

<Rank>2</Rank>

מותר להשתמש בערכי דירוג כפולים במיסים ובעמלות, אבל זה עלול לגרום להתנהגות לא מוגדרת שבה המיסים והעמלות מתווספים באופן שרירותי ומצטבר.

אפשרות אחרת היא להשתמש בפרמטר "exclusive" בתוך התג <Rank> כדי לציין שכל המיסים והעמלות באותה רמה חלים על המחיר. ערך ברירת המחדל הוא false וכל המיסים והעמלות עם אותו דירוג מוחלים על התעריף באופן שרירותי. הערך "exclusive" הוא אופציונלי.

אם הפרמטר exclusive מוגדר לערך true, רק המס הראשון שמופיע בפרמטר <Tax> או העמלה הראשונה שמופיעה בפרמטר <Fee> יחולו על המחיר. 

<Rank exclusive="true">1</Rank>

המיסים מחושבים לפני העמלות. לכן, אם מס ועמלה הם באותה רמה והעמלה מוגדרת כ-"exclusive" עם הערך true, המס עדיין יחושב קודם. השיטה המומלצת היא לציין את המיסים והעמלות בסדר שבו הם אמורים לחול.

כדי לכלול את כל המיסים והעמלות באותו דירוג, אל תגדירו את הערך של exclusive כ-true.

המיסים והעמלות ללא דירוג יחולו לפני כל הערכים המדורגים.

הערך של <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 בהודו, שחל על בסיס מחירים ללילה. מדרגות המס הן:

  • לא יחול מס אם התעריף ללילה הוא 1,000 או פחות.
  • מס בשיעור של 12% אם מחיר הלילה גדול מ-1,000 וקטן מ-7,500 או שווה לו.
  • מס של 18% אם המחיר ללילה גבוה מ-7,500.
<?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>

טווחים חופפים של תאריכי שהייה

אם מוגדרים כמה טווחי תאריכים של שהייה שחופפים זה לזה, התאריך של השהייה צריך להיות בטווח אחד מהם ולא בכולם. צריך לציין את טווחי התאריכים של השהייה בטווח התחלה וסיום אחד.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2025-03-12T10:59:49+01:00"
            id="12345678"
            partner="partner_key">
  <Property action="overlay">
    <ID>987654</ID>
      <Taxes>
        <Tax>
          <Type>amount</Type>
          <Basis>person</Basis>
          <Period>night</Period>
          <RoomTypes>
            <RoomType id="RoomID_1"/>
            <RoomType id="RoomID_2"/>
          </RoomTypes>
          <StayDates application="any">
            <DateRange start="2025-06-16"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>50</Amount>
        </Tax>
      </Taxes>
      <Fees>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-12" end="2025-03-18"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>200</Amount>
        </Fee>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-19"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>300</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

מספר מיסים ועמלות עם בלעדיות לדירוג

בדוגמה הבאה מוצגים כמה מיסים ועמלות עם exclusive="true" ודירוגים שונים. כדאי להביא בחשבון את המיסים והעמלות הבאים שצריך להוסיף למחיר:

  • מס תפוסה של 5% עם דירוג 1 exclusive="true".
  • מס שירות חדרים בסך 10 דולר ארה"ב עם דירוג 1.
  • עמלת ניקוי של 50 דולר עם דירוג 2 exclusive="true".
  • עמלת שירותים בשיעור 2% עם דירוג 3.

הסדר הכרונולוגי שבו המיסים והעמלות חלים על סמך <Rank> הוא:

  1. קודם יחול מס האירוח עם exclusive="true" ודירוג 1.
  2. מס שירות החדרים עם הדירוג 1 לא יחול כי מס הלינה הקודם הוא ללא מע"מ.
  3. לאחר מכן, תתווסף עמלת הניקיון עם exclusive="true" ודירוג 2.
  4. דמי השירותים עם דירוג 3 יחולו אחרי דמי הניקיון עם דירוג 2.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-02-29T12:00:00Z"
            id="tax-fee-id"
            partner="partner_key">
  <Property action="overlay">
    <ID>765432</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Amount>5</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank exclusive="true">1</Rank>
      </Tax>
      <Tax>
        <Type>amount</Type>
        <Amount>10</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank>1</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Amount>50</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank exclusive="true">2</Rank>
      </Fee>
      <Fee>
        <Type>percent</Type>
        <Amount>2</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank>3</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

תשובות

תחביר

ההודעה TaxFeeInfoResponse משתמשת בתחביר הבא:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</TaxFeeInfoResponse>

רכיבים ומאפיינים

ההודעה TaxFeeInfoResponse כוללת את הרכיבים והמאפיינים הבאים:

רכיב / @מאפיין מופעים סוג תיאור
TaxFeeInfoResponse 1 Complex element רכיב הבסיס שמציין את ההצלחה או הבעיות בהודעת בקשה מסוג TaxFeeInfo שהתקבלה.
TaxFeeInfoResponse / @timestamp 1 DateTime התאריך והשעה שבהם ההודעה נוצרה.
TaxFeeInfoResponse / @id 1 string המזהה הייחודי מההודעה המשויכת TaxFeeInfo.
TaxFeeInfoResponse / @partner 1 string חשבון השותף שאליו משויכת ההודעה.
TaxFeeInfoResponse / Success 0..1 Success מציין שההודעה TaxFeeInfo עובדה בהצלחה ללא אזהרות, שגיאות או כשלים.

הערך <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>