דוחות העסק דרך ה-API: רווח והפסד, מכירות, גיול ותזרים

המספרים של העסק, ישר למערכת שלכם

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

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

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

ארבע הפעולות

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

רווח והפסד: report_profit_loss

שולחים את התקופה ב-date_from וב-date_to. בלי תאריכים, הדוח הוא מ-1 בינואר של השנה ועד היום.

{
  "api_token": "<המפתח שלכם>",
  "date_from": "2026-01-01",
  "date_to": "2026-03-31"
}

בתשובה חוזרים total_income (ההכנסות), total_expenses (ההוצאות), profit (הרווח) ו-profit_percent (הרווח באחוזים מההכנסות). ב-rows חוזרות שורות הדוח לפי הסדר שבמסך: הסעיפים, סה״כ לכל קבוצה, סה״כ הכנסות וסה״כ הוצאות, ובסוף שורת הרווח.

"data": {
  "date_from": "2026-01-01T00:00:00",
  "date_to": "2026-03-31T00:00:00",
  "total_income": 50000,
  "total_expenses": -30000,
  "profit": 20000,
  "profit_percent": 40,
  "rows": [
    { "row_type": "section", "category": "income", "name": "הכנסה ממכירות", "amount": 50000, "percent_of_income": 100 },
    ...
    { "row_type": "report_total", "category": "report", "name": "רווח (הפסד)", "amount": 20000, "percent_of_income": 40 }
  ]
}

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

מכירות לפי לקוח: report_sales

גם כאן שולחים את התקופה ב-date_from וב-date_to. בתשובה חוזרים total_amount (סך המכירות), customers_count (מספר הלקוחות) ו-customers: לכל לקוח customer_id, השם והסכום, מהגדול לקטן.

"data": {
  "total_amount": 12500,
  "customers_count": 2,
  "customers": [
    { "customer_id": 1001, "company_name": "לקוח לדוגמה", "amount": 10000 },
    { "customer_id": 1002, "company_name": "לקוח נוסף לדוגמה", "amount": 2500 }
  ]
}

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

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

גיול חובות: report_debt_aging

הגיול תמיד נכון להיום, ולכן לא שולחים תאריכים, רק את המפתח. בתשובה חוזר קודם הסיכום של כל הלקוחות: total_net_debt (החוב הפתוח נטו), ו-total_net_debt_over_30 ו-total_net_debt_over_60 (החוב מעל 30 יום ומעל 60 יום), עם מספר הלקוחות בכל אחד. אחריו, ב-customers, השורה של כל לקוח, עם net_debt, net_debt_over_30 ו-net_debt_over_60.

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

כאן חוב הוא מספר חיובי. לקוח שחייב לכם מגיע עם net_debt גדול מ-0, בניגוד ל-customer_balance, שבה היתרה של לקוח שחייב לכם היא מספר שלילי.

השדה overdue_over מקבל רק 0, 30 או 60. ערך אחר נדחה ב-400 "שדה overdue_over יכול להיות 0, 30 או 60".

תזרים מזומנים צפוי: report_cash_flow

גם התזרים נכון להיום, והבקשה כוללת רק את המפתח. בתשובה חוזרים opening_balance, יתרת הבנק שהעסק הקליד במסך התזרים, ו-opening_balance_date, מתי היא הוקלדה. אחריהן, ב-periods, השורות של המסך: "עד היום (כולל איחורים)", שמונה שבועות, ו"אחרי 8 שבועות".

לכל תקופה חוזרים הסכומים שצפויים להיכנס, מחשבוניות לגבייה (invoices_in) ומשיקים להפקדה (cheques_in), והסכומים שצפויים לצאת, להוצאות לתשלום (expenses_out) ולשיקים לספקים (cheques_out). איתם חוזרים net והיתרה המצטברת ב-balance. בשדה note חוזר ההסבר שמופיע גם במסך: מה התחזית כוללת, ומה נשאר מחוץ לה, למשל מע״מ, שכר והוצאות קבועות.

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

תקופה ותאריכים: מה נדחה

ברווח והפסד ובמכירות התקופה היא עד 366 ימים. תקופה ארוכה יותר נדחית ב-400 "טווח התאריכים המקסימלי הוא 366 ימים".

תאריך שהשנה שלו אינה בין 1900 ל-9998 נדחה ב-400, עם שם השדה בהודעה, למשל "שדה date_from אינו תאריך תקין – השנה חייבת להיות בין 1900 ל-9998".

מפתח לקריאה בלבד, והרשאת הדוחות

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

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

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

גם בשרת ה-MCP יש ארבעה כלים לאותם דוחות, כך ש-ChatGPT, Claude, Gemini, Cursor וכלים דומים עונים על שאלה כמו "כמה הרווחתי מתחילת השנה?" מתוך אותם מספרים: חיבור Claude ו-Cursor לביג בוס: שרת MCP. עוד שאלות לדוגמה: מה לשאול את ChatGPT, Claude או Gemini על העסק שלכם בביג בוס.

איך ביג בוס עוזרת להביא את מספרי העסק למערכת שלכם, ומה היא לא עושה

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

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

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

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

יש שאלה לפני שמתחילים? דברו איתנו

מדריכים נוספים

• הפעלת ממשק ה-API ויצירת מפתח גישה ראשון: יצירת המפתח, ובחירה בין "קריאה בלבד" ל"קריאה וכתיבה".
• הקריאה הראשונה ל-API: מבנה הבקשה, התשובה וקודי התשובה: מבנה הבקשה והתשובה, וקודי התשובה.
• חיבור Claude ו-Cursor לביג בוס: שרת MCP: ארבעת הדוחות גם מתוך Claude, Cursor וכלים דומים.
• ממשק API בביג בוס: כל המדריכים של התוסף.

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