واجهة الفاصل البرمجية (API)

أرسل ملفاً واستلم JSON مُدقَّقاً، مع إشعار Webhook موقّع عند انتهاء المعالجة. متاحة في كل باقة مدفوعة.

  • المبالغ نصوص عشرية دقيقة والتواريخ بصيغة YYYY-MM-DD
  • لكل تنبيه رمز ثابت ورسائل بالعربية والإنجليزية
  • الفواتير الإلكترونية XML تُقرأ كما هي دون ذكاء اصطناعي
  • مفاتيح Idempotency تجعل إعادة المحاولة آمنة
الرفعPOST /v1/documents
curl https://alfasil.com/v1/documents \
  -H "Authorization: Bearer $ALFASIL_KEY" \
  -H "Content-Type: application/pdf" \
  --data-binary @invoice-4471.pdf
النتيجة (مختصرة)GET /v1/documents/{id}
{
  "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. 1

    ارفع ملفاً

    أرسل ملف PDF أو الصورة أو الفاتورة الإلكترونية XML في جسم الطلب، وتستلم رقم المستند فوراً.

  2. 2

    استلم JSON مُدقَّقاً

    اطلب المستند حين يجهز: كل الحقول والبنود وتفصيل الضريبة والتنبيهات.

  3. 3

    أو انتظر إشعار Webhook

    الحدثان document.processed و document.failed، موقّعان بخوارزمية HMAC-SHA256 لتتحقق منهما.

الحدود في كل باقة

الباقةطلبات في الدقيقةأكبر ملفصفحات شهرياً
المبتدئ6020 MB500
الاحترافي12025 MB1,500
مكاتب المحاسبة24025 MB5,000

اترك الإدخال اليدوي للفاصل.

جرّبه على فاتورة من فواتيرك. دون تسجيل ودون بطاقة.