דף זה תורגם על ידי Cloud Translation API.

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

סקירה כללית

ההודעה 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`