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

סקירה כללית

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

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

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

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

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

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

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

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

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

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

בסיס = [חדר|אדם]
תקופה = [שהייה|לילה]
סוג = [אחוז|סכום]

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

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

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

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

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

בהפניה ל-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

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

במאפיין 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>

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

מדריכים

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

תרחיש 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 כדי להסיר את כל המיסים והעמלות הקיימים.

דוגמה

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

    <?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 שמוחל לפי טווחים על המחירים ללילה.

פתרון

בתרחיש הזה, נניח שמדרגות מס ה-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>

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

סקירה כללית

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

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

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

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

הנחיות

פעולות

כללי

דוגמה

מדריכים

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

תיאור

פתרון

דוגמה

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

תיאור

פתרון

דוגמה

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

תיאור

פתרון

דוגמה

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

תיאור

פתרון

דוגמה

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

תיאור

פתרון

דוגמה

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

תיאור

פתרון

דוגמאות

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

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

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

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