הודעה בנושא מיסים ועמלות

סקירה כללית

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

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

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

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

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

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

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

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

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

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

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

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

• Basis = [room|person]
• Period = [stay|night]
• Type = [percent|amount]

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

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

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

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

רכיבים נדרשים ואופציונליים

בחומר העזר בנושא 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

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

נקודה חשובה: שולחים ל-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.

דוגמה

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

<?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: איך מגדירים מס ודמי מס

תיאור

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

פתרון

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

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

דוגמאות

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

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

קטע הקוד הבא מגדיר את המס (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>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$ (18% GST) + 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>