BillOS/יכולות/מסמכים

API למסמכים שפשוט עובד

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

מפיקים מהסטאק שאתם אוהבים

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

JSNode.js
curlREST
PyPython
PHPPHP
GoGo
RbRuby
JavaJava
.NET.NET
RsRust
$_CLI
MCPMCP
{}Make
const BASE = 'https://api.billos.co.il/v1'
const headers = { 'X-Api-Key': process.env.BILLOS_KEY, 'Content-Type': 'application/json', 'Idempotency-Key': 'order-8812' }

const { document } = await fetch(`${BASE}/businesses/${bid}/documents`, {
  method: 'POST', headers,
  body: JSON.stringify({
    docType: 320, priceMode: 'gross',
    party: { name: 'דנה לוי', phone: '0521111111' },
    lines: [{ description: 'איפור ערב', quantity: 1, unitPriceExVat: 35000 }],
    payments: [{ method: 3, amount: 35000 }],
  }),
}).then((r) => r.json())

const issued = await fetch(`${BASE}/businesses/${bid}/documents/${document.id}/issue`, { method: 'POST', headers }).then((r) => r.json())
console.log(issued.document.docNumber)   // 1042

נראות מלאה של כל קריאה

חוקרים עם לוגים מפורטים: הבקשה, התשובה, קוד השגיאה והסיבה. כל קריאה נספרת ב-GET /usage, המקום הראשון להסתכל בו כשמשהו נכשל או נחסם.

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

נקודת קצה לכל תרחיש

עושים יותר עם המסמכים: תיקון בזיכוי מקושר, PDF חתום בקישור ציבורי, שליחה במייל, וכל זה בטוח לניסיון חוזר.

Idempotency-Key

שולחים את מזהה ההזמנה שלכם ב-header או ב-externalRef. ניסיון חוזר מחזיר את אותה שורה עם deduped: true, ולעולם לא מסמך כפול.

זיכוי מקושר

POST /credit-note מפיק חשבונית זיכוי (330) שמשקפת את המקור, או קבלה שלילית. הדרך היחידה, והחוקית, לבטל מסמך שהופק.

PDF ומייל

POST /prints מחזיר קישור ציבורי ל-PDF החתום (מקור פעם אחת, אחר כך העתק). POST /email שולח אותו ללקוח, עד חמישה נמענים.

POST /documents · Idempotency-Key: order-8812
// first call
HTTP 201 { "document": { "id": "doc_k3t8…", "status": "draft" } }

// the network dropped, the client retried with the same key
HTTP 200 { "document": { "id": "doc_k3t8…", "status": "draft" }, "deduped": true }

// a 502 from us is transient: retry with the same key, it can never double-create

מפתחות Idempotency

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

API שאפשר לסמוך עליו

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

269101

רשומה ברשות המסים

BillOS רשומה במרשם התוכנות (הוראה 36 נספח ה'). המסמך שהקוד שלכם מפיק הוא מסמך חשבונאי לכל דבר.

60/דק'

תקציב ברור

60 קריאות בדקה לכל מפתח, עם Retry-After כשעוברים. GET /usage מראה את הצריכה שלכם לפי נקודת קצה.

7 שנים

שמירה מובטחת

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

מתחילים להפיק
תוך דקות.