iCount API: מדריך אוטומציה ל־iCount עם Make, n8n ו־Webhooks

iCount API (גרסה 3) הוא הממשק הרשמי שדרכו מערכות אחרות מפיקות מסמכים ב־iCount, מנהלות לקוחות, גובות תשלומים, קולטות הוצאות ומושכות דוחות, בלי שמישהו יקליד את הנתונים פעמיים. נכון לאוקטובר 2026 הוא כלול במסלול Advanced ולא זמין במסלול Express. מתחברים אליו ישירות, דרך האפליקציה המובנית של iCount ב־Make, או דרך HTTP ו־Webhooks ב־n8n וב־Zapier.

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

מה אפשר לעשות עם ה־API של iCount?

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

תחום	מה אפשר לעשות לפי התיעוד
מסמכים	יצירה, חיפוש, שליחה במייל וב־SMS, קישור לתשלום עצמי (PayNow), סגירה וביטול
לקוחות	יצירה או עדכון, יתרה, מסמכים פתוחים, כרטסת ואיחוד לקוחות
תשלומים	חיוב כרטיס אשראי, עמודי סליקה ויצירת מכירה בעמוד סליקה
הוצאות	יצירה, סריקת מסמך ויצירת הוצאה ממנו, חיפוש
CRM	הוספת ליד, וגם משימות ואירועים
דוחות וייצוא	בין השאר דוח מע״מ ודוח הכנסות, וייצוא נתונים להנהלת חשבונות
Webhooks	הוספה, רשימה ומחיקה של Webhooks

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

איך מתחברים ל־iCount API?

כל הבקשות נשלחות ב־POST עם JSON לכתובת https://api.icount.co.il/api/v3.php/. התיעוד מציע שלוש דרכי התחברות:

דרך	מתאימה ל־	תוקף
טוקן API (מומלץ)	אינטגרציות קבועות, Webhooks ומשימות רקע	עד שמבטלים אותו
מזהה סשן (sid)	אפליקציות שבהן משתמש עובד באופן פעיל	20 דקות מהבקשה האחרונה
שם משתמש וסיסמה בכל בקשה	בדיקות וסקריפטים חד־פעמיים	לא רלוונטי, וזו הדרך הפחות בטוחה

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

באיזה מסלול זה כלול?

לפי עמוד המחירון, נכון לאוקטובר 2026:

• Express (276 ₪ לשנה, לפני מע״מ): המסלול הבסיסי, ואי אפשר להוסיף לו API או חיבור לחנויות.
• Advanced: ה־API מופיע ככלול, ולפי עמוד ה־API הוא ״ניתן חינם לכל הלקוחות במסלול הרגיל״. המחיר נקבע לפי כמות המסמכים: 32 ₪ לחודש עד 10 מסמכים, 59 ₪ עד 100 ו־85 ₪ עד 200, לפני מע״מ.
• Master: מסלול Advanced בתוספת ייצוג ברשויות המס, החל מ־111 ₪ לחודש לפני מע״מ.

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

אילו אינטגרציות מובנות יש ל־iCount?

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

• סליקה ותשלומים: CreditGuard, Cardcom, Tranzila, Z-Credit, PayMe, Pelecard, EasyCard, ישראכרט ו־PayPal.
• מכירה אונליין: WooCommerce, Wix, Shopify, Etsy, Magento וקונימבו, עם הפקת חשבוניות וקבלות אוטומטית.
• הנהלת חשבונות: ייצוא דוח ריכוז תנועות לחשבשבת, לריווחית, ל־Priority ול־SAP.
• דיוור והודעות: Mailchimp, Smoove ומערכות דיוור ישראליות.
• Make: iCount מופיעה ברשימה עם חיבור ל־Make.

יש גם פיצ׳רים מובנים שחוסכים בנייה של אוטומציה. הנודניק, למשל, מאתר חשבוניות שלא שולמו ושולח ללקוחות תזכורות במייל, ב־SMS ובוואטסאפ, ובחיבור למסוף סליקה גם קישור לתשלום. נכון לאוקטובר 2026 הוא עולה 29 ₪ לחודש, ושליחה בוואטסאפ וב־SMS מותנית ברכישת קרדיטים.

