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

סקירה כללית

ההודעה 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. אי אפשר לציין שחיוב במס ובעמלות יתבצע רק אם כל התאריכים בתוכנית הנסיעה חופפים לטווח התאריכים של השהייה. אם יש כמה טווחי תאריכים של שהייה שחופפים זה לזה, טווחי 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

מידע נוסף על שליחת הודעות באמצעות 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 ש"ח.

דוגמה

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

<?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>