CloudRefit
OpenAPI 3.0 & RESTSub-5ms EngineFull ZATCA Phase 2

واجهة REST API فائقة السرعة لربط أي نظام مالي

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

احصل على مفتاح API تجريبي
curl -X POST https://invoicing.cloudrefit.com/api/v1/invoices \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": 1,
    "invoice_type": "388",
    "subtype": "0100000",
    "issue_date": "2026-11-09",
    "issue_time": "14:30:00",
    "line_items": [
      {
        "name": "Software License",
        "quantity": 1,
        "unit_price": 1000.00,
        "tax_rate": 0.15
      }
    ]
  }'

بنية تحتية هندسية للمطورين والشركات

واجهات برمجية خفيفة وقوية مصممة لتحمل ملايين الطلبات الشهرية مع أداء فائق دون أي اختناقات.

محرك تسوية فائق السرعة (< 5ms)

مدعوم بنواة Java gRPC متعددة المسارات لتوليد ملفات XML، وتوقيع الهاش بمفتاح ECDSA، وختم الـ QR في أجزاء من الثانية.

مواصفات OpenAPI 3.0 ومجموعات Postman

توثيق برمجي شامل لمواصفات OpenAPI 3.0، مع مجموعات Postman تفاعلية ومكتبات مساعدة لأشهر لغات البرمجة.

حماية التكرار والتزامن (Idempotency Key)

إعادة إرسال آمنة تماماً عبر ترويسة Idempotency-Key تمنع تكرار الفواتير أو كسر تسلسل سلاسل الهاش (PIH).

خطافات الويب (Webhooks) والأحداث اللحظية

استقبل إشعارات فورية عند اكتمال اعتماد الفاتورة من الهيئة أو عند رصد أي تنبيهات نظامية في ملف XML.

عزل كامل للشركات والفروع

إدارة أرقام ضريبية متعددة وشهادات CSID مستقلة لكل فرع ضمن حساب مطور موحد مع أذونات وصول دقيقة.

أرشفة نظامية مشفرة لمدة 5 سنوات

حفظ كل طلب، ملف XML موقع، واستجابة هيئة الزكاة في مستودع غير قابل للتعديل للوفاء بالمتطلبات الضريبية.

نظرة عامة على نقاط النهاية (Endpoints)

نقاط اتصال واضحة وموحدة لكافة مراحل الفوترة الإلكترونية:

POST/api/v1/invoices
إصدار وتوقيع واعتماد الفاتورة الإلكترونية مع الهيئة
GET/api/v1/invoices/:id/pdf
تحميل ملف PDF المعتمد والمختوم مع رمز QR
GET/api/v1/invoices/:id/xml
تنزيل ملف UBL 2.1 XML المعتمد قانونياً
POST/api/v1/credit-notes
إصدار إشعار دائن مرتبط بفاتورة أصلية

ابدأ التطوير والاختبار الآن

أنشئ حساب مطور، احصل على مفاتيح الاختبار فوراً، وقم بتجربة أول فاتورة في بيئة المحاكاة خلال أقل من 5 دقائق.

احصل على مفاتيح API