iCount ב־Make, ב־n8n וב־Zapier

כלי	אפליקציה מובנית?	איך מתחברים
Make	כן, אפליקציית iCount עם פעולות בלבד, בלי טריגרים	פעולות דרך האפליקציה; טריגר דרך Webhook של iCount אל מודול Webhooks של Make
n8n	לא מצאנו צומת מובנה (נכון לאוקטובר 2026)	צומת HTTP Request עם טוקן Bearer, וצומת Webhook לקבלת אירועים
Zapier	לא מצאנו אפליקציה בספרייה הציבורית (נכון לאוקטובר 2026)	Webhooks by Zapier, רק במסלולים בתשלום

באפליקציה של Make יש פעולות למסמכים (יצירה, שליפה, חיפוש וביטול), ללקוחות, להוצאות, למלאי, ל־CRM ולשעון הנוכחות, וגם פעולת ״Make an API Call״ לכל השאר. החיבור שלה מבקש שם משתמש, מזהה חברה וסיסמה של iCount, ולכן גם כאן כדאי משתמש ייעודי עם הרשאות מוגבלות.

ה־Webhooks של iCount הם מה שמחליף טריגר. לפי מאגר המידע של iCount, מפעילים את מודול WebHooks תחת מערכת ← הגדרות ← מודולים, ואז מגדירים את הכתובת תחת מערכת ← הגדרות ← אוטומציה. בכל הפקת מסמך iCount שולחת את כל נתוני המסמך ב־JSON לכתובת שהוגדרה, ואפשר לשלוח Webhook מחדש מתוך עמוד המסמך. אם עוד לא הוחלט באיזה כלי לעבוד, ריכזנו את ההבדלים במדריך Make או n8n.

3 תהליכים לדוגמה עם iCount API

1. מטופס באתר לחשבונית מס קבלה, בלי כפילויות

1. הזמנה מהאתר, עם מספר הזמנה, מגיעה ל־Make או ל־n8n.
2. התרחיש יוצר ב־iCount חשבונית מס קבלה עם פרטי הלקוח, ומעביר את מזהה הלקוח מהמערכת המקורית בשדה custom_client_id.
3. מספר ההזמנה נשלח גם בשדה sanity_string, כך שאם התרחיש רץ פעמיים, iCount מסרבת להפיק מסמך שני.
4. המקור של המסמך נשלח ללקוח במייל, ישירות מ־iCount.
5. מספר המסמך, הקישור אליו ומספר ההקצאה (אם התקבל) נשמרים חזרה במערכת שממנה הגיעה ההזמנה.

בסכומים גדולים אפשר להוסיף שלב אישור: התרחיש שולח לבעל העסק סיכום, ומפיק רק אחרי לחיצה על ״מאשרים״.

2. קישור לתשלום בוואטסאפ שמעדכן את ה־CRM

1. מקימים פעם אחת עמוד סליקה ב־iCount, ובוחרים בו איזה סוג מסמך יופק בתשלום.
2. כשעסקה נסגרת ב־CRM, התרחיש יוצר מכירה בעמוד הסליקה, עם הסכום, פרטי הלקוח, מזהה העסקה בשדה x_order_id וכתובת התראה (IPN) של התרחיש.
3. iCount מחזירה קישור תשלום ללקוח, והוא נשלח בוואטסאפ או במייל.
4. אחרי חיוב מוצלח, iCount שולחת הודעה לכתובת ההתראה.
5. התרחיש מזהה את העסקה לפי המזהה ומסמן אותה ב־CRM כ״שולמה״.

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

3. חבילה חודשית לרו״ח ורשימת חובות פתוחים

1. ב־1 לכל חודש התרחיש מופעל אוטומטית.
2. הוא מושך דרך מודול הדוחות את דוח המע״מ ודוח ההכנסות של החודש הקודם, או משתמש בייצוא הנתונים להנהלת חשבונות.
3. הוא מחפש מסמכים שעדיין פתוחים ובונה רשימה של לקוחות שלא שילמו.
4. הרו״ח מקבל את הדוחות במייל, ובעל העסק מקבל את רשימת החובות.

