חיבור Pipedrive למורנינג (חשבונית ירוקה): חשבונית אוטומטית כשעסקה נסגרת

כדי לחבר את Pipedrive למורנינג (חשבונית ירוקה), רושמים ב-Pipedrive webhook מסוג change.deal. כשה-status של עסקה משתנה ל-won, הקוד מאתר או יוצר את הלקוח במורנינג, מפיק מסמך דרך POST /documents - בדרך כלל סוג 305, חשבונית מס, או 320, חשבונית מס קבלה - ורושם את מספר המסמך שחזר בחזרה על העסקה.

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

מה החיבור בין Pipedrive למורנינג עושה בפועל?

חיבור תקין מריץ מעגל קצר אחד לכל עסקה שנסגרה, בסדר הזה:

1. קבלת ה-webhook. Pipedrive שולח אירוע change.deal לכתובת שלכם. עונים מיד ב-2xx ומכניסים את העבודה לתור.
2. וידוא שזו זכייה חדשה. בודקים ש-data.status הוא won ושבבלוק previous מופיע סטטוס אחר. כל עריכה אחרת של עסקה שכבר נסגרה היא לא מכירה חדשה.
3. שליפת העסקה. GET /api/v2/deals/{id} לסכום ולמטבע, ו-GET /api/v2/deals/{id}/products אם אתם מוכרים לפי פריטים.
4. זיהוי הלקוח. קוראים את איש הקשר והארגון המקושרים, מחפשים במורנינג עם POST /clients/search לפי מייל או שם, ויוצרים לקוח עם POST /clients כשאין התאמה.
5. הפקת המסמך. POST /documents עם type, lang, currency, vatType ו-income - חמשת שדות החובה.
6. רישום בחזרה. שומרים את ה-number שחזר ואת קישור ההורדה על העסקה עם PATCH /api/v2/deals/{id}.

איזה webhook של Pipedrive צריך להפעיל את החשבונית?

ב-Pipedrive אין אירוע ייעודי של "עסקה נסגרה בזכייה". webhook מוגדר לפי event_action (create, change, delete או *) ולפי event_object כמו deal, person או organization, ולכן הטריגר לחשבונית הוא change.deal יחד עם בדיקת סטטוס בקוד. כל עריכה של עסקה, כולל מעבר שלב או שינוי שם, שולחת התראת change, ובבלוק previous מופיעים רק השדות שהשתנו.

יוצרים webhooks עם POST /v1/webhooks, וגרסה 2.0 היא ברירת המחדל. ארבעה פרטים מהמדריך של Pipedrive קובעים את התכנון:

• הכתובת צריכה לענות תוך 10 שניות ב-2xx. אחרת Pipedrive מנסה שוב 3 פעמים, אחרי 3, 30 ו-150 שניות, והשדה meta.attempt מראה באיזה ניסיון מדובר.
• webhook שלא הצליח אף משלוח במשך 3 ימים רצופים נמחק, כך ששרת מקבל תקול עוצר את כל התהליך בלי הודעה.
• כל אירוע נבדק מול ההרשאות של ה-user_id שהוגדר ל-webhook. כדי לקבל כל עסקה שנסגרה, יוצרים אותו תחת משתמש אדמין.
• המגבלה היא 40 webhooks למשתמש, ואפשר להגן על הכתובת עם http_auth_user ו-http_auth_password.

בצד של Pipedrive האימות הוא טוקן API בכותרת x-api-token, או OAuth 2.0 לאפליקציה ב-Marketplace. הטוקן שייך למשתמש אחד, רק אחד פעיל בכל רגע, והנפקה של טוקן חדש משביתה כל חיבור שעדיין משתמש בישן.

איך עובד הצד של מורנינג?

ה-API של מורנינג מאמת עם OAuth 2.0 מסוג client credentials. יוצרים מפתח API (מזהה ומפתח סודי) בהגדרות המפתחים במורנינג, מחליפים אותו ב-POST https://api.morning.co/idp/v1/oauth/token עם grant_type: client_credentials, ושולחים את ה-accessToken שחזר כ-Bearer. הטוקן תקף לשעה ומוגבל לעסק שהמפתח שייך אליו. קריאות המסמכים נשלחות ל-https://api.greeninvoice.co.il/api/v1, סביבת הבדיקות היא https://sandbox.d.greeninvoice.co.il/api/v1, ולכל סביבה צריך מפתחות משלה. חידוש הטוקן וההבדל בין 401 ל-403 מוסברים במדריך לשגיאות 401 ו-403 ב-API של מורנינג.

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

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

