שגיאות נפוצות ופתרונן

ריכזנו כאן את השגיאות שאנחנו פוגשים הכי הרבה אצל לקוחות. אם נתקלתם במשהו שלא מופיע ברשימה — פתחו פנייה ב-Dashboard ונחזיר תשובה תוך 24 שעות.

401 Unauthorized / 403 Forbidden

הסיבה: Token API פג, נמחק, או שלמשתמש אין הרשאות לאובייקט שהזרימה ניגשת אליו.

פתרון:

1. בדקו ב-Connections ← Connection name ← Test Connection האם החיבור עדיין ירוק.
2. במערכת היעד (Priority, Wolt, וכו’) — אמתו שמשתמש ה-API פעיל ושה-Token לא פג.
3. אם נדרש — הפיקו Token חדש ועדכנו ב-SYNCA דרך Edit Connection.

429 Too Many Requests

הסיבה: הגעתם ל-rate limit של המערכת הצד-שלישית.

פתרון: SYNCA מבצעת backoff אוטומטי עם retries מעריכיים — ברוב המקרים הריצה תושלם תוך 1-2 דקות. אם זה קורה תכופות, שקלו:

• להעלות את ה-throttle ב-Flow Settings (להאט את הקריאות).
• לפצל flow אחד עם הרבה פעולות ל-2-3 flows קטנים יותר.
• לבדוק עם המערכת הצד-שלישית אם אפשר להעלות את ה-quota.

Validation failed: <field> is required

הסיבה: שדה חובה במערכת היעד לא מולא בריצה.

פתרון: ב-Audit Log ← הריצה הכושלת ← Input/Output — תראו בדיוק איזה שדה חסר. בדרך כלל זה אומר שצריך:

• להוסיף ברירת מחדל ב-Flow (Transform → Default Value).
• להוסיף תנאי שמדלג על הריצה אם השדה לא קיים.
• לתקן את מקור הנתונים (לדוגמה, להוסיף שדה חובה בתפריט Wolt או בטופס הזמנה).

Timeout after 30s

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

פתרון:

• SYNCA תנסה אוטומטית עד 3 פעמים. ב-99% מהמקרים הניסיון השני יצליח.
• אם זה קורה באופן עקבי בשעות מסוימות, שקלו להזיז את ה-trigger לשעות פחות עמוסות.

Duplicate detected — skipping

זו לא שגיאה. SYNCA זיהתה שהאירוע הזה כבר נרשם בעבר (idempotency) ודילגה כדי למנוע כפילות. אם זה לא הצפי שלכם:

• בדקו את ה-Idempotency Key ב-Flow Settings — ייתכן שהוא רחב מדי.
• אם אתם רוצים להריץ מחדש בכוונה, השתמשו ב-Replay מתוך Audit Log במקום ב-trigger חוזר.

Connection refused / DNS error

הסיבה: SYNCA לא מצליחה להתחבר לכתובת ה-API.

פתרון:

1. בדקו שה-Base URL ב-Connection נכון (כולל https:// והנתיב המלא).
2. אם המערכת היעד נמצאת ברשת פנימית (on-prem) — וודאו שאתם משתמשים ב-SYNCA Bridge (זמין בתוכנית Enterprise).
3. בדקו ב-firewall של המערכת היעד שכתובות ה-IP של SYNCA מורשות.

משהו אחר?

פתחו פנייה דרך Help → Contact Support ב-Dashboard, או שלחו מייל ל-info@synca.co.il עם:

• שם ה-Flow.
• ה-Run ID (מתוך Audit Log).
• צילום מסך / טקסט של ההודעה המלאה.