פרטי מס

Requests

תחביר

ההודעה 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]</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>
      </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]</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>
      </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> בהודעה Transactions (נתוני נכס), ומזוהה באמצעות מזהה החדר שלו. (הערך של <RoomID> מופיע גם במאפיין InvTypeCode ב-OTA_HotelRateAmountNotifRQ הודעות).
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_HotelAhaveNotifRQ , וכפי שזוהה ב-PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string המזהה הייחודי של תוכנית התעריפים. הערך הזה ממפה את הערך של PACKAGEID ב-<PackageData> בהודעה עסקה (נתוני נכס), ובמאפיין RatePlanCode ב-<StatusApplicationControl> בהודעות <PackageData> ו-<OTA_HotelAvailNotifRQ>.<OTA_HotelRateAmountNotifRQ> מספר התווים המרבי המותר הוא 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: סכום קבוע להוספה לסכום הסופי
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 סוג המפרט של מדינות המשתמש.

הערכים החוקיים הם include ו-exclude.

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

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

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

מס בשיעור המקומי

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

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