tags: [hr, integration, devops, payroll]
# חיבור מערכת נוכחות לתוכנת שכר — מדריך אינטגרציה צעד אחר צעד
אחת הטעויות הנפוצות ביותר שאני רואה בארגונים היא ההנחה שחיבור מערכת נוכחות לתוכנת שכר הוא "רק ייצוא קובץ אקסל". בפועל, כאשר לא מתכננים את האינטגרציה נכון — מגיעים לסוף החודש עם חישובי שכר שגויים, עובדים ממורמרים ומחלקת כספים שדורשת תיקונים ידניים. המאמר הזה נועד לחסוך לכם את הכאב הזה.
---
## למה האינטגרציה מסובכת יותר ממה שנראה

תוכנות שכר עובדות עם **רגולציה קשיחה**: חוק שעות עבודה ומנוחה, הסכמים קיבוציים, תוספות שכר לפי ותק ועוד. מערכת הנוכחות, לעומת זאת, אוספת עובדות גולמיות — כניסה, יציאה, הפסקות. הפער בין "שעות שהועבדו בפועל" לבין "שעות לתשלום" הוא בדיוק המקום שבו הכי הרבה ארגונים נופלים.
שלושת המשתנים הכי בעייתיים:
1. **שעות נוספות** — האם מחושבות מעל 42 שעות שבועיות? מעל 8.6 שעות ביומי? ואיך מטפלים בשבת?
2. **היעדרויות ומחלה** — האם ימי מחלה מנוכים בתשלום, בחלקי תשלום, או ללא תשלום? האם הם מוזנים ידנית או דרך ממשק?
3. **משמרות** — עובד שמתחיל משמרת ב-23:00 ומסיים ב-07:00 — לאיזה יום מיוחסות השעות?
---
## שלב 1 — מיפוי שדות לפני כל חיבור
לפני שנוגעים ב-API, בנו טבלת מיפוי מלאה:
| שדה במערכת נוכחות | שדה בתוכנת שכר | הערות |
|---|---|---|
| `employee_id` | `worker_code` | חובה שיהיה מפתח זהה |
| `clock_in` / `clock_out` | `hours_worked` | לאחר עיגול לפי נוהל |
| `absence_type` | `deduction_code` | מחלה / חופשה / עדר |
| `overtime_hours` | `ot_125` / `ot_150` | לפי חוק שעות עבודה |
הנקודה הקריטית: **מספר העובד חייב להיות זהה בשני המערכות**. אם יש אי-התאמה ולו של עובד אחד — כל חישוב השכר שלו ייפול.
---
## שלב 2 — בחירת שיטת החיבור
יש שלוש גישות נפוצות:
**ייצוא קובץ (CSV/XML)** — הפשוטה ביותר, אבל ידנית ומועדת לטעויות אנוש. מתאימה לארגונים קטנים עד 30 עובדים.
**אינטגרציה ב-API דו-כיוונית** — מערכת הנוכחות שולחת נתונים בזמן אמת לתוכנת השכר, ומקבלת בחזרה אישורים. זו הגישה המומלצת. טיימקלוק 365, למשל, חושפת ממשק API מתועד שמאפשר לשלוח נתוני נוכחות ישירות למערכות שכר כמו Priority, Hilan ו-Sapak.
**מחבר מוכן (Connector)** — חלק מתוכנות השכר מספקות מחברים מוכנים. בדקו תחילה אם קיים כזה לפני שכותבים קוד מאפס.
---
## שלב 3 — טיפול בחריגות לפני שהן שוברות את הסקריפט
### שעות נוספות
אל תסמכו על כך שתוכנת השכר "תדע" לחשב שעות נוספות לבד. הגדירו כבר בצד מערכת הנוכחות:
- סף יומי לשעות נוספות (בדרך כלל 8.6 שעות)
- סף שבועי (42 שעות)
- תוספת לשעות 125% ולשעות 150%
שלחו את הנתונים **כבר מחולקים** לתוכנת השכר — לא שעות גולמיות. כך תמנעו פרשנויות שונות בין המערכות.
### ימי מחלה
הגדרה ברורה של קוד היעדרות היא קריטית. במקרים רבים מערכת הנוכחות תרשום "נעדר" ותוכנת השכר לא תדע אם מדובר במחלה, חופשה, או כניסה מאוחרת. יצרו מיפוי מפורש:
absence_type: "sick" → deduction_code: "SICK_PAID"
absence_type: "vacation" → deduction_code: "VACATION"
absence_type: "unpaid" → deduction_code: "UNPAID_LEAVE"
### משמרות לילה
הגדירו מראש את "יום עבודה לוגי" — בדרך כלל מ-06:00 ועד 06:00 למחרת. כך משמרת לילה מיוחסת כולה ליום אחד ולא מפוצלת. ודאו שגם תוכנת השכר עובדת לפי אותה הגדרה.
---
## שלב 4 — בדיקות לפני העלייה לאוויר
לפני שמחברים לייב, הריצו **סיבוב בדיקה מלא** על נתוני חודש אחד אחורה:
1. ייצאו נתוני נוכחות היסטוריים
2. העבירו דרך לוגיקת האינטגרציה
3. השוו את הפלט לתלושי שכר קיימים — שורה אחר שורה
4. תעדו כל סטייה
תארגטו שגיאה מקסימלית של **פחות מ-0.5% בסך שעות עובד**. כל דבר מעבר לכך מצריך בדיקה מחודשת של לוגיקת המיפוי.
---
## מלכודות נפוצות שכדאי לדעת מראש
- **עיגול שעות** — חלק מהמערכות מעגלות ל-15 דקות ואחרות לדקה. ודאו שהמדיניות אחידה.
- **שינוי שעון קיץ/חורף** — לילה אחד של 23 שעות במקום 24 יכול לבלבל חישובים שבועיים.
- **עובד שנרשם פעמיים** — כפילות רשומות (לדוגמה, בעקבות שינוי תפקיד) גורמת לשגיאות מפתיעות.
- **שדות ריקים** — תוכנת שכר לרוב לא מטפלת בשדה ריק כמו ב-null. הגדירו ערכי ברירת מחדל.
---
## מעקב וניטור שוטף לאחר האינטגרציה
אינטגרציה טובה לא מסתיימת בהעלייה לאוויר. הגדירו:
- **התראה אוטומטית** כשנפח נתוני הנוכחות שמגיע לתוכנת השכר חורג מהממוצע החודשי ב-20% לכל כיוון
- **לוג שגיאות** שניתן לצפות בו ללא גישה לשרת הייצור
- **תהליך תיקון** ברור למקרה שנוצרת בעיה ב-26 לחודש, יום לפני ריצת השכר
טיימקלוק 365 כוללת לוח בקרה מרכזי שמאפשר לזהות חריגות בזמן אמת — עובדים שלא דיווחו, כניסות כפולות, ושדות חסרים — עוד לפני שהנתונים עוברים לתוכנת השכר.
---
## סיכום
חיבור מערכת נוכחות לשכר הוא פרויקט תשתיתי שדורש תכנון, לא רק קוד. כשעושים אותו נכון — מחלקת שכר עובדת בשקט, עובדים מקבלים את הכסף הנכון ומנהלי IT לא מקבלים טלפונים בסוף חודש.
אם אתם מחפשים נקודת פתיחה עם API מתועד, תמיכה בביומטרי, משמרות ודיווח היעדרויות — שווה לבדוק את [טיימקלוק 365](https://timeclock365.com).
**רוצים לראות איך זה עובד על הנתונים שלכם?** [התחילו ניסיון חינם עכשיו](https://live.timeclock365.com/he/reg) — ללא התחייבות.













