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

סקירה כללית

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדאי להיעזר בדוגמה תחביר 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: איך להגדיר מס slab באמצעות סוגריים

התיאור

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

פתרון

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

  • ללא מס אם התעריף ללילה נמוך מ-1,000 או שווה ל-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$

בקטע הבא מוגדר שיעור המס (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$

בקטע הבא מוגדר שסכום המס (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>