1. אישור חד-פעמי

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

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

2. מתי מבקשים מספר הקצאה

מספר הקצאה נדרש על חשבונית מס, חשבונית מס קבלה וחשבונית זיכוי, ללקוח עסקי עם מספר עוסק או ח.פ, בסכום ₪5,000 ומעלה לפני מע"מ (מ-1.6.2026, לפי הודעת רשות המסים מ-24.05.2026). ללקוח פרטי ללא מספר עוסק לא נדרש מספר, בכל סכום.

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

3. כשהבקשה נכשלת

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

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

4. איפה המספר מופיע

המספר מודפס על המסמך בשורה "מספר הקצאה · חשבונית ישראל". במסמך באנגלית השורה היא "Allocation number · Israel Invoice". בעמוד המסמך מופיע "מספר ההקצאה התקבל", עם המספר ומתי נשמר. אם המסמך כבר נשלח ללקוח, ניקוי המספר דורש אישור, כי הוא לא מבטל את החשבונית. לתיקון מוציאים חשבונית זיכוי. חשבונית זיכוי ומספר הקצאה.

5. רישום במרשם התוכנות

חשבונית ידידותית רשומה במרשם התוכנות של רשות המסים, תעודה 285401, בתוקף עד 30.09.2028. אותו מספר נכתב בכל קובץ מבנה אחיד שהתוכנה מפיקה. עמוד האודות.

להמשך קריאה

English summary: integration guide

Friendly Invoice connects to the Israel Tax Authority "Israel Invoice" (Heshbonit Israel) allocation number API. The business owner authorises the connection once, in Settings, by signing in on the Tax Authority site. The Tax Authority asks to renew the authorisation every three months.

An allocation number is required on a tax invoice, tax invoice-receipt or credit note to a business customer of 5,000 ILS or more before VAT (from 1 June 2026). Private customers and receipts do not need one, so an osek patur never requests numbers.
The number is requested with one click on the document page after saving, stored on the document and printed on it. The document cannot be sent to the customer until the number arrives.
On failure the app shows the reason in Hebrew. The user can retry, or get the number on the Tax Authority site and type it in.
Registered with the Tax Authority software registry, certificate 285401, valid to 2028-09-30.

Full English guide: allocation number integration guide. More in English: Friendly Invoice in English.

חיבור לחשבונית ישראל ומספרי הקצאה: איך זה עובד בחשבונית ידידותית