חיבורים למערכות ו־API
OptiRoutes מתחברת למערכות שכבר עובדות אצלכם. ההזמנות נכנסות מקובץ Excel או CSV, מ־FTP או SFTP, או דרך Files API מאובטח; תעודות משלוח חתומות, קובצי יצוא של מסלולים ודוחות חוזרים באותה דרך. API לדוחות מעביר את הנתונים שלכם לכלי BI, וכתובות אינטרנט מקבלות דיווחי מסירה וקובצי יצוא של מסלולים ברגע שהם קורים.
עודכן:
לאילו מערכות OptiRoutes מתחברת?
| הצורך | איך OptiRoutes עושה את זה |
|---|---|
| טעינת הזמנות היום | העלאת Excel או CSV, טעינה אוטומטית מ־FTP, מ־SFTP או מ־Files API, בפורמט CSV, JSON או TXT ברוחב קבוע. |
| איסוף אישורי מסירה חתומים | קריאות Files API לפי יום או לפי הזמנה, או קובץ ZIP אחד ליום; העתקים במייל. |
| שליחת מסלולים למערכת שלכם | יצוא מסלולים ב־CSV, XLSX, XML, JSON או TXT — לקובץ, ל־FTP שלכם, לתיקיית החברה או לכתובת אינטרנט. |
| דיווח ל־BI או ל־ERP שלכם | ה־API לדוחות: הזמנות, מסלולים, נהגים, לקוחות, POD וסיכום משלוחים יומי. |
| תגובה לכל משלוח | כתובת דיווחי מסירה שמקבלת כל דיווח ברגע שהוא נעשה. |
| תשלום על השירות | Stripe Checkout לטעינת קרדיט בתשלום מראש ולטעינה אוטומטית. |
טעינת הזמנות מקובץ, מ־FTP או מ־SFTP
החיבור הפשוט ביותר הוא הקובץ שהמערכת שלכם כבר מייצאת. במסך ההזמנות, טעינת משלוחים קוראת קובץ Excel או CSV; מתאימים פעם אחת כל שדה במערכת — כתובת, שם לקוח, מספר הזמנה, כמות וכן הלאה — לשם העמודה אצלכם, וכל קובץ בהמשך נטען באותה צורה. בקובץ TXT ברוחב קבוע מזינים מיקומי תווים במקום שמות עמודות. אפשר לדלג על שורות לפי מילת סימון בהערות, מילת סימון שנייה יכולה להחליף את הכתובת, ואתם מחליטים אם מספר הזמנה קיים מתעדכן או נוסף כהזמנה חדשה.
כדי לוותר על עבודה ידנית, בחרו בהגדרות שיטת טעינה אוטומטית:
- שרת הקבצים של OptiRoutes — המערכת שלכם מניחה את הקובץ היומי, שנקרא לפי התאריך, בתיקיית החברה בשרת ה־FTP או בשרת ה־SFTP המוצפן.
- שרת FTP משלכם — OptiRoutes מתחברת עם המשתמש שתתנו לה וטוענת את הקובץ שנקרא לפי תאריך היום, או את הקובץ שעודכן אחרון.
- ייבוא ויצוא אוטומטיים — ההזמנות נטענות מעצמן וגם המסלולים מתוכננים, בלי שום לחיצה.
- Files API — התוכנה שלכם מעלה את קובץ ההזמנות ב־HTTPS, כפי שמתואר בהמשך.
במסך הלקוחות, קובץ Excel או CSV עם מספר לקוח, שם, כתובת, זמן עצירה ושעות פתיחה וסגירה יוצר או מעדכן לקוחות ואת חלונות הזמן שלהם.
Files API: הזמנות נכנסות, אישורי מסירה ודוחות יוצאים
לכל חברה ב־OptiRoutes יש תיקיית קבצים פרטית משלה: ההזמנות שהיא טוענת, תעודות המשלוח החתומות עם התמונות והחתימות, קובצי היצוא של המסלולים ודוחות סוף היום. Files API (ממשק הקבצים) מאפשר למערכות שלכם לקרוא ולכתוב בתיקייה הזו ישירות ב־HTTPS, בלי שרת FTP באמצע. מנהל החברה עובר בין FTP ל־API בהגדרות ← API וקבצים ויוצר שם את המפתחות — אין צורך לפנות לתמיכה, וחברות חדשות מתחילות ישר עם ה־API.
| תיקייה | מה יש בה | מי כותב |
|---|---|---|
| orders_files/ | קובץ ההזמנות היומי, וקובצי היצוא של המסלולים. | אתם (הזמנות), OptiRoutes (קובצי יצוא) |
| pod/YYYY/MM/DD/ | אישורי המסירה החתומים של אותו יום: קובץ ה־PDF החתום, החתימה והתמונות. | OptiRoutes |
| pod/ | תעודות משלוח מקוריות לחתימה באפליקציית הנהג, קובץ PDF אחד לכל מספר הזמנה. | אתם |
| reports/YYYY/MM/ | דוחות סוף יום ודוחות החזרות. | OptiRoutes |
| podBaseFile/ | טופס הבסיס של אישור המסירה. | אתם |
| inbox/ | תיקייה חופשית לקבצים שתרצו להעביר. | אתם |
הקריאות כוללות בדיקת מפתח, הצגת תוכן תיקייה, הורדה, העלאה (עד 50 MB לקובץ) ומחיקה של קבצים שהעליתם, הצגת קובצי אישורי המסירה של יום לפי הזמנה וסוג, והורדה של כל קובצי אישורי המסירה של יום כקובץ ZIP אחד. המדריך כולל דוגמאות קוד ב־Python, C# ו־Node.js, וסקריפט PowerShell שמסנכרן תיקייה בשרת שלכם עם תיקיית החברה — כך שצוות שרגיל ל־FTP יכול להמשיך לעבוד באותה צורה. קראו את המדריך ל־Files API.
איך מאובטחים מפתחות ה־API?
- הרשאות מינימליות — כל מפתח מקבל רק את ההרשאות שהוא צריך: אישורי מסירה חתומים בלבד, קריאה של כל הקבצים, או העלאת הזמנות וקבצים לתיקיית inbox.
- כתובות מורשות — אפשר להגביל מפתח לכתובות ה־IP הקבועות של השרת שלכם.
- תפוגה והחלפה — מפתח יכול לפוג אחרי מספר ימים; יוצרים מפתח חדש, עוברים אליו ואז מבטלים את הישן, בלי שום השבתה.
- ביטול מיידי — מפתח שבוטל מפסיק לעבוד תוך 30 שניות.
- תיעוד ובקרה — כל קריאה נרשמת עם שעה, כתובת, קובץ ותשובה, ומוצגת למנהל.
- שמירה בטוחה — OptiRoutes שומרת רק טביעת אצבע SHA-256 של כל מפתח; החיבורים הם HTTPS עם TLS 1.2 ומעלה, ומפתח מגיע רק לתיקייה של החברה שלו.
מגבלות: 300 בקשות בדקה לכל מפתח, 50 MB לקובץ, 20 מפתחות פעילים לחברה, ועד 5,000 פריטים בהצגת תוכן של תיקייה אחת.
ה־API לדוחות ולדחיפת נתונים
לכלי דיווח ולמחברי ERP, API נפרד בכתובת api-users.optiroutes.com מגיש את נתוני החברה שלכם כדוחות ומקבל נתונים שנדחפים אליו. כתובת אחת וטוקן אחד, ש־OptiRoutes מנפיקה לחברה שלכם, מכסים את כל הקריאות. בעמוד התיעוד אפשר להדביק את הטוקן ולראות אילו דוחות פתוחים לכם ואת מיפוי העמודות של החשבון שלכם: קראו את תיעוד ה־API.
| דוח | מה הוא מחזיר |
|---|---|
| orders | הזמנות ומשלוחים, עם מסלול ונהג. |
| routes | מסלולים, עם נהג ומספר תחנות. |
| drivers | נתוני נהגים. |
| customers | נתוני לקוחות וכתובות. |
| pod | תיעוד המסירות. |
| delivery-summary | סיכום יומי לפי סטטוס. |
שתי קריאות דחיפה עובדות בכיוון ההפוך: דחיפת הזמנות כותבת את קובץ ההזמנות של היום ומפעילה את הטעינה האוטומטית, ודחיפת נהגים, קווים ורכבים מחליפה את כל צי הרכבים, כמו קובץ צי. מכיוון שרשימת הנהגים שנדחפת נחשבת לצי המלא, שלחו תמיד את כל הנהגים — לא רק את השינויים.
יצוא מסלולים ו־webhooks
יצוא מסלולים כותב את המסלולים המסומנים ב־CSV, XLSX, XML, JSON או TXT ברוחב קבוע. טבלת עמודות קובעת אילו שדות יוצאים ותחת איזו כותרת, אפשר להוסיף עמודות מקוריות מקובץ ההזמנות שלכם, ובניהול פריטים קובץ שני מפרט כל פריט. את קובצי היצוא אפשר לשלוח למחשב שלכם, לשרת ה־FTP שלכם או לתיקיית החברה, וב־JSON אפשר לשלוח את היצוא גם לכתובת אינטרנט; אם השליחה נכשלת, המערכת מנסה שוב פעם אחת.
כדי לקבל כל משלוח ברגע שהוא קורה, מלאו את כתובת דיווחי המסירה בהגדרות אפליקציית הנהג: כל דיווח מסירה של הנהגים נשלח גם לשם, כך שמערכת אחרת שלכם מתעדכנת מעצמה.
מייל, תשלומים, מפות והודעות
- מייל — תעודות משלוח חתומות יוצאות מחשבון ה־Gmail שלכם עם סיסמת אפליקציה של Google; דוחות כמו דוח המשטחים של סוף היום נשלחים למייל הדוחות שלכם; מהקופה, לקוחות משלמים מקבלים קבלות ונהגים מקבלים אישורי הפקדה.
- תשלומים — טעינות קרדיט משולמות בעמוד תשלום מאובטח של Stripe, עם אפשרות לשמור כרטיס לטעינה אוטומטית.
- כתובות ומפות — הכתובות נבחרות מתוך ההצעות של Google ומאומתות על המפה לפני התכנון.
- ניווט — אפליקציית הנהג מעבירה כל תחנה ל־Waze, או ל־Apple Maps ב־iPhone, לפי כתובת או לפי קואורדינטות מדויקות.
- SMS ו־WhatsApp — הודעות הגעה וקישורי מעקב ללקוחות, התראות למנהלים, קווים לקבלני משנה ותמונות מסלול לנהגים ב־WhatsApp.
מתכננים חיבור ל־ERP או למערכת ניהול המחסן שלכם? ספרו לנו מה צריך לחבר.
ניסיון חינם ל־3 ימים · עד 50 כתובות ביום · בלי כרטיס אשראי
שאלות נפוצות
האם OptiRoutes יכולה לטעון הזמנות אוטומטית מה־ERP שלנו?
כן. ה־ERP שלכם יכול להניח קובץ יומי בשרת ה־FTP או ה־SFTP של OptiRoutes, בשרת FTP משלכם, או להעלות אותו דרך Files API, ו־OptiRoutes טוענת אותו מעצמה.
איך מכניסים את אישורי המסירה החתומים למערכת שלנו?
דרך Files API: מציגים ומורידים את קובצי אישורי המסירה של יום, או מורידים את כולם כקובץ ZIP אחד. בנוסף, העתק נשלח במייל לפי כללי הניתוב שלכם.
מי יוצר מפתחות API ל־Files API?
מנהל החברה, בהגדרות, API וקבצים. למפתחות יש הרשאות, אפשרות לכתובות מורשות ולתפוגה, ואפשר לבטל אותם בכל רגע.
יש API לדוחות?
כן. ה־API לדוחות מחזיר הזמנות, מסלולים, נהגים, לקוחות, POD וסיכום משלוחים יומי, עם טוקן ש־OptiRoutes מנפיקה.
באילו פורמטים אפשר לייצא מסלולים?
CSV, XLSX, XML, JSON ו־TXT ברוחב קבוע, עם העמודות והכותרות שתבחרו.
התחילו ניסיון חינם — 3 ימים, בלי כרטיס אשראי
ניסיון חינם ל־3 ימים · עד 50 כתובות ביום · בלי כרטיס אשראי