SolaBill API الشروع في العمل

المتطلبات الأساسية

قبل الاتصال بواجهات برمجة تطبيقات الإنتاج، تأكد من اكتمال إعداد حساب العميل الخاص بك.

المصادقة

احصل على رمز الوصول وقم بتمريره في Authorization: Bearer <token> header.

curl -X POST "https://solabill.com/api/v1/client/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "client.user@example.com",
    "password": "password",
    "device_name": "erp-connector"
  }'

{
  "success": true,
  "message": "Login successful",
  "data": {
    "token": "1|sample-token-value",
    "token_type": "Bearer"
  }
}

إرسال الفاتورة

أنشئ فاتورة باستخدام رمز Bearer الخاص بك. احتفظ بـ رقم الفاتورة unique per client account.

curl -X POST "https://solabill.com/api/v1/client/invoices" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_number": "INV-2026-1001",
    "recipient_name": "Acme LLC",
    "recipient_peppol_id": "ae:TRN123456789000003",
    "issue_date": "2026-02-12",
    "due_date": "2026-03-12",
    "currency": "AED",
    "total_amount": 1500.00
  }'

حالة المسار

استخدم نقاط نهاية التتبع لمراقبة حالات دورة الحياة من القبول إلى التسليم.

curl -X GET "https://solabill.com/api/v1/client/messages/{trackingId}" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

تدفق إشعارات الويب

اشترك في الأحداث لتجنب الاقتراع المتكرر واحصل على تحديثات في الوقت الفعلي تقريبًا.

1. أنشئ اشتراك إشعار ويب من حساب العميل الخاص بك.
2. تحقق من التواقيع في طلبات النداء الراجع الواردة.
3. قم بإرجاع HTTP 2xx بسرعة وقم بالمعالجة بشكل غير متزامن في نظامك.
4. التعامل مع عمليات إعادة المحاولة لعمليات التسليم المكررة بأمان.

الأخطاء وإعادة المحاولة

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "invoice_number": ["The invoice number field is required."]
  }
}

اذهب إلى قائمة التحقق المباشرة

• تحقق من صحة كافة حقول الفاتورة الإلزامية من تخطيط تخطيط موارد المؤسسات (ERP) الخاص بك.
• قم بتأكيد حدود نطاق المستأجر والعميل في كل استدعاء لواجهة برمجة التطبيقات.
• نفّذ اختبارات بيئة الاختبار لسيناريوهات النجاح وحالات الفشل.
• فعّل التنبيهات عند فشل إشعارات الويب، وتأخر قائمة الانتظار، وارتفاع أخطاء API من فئة 5xx.
• قم بمراجعة سجل التغيير قبل نشر كل إصدار.

العودة إلى الصفحة الرئيسية للمطورين