קורן בן עזרא
skills-ilמה זה חשבונית אלקטרונית ישראלית?
הסקיל בונה חשבונית מס לפי קודי המסמכים הרשמיים של שע"מ, ומחליט בכל מקרה אם המסמך צריך לשאת מספר הקצאה, לפי ארבעה תנאים ביחד ולא לפי ניחוש. הוא גם מסביר מה עושים כשרשות המסים דוחה בקשה למספר או כשהמערכת שלה נופלת, ולא רק את המקרה הרגיל שבו הכל עובד חלק.
מי שצריך להוציא חשבונית מס עסקית בישראל נתקל מהר במושג מספר הקצאה, מספר בן תשע ספרות שרשות המסים מקצה לחשבוניות מעל סכום מסוים. הסקיל הזה בונה את החשבונית לפי הקוד הנכון מתוך רשימת סוגי המסמכים הרשמית של שע"מ, מחשב את המע"מ, ובודק אם המסמך הספציפי הזה בכלל צריך מספר הקצאה, כי לא כל חשבונית צריכה, וזו הטעות הכי נפוצה.
הבדיקה עצמה מתבססת על ארבעה תנאים שצריכים להתקיים יחד, לא רק אחד מהם: הסכום לפני מע"מ מעל הסף התקף לאותו תאריך, יש במסמך רכיב מע"מ שאינו אפס, הלקוח הוא עוסק מורשה, והלקוח ביקש את המספר. הסקיל גם מזכיר שהסף עצמו ירד בהדרגה בשנים האחרונות, כך שחשבונית מלפני שנה נבדקת מול הסף שהיה תקף אז, לא מול הסף הנמוך של היום.
חלק ייחודי בסקיל הוא הטיפול במקרים שבהם משהו משתבש: רשות המסים דוחה בקשה למספר, או שהמערכת שלה נופלת זמנית. לכל אחד מהמצבים האלה יש נוהל מוגדר בחוק, כולל אפשרות של חיוב הפוך שבו הלקוח עצמו מדווח על העסקה, ולוח זמנים סטטוטורי לשימוע ולערר. זה לא רק כלי ליצירת חשבונית תקינה, אלא גם מדריך למה לעשות כשהתהליך הרגיל נתקע.
הסקיל הוא כלי מידע חינמי שמפעיל מודל שפה, לא ייעוץ מס ולא דוח שהוגש. הפלט הוא טיוטה להכנה אישית, והחישוב המחייב הוא זה של רשות המסים. כדאי לוודא מול רואה חשבון לפני שמסתמכים על קוד מסמך או קביעת חובת מספר הקצאה בחשבונית אמיתית.
למי זה מתאים
- עוסק מורשה שמוציא חשבוניות מס ללקוחות עסקיים ורוצה לוודא שהוא בונה את המסמך הנכון עם הקוד הנכון
- בעל עסק שמתלבט אם חשבונית ספציפית צריכה מספר הקצאה, במיוחד סביב הסף שיורד מדי כמה חודשים
- מפתח שמשלב את ה-API של שע"מ במערכת חיוב ורוצה להבין את קודי השגיאה והתהליך כשהמערכת דוחה בקשה
- מנהל חשבונות שצריך להבחין בין חשבונית מס, חשבונית מס וקבלה, וחשבונית זיכוי, ולדעת איזו מהן דורשת מספר
- עסק שנתקל בתקלה במערכת שע"מ ורוצה לדעת מה מותר לעשות עד שהתקלה מתוקנת
מה הוא עושה
כל קודי המסמכים הרשמיים
חשבון עסקה, חשבונית מס, חשבונית מס תקופתית, חשבונית מס וקבלה, חשבונית זיכוי ופרופורמה, עם הבהרה מפורשת שאין קוד עצמי חדש להמציא.
בדיקת ארבעת התנאים למספר הקצאה
הסכום לפני מע"מ מעל הסף, רכיב מע"מ שאינו אפס, לקוח עוסק מורשה, ובקשה מפורשת מהלקוח, ולא רק תנאי אחד בבידוד.
לוח זמנים מלא של ירידת הסף
מ-25,000 שקל במאי 2024, דרך 20,000 ו-10,000, ועד לסף הנוכחי, עם בדיקה מול התאריך של החשבונית עצמה ולא מול התאריך של היום.
נוהל דחייה מהרשות
ארבע חלופות כשרשות המסים דוחה בקשה: ביטול, המשך בלי מספר, חיוב הפוך שבו הלקוח מדווח בעצמו, או פנייה ליחידת הבקרה עם לוח זמנים סטטוטורי לשימוע וערר.
נוהל תקלת מערכת
הבחנה בין תקלה מקומית לתקלה רחבה במערכת שע"מ, עם שלוש אפשרויות עד לתיקון, כולל בקשה רטרואקטיבית אחרי שהתקלה נפתרת.
וולידציה של שדות ותקינות
בדיקת מספר עוסק עם ספרת ביקורת, חישוב מע"מ נכון, רצף מספרי חשבוניות, ותאריך תקין, לפני שמסמנים את המסמך כמוכן.
סקריפט אימות בפייתון
scripts/validate_invoice.py בודק חשבונית בפורמט JSON מול דרישות שע"מ, כולל ספרת ביקורת ותנאי הסף למספר הקצאה.
פרטי אינטגרציה שנופלים בפועל
הסבר על שדה מספר לקוח חובה, קוד שגיאה שמוחזר בהצלחת HTTP, והבהרה שמדפיסים רק תשע הספרות האחרונות ממספר האישור הארוך.
דוגמאות שימוש
מה כותבים ל-Claude אחרי ההתקנה, ומה מקבלים.
חשבונית מס לפרויקט פיתוח
תשתמש בסקיל israeli-e-invoice ותכין חשבונית מס לפרויקט פיתוח אתר על 15,000 שקל לחברה בעםמה מקבלים: חשבונית מסוג 305 עם חישוב מע"מ, והנחיה לבקש מספר הקצאה מראש כי הלקוח עוסק מורשה שצפוי לבקש אותו.
קבלה על תשלום מזומן קטן
אני צריך קבלה על תשלום של 500 שקל במזומן, בלי לקוח עסקימה מקבלים: מסמך קבלה רגיל בלי מספר הקצאה, עם הבהרה שקבלה כלל לא נמצאת ברשימת המסמכים שדורשים מספר.
חשבונית זיכוי חלקית
תכין חשבונית זיכוי לחשבונית מספר 1234, החזר חלקי של 3,000 שקלמה מקבלים: חשבונית זיכוי מסוג 330 עם קישור למספר החשבונית המקורית, והבהרה שחשבונית זיכוי לעולם לא דורשת מספר הקצאה.
בדיקת סף על חשבונית מלפני שנה
החשבונית הזאת מדצמבר 2024 על 22,000 שקל. תבדוק אם היא הייתה צריכה מספר הקצאהמה מקבלים: בדיקה מול הסף של 25,000 שקל שהיה תקף בתקופה ההיא, ומסקנה שלא נדרש מספר, בניגוד לסף הנמוך שתקף היום.
רשות המסים דחתה בקשה למספר
קיבלתי דחייה מרשות המסים על בקשת מספר הקצאה. מה האפשרויות שלימה מקבלים: רשימת ארבע החלופות החוקיות, כולל האפשרות של חיוב הפוך שבו הלקוח עצמו מדווח, והסבר על לוח הזמנים לשימוע ולערר.
מה צריך לפני שמתחילים
- גישה לרשת כדי לתקשר עם ה-API של שע"מ, אם מבקשים מספר הקצאה בפועל ולא רק בונים טיוטת חשבונית
- מספר עוסק תקין בן תשע ספרות למוכר וללקוח עסקי
- Python להרצת סקריפט הוולידציה המצורף, אם רוצים לבדוק קובץ JSON של חשבונית לפני שליחה
- היכרות בסיסית עם קוד סוג המסמך הנכון לעסקה, כי הסקיל לא בוחר במקומכם בלי מידע על אופן התשלום
אין עדיין Claude Code? במדריך הזה יש התקנה צעד אחרי צעד.
איך מתקינים את חשבונית אלקטרונית ישראלית.
יש 3 דרכים, ומספיקה אחת מהן. הראשונה הכי פשוטה, בלי קוד בכלל.
הכי פשוט: באפליקציה של Claude, בלי שום קוד
מתאים ל-Claude במחשב ובדפדפן. לוקח דקה, ועושים את זה פעם אחת.
- מורידים את הסקילהורדת israeli-e-invoice.zip (42 KB)לא פותחים את הקובץ, מעלים אותו כמו שהוא.
- מדליקים פעם אחת את היכולתב-Claude נכנסים ל-Settings, ואז Capabilities, ומדליקים את
Code execution and file creation. - מעלים את הקובץנכנסים ל-Customize, ואז Skills, לוחצים על הפלוס, בוחרים
Create skillואזUpload a skill, ובוחרים את הקובץ שהורדתם. - זהו, עובדיםמבקשים מ-Claude את המשימה במילים רגילות, והוא משתמש בסקיל לבד כשהוא רלוונטי.
ב-Claude Code: מדביקים הודעה אחת
פותחים שיחה חדשה ב-Claude Code, מעתיקים את ההודעה ומדביקים. כש-Claude מבקש אישור להריץ, לוחצים Allow.
תתקין לי בבקשה את הסקיל israeli-e-invoice ממאגר skills-il/accounting לתיקיית הסקילים שלי. תריץ את הפקודה הזו בדיוק: D="$(mktemp -d)" && git clone --depth 1 -q https://github.com/skills-il/accounting "$D/repo" && mkdir -p ~/.claude/skills && cp -R "$D/repo/israeli-e-invoice" ~/.claude/skills/ && rm -rf "$D" && echo "הותקן ✓"
בטרמינל, ידנית
למי שמעדיף להריץ בעצמו. מעתיקים לטרמינל ומריצים.
D="$(mktemp -d)" && git clone --depth 1 -q https://github.com/skills-il/accounting "$D/repo" && mkdir -p ~/.claude/skills && cp -R "$D/repo/israeli-e-invoice" ~/.claude/skills/ && rm -rf "$D" && echo "הותקן ✓" אופציה ב, CLI רשמי, דורש Node.js 20 ומעלה: npx skills-il add skills-il/accounting@v2.3.0-israeli-e-invoice --skill israeli-e-invoice -a claude-code -y -g
מפעילים מחדש את Claude Code אחרי ההעתקה. אם רוצים לבקש מספר הקצאה בפועל ולא רק ללמוד את הכללים, צריך גישה מוסדרת ל-API של שע"מ לפי references/shaam-api-reference.md בסקיל.
- מריצים ls ~/.claude/skills/israeli-e-invoice ומוודאים שקובץ SKILL.md קיים
- מבקשים דוגמת חשבונית מס לסכום מעל הסף הנוכחי ובודקים שהתשובה מזכירה מספר הקצאה
- מריצים python scripts/validate_invoice.py --help כדי לוודא שהסקריפט המצורף עובד
מריצים שוב את אותה פקודת התקנה, וההעתקה מביאה את הגרסה העדכנית מהמאגר במקום הישנה.
rm -rf ~/.claude/skills/israeli-e-invoice
איך משתמשים ביום יום
- מציינים את סוג העסקה, מכירה עם תשלום מיידי, חשבונית תקופתית, או זיכוי, כי זה קובע את קוד המסמך מההתחלה
- מוסרים אם הלקוח עוסק מורשה ואם הוא ביקש מספר הקצאה, כי בלי זה אי אפשר לקבוע אם המספר נדרש
- בחשבוניות ישנות, מציינים את תאריך ההוצאה המקורי כדי שהבדיקה תתבצע מול הסף הנכון לאותה תקופה
- כשמתקבלת דחייה או תקלה במערכת שע"מ, מבקשים מClaude להציג את כל האפשרויות ולא רק את הראשונה שעולה בראש
טיפים שימושיים
- בודקים תמיד אם הסכום שקיבלתם כולל מע"מ או לא, כי הסף נבדק על הסכום לפני מע"מ בלבד ולא על הסכום הכולל
- חשבונית זיכוי לעולם לא דורשת מספר הקצאה, בשום סכום, אבל היא חייבת להפנות למספר החשבונית המקורית
- כשלקוח לא מנכה מע"מ בכלל, כמו עמותה שאינה מקזזת, אפשר עדיין לבקש מספר לצורך אחידות, ואז משתמשים במספר לקוח הסנטינל הקבוע
- מדפיסים על החשבונית רק את תשע הספרות האחרונות ממספר האישור הארוך שמתקבל מהמערכת, לא את המספר המלא
תקלות נפוצות
מתקבלת שגיאה על מספר לקוח לא תקין
לא בטוחים אם החשבונית צריכה מספר הקצאה
בקשת מספר הקצאה נדחתה
מערכת שע"מ לא זמינה כרגע
שאלות ותשובות
כל חשבונית מס צריכה מספר הקצאה
הסקיל שולח את הבקשה בפועל למערכת שע"מ
מה ההבדל בין חשבונית מס לחשבונית מס וקבלה
אפשר להשתמש בזה על עוסק פטור
קרדיט ומקור. חשבונית אלקטרונית ישראלית נכתב על ידי skills-il ונמצא ב-skills-il/accounting ברישיון MIT. skills-il הוא פרויקט קוד פתוח ישראלי של סקילים ל-AI, ואפשר למצוא את כל הסקילים שלהם גם ב-agentskills.co.il. את העמוד כתב קורן בן עזרא אחרי בדיקה של המאגר ושל פקודות ההתקנה (29.09.2026). מאגרים מתעדכנים, ולכן אם משהו השתנה, המאגר הוא המקור הקובע.