פרטי מס

בקשות

תחביר

ההודעה 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 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>