BillOS/יכולות/סנדבוקס

אותו API, ספר אחר

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

המפתח בוחר את הספר

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

POST /businesses/…/documents/…/issueX-BillOS-Mode: sandbox
→ 201 {
  "document": { "docNumber": 17, "status": "issued", "totalIncVat": 35000 },
  "warnings": ["unsigned"]
}
// PDF: SANDBOX watermark · no signature · never sent to the tax authority
SANDBOX

מה מתנהג אחרת

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

PDF עם סימן מים

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

בלי חתימה, בלי רשות המסים

לסנדבוקס אין CA, ה-PDF לא נחתם, ומספרי הקצאה לא מתבקשים. התשובה מציינת זאת ב-warnings.

בלי מייל אמיתי

POST /email מסרב בסנדבוקס. Webhooks כן נשלחים, לכתובת שלכם, כדי שתוכלו לבדוק את הצד שלכם.

אותם קודי שגיאה

validation, approval_required, rate_limited, doc_type_not_allowed: כל מה שתפגשו ב-live תפגשו קודם כאן.

נתונים מתנקים

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

OCR אמיתי

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

עוברים ל-live

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

1

בונים מול bk_test_

כל הזרימה: עסק, לקוח, טיוטה, הפקה, זיכוי, webhooks. עד שהיא עובדת מקצה לקצה.

2

מבקשים מפתח live

מהקונסול, במשפט על מה אתם בונים ולמי. אנחנו עונים, ומנפיקים.

3

מחליפים מפתח

אותו קוד, אותן כתובות. רק התחילית משתנה, וה-PDF הבא חתום ואמיתי.

.env
# before
BILLOS_KEY=bk_test_3f9a…
# after
BILLOS_KEY=bk_live_7c21…

בודקים היום,
מפיקים מחר.