ما يمكنك بناؤه اليوم
تتيح الواجهة البرمجية لوندرفاتورة (v1) لمنشأة على باقة الأعمال أو المؤسسات إنشاء الفواتير الضريبية من أنظمتها (متجر إلكتروني، نظام حجوزات، نقطة بيع، منصة اشتراكات) وقراءتها مع حالتها لدى الهيئة. الإصدار والترقيم النظامي ورمز QR، والاعتماد أو الإبلاغ للمنشآت المرتبطة بالهيئة، كلها تتم داخل وندرفاتورة تمامًا كالفواتير المنشأة من لوحة التحكم.
GET
/api/v1/ping
متاح
تحقق من أن المفتاح يعمل واعرف المنشأة التي يعمل باسمها.
POST
/api/v1/invoices
متاح
أنشئ مسودة أو أصدر فاتورة ضريبية، مع عميل موجود أو بيانات مباشرة، وعملة أجنبية، وأسباب الإعفاء من الضريبة.
GET
/api/v1/invoices/{id}
متاح
اقرأ فاتورة مع بنودها ومجاميعها وحالتها لدى الهيئة.
POST
/api/v1/invoices/{id}/issue
متاح
افحص مسودة أُنشئت سابقًا وأصدرها، ونزّل ملف PDF أو XML الخاص بها.
POST
/api/v1/customers
متاح
أنشئ العملاء واعرضهم وعدّلهم، مع العنوان الوطني كاملًا.
POST
/api/v1/invoices/{id}/notes
متاح
أنشئ الإشعارات الدائنة والمدينة وأصدرها.
POST
/api/v1/webhook-endpoints
متاح
استقبل Webhooks موقّعة عند إصدار الفواتير أو اعتمادها أو رفضها أو سدادها.
كل مفتاح يعمل باسم منشأة واحدة. المنشأة يحددها المفتاح، ولا يستطيع أي طلب اختيارها أو تغييرها.
ابدأ من هنا
البدء السريع
من مفتاح API إلى أول مسودة فاتورة في خمس دقائق.
المصادقة
إرسال المفتاح والصلاحيات والانتهاء والتجديد.
مرجع الواجهة البرمجية
كل نقطة نهاية وحقل ورد.
الأخطاء وحل المشكلات
كل رمز خطأ وطريقة معالجته.
أدلة
الفواتير
المسودات والفواتير الصادرة والعملات والخصومات والإعفاءات وحالة الهيئة.
العملاء
ربط المشترين بالفواتير، وما تشترطه الهيئة للمشترين من المنشآت.
منصات SaaS متعددة المستأجرين
الفوترة لمنشأتك أو لمنشآت عملائك.
الأمان
كيف نحمي المفاتيح والبيانات، وما نطلبه منك.
إمكانات المنصة
ابنِ واختبر من البداية إلى النهاية: منشأة اختبار لتجربة كل شيء بأمان، وWebhooks بدل الاستطلاع المتكرر، وربط التطبيقات عبر OAuth لمنتجات SaaS، وخادم MCP لوكلاء الذكاء الاصطناعي.
Webhooks
إشعارات موقّعة عند إصدار الفواتير أو اعتمادها أو سدادها.
بيئة الاختبار
منشأة اختبار بمفاتيح اختبار ونتائج محاكاة للهيئة.
وكلاء الذكاء الاصطناعي و MCP
خادم MCP بعيد مع موافقة بشرية على الإصدار.
حزم SDK
مكتبات رسمية بلغات PHP و Node.js و Python، جاهزة وبانتظار النشر.
حالات الاستخدام
واجهة برمجية للفوترة الإلكترونية في السعودية
أصدر فواتير ضريبية متوافقة من أي نظام.
الربط مع المرحلة الثانية عبر واجهة برمجية
الاعتماد والإبلاغ من برنامجك أنت.
واجهة برمجية لفوترة الاشتراكات
فاتورة ضريبية لكل دفعة اشتراك.
الربط مع Laravel
صنف خدمة ومهمة في الطابور ومعالجة للأخطاء.
واجهة فواتير متعددة المستأجرين
الفوترة لعدة منشآت بائعة من منصة واحدة.
الربط مع وكلاء الذكاء الاصطناعي
الوكيل يجهّز المسودات والإنسان يصدر.
خادم MCP
Wonder Fatoora MCP: أدوات لوكلاء الذكاء الاصطناعي.
جاهز للبدء؟
الوصول إلى الواجهة البرمجية ضمن باقات: الأعمال والمؤسسات. أنشئ مفتاحًا من الإعدادات ← مفاتيح API وأرسل أول طلب خلال دقائق.