התאמת בנק ישראלי

אוטומציה של תהליך התאמת עסקאות בנק ישראליות מול רשומות הנהלת החשבונות שלך. מיומנות זו משתמשת בספריית הקוד הפתוח israeli-bank-scrapers לשליפת עסקאות ומספקת זרימת עבודה מובנית להתאמה, זיהוי פערים והפקת דוחות.

שלב 1: הגדרת סביבת העבודה

התקן את התלויות הנדרשות לסריקת בנקים ועיבוד נתונים.

npm init -y
npm install israeli-bank-scrapers csv-parse csv-stringify dayjs

אם אתה מתכנן לייבא קבצי OFX במקום סריקה, התקן גם:

npm install ofx-js

לעיון, ספריית הסריקה המרכזית מתוחזקת כאן: https://github.com/eshaham/israeli-bank-scrapers

למשתמשים המעוניינים במעקב תקציבי אוטומטי לצד התאמה, מומלץ לבדוק את Caspion: https://github.com/brafdlog/caspion

שלב 2: הגדרת פרטי גישה לבנק

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

צור קובץ בשם bank-config.json במבנה הבא:

{
  "accounts": [
    {
      "id": "main-business",
      "bank": "hapoalim",
      "credentials": {
        "userCode": "${BANK_USER_CODE}",
        "password": "${BANK_PASSWORD}"
      }
    }
  ]
}

מזהי בנקים נתמכים:

• hapoalim - בנק הפועלים
• leumi - בנק לאומי
• discount - בנק דיסקונט
• mizrahi - מזרחי טפחות
• otsar-hahayal - אוצר החייל
• mercantile - מרכנתיל דיסקונט
• max - מקס (לשעבר לאומי קארד)
• visa-cal - ויזה כאל
• isracard - ישראכרט

שמור את פרטי הגישה האמיתיים במשתני סביבה, לא בקובץ ההגדרות.

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

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

const { createScraper } = require('israeli-bank-scrapers');

async function fetchTransactions(bankId, credentials, startDate) {
  const scraper = createScraper({
    companyId: bankId,
    startDate: startDate,
    combineInstallments: false,
    showBrowser: false
  });

  const result = await scraper.scrape(credentials);

  if (!result.success) {
    throw new Error(`הסריקה נכשלה: ${result.errorType} - ${result.errorMessage}`);
  }

  return result.accounts.flatMap(account =>
    account.txns.map(txn => ({
      date: txn.date,
      amount: txn.chargedAmount,
      description: txn.description,
      memo: txn.memo || '',
      reference: txn.identifier || '',
      status: txn.status,
      accountNumber: account.accountNumber
    }))
  );
}

שלב 4: ייבוא רשומות הנהלת חשבונות

טען את החשבוניות והקבלות שלך מ-CSV, או התחבר למערכת הנהלת החשבונות שלך. ההתאמה מצפה לרשומות בפורמט מנורמל.

פורמט רשומת חשבונאות צפוי:

בעת ייבוא CSV, טפל בפורמטים ישראליים:

• סכומי שקלים עשויים להשתמש בפסיק כמפריד עשרוני (1,234.56 או 1.234,56)
• תאריכים עשויים להופיע כ-DD/MM/YYYY (פורמט ישראלי) במקום YYYY-MM-DD
• שמות עסקים בעברית דורשים קידוד UTF-8

שלב 5: הגדרת כללי התאמה

הגדר כללים להתאמת עסקאות אוטומטית. מנוע ההתאמה תומך באסטרטגיות מרובות המופעלות לפי סדר עדיפות.

התאמה מדויקת: התאמה לפי מספר אסמכתא וסכום מדויק.

