הודעה על מיסים ועמלות

סקירה כללית

ההודעה TaxFeeInfo מגדירה את המיסים והעמלות שחלים על משתמש כשמזמין לינה בנכס, בהתאם לתקנות המס של הנכס שמפורטות באתר. כדי להוסיף נתונים של מיסים ועמלות, משתמשים בהודעה על המחיר (OTA_HotelRateAmountNotifRQ).

הערה: מומלץ להשתמש בסוג ההודעה TaxFeeinfo, והוא לא נדרש אם מציינים את AmountAfterTax בהודעת המחיר.

הפעולה היחידה שנתמכת בהודעה הזו היא overlay, שמשמשת להחלפת נתוני המס והעמלות של כל נכס. חשוב לשלוח עדכונים לגבי מיסים ועמלות בכל פעם שיש שינויים.

נקודה חשובה: אתם חייבים לכלול את כל המיסים והעמלות שהמשתמשים צריכים לשלם (מע"מ, מס על שהייה, מס עירוני וכו'), גם אם הם לא משולמים בזמן ההזמנה או לא משולמים ישירות למקום האירוח.

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

שיטות להוספת מיסים ועמלות

יש שתי דרכים כלליות להוסיף מיסים ועמלות:

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

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

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

בדף הזה מתואר רק השימוש בשיטה המועדפת של TaxFeeInfo, ולא השיטה של ציון AmountAfterTax בהודעת המחיר (OTA_HotelRateAmountNotifRQ).

שיטות להגדרת מיסים

יש לכם את האפשרויות הבאות להגדרת מיסים:

• ‫Basis = [room|person]
• תקופה = [שהייה|לילה]
• סוג = [אחוז|סכום]

אם הערך של Period הוא stay והערך של Type הוא percent,‏ Google מחילה מיסים ועמלות על כל השהייה, גם אם תאריך אחד במסלול הנסיעה חופף לטווח StayDates. אי אפשר לציין החלת מס ועמלה רק אם כל התאריכים במסלול הנסיעה חופפים לטווח התאריכים של השהייה. אם יש כמה טווחי תאריכים של שהייה שחופפים זה לזה, טווחי התאריכים StayDates מצוינים בטווח פתוח אחד. TaxFeeInfo דוגמאות

דוגמאות לתרחישים שונים שקשורים למיסים מופיעות במאמר הוראות שימוש. הדוגמאות כוללות כמה מהתרחישים הנפוצים ביותר בנושא מיסים, כולל הוראות לביצוע הפעולות הבאות:

1. מס קבוע ומס באחוזים שמוחלים על כל נכס
2. מס באחוזים שחל רק על לילות אחרי הלילה הראשון
3. שיטה להחלפת מיסים ישנים במיסים חדשים
4. הכללה או החרגה של מיסים במדינות
5. הגדרת מס לפי מדרגות עם טווחים
6. הגדרת מס ועמלה שחייבת במס

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

רכיבי חובה ורכיבים אופציונליים

בהפניה ל-XML מופיעים תיאורים של הרכיבים הנדרשים והאופציונליים. פרטים על מאפיינים ורכיבי צאצא מופיעים במאמר TaxFeeInfo רכיבים ומאפיינים.

תחביר וסכימות

כדאי להשתמש בדוגמה של TaxFeeInfo התחביר כעיון כשיוצרים את ההודעה, כדי לוודא שהפורמט נכון. אתם יכולים להשתמש בכלי XML של צד שלישי, כמו xmllint, כדי לאמת את הפידים באמצעות הסכימות שפורסמו לפני שאתם שולחים אותם ל-Google. למידע על סכימת ההודעות TaxFeeinfo, אפשר לעיין במאמר סכימות של מודעות להזמנת חדרים.

הנחיות

בקטע הזה מפורטות ההנחיות הנפוצות וההוראות המיוחדות להגדרת מיסים ועמלות.

פעולות

שכבת-על

כדי להחליף את כל המיסים של נכס, משתמשים בפעולה overlay. הפעולה overlay היא ברירת המחדל והפעולה היחידה שנתמכת. כל המיסים והעמלות הקודמים שחלים על המלון הזה יימחקו אחרי שהעדכון הזה יוחל.

כללי

• כל Tax נבדק, ואם רלוונטי, מחושב על סמך הסכום AmountBeforeTax שצוין ב-BaseByGuestAmt.

• אחרי חישוב כל המיסים והעמלות הרלוונטיים, הם מתווספים למחיר הבסיס ויוצרים את המחיר הכולל.

• התחביר של <Tax> ושל <Fee> זהה.

• יכולות להיות מגבלות על מיסים ועמלות, למשל:

  • ההנחה חלה רק על סוגים ספציפיים של חדרים ועל תוכניות מחירים.
  • ההנחה רלוונטית רק לתאריכים ספציפיים של שהייה.

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

• שליחת עדכון TaxFeeInfo בכל פעם שיש שינוי במיסים או בעמלות.

דוגמה

בקטע הזה מופיעה דוגמה בסיסית להודעת TaxFeeInfo שכוללת רכיבים נדרשים ואופציונליים. אחרי שמכינים את הקובץ, צריך לשלוח אותו ל-Google באמצעות הודעת POST לנקודת הקצה הזו:

https://www.google.com/travel/hotels/uploads/taxes

מידע נוסף על שליחת הודעות זמין במאמר בנושא שליחת הודעות.

נקודה חשובה: בכל פעם שמשתנים המיסים והעמלות, צריך לשלוח ל-Google הודעת TaxFeeInfo מעודכנת.

במאפיין hotel_id, צריך להשתמש במזהה המלון הייחודי שבו השתמשתם במערכת שלכם כדי לזהות את הנכס. הערך הזה צריך להיות זהה למזהה המלון שצוין באמצעות התג <id> ברכיב <listing> בפיד רשימת המלונות. התאמה למערכת שלכם היא קריטית כדי לוודא ש-Google מציגה את הנתונים שלכם בצורה נכונה.

בדוגמה הזו מוצגות הגדרות של שיעור מס של 10% וסכום עמלה של 50 $‎ לנכס, לכל תקופת השהייה (לא לכל לילה):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

הערה: אם לא מציינים את <Currency> אבל מציינים את <Amount>, ערך ברירת המחדל של <Currency> הוא המטבע של שיעור הבסיס.

דוגמאות להוספת מיסים שקשורים לגיל ודוגמאות נוספות מופיעות במאמר דוגמאות למיסים.

מדריכים

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

תרחיש 1: איך מוסיפים מס קבוע

בדוגמה הזו נראה איך מגדירים מס קבוע לכל נכס.

תיאור

אתם רוצים להחיל מס קבוע על החדר או על השהייה בכל מלון, ולא מס באחוזים.

פתרון

כדי להוסיף את אפשרות המס הקבוע, משתמשים במאפיין amount ולא במאפיין percentage.

דוגמה

בדוגמה הזו אפשר לראות איך מוסיפים מס קבוע באמצעות amount במקום percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

תרחיש 2: איך לטרגט מיסים באמצעות ApplicableNights

תיאור

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

פתרון

אפשר להשתמש ב-<ApplicableNights excluded="1"/> כדי לקבוע באילו לילות יחולו מיסים.

דוגמה

בדוגמה הזו מוסבר איך להשתמש ב-ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

תרחיש 3: איך מחליפים מיסים ועמלות ישנים במיסים ועמלות חדשים

תיאור

המיסים והעמלות הנוכחיים השתנו וצריך להחליף אותם בחדשים.

פתרון

משתמשים בפעולה overlay כדי להסיר את כל המיסים והעמלות הקיימים.

הערה: פעולת ברירת המחדל היא overlay אם לא מציינים פעולה אחרת. כלומר, אפשר רק להחליף את כל המיסים והעמלות בכל נכס, ואי אפשר להוסיף מיסים או עמלות חדשים באופן מצטבר.

דוגמה

בדוגמה הבאה אפשר לראות איך מסירים את כל המיסים והעמלות מנכס:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

תרחיש 4: איך לכלול או להחריג מיסים במדינות

תיאור

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

פתרון

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

דוגמה

בדוגמה הבאה מוצג איך להגדיר מיסים למשתמשים מחוץ למדינה שבה נמצא המלון (ישראל):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16: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>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

תרחיש 5: איך מגדירים מס פרוגרסיבי עם מדרגות מס

תיאור

אתם רוצים להוסיף מס GST שמוחל לפי טווח מחירים ללילה.

הערה: בתרחיש הזה, צריך להשתמש באפשרות Brackets (קבוצה של מדרגות מס לא חופפות) כדי להגדיר את האפשרות הזו.

פתרון

בתרחיש הזה, נניח שמדרגות מס ה-GST במדינת היעד הן:

• אין מיסים אם המחיר ללילה הוא 1,000 או פחות.
• מס בשיעור של 12% אם המחיר ללילה גדול מ-1,000 וקטן מ-7,500 או שווה לו.
• ‫18% מס אם המחיר ללילה גבוה מ-7,500.

דוגמה

בדוגמה הבאה אפשר לראות איך מגדירים מס פרוגרסיבי עם מדרגות מס:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16: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>

תרחיש 6: איך מגדירים מס ועמלה שחייבת במס

תיאור

אתם רוצים להוסיף מס כמו מע"מ, ועמלת שירות נוספת שחלה גם על המס הזה.

פתרון

התרחיש הזה מתייחס לשני תרחישים לדוגמה של עמלות שחייבות במס:

• המס והעמלה החייבת במס מוגדרים כחיובים באחוזים.
• המס הוא חיוב באחוזים, והעמלה החייבת במס היא סכום קבוע לכל שהייה.

דוגמאות

עמלה שחייבת במס כאחוז

בדוגמה הזו, סכום העמלה הוא AmountBeforeTax100$, מס ה-GST הוא 18% ועמלת השירות הנוספת היא 5%. לכן, אחוז העמלה הכולל שחייב במס הוא 5.9% (‎5*1.18), וסכום העמלה הכולל הוא 123.90 $‎ ‏[‎= 118 $‎ (18% GST) + 5.9$‎ (5.9% עמלת שירות)].

בקטע הקוד הבא מוגדרים המיסים (GST) והעמלה החייבת במס (service charge) באחוזים:

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

עמלה חייבת במס כסכום

בדוגמה הזו, AmountBeforeTax הוא 100$, מס GST הוא 18% ועמלה נוספת של 20 $‎ – כך שהעמלה הכוללת שחייבת במס היא 23.60 $‎ ‏(20$‎ כפול 1.18), וסכום התעריף הכולל הוא 141.60 $‎ ‏[‎= 118 $‎ (מס GST של 18%) + 23.60 $‎ (תשלום קבוע של 20$‎)].

בקטע הקוד הבא מוגדר מס (GST) באחוזים ועמלה חייבת במס (דמי שירות) כסכום קבוע:

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>