BillOS/יכולות/הוצאות

הוצאות שנרשמות לבד

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

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

POST /expenses/ocr מקבל את הבייטים של התמונה או ה-PDF, מחלץ את השדות עם ראייה ממוחשבת, שומר את הקובץ המקורי ומחזיר טיוטה ממולאת. תמיד טיוטה: מע"מ שנקרא לא נכון הוא עניין של מס, אז המשתמש מאשר לפני הרישום.

  • JPEG, PNG, WebP או PDF, עד 5MB לתמונה
  • רמת ביטחון על כל חילוץ, כדי שתדעו מתי להציג אזהרה
  • Idempotency-Key: סריקה חוזרת מחזירה את אותה טיוטה בלי לחייב
פז · תחנת הדלק הרצליה
ע.מ 520018078

06/09/2026 14:05#88412
בנזין 95 · 32.1 ל'100.00
מע"מ 18%18.00
סה"כ לתשלום118.00
אשראי ****4411118.00

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

טיוטה, רישום, תיקון

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

1

פותחים טיוטה

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

curl
curl -X POST $BASE/businesses/$BID/expenses/ocr -H "X-Api-Key: $KEY" \
  -H "Content-Type: image/jpeg" -H "Idempotency-Key: receipt-scan-991" --data-binary @receipt.jpg
→ 201 { "expense": { "id": "exp_88a1…", "status": "draft", "supplierName": "פז", "amountIncVat": 11800, "vatAmount": 1800 },
        "extracted": { "confidence": "high", … } }
2

רושמים

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

POST /expenses/exp_88a1…/record
→ 200 { "expense": { "status": "recorded", "recordNumber": 217, "amountIncVat": 11800 } }
// webhook: expense.recorded
3

מתקנים בסטורנו

טעות ברשומה שנרשמה? POST /correction פותח רשומה נגדית מקושרת שמאפסת אותה, לפי הוראה 23. המקור נשאר.

POST /expenses/exp_88a1…/correction
{ "reason": "נרשם פעמיים" }
→ 201 { "expense": { "recordNumber": 218, "amountIncVat": -11800, "correctsId": "exp_88a1…" } }

מטבע זר

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

מע"מ תשומות, בכנות

מע"מ מודפס נשמר תמיד. מע"מ שלא מודפס הוא אפס אמיתי, לא ניחוש של 18%: קבלה של עוסק פטור לא מזכה בתשומות.

הקובץ המקורי נשמר

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

הוצאה ראשונה
נרשמת היום.