חשבונית ירוקה API: מה אפשר לאוטמט במורנינג

מה אפשר לעשות עם חשבונית ירוקה API?

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

אנחנו בונים אוטומציות שמחברות מערכות חשבונאות כמו מורנינג לשאר התשתית העסקית - CRM, גיליונות, טפסים, ו-WhatsApp. החיבור נעשה דרך ה-API הרשמי של מורנינג, שמאפשר קריאה וכתיבה של לקוחות, פריטים, חשבוניות, וקבלות. התהליך רץ על לוח זמנים שנקבע מראש או מופעל על ידי אירוע - למשל, כשעסקה בשלב “סגור” ב-CRM, או כשמתקבלת תשלום דרך אמצעי תשלום מקוון.

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

איך מחברים את מורנינג ל-API?

חיבור מורנינג ב-API מתחיל בהנפקת מפתח API מתוך הגדרות החשבון במערכת מורנינג. המפתח הזה הוא מחרוזת ייחודית שמזהה את החשבון ומאפשרת גישה לנתונים. אנחנו שומרים אותו בסביבת העבודה של n8n או במערכת ניהול הסודות, לא בקוד עצמו.

אחרי שיש מפתח, בונים workflow ב-n8n שמבצע בקשות HTTP למערכת מורנינג. כל בקשה כוללת את המפתח בכותרת Authorization, את סוג הפעולה (GET, POST, PUT), ואת הנתונים הרלוונטיים בגוף הבקשה. למשל, כדי להוציא חשבונית חדשה, שולחים POST לנקודת הקצה /documents עם פרטי הלקוח, פירוט השורות, והסכום.

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

החיבור עצמו לא דורש שרת ייעודי. n8n רץ על ענן או על שרת פנימי, ומבצע את הבקשות מתוך הסביבה שלו. אם העסק כבר עובד עם גיליונות או CRM, אנחנו מוסיפים את מורנינג כצעד נוסף באותו תהליך.

מה קורה כשמגיע הזמנה חדשה?

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

אם הכל תקין, ה-workflow בודק אם הלקוח כבר קיים במורנינג. הוא שולח בקשת GET לנקודת הקצה /clients עם שם הלקוח או מספר ת“ז. אם הלקוח קיים, ה-workflow מושך את ה-ID שלו. אם לא, הוא יוצר לקוח חדש עם בקשת POST לאותה נקודת קצה, ושומר את ה-ID שחזר.

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

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

איך מטפלים בשגיאות ובמקרי קצה?

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

כל בקשה ל-API עוטפת בבלוק try-catch. אם הבקשה נכשלת, ה-workflow לא קורס - הוא עובר לענף שגיאה שרושם את הפרטים, שולח התראה לערוץ ייעודי ב-Slack או למייל, ומעדכן את השורה המקורית עם סטטוס “נכשל”. אם השגיאה זמנית - למשל, timeout - ה-workflow מנסה שוב אחרי דקה, עד שלוש פעמים.

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

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

מה ההבדל בין חיבור ידני לאוטומציה מלאה?

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

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

היבט	חיבור ידני	אוטומציה מלאה
זמן להנפקה	5-10 דקות לחשבונית	פחות מדקה
טעויות הקלדה	קורות	לא קורות אם הנתונים תקינים במקור
עדכון CRM או גיליון	ידני, לעיתים נשכח	אוטומטי, תמיד מעודכן
טיפול בשגיאות	מתגלה רק כשבודקים	התראה מיידית

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

כמה זמן לוקח להקים את זה?

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

אם צריך לחבר מספר מקורות - CRM, טפסים, ו-WhatsApp - או לבנות לוגיקה מורכבת יותר - למשל, חשבוניות חלקיות, זיכויים, או חישוב מע“מ דיפרנציאלי - זה יכול לקחת שלושה עד ארבעה שבועות. התהליך כולל פגישת פתיחה שבה אנחנו ממפים את התהליך הקיים, בנייה ובדיקות בסביבת פיתוח, ואז העברה לסביבת ייצור עם ליווי בשבועיים הראשונים.

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

אחרי ההשקה, אנחנו עוקבים אחרי התהליך דרך התראות ודוחות. אם משהו משתנה - למשל, מורנינג משנים את מבנה ה-API או העסק מוסיף סוג מוצר חדש - אנחנו מעדכנים את ה-workflow בהתאם. רוב העסקים שאנחנו עובדים איתם רואים יציבות מלאה אחרי חודש.

מה עוד אפשר לחבר למורנינג?

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

למשל, אפשר לחבר מורנינג ל-CRM כך שכל עסקה שעוברת לשלב “סגור” מפעילה הנפקת חשבונית אוטומטית, ואז מעדכנת את רשומת הלקוח ב-CRM עם מספר החשבונית ותאריך ההנפקה. אפשר גם לחבר למערכת תשלומים מקוונת - כשמתקבל תשלום, ה-workflow בודק אם יש חשבונית פתוחה, מנפיק קבלה במורנינג, ושולח ללקוח הודעת WhatsApp עם הקבלה.

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

חיבורים כאלה בנויים על אותו עיקרון: נתונים זורמים בין מערכות דרך API, עם בדיקות ואימותים בכל שלב, ועם התראות כשמשהו דורש תשומת לב. אנחנו מתכננים את הזרימה ביחד עם העסק, כך שהיא משקפת את התהליך האמיתי ולא כופה תהליך חדש.

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