<!-- source: https://docs.opticcount.com/he/guide/management/integrations -->
# מסך האינטגרציות שלי

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

**מי רואה:** משתמש ראשי · מנהל משותף · תת מנהל

**משמש במודולים:** `ספירה` `ליקוט` `קליטה` `החזרות`

::: tip TL;DR
מוסיפים אינטגרציה, ממלאים את פרטי החיבור, מסמנים **פעיל** ושומרים. מרגע זה כפתורי **יבא … עם** ו‑**ייצוא סיכום ספירה** מופיעים במסכים הרלוונטיים, ובעמודה **סנכרון אוטומטי** אפשר לתזמן משיכה קבועה של נתונים. מה כל מערכת יודעת לעשות – בטבלאות בהמשך.
:::

## איך מגיעים לכאן

- **בטלפון:** תפריט ☰ ← **הגדרות** ← **האינטגרציות שלי**
- **במחשב:** תפריט צד ← **הגדרות** ← **האינטגרציות שלי**

## מה יש במסך

![דף האינטגרציות שלי עם הוסף אינטגרציה חדשה (1), תג פעיל / לא פעיל בשורות WhatsApp ובינה (2) וכפתור ערוך (3)](/screens/integrations/overview.he.png)

### (1) הוסף אינטגרציה חדשה

פותח את הדיאלוג **הוסף אינטגרציה**.

### (2) טבלת האינטגרציות

