פרטי מס

בקשות

תחביר

ההודעה 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> בהודעת Transaction (Property Data), ומזוהה באמצעות RoomID שלו. (בהודעות OTA_HotelRateAmountNotifRQ יש הפניה גם לערך <RoomID> של המאפיין InvTypeCode).
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string המזהה הייחודי של המלאי (סוג החדר). הערך הזה ממופה לערך <RoomID> בהודעה מסוג Transaction (נתוני נכס). אפשר להזין עד 50 תווים.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans מאגר לרשימת תעריפים שבהם חל המס. אם לא מציינים ערך של <RatePlans>, המס יחול על כל תוכניות התמחור והתשלומים.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan מציין תוכנית תעריפים. תוכנית תעריפים מוגדרת על ידי שילוב של חבילת שירות, תעריפים וזמינות, כפי שהם מוגדרים בהודעות Transaction‏ (נתוני המלון), OTA_HotelRateAmountNotifRQ ו-OTA_HotelAvailNotifRQ, וכפי שהם מזוהים לפי PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string המזהה הייחודי של תוכנית התמחור. הערך הזה ממופה לערך PackageID בשדה <PackageData> של ההודעה Transaction (Property Data), ולערך 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 slab בהודו.

הרכיב הזה תקף רק כשהערך של <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, המס יחול רק על משתמשים מהמדינות שצוינו.

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

אם לא תגדירו את השדה UserCountries‏ 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 שונה מקוד המדינה בן 2 האותיות לפי תקן ISO. בנוסף, אין תמיכה בקודים של אזורים מ-CLDR.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

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

הערך של <Rank> חייב להיות בטווח 1 עד 99 (כולל).

TaxFeeInfo / Property / Fees 0..1 Fees קונטיינר של רכיב <Fee> אחד או יותר.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

עמלה אישית שחלה על הנכס.

כל רכיבי הצאצאים של <Tax> נתמכים גם ב-<Fee> עם אותה תחביר.

דוגמאות

לכל נכס יש מגבלה של 300 מיסים ועמלות. עיינו בדוגמה 'מחיקת מיסים' כדי להסיר את המיסים והעמלות מנכס מסוים.

הודעה בסיסית

הודעת TaxFeeInfo בסיסית:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="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$ למבוגרים.
  • מס של 40 ש"ח לילדים בגילאי 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>

תשובות

תחביר

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