את הקליטה של חשבוניות ספקים אפשר להוסיף לאותו תרחיש: ב־Make יש פעולת ״Add an Expense״, ובתיעוד ה־API יש פעולה שסורקת מסמך ויוצרת ממנו הוצאה. רעיונות נוספים יש במדריך אוטומציה לעסקים קטנים.

מספרי הקצאה ב־iCount: מה חשוב באוטומציה

במודל ״חשבוניות ישראל״, רשות המסים מנפיקה מספר הקצאה בן 9 ספרות לחשבונית מס, וקבלת המספר היא תנאי לכך שהלקוח יוכל לנכות את מס התשומות שבחשבונית. לפי הוראת הביצוע של רשות המסים מדצמבר 2025, הסף ירד בשנת 2026 בשתי פעימות:

ממתי	חשבונית מס בסכום של יותר מ־
1 בינואר 2026	10,000 ₪, ללא מע״מ
1 ביוני 2026	5,000 ₪, ללא מע״מ

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

מה זה אומר באוטומציה עם iCount:

• התמיכה קיימת בכל המסלולים. לפי עמוד המחירון, ״תמיכה בחשבוניות ישראל״ מופיעה גם ב־Express וגם ב־Advanced.
• שומרים את המספר שחוזר. התשובה ליצירת מסמך כוללת את השדה invoice_reference_number. שומרים אותו יחד עם מספר המסמך.
• מעבירים את מספר העוסק של הלקוח. הבקשה נשענת על מספר ע״מ או ח״פ של הלקוח, ולכן התרחיש מעביר אותו בשדה vat_id בכל חשבונית ללקוח עסקי.
• מתריעים כשהשדה ריק. אם בחשבונית מעל הסף ללקוח עסקי לא חזר מספר הקצאה, עדיף שהתרחיש ישלח התראה לבדיקה ידנית ולא ימשיך כרגיל. רשות המסים רשאית לסרב להקצות מספר, ואז נפתח תהליך מול הרשות.

זו תמונה כללית בלבד. את הכללים שחלים על העסק שלך כדאי לבדוק עם רו״ח.

טעויות נפוצות ב־iCount API

חשבוניות כפולות

תרחיש שרץ פעמיים, או בקשה שנשלחת שוב אחרי תקלת רשת, יכולים להפיק מסמך כפול. הפתרון ב־iCount מובנה: שולחים בכל יצירת מסמך sanity_string ייחודי, עד 30 תווים, למשל מספר ההזמנה. אם כבר קיים מסמך עם אותו ערך, iCount מחזירה שגיאה במקום להפיק מסמך נוסף.

לקוחות כפולים

לפי התיעוד, כשיוצרים מסמך ו־iCount לא מוצאת את הלקוח, היא יוצרת לקוח חדש. החיפוש נעשה לפי סדר קבוע: מזהה לקוח ב־iCount, מזהה מהמערכת החיצונית (custom_client_id), מספר עוסק, מייל ושם. שם שנכתב קצת אחרת יכול לייצר לקוח כפול, ולכן מעבירים תמיד מזהה קבוע.

מע״מ

בשורות המסמך יש שדה למחיר ללא מע״מ (unitprice) ושדה למחיר כולל מע״מ (unitprice_incvat), שממנו המערכת מחלצת את המע״מ לבד. מחיר כולל מע״מ שנשלח בשדה הלא נכון יוביל לסכום שגוי. בוחרים שדה אחד ונצמדים אליו בכל התרחישים.

בדיקות בלי Sandbox

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

ועוד כמה דברים שכדאי לזכור

• טוקן שלא פג: טוקן API עובד עד שמבטלים אותו. שומרים אותו בחיבור המאובטח של Make או n8n, ומבטלים אותו כשספק או עובד מסיימים לעבוד איתו.
• Webhooks גדולים: לפי מאגר המידע של iCount, אין הגבלה על גודל ה־Webhook, ומסמך עם הרבה שורות יכול להגיע בהודעה גדולה. בודקים שהצד המקבל עומד בזה.

מתי שווה לקבל עזרה?

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