סורק קבלות ישראלי

שלב 1: הכנת תמונת הקבלה או הטקסט

זהה את פורמט הקלט. הקבלה עשויה להגיע כ:

• תמונה מצולמת או סרוקה (JPEG, PNG, PDF)
• טקסט OCR גולמי שכבר חולץ על ידי כלי אחר
• קבלה דיגיטלית בפורמט טקסט רגיל או HTML

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

שלב 2: זיהוי סוג המסמך

קבע האם המסמך הוא:

• חשבונית מס: מכילה מספר עוסק מורשה, סכום מע"מ מפורט, והכותרת "חשבונית מס" או "חשבונית מס / קבלה". מונפקת על ידי עסקים מורשים (עוסק מורשה) ונדרשת לניכוי מע"מ.
• קבלה: אישור תשלום פשוט יותר ללא פירוט מע"מ מפורט. הכותרת בדרך כלל "קבלה" בלבד.
• חשבונית מס / קבלה משולבת: מסמך משולב המשמש גם כחשבונית וגם כקבלה, נפוץ בקמעונאות. חפש את הכותרת הכפולה.
• חשבונית עסקה: חשבונית מקדימה לפני תשלום, לא תקפה לניכוי מע"מ.

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

שלב 3: חילוץ שדות ליבה

נתח את השדות הבאים מטקסט הקבלה:

1. שם העסק: בדרך כלל השורה הראשונה, בעברית. עשוי לכלול גם תעתיק באנגלית או שם מותג.
2. מספר עוסק מורשה / ח.פ.: מספר בן 9 ספרות, לרוב מופיע עם הקידומת "עוסק מורשה" או "ח.פ.". ממוקם ליד כותרת בית העסק.
3. כתובת: רחוב, עיר. שימושי למעקב מיקום הוצאות.
4. תאריך: קבלות ישראליות משתמשות בפורמט DD/MM/YYYY. חפש את התווית "תאריך" או תאריך ליד החלק העליון.
5. שעה: לרוב צמודה לתאריך.
6. מספר חשבונית / מספר קבלה: מספר רץ, חפש "מס' חשבונית", "מספר קבלה", או "מס' אסמכתא".
7. פריטים: שם מוצר (בעברית), כמות, מחיר ליחידה, וסה"כ שורה. קבלות סופרמרקט מפרטות פריטים עם ברקודים.
8. סכום לפני מע"מ: סכום לפני מס ערך מוסף.
9. מע"מ: נכון ל-2026 שיעור המע"מ בישראל הוא 18%. חפש את התווית "מע"מ".
10. סה"כ: הסכום הסופי לתשלום, בשקלים. חפש "סה"כ", "סה"כ לתשלום", או "סכום כולל".
11. אמצעי תשלום: כרטיס אשראי (4 ספרות אחרונות), מזומן, ארנק דיגיטלי, או העברה בנקאית.
12. תשלומים: אם שולם בתשלומים, מספר התשלומים וסכום כל תשלום.

שלב 4: טיפול בפורמטים נפוצים של קמעונאים ישראליים

קמעונאים ישראליים שונים משתמשים בפריסות קבלה שונות:

רשתות מזון (שופרסל, רמי לוי, יוחננוף, אושר עד):

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

תחנות דלק (פז, סונול, דלק, טן):

• סוג דלק (95, 98, סולר) וליטרים
• מחיר לליטר
• קריאת מד אוץ (לעתים)
• שטיפת רכב או פריטי חנות נוחות כפריטים נפרדים

מסעדות ובתי קפה:

• דמי שירות כאחוז, בדרך כלל 10-12%
• שורת טיפ שעשויה להיות ריקה או מלאה
• מספר שולחן ושם מלצר
• סימני חלוקת חשבון

רכישות מקוונות (חשבוניות ממסחר אלקטרוני ישראלי):

• פורמט דיגיטלי, לרוב PDF
• דמי משלוח כפריט נפרד
• מספר הזמנה בנוסף למספר חשבונית

שלב 5: סיווג אוטומטי של ההוצאה

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

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

שלב 6: ייצוא נתונים מובנים

הפק את הנתונים המחולצים בפורמט מובנה. ברירת המחדל היא JSON:

