מפתח bk_test_ עונה ממסד נתונים נפרד לגמרי: אותן כתובות, אותן תשובות, אותם קודי שגיאה. מפיקים, מבטלים ושולחים כמה שרוצים בלי הסיכון להפיק בטעות מסמך מס אמיתי.
התחילית של המפתח מחליטה מאיזה מסד נתונים עונים. שום עמודה, שום דגל, שום סיכוי לערבב.
→ 201 {
"document": { "docNumber": 17, "status": "issued", "totalIncVat": 35000 },
"warnings": ["unsigned"]
}
// PDF: SANDBOX watermark · no signature · never sent to the tax authority
כל מה שעלול לגעת בעולם האמיתי כבוי בסנדבוקס. כל השאר זהה.
כל מסמך נושא SANDBOX על הדף ובפוטר, מתוך הרשומה שלו עצמה, כך שלעולם לא ייראה כמסמך אמיתי.
לסנדבוקס אין CA, ה-PDF לא נחתם, ומספרי הקצאה לא מתבקשים. התשובה מציינת זאת ב-warnings.
POST /email מסרב בסנדבוקס. Webhooks כן נשלחים, לכתובת שלכם, כדי שתוכלו לבדוק את הצד שלכם.
validation, approval_required, rate_limited, doc_type_not_allowed: כל מה שתפגשו ב-live תפגשו קודם כאן.
הסנדבוקס אינו ספר חשבונות ואין לו חובת שמירה. הנתונים בו זמניים, ואין להם ארכיון.
סריקת קבלה רצה על אותו מודל גם בסנדבוקס, לכן היקף ה-ocr ניתן לפי בקשה, ומופעל על שתי הסביבות יחד.
מפתח בדיקה מקבלים מיד. מפתח live נפתח באישור, כי מאחוריו ספר חשבונות אמיתי.
כל הזרימה: עסק, לקוח, טיוטה, הפקה, זיכוי, webhooks. עד שהיא עובדת מקצה לקצה.
מהקונסול, במשפט על מה אתם בונים ולמי. אנחנו עונים, ומנפיקים.
אותו קוד, אותן כתובות. רק התחילית משתנה, וה-PDF הבא חתום ואמיתי.
# before BILLOS_KEY=bk_test_3f9a… # after BILLOS_KEY=bk_live_7c21…