| עמודה | מה מוצג |
|---|---|
| לוגו | סמל המערכת |
| **שם** | סוג האינטגרציה |
| **הערות** | ההערה שכתבתם (למשל "שרת ייצור") |
| **פעיל** | תג *פעיל* או *לא פעיל* |
| **סנכרון אוטומטי** | הכפתור **תזמון**, או *לא זמין* כשהמערכת לא תומכת בסנכרון אוטומטי או שהאינטגרציה כבויה. ראו [סנכרון אוטומטי](#סנכרון-אוטומטי) |
| **עריכת אינטגרציה** | **ערוך** – פותח את הדיאלוג **עדכון אינטגרציה** |

עמודת **מזהה** מופיעה בסוף הטבלה; בתצוגת הכרטיסיות היא מוסתרת עד שמרחיבים את הכרטיס.

### (3) ערוך

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

## דיאלוג האינטגרציה

בחרו את המערכת ב‑**בחר שם**, מלאו את השדות של אותה מערכת, ובסוף **הערה** ו‑**פעיל**. לחצו **צור אינטגרציה** או **שמור שינויים**. **סגור ללא שמירה** מופיע כשיש שינוי לא שמור.

| מערכת (כפי שמופיעה ברשימה) | שדות חיבור |
|---|---|
| **חשבשבת** | **תחנה**, **תוסף** (HESHIN / IMOVEIN / KUPAIN), **חברה**, **פספורט**, **מפתח פרטי** |
| **פריוריטי** | **כתובת API**, **אסימון גישה אישי**, **סיסמה** |
| **WhatsApp** | **מספרי טלפון**, **טריגרים** (ראו בהמשך) |
| **בינה** | **כתובת API**, **API Key** |
| **בוס פתרונות תוכנה** | **כתובת API**, **Boss Unique ID**, **שם משתמש**, **סיסמה**, **Proxy Password**, ושני מתגים: **האם למשוך נתוני מלאי עדכוני בכל סריקה** ו‑**משיכת שמות ספקים - רק אם נחוץ** |
| **קוד בינה - מיניסופט** | **כתובת API** (לדוגמה `https://w.minisoft.co.il`), **שם משתמש** (בדרך כלל `Api`), **סיסמה** |
| **ירפא** | **טוקן בית המרקחת**, ו‑**סניף למלאי ERP** (אופציונלי). ראו [אינטגרציה עם ירפא](#אינטגרציה-עם-ירפא) |

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

## מה כל מערכת יודעת לעשות

הטבלה מראה את הפעולות שכל מערכת מבצעת דרך המסך הזה והכפתורים במסכים האחרים. באילו מודולים תומכת כל מערכת – ב[סעיף הבא](#באילו-מודולים-תומכת-כל-מערכת-erp).

| מערכת | ייבוא קטלוג | ייבוא סניפים | ייבוא משתמשים | ייבוא לקוחות / ספקים | ייצוא סיכום ספירה | הזמנות |
|---|---|---|---|---|---|---|
| **בינה** | כן | כן | כן | כן | כן | סנכרון הזמנות |
| **בוס פתרונות תוכנה** | כן | כן | כן | – | כן | – |
| **קוד בינה - מיניסופט** | כן | – | – | – | כן | – |
| **פריוריטי** | כן | – | – | – | כן | – |
| **ירפא** | כן | – | – | – | כן | – |
| **חשבשבת** | – | – | – | – | – | – |

חשבשבת נשמרת במסך הזה עם פרטי החיבור בלבד. אינטגרציות עם פריוריטי, SAP Business One וחשבשבת מוקמות לכל לקוח בנפרד יחד עם צוות OpticCount. בינה ומיניסופט מציעות גם פעולות סיום למסמכים (למשל יצירת תעודת משלוח או החזרה ב‑ERP בסיום הזמנה או תעודה). ראו [ניהול הזמנות](/he/guide/management/orders) ו[החזרות](/he/guide/management/returns).

איפה הכפתורים מופיעים:

- **יבא קטלוג** – ב[ניהול קטלוג פריטים](/he/guide/management/catalog). ייבוא חוזר מביא רק פריטים שהשתנו מאז הסנכרון האחרון; אם אין כאלה מופיע *לא נמצאו פריטים חדשים או מעודכנים מאז הסנכרון האחרון*.
- **יבא סניפים** / **יבא משתמשים** / **יבא לקוחות** / **יבא ספקים** – במסכי [סניפים](/he/guide/management/branches), [משתמשים](/he/guide/management/users), [לקוחות](/he/guide/management/customers) ו[ספקים](/he/guide/management/suppliers). הכפתורים מופיעים לכל אינטגרציה פעילה חוץ מ‑WhatsApp; מערכת שלא תומכת בסוג הייבוא מחזירה שגיאה.
- **ייצוא סיכום ספירה** דרך אינטגרציה – ב[ניהול ספירות מלאי](/he/guide/management/counts), לסניף שנבחר. הייצוא משתמש ב**שם ייצוא סניף** כדי לשייך את הכמויות למחסן הנכון.
- **סנכרון הזמנות** – ב[ניהול הזמנות](/he/guide/management/orders): שורת **סינכרון אחרון ב-** ולחצן **לסנכרון ידני**. לפני הסנכרון הראשון מבינה מופיע *לחץ לביצוע סנכרון ראשוני עם Bina*.

## באילו מודולים תומכת כל מערכת ERP

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

| מערכת ERP | ספירת מלאי | קליטת סחורה עם AI | החזרות ויצירת מסמכים | ליקוט הזמנות |
|---|---|---|---|---|
| **בינה** | ✔ | ✔ | ✔ | ✔ |
| **פריוריטי** | ✔ | ✔ | ✔ | ✔ |
| **SAP Business One** | ✔ | ✔ | ✔ | ✔ |
| **חשבשבת** | ✔ | ✔ | ✔ | ✔ |
| **בוס פתרונות תוכנה** | ✔ | ✔ | ✔ | – |
| **קוד בינה - מיניסופט** | ✔ | ✔ | ✔ | – |
| **נשר - תבל** | ✔ | – | – | – |
| **ירפא** (בתי מרקחת) | ✔ | – | – | – |
| כל מערכת אחרת (וואן / כולבולית, Comax ועוד) | ✔ דרך קבצי אקסל | – | – | – |

אינטגרציות עם פריוריטי, SAP Business One וחשבשבת מוקמות לכל לקוח בנפרד יחד עם צוות OpticCount. פריוריטי Zoom היא לא פריוריטי הרגילה: איתה ספירת מלאי עובדת דרך קבצי אקסל בלבד.

## סנכרון אוטומטי

בעמודה **סנכרון אוטומטי** מתזמנים משיכה קבועה של נתונים מה‑ERP, בלי ללחוץ על כפתורי הייבוא בכל פעם. הכפתור **תזמון** מופיע לאינטגרציה פעילה של מערכת שתומכת בכך; בשאר השורות כתוב *לא זמין*.

| מערכת | מה אפשר לתזמן |
|---|---|
| **בינה** | פריטי קטלוג, משתמשים, סניפים, לקוחות, ספקים |
| **בוס פתרונות תוכנה** | פריטי קטלוג, משתמשים, סניפים |
| **קוד בינה - מיניסופט** | פריטי קטלוג |
| **ירפא** | פריטי קטלוג |

1. לחצו **תזמון** בשורת האינטגרציה. נפתח החלון **סנכרון אוטומטי** – *משיכת נתונים לפי לוח זמנים*.
2. הדליקו את המתג ליד סוג הנתונים שרוצים למשוך, למשל **פריטי קטלוג**.
3. ליד **כל** הזינו מספר ובחרו יחידה: **דקות**, **שעות**, **ימים** או **שבועות**. המינימום הוא כל 30 דקות, והמקסימום כחודש.
4. לחצו **שמור**. מופיעה ההודעה *הגדרות הסנכרון האוטומטי נשמרו*.

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

הזמנות לא נכללות בחלון הזה: הזמנות מבינה נמשכות אוטומטית בנפרד, כל כמה דקות. ראו [ניהול הזמנות](/he/guide/management/orders).

## אינטגרציה עם ירפא

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

**שדות החיבור:**

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

**ייבוא קטלוג.** **יבא קטלוג** ב[ניהול קטלוג פריטים](/he/guide/management/catalog) מושך את הפריטים מירפא, יחד עם כמויות המלאי לסניף שנבחר. אפשר גם לתזמן משיכה קבועה של הקטלוג ב[סנכרון האוטומטי](#סנכרון-אוטומטי).

**ייצוא סיכום ספירה.** בסיום הייצוא מ[ניהול ספירות מלאי](/he/guide/management/counts) נפתח חלון עם *נשלחו N פריטים*. שורות שירפא לא מקבלת לא נשלחות, והחלון מציג *N שורות לא נשלחו:* עם רשימה לפי סיבה ודוגמאות של מזהי פריט:

| סיבה | מה זה אומר |
|---|---|
| *פריטים שנוספו ידנית בספירה* | הפריט נוסף בדף הספירה ולא הגיע מהקטלוג של ירפא |
| *פריטים שלא קיימים בקטלוג של ה-ERP* | מזהה הפריט לא נמצא בירפא |
| *מק"ט שאינו מספרי (ה-ERP מקבל מספרים בלבד)* | ירפא מקבלת מזהה פריט מספרי בלבד |
| *כמות עשרונית (ה-ERP מקבל מספרים שלמים בלבד)* | ירפא מקבלת כמויות שלמות בלבד |
| *כמות שלילית* | הכמות שנספרה קטנה מאפס |
| *פריטים לא פעילים* | הפריט מסומן כלא פעיל בקטלוג |
| *פריטים ללא מק"ט* | לפריט אין מזהה פריט |

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

**הרשמה עם קוד QR.** בית מרקחת שנרשם דרך קוד QR של ירפא מקבל חשבון שמחובר כבר לירפא, בלי להזין טוקן. בחשבון כזה הקטלוג נמשך מירפא פעם ביום, והמשיכה הראשונה מתחילה כדקה אחרי הכניסה הראשונה. את התדירות משנים ב**תזמון**. ראו [התחלה מהירה](/he/quick-start#הרשמה-עם-קוד-qr-של-מערכת-erp).

דמי ההתממשקות לירפא מתחדשים עם הרישיון ואינם תשלום חד‑פעמי. ראו [רשיון שימוש ורכישות](/he/guide/management/license).

## תוצאת סנכרון הזמנות מבינה

אחרי סנכרון נפתח החלון **סנכרון Bina הושלם** (או **סנכרון Bina הושלם — עם אזהרות**):

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

## התראות WhatsApp

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

| טריגר | מה נשלח | הגדרה נוספת |
|---|---|---|
| **התראת מלאי נמוך** | כמה פריטים בסניף ירדו מתחת לסף. הרשימה המלאה נמצאת באפליקציה, תחת דוחות מלאי | הסף נקבע לכל פריט בנפרד בקטלוג; פריט בלי סף לא מייצר התראה |
| **דוח תפוגות יומי** | כמה פריטים יפוגו בתוך מספר הימים שהגדרתם. הרשימה המלאה ב[דוח תפוגות](/he/guide/management/counts#דוח-תפוגות) | **ימים לפני תפוגה** (1–365, ברירת מחדל 3) ו**מתי לשלוח** |

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

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

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

## אבטחה

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

## טעויות נפוצות

- **הכפתור לא מופיע** → האינטגרציה לא מסומנת **פעיל**, או שהמערכת לא תומכת בפעולה (ראו הטבלה).
- **בעמודה סנכרון אוטומטי כתוב *לא זמין*** → האינטגרציה כבויה, או שהמערכת לא מופיעה בטבלת [הסנכרון האוטומטי](#סנכרון-אוטומטי).
- **כתובת API שגויה** → ודאו `https://` ונתיב מלא כפי שמופיע בדוגמה בשדה.
- **הזמנות מבינה "דולגו – לא נמצאה חנות"** → הזינו ב[ניהול סניפים](/he/guide/management/branches) את **קוד סניף/מחסן** בדיוק כפי שהוא בבינה.
- **ייבוא קטלוג לא מביא כלום** → זה תקין אם לא היו שינויים; לייבוא מלא לחצו **איפוס סנכרון** ואז ייבאו שוב.
- **הטוקן של ירפא פג** → בקשו טוקן חדש מירפא, הזינו אותו ב**טוקן בית המרקחת** ולחצו **שמור שינויים**.

## דפים קשורים

- [ניהול קטלוג פריטים](/he/guide/management/catalog) – לייבא קטלוג מה‑ERP
- [ניהול ספירות מלאי](/he/guide/management/counts) – לייצא סיכום ספירה
- [ניהול הזמנות](/he/guide/management/orders) – לסנכרן הזמנות מבינה
- [המודולים במבט אחד](/he/modules/) – לבדוק אילו מודולים פתוחים לכל ERP
- [פרטי העסק](/he/guide/management/company) – לבחור את מערכת ה‑ERP לפורמט קובץ הייצוא