מדריך מעשי לחיבור Odoo למערכות חשבוניות והנהלת חשבונות ישראליות: ה-API בגרסאות JSON-2 ו-XML-RPC, איזו תוכנית של Odoo מאפשרת גישה חיצונית, מה כוללת הלוקליזציה l10n_il, ושלושה דפוסי חיבור ששומרים את מספרי ההקצאה ואת מסמכי המס במקום הנכון.
עיקרי הדברים
- Odoo 19 חושפת את JSON-2 בכתובת /json/2/<model>/<method> עם מפתח API כ-bearer; XML-RPC ו-JSON-RPC מתוכננות לצאת משימוש ב-Odoo 22 (סתיו 2028).
- לפי התיעוד של Odoo, גישה ל-API החיצוני זמינה רק בתוכנית Custom, ולא ב-One App Free או ב-Standard.
- המודול הישראלי l10n_il כולל מבנה חשבונות, מסים, דוח מס ומצבי מס, והתיאור שלו לא מזכיר מספרי הקצאה.
- הדפוס הבטוח ביותר משאיר את מסמך המס במערכת חשבוניות ישראלית וכותב את המספר שלו בחזרה להזמנה ב-Odoo.
חיבור של Odoo לחשבוניות ולהנהלת החשבונות בישראל פירושו שימוש ב-API החיצוני של Odoo כדי להעביר לקוחות, הזמנות וחשבוניות למערכת שמפיקה מסמכי מס ישראליים, כמו Morning או iCount, או לספרים שרואה החשבון מנהל בחשבשבת. ב-Odoo 19 ה-API הזה זמין בכתובת /json/2, ורק תוכנית Custom של Odoo כוללת אותו.
Odoo היא מערכת ERP שמרכזת מכירות, מלאי, CRM והנהלת חשבונות במסד נתונים אחד. עסקים ישראליים שעוברים אליה משאירים לא פעם מערכת ישראלית להפקת מסמכי המס ולספרים, ולכן העבודה האמיתית היא הגשר ביניהן. כאן תמצאו את הגשר הזה: ה-API עצמו, מה הלוקליזציה הישראלית של Odoo כוללת ומה לא, ודפוסי החיבור שמחזיקים מעמד מול חשבוניות אמיתיות.
איך נראה ה-API החיצוני של Odoo ב-2026?
ה-API החיצוני של Odoo מאפשר למערכת אחרת להפעיל מתודות של המודלים ב-Odoo דרך HTTP, ומאז Odoo 19 קיימים שני דורות במקביל. הדור החדש נקרא JSON-2: כל קריאה היא POST לכתובת /json/2/<model>/<method>, למשל /json/2/res.partner/search, עם מפתח API בכותרת Authorization: bearer, וכשהשרת מארח כמה מסדי נתונים גם עם הכותרת X-Odoo-Database. כל מסד נתונים מתעד את המודלים, השדות והמתודות שלו בעמוד /doc.
הדור הקודם הוא XML-RPC ו-JSON-RPC, והוא מה ש-Odoo 18 והגרסאות שלפניה מציעות ומה שרוב הדוגמאות ברשת משתמשות בו. קוראים ל-authenticate בכתובת /xmlrpc/2/common כדי לקבל מזהה משתמש, ואז ל-execute_kw בכתובת /xmlrpc/2/object עם שם מסד הנתונים, מזהה המשתמש, הסיסמה או מפתח ה-API, המודל, המתודה והפרמטרים. לפי התיעוד של Odoo, נקודות הקצה /xmlrpc, /xmlrpc/2 ו-/jsonrpc מתוכננות לצאת משימוש ב-Odoo 22, בסתיו 2028.
- מפתחות API. קיימים מאז Odoo 14. המשתמש יוצר מפתח בהעדפות, בלשונית Account Security, בלחיצה על New API Key, והמפתח בא במקום הסיסמה בסקריפטים. Odoo מציגה אותו פעם אחת בלבד.
- תוכנית. לפי התיעוד של Odoo, גישה לנתונים דרך ה-API החיצוני זמינה רק בתוכנית Custom, ולא בתוכניות One App Free או Standard. גם עמוד המחירים של Odoo מציג "External API" ברשימת היכולות של Custom.
- טרנזקציות. כל קריאת JSON-2 רצה בטרנזקציית SQL משלה, ואי אפשר לשרשר כמה קריאות לטרנזקציה אחת. ההמלצה של Odoo היא לקרוא למתודה עסקית אחת שמבצעת את כל הפעולות הקשורות, כמו
action_confirmב-sale.order, במקום כמה כתיבות ברצף.
בדקו את התוכנית לפני כל דבר אחר. לעסק שנמצא ב-Standard ומצפה לחיבור אין למה להתחבר עד שהמנוי משתנה.
האם הלוקליזציה הישראלית של Odoo מטפלת במספרי הקצאה?
המודול הישראלי של Odoo לא מציין שהוא עושה זאת. מודול הליבה נקרא l10n_il, ובשמו "Israel - Accounting", והתיאור שלו מונה שלושה דברים: מבנה חשבונות ישראלי כללי, מסים ודוח מס, ומספר מצבי מס (fiscal positions). הוא תלוי רק במודול account הבסיסי. מספרי הקצאה, שירות ההקצאה המקוון של רשות המסים וסוגי מסמכים ישראליים כמו חשבונית מס קבלה לא מוזכרים בו, ובתיעוד הלוקליזציות של Odoo 19 אין עמוד לישראל.
זהו תיאור טכני, לא ייעוץ מס. במודל חשבוניות ישראל, חשבונית מס מעל סכום מסוים צריכה מספר הקצאה מרשות המסים כדי שהלקוח יוכל לנכות את מע"מ התשומות. הוראת ביצוע מע"מ 01/2025 של רשות המסים מציינת תקרה של 20,000 ש"ח ב-2025, של 10,000 ש"ח מ-1 בינואר 2026 ושל 5,000 ש"ח מ-1 ביוני 2026. על אילו מהחשבוניות שלכם זה חל - את זה בודקים עם רואה החשבון.
מבחינת המערכת המשמעות ברורה: לחשבונית שנרשמה ב-Odoo אין דרך לקבל מספר הקצאה, אלא אם משהו מוסיף אותה. אם אתם שוקלים מודול צד שלישי לשם כך, בחנו את התיעוד שלו, את גרסת Odoo שהוא תומך בה ואת מי שמתחזק אותו. מה משתנה כשהפקת חשבונית תלויה בשירות חיצוני מוסבר במאמר על מספרי הקצאה והמשמעות שלהם למערכת.
שלוש דרכים לחבר את Odoo לחשבוניות ולהנהלת החשבונות
| הדפוס | מי מפיק את מסמך המס | התפקיד של Odoo | מתאים כש... |
|---|---|---|---|
| Odoo מוכרת, מערכת חשבוניות ישראלית מפיקה | Morning, iCount או מערכת ישראלית דומה | הצעות מחיר, הזמנות, לקוחות, מלאי; שומרת את מספר המסמך והקישור | אתם רוצים את Odoo לתפעול וכלי ישראלי למסמכים המחייבים |
| Odoo מפיקה חשבוניות, הספרים בחשבשבת | Odoo | הפקת חשבוניות, והעברת נתוני הנהלת החשבונות למערכת של רואה החשבון | רואה החשבון עובד בחשבשבת וימשיך לעבוד בה |
| Odoo עושה הכול, עם תוסף ישראלי | Odoo, דרך מודול | הנהלת חשבונות מלאה | בדקתם שהמודול מכסה את סוגי המסמכים שלכם ואת תהליך ההקצאה |
הדפוס הראשון משאיר את המסמך המחייב במערכת שנבנתה לכללים הישראליים, ומשאיר ל-Odoo את העבודה שהיא טובה בה. המחיר הוא מערכת נוספת וסנכרון שאסור לו להפיק את אותו מסמך פעמיים. תהליך טיפוסי:
- איש מכירות מאשר הצעת מחיר, ו-
action_confirmהופך את ה-sale.orderלהזמנה מאושרת. - שירות החיבור שלכם בודק אילו הזמנות השתנו מאז הריצה הקודמת לפי השדה
write_date, שקיים בכל מודל ב-Odoo, וקורא את ההזמנה ואת הלקוח שלה מ-res.partner. - הוא מאתר או יוצר את הלקוח במערכת החשבוניות לפי מספר העוסק, ומפיק שם את המסמך.
- הוא כותב את מספר המסמך ואת הקישור ל-PDF בחזרה להזמנה ב-Odoo, בשדה שנוסף לשם כך, כדי שהמשתמשים ב-Odoo יראו מה הופק.
- הוא שומר את מזהה ההזמנה ב-Odoo מול מזהה המסמך, כדי שניסיון חוזר אחרי timeout לא יפיק מסמך שני.
הצד של מערכת החשבוניות בתהליך הזה מפורט במדריך להפקת חשבוניות אוטומטית דרך ה-API של Morning.
הרשומות ב-Odoo שחיבור חשבוניות נוגע בהן
| מודל | שדה או מתודה | מה הוא מכיל |
|---|---|---|
account.move | move_type | out_invoice לחשבונית ללקוח, out_refund לזיכוי ללקוח |
account.move | state | draft, posted או cancel |
account.move | payment_state | מצב התשלום המחושב, כולל in_payment |
account.move | invoice_line_ids, action_post | שורות החשבונית, והמתודה שרושמת טיוטה |
res.partner | vat, company_registry | מוצגים בממשק כ-"Tax ID" וכ-"Company ID" |
sale.order | action_confirm | מאשרת הצעת מחיר והופכת אותה להזמנה |
החליטו בכתב באיזה שדה של הלקוח נשמר מספר העסק הישראלי (ח"פ או מספר עוסק מורשה). אם איש מכירות אחד מקליד אותו ב-vat ואחר ב-company_registry, החיבור ייצור לקוחות כפולים במערכת החשבוניות.
מה משתבש כש-Odoo פוגשת מערכות ישראליות?
- שתי מערכות שמפיקות מסמכים. Odoo רושמת חשבונית, והמערכת הישראלית מפיקה עוד אחת על אותה מכירה. קבעו מפיק אחד לכל סוג מסמך וכבו את השני.
- זיכויים שמועברים כחשבוניות שליליות.
out_refundב-Odoo צריך להפוך למסמך זיכוי במערכת החשבוניות, לא לחשבונית עם סימן מינוס. - קריאות משורשרות שמצליחות בחצי. יצירת לקוח ואחריה הזמנה בשתי קריאות JSON-2 משאירה לקוח יתום כשהקריאה השנייה נכשלת. ודאו שכל שלב אפשר להריץ שוב בלי נזק.
- קוד שנכתב רק ל-XML-RPC. הוא עובד היום ויפסיק לעבוד ב-Odoo 22. פיתוח חדש על Odoo 19 כדאי לבנות על JSON-2.
- שינוי תוכנית שאף אחד לא קישר לחיבור. מעבר מ-Custom ל-Standard מסיים את הגישה ל-API החיצוני.
- משתמש חיבור עם הרשאות מנהל. מפתח ה-API נושא את כל ההרשאות של המשתמש שלו, ולכן תנו לחיבור משתמש נפרד עם הגישה שהוא צריך בלבד.
מה להכין לפני שמתחילים
- גרסת Odoo והיכן היא רצה: Odoo Online, Odoo.sh או שרת משלכם.
- אישור שהמנוי נמצא בתוכנית Custom.
- משתמש ייעודי לחיבור ומפתח ה-API שלו, שנשמר כמו סיסמה.
- החלטה איזו מערכת מפיקה כל מסמך מס, בתיאום עם רואה החשבון.
- מיפוי השדות למספר העוסק, לשיעורי המע"מ ולסוגי המסמכים בשתי המערכות.
אם אתם עדיין מחליטים איפה Odoo משתלבת מול ERP ישראלי או תוכנת הנהלת חשבונות, ההשוואה בין ERP, CRM והנהלת חשבונות מסדרת את ההבדלים, והמדריך לחיבור ERP ישראלי לכל מערכת מתאר את אותו גשר מהצד השני. כמה עולה פרויקט כזה - בעמוד המחירים.
מקורות
שאלות נפוצות
האם ל-Odoo יש API לחיבורים?
כן. Odoo 19 הוסיפה את ה-API בשם JSON-2 בכתובת /json/2/<model>/<method>, עם מפתח API כ-bearer token. Odoo 18 והגרסאות שלפניה עובדות עם XML-RPC ו-JSON-RPC דרך execute_kw. לפי התיעוד של Odoo, הגישה ל-API החיצוני זמינה רק בתוכנית Custom, ולא ב-One App Free או ב-Standard.
האם יש ל-Odoo לוקליזציה ישראלית?
כן. מודול הליבה l10n_il, בשם "Israel - Accounting", מתקין מבנה חשבונות ישראלי כללי, מסים ודוח מס, ומספר מצבי מס. התיאור שלו לא מזכיר מספרי הקצאה או סוגי מסמכים ישראליים, ולכן כדאי לפתור אותם בנפרד, דרך מערכת חשבוניות ישראלית או תוסף שבדקתם.
האם Odoo יכולה לקבל מספר הקצאה מרשות המסים?
בתיאור של המודול הישראלי בליבת Odoo אין שום דבר שאומר זאת. שתי הדרכים המעשיות הן להפיק את מסמך המס במערכת חשבוניות ישראלית ולכתוב את המספר שלו בחזרה ל-Odoo, או מודול צד שלישי שהתיעוד שלו מכסה את תהליך ההקצאה לגרסת Odoo שלכם. על אילו חשבוניות זה חל - שאלה לרואה החשבון.
האם אפשר לחבר את Odoo לחשבשבת?
הצד של Odoo פשוט: ה-API החיצוני קורא חשבוניות רשומות ותשלומים מ-account.move. הצד של חשבשבת תלוי בגרסה, במהדורה ובאופן ההתקנה, והם שקובעים אילו אפשרויות ייבוא או חיבור קיימות. בררו את זה עם רואה החשבון או עם המשווק של חשבשבת לפני שמעריכים את היקף העבודה.
האם חיבורי XML-RPC ל-Odoo ימשיכו לעבוד?
כרגע כן. Odoo 19 עדיין מגישה את /xmlrpc, /xmlrpc/2 ו-/jsonrpc, אבל לפי התיעוד של Odoo הן יוסרו ב-Odoo 22, בסתיו 2028. חיבור שנבנה היום על Odoo 19 צריך להשתמש ב-JSON-2, וחיבור XML-RPC קיים צריך תוכנית מעבר לפני השדרוג ל-Odoo 22.
להמשך קריאה
שירות רלוונטי
אינטגרציות
לגרום למערכות שאתם כבר משלמים עליהן לדבר זו עם זו.
על הכותב
יהונתן סעדיה
מפתח פרילנסר לאוטומציה, אתרים ו-MVP
אני יהונתן סעדיה, מפתח בכיר שבונה אוטומציה עסקית, אתרים מותאמים ומוצרי MVP לעסקים קטנים ובינוניים בארה"ב, אירופה וישראל. המדריכים האלה נכתבים מתוך עבודה אמיתית עם לקוחות, לא מתיאוריה.
בוא נעבוד יחדיש לך פרויקט דומה?
ספר לי מה אתה רוצה לבנות או איזה תהליך להפוך לאוטומטי. אני חוזר תוך 24 שעות עסקים עם כמה שאלות ממוקדות, ואז עוברים על זה יחד בשיחת היכרות חינמית של 30 דקות, בלי התחייבות. בסוף יש לך היקף עבודה, לוח זמנים ומחיר קבוע - או תשובה כנה שלא שווה לבנות את זה.