{
  "document_type": "tax_invoice_receipt",
  "merchant": {
    "name_he": "שופרסל דיל",
    "name_en": "Shufersal Deal",
    "vat_registration": "520044078",
    "branch": "סניף רמת אביב",
    "address": "רחוב איינשטיין 15, תל אביב"
  },
  "document_number": "12345678",
  "date": "2026-03-08",
  "time": "14:32",
  "items": [
    {
      "description": "חלב תנובה 3% 1 ליטר",
      "quantity": 2,
      "unit_price": 6.90,
      "total": 13.80
    }
  ],
  "subtotal": 245.50,
  "vat_rate": 0.18,
  "vat_amount": 37.44,
  "total": 289.69,
  "currency": "ILS",
  "payment": {
    "method": "credit_card",
    "card_last_four": "4532",
    "installments": 1
  },
  "category": "groceries",
  "category_he": "מזון ומכולת"
}

לייצוא CSV, שטח את המבנה עם העמודות הבאות: date, document_type, document_number, merchant_name, vat_registration, subtotal, vat_amount, total, payment_method, category

שלב 7: אימות הנתונים המחולצים

בצע בדיקות אימות על הנתונים המחולצים:

1. חישוב מע"מ: ודא ש-סה"כ = סכום לפני מע"מ + מע"מ (סטייה מותרת של 0.05 ש"ח לעיגול). שיעור המע"מ הנוכחי בישראל הוא 18%.
2. פורמט תאריך: ודא שהתאריך תקין ולא בעתיד.
3. מספר עוסק מורשה: ודא שהמספר הוא בדיוק 9 ספרות.
4. סיכומי פריטים: ודא שסכום כל הפריטים שווה לסכום לפני מע"מ (בטווח סטיית עיגול).
5. מטבע: אשר שהסכומים הם בשקלים. סמן אם מזוהים סמלי מטבע זר.

אם האימות נכשל, כלול מערך warnings בפלט עם הבעיות הספציפיות שנמצאו.

דוגמה 1: קבלת סופרמרקט

המשתמש אומר: "סרוק את הקבלה הזו משופרסל וחלץ את הנתונים."

המשתמש מספק תמונה של קבלת שופרסל. הסוכן:

1. קורא את תמונת הקבלה באמצעות יכולות ראייה
2. מזהה את המסמך כ"חשבונית מס / קבלה"
3. מחלץ בית עסק: "שופרסל דיל, סניף רמת אביב"
4. מחלץ מספר עוסק מורשה: "520044078"
5. מנתח 12 פריטים כולל תוצרת חקלאית, מוצרי חלב ומוצרים ארוזים
6. מזהה שורת הנחת מועדון: "הנחת מועדון: -15.40"
7. מחלץ סיכומים: סכום לפני מע"מ 312.80, מע"מ 47.66, סה"כ 369.10
8. תשלום: כרטיס אשראי המסתיים ב-4532, תשלום אחד
9. מסווג אוטומטית כ"מזון ומכולת"
10. מייצר JSON מובנה עם כל השדות מאוכלסים

תוצאה: פלט JSON מלא עם כל 12 הפריטים, סיכומים מאומתים (בדיקת מע"מ עברה), והקצאת קטגוריה.

דוגמה 2: קבלת תחנת דלק עם מספר פריטים

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

המשתמש מספק תמונת קבלה מסונול. הסוכן:

1. קורא את הקבלה ומזהה אותה כחשבונית מס
2. מחלץ בית עסק: "סונול, תחנת שירות הרצליה"
3. מנתח שני פריטים: דלק (אוקטן 95, 35.2 ליטר במחיר 7.45/ליטר = 262.24) ורכישת חנות נוחות (בקבוק מים, 8.90)
4. מחלץ סיכומים: סכום לפני מע"מ 229.78, מע"מ 41.36, סה"כ 271.14
5. תשלום: כרטיס אשראי המסתיים ב-8891
6. מכיוון שהקבלה מכילה גם דלק וגם פריט חנות, יוצר שתי הקצאות קטגוריה:
   • דלק: 262.24 ש"ח
   • כללי: 8.90 ש"ח
7. מייצר JSON מובנה עם סיווג מפוצל

תוצאה: JSON עם קטגוריות הוצאה מפוצלות והערה שהקבלה מכסה שני סוגי הוצאות.

דוגמה 3: חשבונית מס ממסעדה

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

המשתמש מספק קבלת מסעדה. הסוכן:

1. קורא את הקבלה ומזהה אותה כ"חשבונית מס / קבלה"
2. מחלץ בית עסק: "מסעדת רפאל, תל אביב"
3. מחלץ מספר עוסק מורשה לבדיקת זכאות לניכוי מס
4. מנתח פריטי מזון, משקאות ודמי שירות של 12%
5. מסמן שלצורכי ניכוי ארוחות עסקיות בישראל, רק חלק מהוצאות המסעדה ניתן לניכוי לצורכי מע"מ
6. מייצר JSON עם שדה tax_notes: "ניכוי מע"מ על ארוחות עסקיות כפוף למגבלות רשות המסים בישראל"

תוצאה: JSON מלא עם הערות רלוונטיות למס עבור רואה החשבון.

סקריפטים

• scripts/receipt_parser.py -- כלי Python לעיבוד אצוות של תמונות קבלות. הרצה: python scripts/receipt_parser.py --help
• scripts/export_csv.py -- המרת נתוני קבלות מ-JSON לפורמט CSV לייבוא לתוכנת הנהלת חשבונות. הרצה: python scripts/export_csv.py --input receipts.json --output expenses.csv

חומרי עזר

• references/israeli-vat-rates.md -- שיעורי מע"מ היסטוריים וסכומי סף בישראל. עיין בעת אימות חישובי מע"מ על קבלות ישנות.
• references/receipt-field-glossary.md -- מילון מונחים עברית-אנגלית של שדות קבלה נפוצים. עיין בעת מפגש עם מונחים עבריים לא מוכרים בקבלות.

שגיאה: "לא ניתן לקרוא טקסט בעברית מהתמונה"

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

פתרון:

1. בקש תמונה ברזולוציה גבוהה יותר (לפחות 300 DPI למסמכים סרוקים)
2. אם הקבלה דהויה, בקש מהמשתמש להתאים ניגודיות או לצלם תחת תאורה חזקה ואחידה
3. נסה לסובב את התמונה אם הטקסט מופיע הפוך או על הצד
4. עבור קבלות הניתנות לקריאה חלקית, חלץ את מה שאפשר וסמן שדות בלתי קריאים כ-null עם אזהרה

שגיאה: "אי-התאמה בחישוב מע"מ"

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

פתרון:

1. בדוק אם חלק מהפריטים פטורים ממע"מ (לדוגמה, פירות וירקות בהקשרים מסוימים)
2. ודא את שיעור המע"מ שנעשה בו שימוש, השיעור הסטנדרטי הוא 18% אך אשר מול הקבלה
3. אפשר סטיית עיגול של עד 0.10 ש"ח עבור קבלות עם פריטים רבים
4. אם אי-ההתאמה חורגת מהסטייה המותרת, סמן אותה באזהרות הפלט אך עדיין כלול את הערכים כפי שמודפסים

שגיאה: "בית עסק לא מוכר, לא ניתן לסווג אוטומטית"

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

פתרון:

1. נסה לסווג לפי הפריטים במקום לפי שם בית העסק
2. בדוק אם מספר העוסק המורשה ממופה לקטגוריית עסק מוכרת
3. חפש מילות מפתח בקבלה (לדוגמה, "מסעדה" למסעדה, "תדלוק" לדלק)
4. הגדר כברירת מחדל "הוצאות כלליות" וכלול דגל needs_review: true

שגיאה: "פורמט תאריך עמום"

סיבה: חלק מהקבלות מדפיסות תאריכים ללא מפרידים ברורים או משתמשות בפורמטים לא עקביים. לדוגמה, "080326" יכול להתפרש כ-08/03/2026 (DD/MM/YYYY) או 03/08/2026 (MM/DD/YYYY).

פתרון:

1. קבלות ישראליות משתמשות בפורמט DD/MM/YYYY כברירת מחדל, החל הנחה זו
2. הצלב עם יום השבוע אם מודפס על הקבלה
3. אם הקבלה כוללת תאריך עברי, השתמש בו כאימות משני
4. כאשר יש עמימות אמיתית, הצג את שני התאריכים האפשריים וסמן לאישור ידני