כשקבלה באה אחרי חשבונית, מעבירים את מזהה החשבונית ב-linkedDocumentIds, ומורנינג סוגרת את החשבונית המקורית. מסמך אחד מכיל עד 200 שורות הכנסה ותקבולים.

מיפוי השדות מ-Pipedrive למסמך במורנינג

רוב המיפוי ישיר. היוצא מן הכלל הוא מספר העוסק או הח"פ, כי ב-Pipedrive אין לו שדה מובנה:

ב-API v2 השדות המותאמים יושבים בתוך אובייקט custom_fields, והמפתח של כל שדה הוא מחרוזת hash בת 40 תווים ששונה בכל חשבון Pipedrive. מעתיקים כל מפתח מ-Company settings, Data fields, Copy API key, ושומרים את המפתחות בקובץ הגדרות ולא בקוד. ב-v2 השדות person_id ו-org_id הם מזהים פשוטים, כך שזיהוי הלקוח עולה עוד שתי קריאות. כדאי לשמור גם את מזהה הלקוח של מורנינג על הארגון, ואז העסקה הבאה של אותו לקוח מדלגת על החיפוש.

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

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

• ניסיונות חוזרים של Pipedrive. תשובה איטית גורמת לאותו אירוע להגיע שוב. שומרים כל משימה לפי מזהה העסקה ובודקים במסד שלכם לפני שפונים למורנינג. דפוס התור והעובד שמאחורי זה מתואר במדריך לאוטומציה של מסמכים במורנינג.
• הרישום שהקוד עצמו כותב. שמירת מספר המסמך על העסקה מפעילה עוד change.deal. בבלוק ה-previous שלו אין status, וכך מבדילים בינו לבין זכייה.
• נסגרה, נפתחה, נסגרה שוב. איש מכירות שפותח עסקה מחדש ומסמן אותה שוב כזכייה יוצר שינוי סטטוס אמיתי. אם על העסקה כבר רשום מספר מסמך, מעבירים אותה לבדיקה של אדם במקום להפיק.
• עריכות גורפות. meta.is_bulk_edit מסמן אירועים שהגיעו משינוי גורף. עוצרים אותם לבדיקה במקום להפיק עשרות חשבוניות בבת אחת.

מגבלות הקריאות פחות קריטיות כאן מאשר בסנכרון מלא, אבל הן קיימות. Pipedrive נותן לכל חברה תקציב יומי של 30,000 טוקנים בסיסיים, כפול מכפיל המסלול (Lite 1, Growth 2, Premium 5, Ultimate 7), כפול מספר המשתמשים, מחזיר 429 כשהתקציב נגמר, ומפעיל מגבלת פרץ לכל טוקן בחלון מתגלגל של 2 שניות: 20 בקשות לטוקן API במסלול Lite, 40 ב-Growth. נקודות הקצה של v2 צורכות פחות טוקנים מהגרסאות שלהן ב-v1.

מה צריך להכין לפני שבונים?

• מסלול מורנינג שכולל גישה ל-API, ומפתח API. המפתח הסודי מוצג פעם אחת בלבד, ברגע היצירה.
• חשבון בסביבת ה-Sandbox. לפי מרכז העזרה של מורנינג, מגדירים שם עסק פיקטיבי ומבצעים רכישה פיקטיבית של מינוי Best, ורק אז אפשר ליצור מפתח לבדיקות.
• תשובה כתובה מרואה החשבון: איזה סוג מסמך מופק לכל תוצאה של עסקה, והאם המחירים כוללים מע"מ.
• שדות מותאמים ב-Pipedrive לח"פ של הלקוח, למזהה הלקוח במורנינג ולמספר המסמך במורנינג.
• משתמש אדמין ב-Pipedrive שיהיה הבעלים של ה-webhook, וכתובת HTTPS ציבורית שעונה בפחות מ-10 שניות.

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

מקורות

• Pipedrive - Guide for Webhooks v2
• תיעוד ה-API של מורנינג
• מרכז העזרה של מורנינג - יצירת מפתח API