התאמה מקורבת: התאמה לפי טווח תאריכים (+/- 3 ימים), סטיית סכום (עד 1 ש"ח), ודמיון בשם הספק.

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

const matchingRules = [
  {
    name: 'exact-reference',
    priority: 1,
    match: (bankTxn, accRecord) =>
      bankTxn.reference === accRecord.reference &&
      Math.abs(bankTxn.amount - accRecord.amount) < 0.01
  },
  {
    name: 'amount-date-fuzzy',
    priority: 2,
    match: (bankTxn, accRecord) => {
      const dateDiff = Math.abs(
        dayjs(bankTxn.date).diff(dayjs(accRecord.date), 'day')
      );
      const amountDiff = Math.abs(bankTxn.amount - accRecord.amount);
      return dateDiff <= 3 && amountDiff <= 1.0;
    }
  },
  {
    name: 'recurring-pattern',
    priority: 3,
    patterns: [
      { regex: /חשמל|electric/i, category: 'utilities' },
      { regex: /ארנונה|municipal/i, category: 'municipal-tax' },
      { regex: /ביטוח|insurance/i, category: 'insurance' }
    ]
  }
];

שלב 6: הרצת מנוע ההתאמה

בצע את תהליך ההתאמה וסווג את התוצאות לשלוש קטגוריות:

1. מותאם - עסקת בנק שמותאמת לרשומה חשבונאית
2. לא מותאם בבנק - עסקאות בנק ללא רשומה חשבונאית מתאימה (חשבוניות חסרות)
3. לא מותאם בהנהלת חשבונות - רשומות חשבונאיות ללא עסקת בנק מתאימה (הפקדות ממתינות או שגיאות)

בנוסף, סמן עסקאות חשודות:

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

שלב 7: הפקת דוחות התאמה

הפק דוח מובנה המציג את סטטוס ההתאמה.

הדוח צריך לכלול:

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

פורמטי פלט:

• CSV לייבוא לתוכנות גיליונות אלקטרוניים
• JSON לצריכה תוכניתית
• סיכום קונסולי לבדיקה מהירה

דוגמה 1: התאמה חודשית לעסק קטן

המשתמש אומר: "התאם את חשבון העסק שלי בבנק הפועלים לינואר 2026 מול הייצוא מ-QuickBooks."

פעולות:

1. שליפת עסקאות מבנק הפועלים לתאריכים 1-31 בינואר 2026 באמצעות israeli-bank-scrapers
2. פענוח קובץ ה-CSV מ-QuickBooks, נרמול תאריכים מ-DD/MM/YYYY ל-YYYY-MM-DD וסכומים לש"ח
3. הרצת כללי התאמה: התאמה מדויקת לפי אסמכתא תחילה, ואז התאמה מקורבת לפי תאריך+סכום
4. זיהוי 142 עסקאות מותאמות, 8 עסקאות בנק לא מותאמות, ו-3 רשומות חשבונאיות לא מותאמות

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

דוגמה 2: התאמת ריבוי בנקים עם כרטיסי אשראי

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

פעולות:

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

תוצאה: דוח התאמה משולב המכסה את שני החשבונות. עו"ש לאומי מציג שיעור התאמה של 97% עם 12 פריטים לא מותאמים. כרטיס אשראי מקס מציג שיעור התאמה של 91%, כאשר רוב הפריטים הלא מותאמים הם פיצולי תשלומים. הדוח כולל המלצה לפצל 4 רשומות חשבונאיות כדי להתאים לדפוס התשלומים. הפרש התאמה כולל: 127.50 ש"ח, שמקורו בהפרש עיגול של המרת מטבע חוץ.

דוגמה 3: זיהוי חשבוניות חסרות לפני הגשת דוח מס

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

פעולות:

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

תוצאה: נמצאו 34 עסקאות הוצאה בסך 18,200 ש"ח ללא חשבוניות תואמות. הפערים הגדולים ביותר הם: ציוד משרדי מספק שחייב במזומן (6 עסקאות, 3,400 ש"ח), מנויי תוכנה שחויבו בדולר והומרו (8 עסקאות, 5,100 ש"ח), וחיובי חניה/כבישי אגרה (20 עסקאות קטנות, 9,700 ש"ח). מסופקת רשימה מתועדפת לרואה החשבון לאיתור או יצירת חשבוניות חסרות.

מקורות

• תיעוד ספריית israeli-bank-scrapers: https://github.com/eshaham/israeli-bank-scrapers - יש לעיין בעת הוספת תמיכה בסוגי בנקים חדשים או פתרון בעיות בהגדרת הסורק.
• Caspion למעקב תקציבי אוטומטי: https://github.com/brafdlog/caspion - יש לעיין כאשר משתמשים רוצים לשלב התאמה עם מעקב תקציבי שוטף וקטגוריזציה.

שגיאה: "Scrape failed: INVALID_PASSWORD"

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

שגיאה: "No transactions found for the specified date range"

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

שגיאה: "CSV parsing failed: unexpected character at position N"

סיבה: תוכנות הנהלת חשבונות ישראליות לעתים קרובות מייצאות CSV בקידוד Windows-1255 (עברית) או כוללות סמני BOM שמפריעים למפענחי UTF-8. פתרון: המר את הקובץ ל-UTF-8 לפני הפענוח: iconv -f WINDOWS-1255 -t UTF-8 input.csv > output.csv. לחלופין, ציין את הקידוד באפשרויות מפענח ה-CSV. כמו כן, בדוק אם יש מפרידי נקודה-פסיק (נפוץ בייצוא Excel ישראלי) במקום פסיקים.

שגיאה: "Amount mismatch: bank shows -X but accounting shows -Y"

סיבה: הפרשי עיגול בהמרת מטבע, חישובי מע"מ, או פיצול תשלומים עלולים לגרום לפערים קטנים בין סכומי הבנק לרשומות החשבונאיות. פתרון: הגדר את סף סטיית ההתאמה. לסכומי שקלים, סטייה של 1.00 ש"ח מטפלת ברוב מקרי העיגול. לעסקאות הכוללות המרת מטבע חוץ, הגדל את הסטייה ל-5.00 ש"ח. אם הפערים שיטתיים, בדוק האם מע"מ (17% בישראל) כלול בסכומי הבנק אך מופרד ברשומות החשבונאיות.