קריאת חשבונית ספק מקובץ דרך ה-API

כל מה שקראתם כאן, המערכת עושה בשבילכם בקליק

45 יום לנסות את ביג בוס בחינם. בלי כרטיס אשראי, בלי התקנה: מייל וסיסמה וזהו.

מדריך למשתמש לקריאת חשבונית ספק מקובץ דרך ממשק ה-API של ביג בוס

קובץ נכנס, ופרטי החשבונית חוזרים

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

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

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

שליחת הקובץ: expense_file_read

את הקובץ שולחים ב-file, כמו קובץ שמצרפים להוצאה: שם הקובץ ב-file_name, והתוכן ב-base64 ב-content_base64. בבדיקה שלנו נשלח PDF של חשבונית ספק, עם "create": "none", כלומר רק לקרוא, בלי לרשום הוצאה.

{
  "api_token": "<המפתח שלכם>",
  "file": {
    "file_name": "invoice-2041.pdf",
    "content_base64": "JVBERi0xLjQK..."
  },
  "create": "none"
}

מה חוזר: הפרטים שנקראו

reading_status הוא "ok" כשהקריאה הצליחה, ו-message מסביר את התוצאה. ב-document חוזרים הפרטים שנקראו מהחשבונית:

is_invoice ו-document_kind: האם זו חשבונית, ומאיזה סוג. בבדיקה שלנו חזר tax_invoice.
הספק: השם (supplier_name) והח.פ. (supplier_hp).
reference ו-document_date: האסמכתא והתאריך.
הסכומים: המטבע (currency), הסכום לפני מע״מ, המע״מ, השיעור והסכום הכולל.
lines: שורות החשבונית.
confidence: לכל שדה רמת ביטחון: high, medium או low.

"data": {
  "reading_status": "ok",
  "message": "החשבונית נקראה - ההוצאה כבר רשומה במערכת",
  "document": {
    "is_invoice": true,
    "document_kind": "tax_invoice",
    "supplier_name": "ספק לדוגמה",
    "supplier_hp": "<ח.פ. של הספק>",
    "reference": "INV-2041",
    "document_date": "2026-10-28",
    "currency": "ILS",
    "amount_before_vat": 100,
    "vat_amount": 18,
    "amount_total": 118,
    "confidence": { "supplier_hp": "high", "reference": "medium", "amount_total": "high" }
  }
}

רמת ביטחון נמוכה אומרת שכדאי לבדוק את השדה הזה מול הקובץ לפני שרושמים אותו.

הבדיקות: checks

ב-checks חוזרות הבדיקות שנעשו על הפרטים שנקראו. לכל בדיקה יש code, הודעה ב-message, ו-blocks_final, שאומר אם היא חוסמת רישום של הוצאה סופית.

בבדיקה שלנו החשבונית כבר הייתה רשומה, ולכן ה-message היה "החשבונית נקראה – ההוצאה כבר רשומה במערכת", וב-checks חזרה בדיקת כפילות:

"checks": [
  { "code": "duplicate", "message": "הוצאה עם אסמכתא זו כבר רשומה לספק (expense_id 31560)", "blocks_final": true }
]

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

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

הספק והסעיף המוצע

ב-supplier חוזר הספק שנמצא בביג בוס, ו-matched_by אומר לפי מה הוא נמצא. בבדיקה שלנו הספק נמצא לפי הח.פ. (company_hp).

ב-suggested_expense_account חוזר סעיף הוצאה מוצע, עם המספר, השם והסיבה, למשל "הסעיף של ההוצאה הקודמת מספק זה". זו הצעה בלבד: את הסעיף קובעים כשרושמים את ההוצאה.

"supplier": { "supplier_id": 9120, "company_name": "ספק לדוגמה", "matched_by": "company_hp" },
"suggested_expense_account": { "expense_account_id": 41, "name": "פרסום וקידום מכירות", "reason": "הסעיף של ההוצאה הקודמת מספק זה" }

מהקריאה להוצאה רשומה

1. קוראים את הקובץ
שולחים אותו ב-expense_file_read, ובודקים ש-reading_status הוא "ok".

2. עוברים על הבדיקות
אם ב-checks יש בדיקה עם blocks_final true, מטפלים בה קודם. למשל, בהוצאה שכבר רשומה לא רושמים שוב.

3. רושמים את ההוצאה
ב-expense_new, עם הספק שנמצא, הסכום והאסמכתא שנקראו, ואותו קובץ ב-file. מי שרוצה שאדם יעבור על הפרטים שולח אותה כטיוטה: הוצאות ותשלום לספק דרך ה-API.

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

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

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

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

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

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