🧪 Sandbox Environment

🔐 Test Credentials

⚡ Quick Start

ابدأ العمل في ثلاث خطوات:

الخطوة 1 - المصادقة

BASHcurl -X POST https://www.solabill.com/api/v1/client/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "YOUR_ASSIGNED_TEST_EMAIL",
    "password": "YOUR_ASSIGNED_TEST_PASSWORD"
  }'

# Response:
# {
#   "data": {
#     "token": "1|abc123...",
#     "user": { "name": "Assigned Test User", "email": "YOUR_ASSIGNED_TEST_EMAIL" },
#     "account": { "company_name": "Sandbox Corp", "status": "active" }
#   }
# }

Step 2 — Create an Invoice Draft

BASHcurl -X POST https://www.solabill.com/api/v1/client/invoices \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_number": "INV-SANDBOX-001",
    "recipient_name": "Sandbox Buyer LLC",
    "recipient_peppol_id": "100820361200003",
    "buyer_endpoint_scheme": "0235",
    "buyer_street": "Airport Road",
    "buyer_city": "Abu Dhabi",
    "buyer_subdivision": "AUH",
    "buyer_country": "AE",
    "total_amount": 105.00,
    "currency": "AED",
    "issue_date": "2026-02-12",
    "issue_time": "09:30",
    "due_date": "2026-03-12",
    "payment_means_code": "48",
    "items": [{"item_code":"SVC-1","name":"Service","description":"Sandbox service","unit_code":"C62","quantity":1,"base_quantity":1,"net_unit_price":100,"gross_unit_price":100,"discount_amount":0,"vat_category":"S","vat_rate":5}]
  }'

# Response includes an invoice ID and submitted=false

# Submit only after an active Orchida sandbox connection is provisioned
curl -X POST https://www.solabill.com/api/v1/client/invoices/INVOICE_ID/submit-orchida \
  -H "Authorization: Bearer YOUR_TOKEN"

Step 3 — Check Orchida Status

BASHcurl https://www.solabill.com/api/v1/client/invoices/INVOICE_ID \
  -H "Authorization: Bearer YOUR_TOKEN"

# Returns provider validation, Orchida invoice, tax-authority and receiver states separately

🧪 Test Scenarios

قم بتغطية هذه السيناريوهات قبل الذهاب إلى الإنتاج:

⚖️ Sandbox vs Production

📦 Sample Data

يأتي صندوق الحماية محملاً مسبقًا ببيانات الاختبار التالية بعد كل عملية إعادة تعيين:

🔬 Interactive API Explorer

Try API calls directly from this page only after an administrator securely assigns your tenant-isolated SolaBill test account. No shared credentials are embedded here.

✅ Pre-Production Checklist

قبل التبديل من وضع الحماية إلى الإنتاج، تحقق من كل ما يلي:

• ☐
  تدفق المصادقة — Login, token storage, refresh/re-login on 401, logout
• ☐
  إنشاء الفاتورة — Valid payloads accepted (201), invalid payloads rejected (422)
• ☐
  Credit-note boundary — Drafts link correctly; regulated submission remains blocked until the confirmed Orchida contract and sandbox mapping exist
• ☐
  Buyer and onboarding data — Verify buyer profiles supply ordinary endpoint data and regulated onboarding remains Orchida-owned
• ☐
  Orchida status tracking — Reconcile provider-validation, top-level invoice, tax-authority and receiver states separately without inferring exchange success
• ☐
  ترقيم الصفحات — Handle has_more, current_page, last_page بشكل صحيح
• ☐
  معالجة الأخطاء — Parse error envelope (error.code, خطأ.رسالة, تفاصيل الخطأ)
• ☐
  التعامل مع حد المعدل — Respect 429 responses and إعادة المحاولة بعد header
• ☐
  التحقق من إشعار الويب — Validate HMAC signature, reject stale/duplicate events
• ☐
  Invoice idempotency — No duplicate Orchida invoice submission on safe retries; never imply credit-note submission is enabled
• ☐
  طلب التتبع — Log معرف طلب X رأس من الردود على تذاكر الدعم
• ☐
  Production promotion — Provision a separately approved production connection; never turn sandbox into production by changing only a URL