واجهة الفاصل البرمجية (API)
أرسل ملفاً واستلم JSON مُدقَّقاً، مع إشعار Webhook موقّع عند انتهاء المعالجة. متاحة في كل باقة مدفوعة.
- المبالغ نصوص عشرية دقيقة والتواريخ بصيغة YYYY-MM-DD
- لكل تنبيه رمز ثابت ورسائل بالعربية والإنجليزية
- الفواتير الإلكترونية XML تُقرأ كما هي دون ذكاء اصطناعي
- مفاتيح Idempotency تجعل إعادة المحاولة آمنة
curl https://alfasil.com/v1/documents \
-H "Authorization: Bearer $ALFASIL_KEY" \
-H "Content-Type: application/pdf" \
--data-binary @invoice-4471.pdfالنتيجة (مختصرة)
{
"document": {
"id": "doc_0mgf3k2q1zA8b2Kc9dX1",
"status": "done",
"data": {
"supplier": { "name": "Al Noor Stationery Est." },
"invoice_number": "INV-4471",
"issue_date": "2026-09-14",
"currency": "AED",
"tax_total": "80",
"total": "1680"
},
"warnings": []
}
}كيف يعمل
- 1
ارفع ملفاً
أرسل ملف PDF أو الصورة أو الفاتورة الإلكترونية XML في جسم الطلب، وتستلم رقم المستند فوراً.
- 2
استلم JSON مُدقَّقاً
اطلب المستند حين يجهز: كل الحقول والبنود وتفصيل الضريبة والتنبيهات.
- 3
أو انتظر إشعار Webhook
الحدثان document.processed و document.failed، موقّعان بخوارزمية HMAC-SHA256 لتتحقق منهما.
الحدود في كل باقة
| الباقة | طلبات في الدقيقة | أكبر ملف | صفحات شهرياً |
|---|---|---|---|
| المبتدئ | 60 | 20 MB | 500 |
| الاحترافي | 120 | 25 MB | 1,500 |
| مكاتب المحاسبة | 240 | 25 MB | 5,000 |