התממשקות להפקת הכנסות דרך Make
חיבור מערכת פינבוט לפלטפורמת Make מאפשר לך ליצור אוטומציה מתקדמת להפקת הכנסות.
באמצעות חיבור זה, תוכל להגדיר תרחישים שיפיקו הכנסות באופן אוטומטי בפינבוט בעקבות טריגרים ממגוון מערכות חיצוניות, כגון חנויות מקוונות, מערכות CRM, טפסים מקוונים ועוד.
דגשים חשובים
- ✓ המודול של Finbot ב-Make הינו חינמי אך דורש התקנה מיוחדת (אינו מופיע בחנות הרגילה)
- ✓ ניתן לחבר את פינבוט לכל אחד מ-1000+ המודולים השונים הקיימים ב-Make
- ✓ התהליך דורש ידע טכני בסיסי אך לא מומחיות מעמיקה
- ✓ כל חיבור הוא ייחודי והשדות תלויים במודול שאליו אתה מתממשק
- ✓ בדוק את התרחיש על נתוני בדיקה לפני הפעלתו על נתונים אמיתיים
שלבי ביצוע חיבור פינבוט לפלטפורמת Make
1. התקנת המודול של Finbot ב-Make
כדי להתחיל, עליך להתקין את המודול הייעודי של Finbot בחשבון ה-Make שלך. גש ללינק ההתקנה הייעודי ולחץ על כפתור "Install" כדי להוסיף את המודול לחשבונך.
טיפ: ודא שאתה מחובר לחשבון ה-Make שלך לפני שאתה מנסה להתקין את המודול.
לאחר הלחיצה על Install, תתבקש לבחור לאיזה חשבון ב-Make לחבר את המודול.
2. פתיחת תרחיש חדש ב-Make
לאחר התקנת המודול, עליך ליצור תרחיש חדש ב-Make. לחץ על "Create a new scenario" ובחר את המודול הראשון שתרצה לחבר (למשל, Shopify, WooCommerce, Google Forms וכו').
לאחר הוספת המודול הראשון, הוסף את מודול Finbot על ידי חיפוש "Finbot" בחיפוש המודולים.
דוגמה: אם ברצונך להפיק הכנסות אוטומטית בכל פעם שנוצרת הזמנה חדשה בחנות WooCommerce, בחר תחילה את מודול WooCommerce עם טריגר "New Order", ולאחר מכן הוסף את מודול Finbot.
בחר בשירות הפקת המסמכים ולאחר מכן בחר באפשרות "Create an Income" כדי להגדיר פעולה להפקת הכנסה.
מכאן תיפתח לנו בקשה להתממשקות Finbot עם החשבון שלכם ב-Finbot עליו נרחיב בשלב הבא
3. העתקת הטוקן הייחודי מפינבוט
כעת תתבקש להתחבר לחשבון פינבוט שלך.
היכנס למערכת פינבוט ונווט אל "הגדרות עסק" > "מפתח API להפקת הכנסות". במסך זה תוכל לראות את הטוקן הייחודי שלך.
שים לב: הטוקן הוא אישי וחסוי. אין לשתף אותו עם גורמים לא מורשים.
העתק את הטוקן המוצג במסך והדבק ב MAKE
4. מיפוי השדות להפקת הכנסות
לאחר יצירת החיבור, תוכל להתחיל למפות את השדות הנדרשים להפקת הכנסה. המסמך החשבונאי מפורק לגורמים ב-Make, ועליך למפות את השדות כך שיקבלו את הנתונים מהמודול המקור.
השדות העיקריים שתצטרך למפות כוללים:
- פרטי הלקוח (שם, מספר זיהוי, כתובת)
- פרטי המסמך (תאריך, מספר אסמכתא, הערות)
- פרטי הפריטים (שם המוצר, כמות, מחיר, מע"מ)
- פרטי התשלום (סכום, אמצעי תשלום)
5. סיום והשלמת התהליך
לאחר שסיימת למפות את כל השדות ולהגדיר את התרחיש, בצע בדיקה כדי לוודא שהכל עובד כראוי. לחץ על "Run once" כדי להריץ את התרחיש פעם אחת ובדוק את התוצאות.
לאחר הפעלת התרחיש, המערכת תתחיל להפיק הכנסות באופן אוטומטי בפינבוט בהתאם לטריגרים שהגדרת. תוכל לראות את ההכנסות שהופקו במסך "הכנסות" במערכת פינבוט.
התהליך הושלם בהצלחה כאשר התרחיש פועל באופן תקין ומפיק הכנסות בפינבוט בהתאם לטריגרים שהגדרת. מומלץ לבדוק את ההכנסות הראשונות שהופקו כדי לוודא שהכל תקין.
צירפנו למאמר מדריך שדות מקיף להפקת הכנסות אוטומטית באמצעות Make.
סוגי מסמכים
בחירת סוג המסמך הנכון היא הצעד הראשון בהפקת הכנסה. להלן כל סוגי המסמכים הזמינים:
| קוד | סוג מסמך | מתי להשתמש? | עוסק פטור? |
|---|---|---|---|
| 0 | חשבונית מס | לעוסק מורשה - מסמך הכנסה ללא תשלום | ❌ |
| 1 | קבלה | אישור קבלת תשלום בלבד | ✓ |
| 2 | חשבונית מס קבלה | לעוסק מורשה - מסמך הכנסה + תשלום | ❌ |
| 3 | דרישת תשלום | בקשה לתשלום (ללא ערך חשבונאי) | ✓ |
| 4 | חשבונית זיכוי | ביטול/החזר של חשבונית מס קיימת | ❌ |
| 5 | הזמנה | אישור הזמנה (ללא ערך חשבונאי) | ✓ |
| 6 | תעודת משלוח | אישור משלוח סחורה | ✓ |
| 7 | הצעת מחיר | הצעה ללקוח (ללא ערך חשבונאי) | ✓ |
| 8 | חשבונית | לעוסק פטור - מסמך הכנסה | ✓ |
מדריך שדות מלא
שדות בסיסיים (חובה)
השדות הבאים נדרשים בכל הפקת מסמך:
| שדה | שם ב-API | ברירת מחדל | הסבר |
|---|---|---|---|
| סוג מסמך | type | - | ראו טבלת סוגי מסמכים למעלה |
| תאריך מסמך | date | תאריך נוכחי | פורמט: DD/MM/YYYY (לדוגמה: 20/01/2026) |
| שפת מסמך | language | עברית (HE) | HE או EN |
| מטבע | currency | שקל (ILS) | ILS, USD, EUR ועוד |
| עיגול סכומים | rounding | true | האם לעגל את הסכומים |
| כולל מע"מ | vatType | true | האם המחירים כוללים מע"מ |
חשוב לעוסק פטור: השדה vatType חייב להיות false! אחרת תתקבל שגיאה 115.
פרטי לקוח
ניתן להפיק מסמך עבור לקוח קיים (לפי מזהה) או ליצור לקוח חדש:
| שדה | שם ב-API | חובה? | הסבר |
|---|---|---|---|
| מזהה לקוח | customer.id | לא | המספר הסידורי של לקוח קיים. אם מוזן - שאר הפרטים לא נדרשים. |
| שם הלקוח | customer.name | כן* | חובה אם לא הוזן מזהה. עד 100 תווים. |
| מייל | customer.email | לא | עד 50 תווים. |
| טלפון | customer.phone | לא | עד 20 תווים. |
| כתובת | customer.address | לא | עד 100 תווים. |
| ח.פ / מספר עוסק | customer.tax | כן** | עד 9 ספרות. **חובה למספר הקצאה! |
| שמירת לקוח | customer.save | לא | ברירת מחדל: true. false = לקוח מזדמן. |
פריטים
כל מסמך (למעט קבלה) חייב לכלול לפחות פריט אחד:
| שדה | שם ב-API | חובה? | הסבר |
|---|---|---|---|
| מספר סידורי | items[].id | לא | מספר סידורי של פריט קיים בפינבוט |
| שם הפריט | items[].name | כן* | חובה אם לא הוזן מספר סידורי. עד 100 תווים. |
| כמות | items[].amount | כן | כמות הפריטים. 1-99999. |
| מחיר ליחידה | items[].price | כן | ⚠️ יש לרשום מחיר לפני מע"מ! |
| שמירת פריט | items[].save | לא | ברירת מחדל: false. true = שמור לרשימת הפריטים. |
שגיאה נפוצה: המחיר חייב להיות לפני מע"מ, גם אם בחרתם "כולל מע"מ" בהגדרות. המערכת מחשבת את המע"מ אוטומטית.
אמצעי תשלום
רלוונטי רק למסמכים מסוג: חשבונית מס קבלה (2) וקבלה (1).
| קוד | אמצעי תשלום | קוד | אמצעי תשלום |
|---|---|---|---|
| 0 | מזומן | 1 | העברה בנקאית |
| 2 | אשראי | 3 | צ'ק |
| 4 | ניכוי במקור מלקוחות | 5 | פייפאל |
| 6 | ביטקוין | 7 | אחר |
| 8 | ביט | 9 | פייבוקס |
| 10 | ניכויים אחרים | 11 | אתריום |
| 12 | שווה כסף | 13 | שובר מתנה |
| 14 | Google Pay | 15 | Apple Pay |
שדות נוספים לצ'ק (קוד 3):
- bankName - מספר בנק (חובה)
- bankBranch - מספר סניף (חובה)
- bankAccount - מספר חשבון (חובה)
- checkNumber - מספר הצ'ק (חובה)
שדות נוספים לאשראי (קוד 2):
- cardNumber - 4 ספרות אחרונות (חובה)
- numberPayments - מספר תשלומים (חובה)
חשוב: סכום כל אמצעי התשלום חייב להיות שווה לסכום הכולל של המסמך!
שדות מתקדמים
שדות אלו מופיעים תחת "הגדרות מתקדמות" ב-Make:
| שדה | שם ב-API | הסבר |
|---|---|---|
| תיאור המסמך | description | יופיע מעל רשימת הפריטים. עד 200 תווים. |
| הערות | remark | יופיעו בתחתית המסמך. עד 1,500 תווים. |
| כותרת למסמך | title | לשימוש פנימי בלבד. עד 100 תווים. |
| נתוני הנחה | discount | סוג הנחה (sum/percent) + כמות |
| מספר הקצאה | confirmationNumber | קבלת מספר הקצאה מרשות המיסים |
| מקושר למסמך | linkedDocument | המספר הסידורי (לא אסמכתא!) של מסמך לקישור |
| סכום לזיכוי | credit | חובה בחשבונית זיכוי! הסכום לזיכוי. |
מקרים מיוחדים
הפקת מסמכים לעוסק פטור
עוסק פטור מוגבל בסוגי המסמכים שניתן להפיק:
- ✓ מותר: קבלה (1), דרישת תשלום (3), הזמנה (5), תעודת משלוח (6), הצעת מחיר (7), חשבונית (8)
- ✗ אסור: חשבונית מס (0), חשבונית מס קבלה (2), חשבונית זיכוי (4)
חובה: השדה vatType חייב להיות false! אם תגדירו true תקבלו שגיאה 115.
הפקת חשבונית זיכוי
להפקת חשבונית זיכוי יש לוודא:
- סוג מסמך: 4 (חשבונית זיכוי)
- מקושר למסמך: חובה! המספר הסידורי של חשבונית המס המקורית
- סכום לזיכוי: חובה! הסכום שברצונכם לזכות
טיפ: "מקושר למסמך" מקבל את המספר הסידורי (ID פנימי), לא את מספר האסמכתא שמופיע על המסמך!
מספר הקצאה מרשות המיסים
מספר הקצאה נדרש במקרים הבאים:
- חשבונית מס או חשבונית מס קבלה
- סכום מעל 25,000 ₪ לפני מע"מ
דרישות:
- העסק חייב להיות מחובר לרשות המיסים בפינבוט
- ללקוח חייב להיות ח.פ/מספר עוסק מוזן
- השדה confirmationNumber צריך להיות true
שגיאות נפוצות ופתרונות
שגיאות משתמש (100-101)
| קוד | הודעה | פתרון |
|---|---|---|
| 100 | המשתמש אינו פעיל | פנו לתמיכה בטלפון *6453 |
| 101 | לא קיים למשתמש אמצעי תשלום תקין | עדכנו אמצעי תשלום באפליקציית Finbot |
שגיאות מסמך (102-135)
| קוד | הודעה | פתרון |
|---|---|---|
| 104 | עוסק פטור אינו יכול להפיק את סוג המסמך המבוקש | בחרו סוג מסמך מותר לעוסק פטור |
| 105 | לא ניתן להפיק חשבונית זיכוי ללא קישור | הוסיפו מספר סידורי בשדה "מקושר למסמך" |
| 106 | הערך בשדה date אינו תקין | השתמשו בפורמט DD/MM/YYYY |
| 108 | שובר המע"מ של חודש זה שודר | לא ניתן להפיק מסמך לחודש ששודר |
| 115 | עוסק פטור אינו יכול לבחור כולל מע"מ | שנו את vatType ל-false |
| 133 | לא ניתן לבקש מספר הקצאה ללא מספר עוסק | הוסיפו ח.פ/מספר עוסק ללקוח |
| 134 | המשתמש אינו מחובר לרשות המיסים | חברו את העסק לרשות המיסים בהגדרות |
שגיאות לקוח (200-208)
| קוד | הודעה | פתרון |
|---|---|---|
| 201 | לא נמצא לקוח המכיל את המספר סידורי | בדקו שהמספר נכון או צרו לקוח חדש |
| 203 | שדה שם לקוח הינו שדה חובה | הוסיפו שם לקוח או מזהה לקוח קיים |
שגיאות פריטים (300-308)
| קוד | הודעה | פתרון |
|---|---|---|
| 303 | שדה שם פריט הינו שדה חובה | הוסיפו שם פריט או מספר סידורי של פריט קיים |
| 305 | שדה כמות הינו שדה חובה | הוסיפו כמות לכל פריט |
| 307 | שדה מחיר ליחידה הינו שדה חובה | הוסיפו מחיר (לפני מע"מ!) לכל פריט |
שגיאות תשלום (400-500)
| קוד | הודעה | פתרון |
|---|---|---|
| 405-411 | שדות צ'ק חסרים | מלאו את כל שדות הצ'ק |
| 413-415 | שדות אשראי חסרים | מלאו 4 ספרות כרטיס ומספר תשלומים |
| 500 | סכום הפריטים אינו תואם לסכום התקבולים | ודאו שסה"כ התשלומים = סה"כ המסמך |
שאלות נפוצות
האם ניתן להפיק מסמכים עבור לקוחות חדשים?
כן! פשוט מלאו את פרטי הלקוח (שם, טלפון, מייל וכו') והשאירו את customer.save = true כדי לשמור אותו לשימוש עתידי, או false ללקוח מזדמן.
איך מוצאים את המספר הסידורי של מסמך?
היכנסו למסמך בפינבוט ובדקו את ה-URL - המספר מופיע שם. לחילופין, בתגובה להפקת מסמך ב-Make תקבלו את המספר הסידורי.
למה אני מקבל שגיאה 500 (אי-התאמה בסכומים)?
סכום כל אמצעי התשלום חייב להיות שווה בדיוק לסכום הכולל של המסמך (כולל מע"מ). בדקו את החישוב שלכם.
מה ההבדל בין vatType=true ל-vatType=false?
true = המחירים שהזנתם כבר כוללים מע"מ, המערכת תחשב אחורה.
false = המחירים לפני מע"מ, המערכת תוסיף מע"מ.
חשוב: בשדה price יש להזין תמיד את המחיר לפני מע"מ!
האם אפשר לשלוח את המסמך במייל אוטומטית?
כן! מלאו את שדות ה-email (כותרת, תוכן, נמענים) והמסמך יישלח אוטומטית ללקוח.
קישורים לתהליכים נוספים
תוכן עניינים
מאמרים קשורים
-
הפקת חשבונית מס או חשבונית קבלה עם מספר הקצאה
המשך למאמר -
הקמת מייל אישי להוצאות
המשך למאמר -
הקמת חיוב מחזורי
המשך למאמר