عن ماثل
ماثل API يربط أي برنامج فوترة مع منصة «فاتورة» في هيئة الزكاة والضريبة والجمارك للمرحلة الثانية من الفوترة الإلكترونية. طلب واحد يوقّع الفاتورة، ويرسلها للهيئة، ويرجّع ردها والمستند المختوم.
وش هو ماثل
انبنى للمطورين وبرامج الكاشير والمحاسبة اللي تحتاج تربط مع زاتكا بدون ما تبني محرك توقيع وتشفير من الصفر. يغطي الثلاث بيئات (بوابة المطورين، المحاكاة، الإنتاج)، والفاتورة الضريبية والمبسّطة، والإشعارات الدائنة والمدينة.
كيف يشتغل
- المحرك يبني الفاتورة بصيغة UBL 2.1، ويحسب الهاش، ويوقّعها (XAdES بمفتاح secp256k1)، ويسوي رمز QR، ويرسلها للهيئة.
- يشغّل مسار الربط الكامل مع الهيئة من البداية للنهاية: CSR، وشهادة الامتثال، والفحوصات الستة، وشهادة الإنتاج. على بوابة المطورين يعدّي الفحوصات الستة في حوالي ٣ ثواني.
- السيرفر في الرياض.
البيانات
ماثل ما يحتفظ بالفواتير ولا بالمفاتيح: الطلب يتعالج ويرجع الرد، والمستند والشهادة ترجع لك أنت. الشي الوحيد اللي يتسجّل هو عدد الفواتير والأجهزة لكل مفتاح (الجهاز بعلامة مشفّرة من شهادته) عشان الباقة، والدفع عن طريق Polar. التفاصيل في سياسة الخصوصية.
مين وراه
محرك ماثل بناه محمد نجيب، مهندس منتجات. الأخطاء المشروحة في صفحة أخطاء زاتكا هي اللي واجهها فعلاً وهو يبني المحرك ويجرّبه على بوابات الهيئة. للتواصل: hello@matheel.app.
شروحات قواعد زاتكا كلها بيانات مفتوحة على GitHub، وأداة فحص الفاتورة مجانية. وتقدر تشوف مقارنة ماثل مع ZATCA Tools.
About Matheel (English)
Matheel is an API that connects any invoicing software to ZATCA's Fatoora platform for Saudi e-invoicing Phase 2. One request builds the UBL 2.1 invoice, hashes and signs it (XAdES, secp256k1), generates the QR code, files it with ZATCA (clearance or reporting) and returns ZATCA's answer with the stamped XML. It runs ZATCA's full integration flow end to end, including device onboarding (CSR, compliance CSID, the six compliance checks, production CSID). It is hosted in Riyadh and keeps no invoices or keys. Matheel's engine was built by Mohammed Nagieeb, a product engineer. Contact: hello@matheel.app.