פרטי מס

בקשות

תחביר

ההודעה 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 (נתוני נכס), ומזוהה באמצעות השדה RoomID שלו. (בהודעות OTA_HotelRateAmountNotifRQ יש הפניה גם לערך <RoomID> של המאפיין InvTypeCode).
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> בהודעה Transaction (נתוני נכס), ובמאפיין 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> מוגדר כ-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.

אם המדיניות 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 שונה מקוד המדינה בן 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> עם אותו תחביר.

דוגמאות

הודעה בסיסית

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