חיבור למערכות הארגון
מה צריך כדי ש-ShipFlow תקרא מהמערכות שלכם
המערכת בנויה כך שהחיבור למקורות הנתונים הוא קונפיגורציה ולא פיתוח: מזינים פרטי גישה במסך הניהול, לוחצים ״בדוק חיבור״, והסנכרון הבא קורא מהמקור האמיתי. בעמוד הזה — מה נדרש מצדכם ב-monday.com וב-Priority, לפי תיעוד היצרנים.
monday.com
בורד המעקב של צוות הרכש
ה-API של monday.com מבוסס GraphQL עם endpoint יחיד: https://api.monday.com/v2. כל בקשה נשלחת עם שלוש כותרות: Authorization (הטוקן), Content-Type: application/json ו-API-Version.
הפקת טוקן: לחיצה על האווטאר ← Administration ← Connections ← Personal API token. משתמש שאינו אדמין מפיק טוקן ממסך Developer ← My Access Tokens.
הטוקן כפוף להרשאות המשתמש שהפיק אותו — לכן מומלץ להקים משתמש ייעודי עם גישה לבורד הרכש בלבד, ולהפיק ממנו את הטוקן.
- 1הפקת טוקן
במשתמש הייעודי: אווטאר ← Administration ← Connections ← Personal API token. מעתיקים את הטוקן.
- 2הדבקה באדמין
ניהול ← קונקטורים ← Monday ← ״חיבור מודרך״: מדביקים את הטוקן ומזינים את מזהה הבורד (Board ID).
- 3בדיקת חיבור ובחירת בורד
״בדוק חיבור״ מבצע שאילתת me מול ה-API ומציג עם מי מחוברים. מכאן הסנכרון קורא את פריטי הבורד.
- חשבון monday.com עם גישה לבורד הרכש
- משתמש ייעודי (מומלץ) עם הרשאה לבורד הזה בלבד
- Personal API token שהופק מאותו משתמש
- מזהה הבורד (Board ID) — מופיע בכתובת הבורד
שעות בודדות למי שיש לו הרשאות אדמין ב-monday.com.
בצד שלנו אין פיתוח — החיבור הוא קונפיגורציה באדמין.
Priority
הזמנות הרכש הפתוחות — מקור האמת
ה-API של Priority מבוסס OData REST וחושף את טפסי המערכת. ShipFlow קוראת את טופס הזמנות הרכש ומשתמשת בו כמקור האמת למספר ההזמנה, הספק, תיאור המוצר והשווי.
דרישות קדם אצלכם: מודול API ורישיונות API פעילים; סימון Available for API לטפסים הרלוונטיים (הזמנות רכש); והגדרת API User Name + סימון API License למשתמש הייעודי.
אימות מומלץ: טוקן מטופס REST Interface Access Tokens (מוצג פעם אחת בלבד). החיבור נעשה עם Basic Authorization, כאשר ה-username הוא הטוקן והסיסמה היא PAT.
- 1קבלת כתובת השירות
המטמיע או ה-IT מספקים את כתובת שירות ה-OData של הסביבה ואת שם החברה (company), אחרי הפעלת מודול ה-API וסימון הטפסים.
- 2הזנה באדמין
ניהול ← קונקטורים ← Priority ← ״חיבור מודרך״: כתובת ה-API, החברה, והטוקן מטופס REST Interface Access Tokens (כ-username) עם PAT כסיסמה.
- 3בדיקת חיבור
״בדוק חיבור״ מאמת שהשירות מגיב. מכאן הסנכרון קורא את הזמנות הרכש הפתוחות בכל הרצה.
- מודול API ורישיונות API פעילים ב-Priority
- הטופס של הזמנות הרכש מסומן Available for API
- משתמש ייעודי עם API User Name וסימון API License
- טוקן מטופס REST Interface Access Tokens (נשמר אצלכם — מוצג פעם אחת)
- כתובת שירות ה-OData ושם החברה מהמטמיע / IT
שעות בודדות למי שיש לו הרשאות והמודול פעיל; אם צריך להפעיל רישיונות API — בתיאום עם המטמיע.
בצד שלנו אין פיתוח — החיבור הוא קונפיגורציה באדמין.
תיבת הדואר של הרכש מחוברת דרך IMAP (שרת, משתמש, סיסמת אפליקציה). מעקב המכולות מול חברות הספנות נעשה דרך ה-API של הספנות או ספק אגרגציה — לפי מה שקיים אצלכם. גם כאן ההגדרה היא דרך ״חיבור מודרך״ במסך הניהול.