محرك الفوترة الإلكترونية للمرحلة الثانية من هيئة الزكاة والضريبة والجمارك على Laravel (جاهز لفاتورة)
خلِّص كل فاتورة لدى هيئة الزكاة والضريبة والجمارك لحظياً. حزمة Laravel جاهزة تبني ملف UBL 2.1 وتوقّعه بختمك المعتمد، وتولّد رمز QR بصيغة TLV، وتتصل بواجهة فاتورة — تخليص B2B وإبلاغ B2C، في بيئتَي الاختبار والإنتاج.
الموجة الرابعة والعشرون تبدأ في 30 يونيو 2026. وهذه هي الشيفرة التي توصلك إليها.
تشمل الموجة الرابعة والعشرون من هيئة الزكاة والضريبة والجمارك كل منشأة مسجّلة في ضريبة القيمة المضافة تجاوزت إيراداتها 375,000 ريال في 2022 أو 2023 أو 2024 — وهو أدنى حدّ حتى الآن، وأول ما يصل إلى المنشآت الصغيرة. إن كان هذا ينطبق عليك، فيجب أن تصل فواتيرك إلى منصة فاتورة عبر واجهة برمجية موقّعة قبل الموعد لا بعده.
هذه الحزمة هي طبقة التكامل، مكتوبة لـ Laravel 10 و11 و12. ركّبها، ووجّهها إلى نموذج الفاتورة لديك، فتُبنى كل فاتورة تصدرها وتُختم وتُخلَّص وتُحفظ وفق نص المواصفة حرفياً.
ما تفعله
تبني ملف XML مطابقاً
- مستندات فواتير UBL 2.1 مُتحقَّق منها مقابل ملف XSD الخاص بالهيئة قبل الإرسال
- فواتير ضريبية قياسية (B2B) وفواتير ضريبية مبسّطة (B2C)
- إشعارات دائنة ومدينة مع الإشارة إلى الفاتورة الأصلية
- ضريبة قيمة مضافة على مستوى السطر بنسبة 15%، وفئات صفرية ومعفاة، مع رموز الأسباب التي تتوقعها الهيئة
توقّع وتختم
- توليد CSR والتسجيل مقابل واجهة الامتثال، فتحصل على CSID الإنتاجي دون مغادرة الطرفية
- توقيع ECDSA على المستند بعد توحيد صيغته، جاهزاً لسلسلة تجزئة الفواتير
- سلسلة تجزئة الفاتورة السابقة (PIH) تُحفظ تلقائياً — فالعدّاد لا يقفز ولا يتكرر
- رمز QR بترميز TLV وBase64 يحمل اسم البائع ورقمه الضريبي والطابع الزمني والإجمالي وإجمالي الضريبة
تتصل بفاتورة
- تخليص لحظي للفواتير القياسية؛ يعود ملف XML المخلَّص ويُحفظ بجانب الأصل
- إبلاغ خلال 24 ساعة للفواتير المبسّطة، في طابور فلا تعطّل واجهة بطيئة أي عملية بيع
- تبديل كامل بين بيئات الاختبار والمحاكاة والإنتاج من قيمة إعداد واحدة
- كل طلب واستجابة مؤرشفان لمدة الاحتفاظ البالغة ست سنوات، لأن "أرسلناها" ليست جواباً حين تسأل الهيئة
تصمد في الواقع
- الإرسالات الفاشلة تُعاد بتباعد متزايد وتستقر في جدول رسائل ميتة تراه فعلاً
- أمر artisan يعيد تشغيل كل ما استسلم له الطابور
- الاستجابات التي فيها تحذيرات تُسجَّل ولا تُبتلع — فالفاتورة المخلَّصة بتحذير مخلَّصة، لكنك ستعلم بها
التقنيات
- الإطار: Laravel 10 / 11 / 12، وPHP 8.2 فأعلى
- التشفير: phpseclib مع OpenSSL، وECDSA بمنحنى secp256k1
- الطابور: أي مشغّل طوابير في Laravel؛ ويُنصح بـ Redis
- التخزين: MySQL أو PostgreSQL
- الاختبارات: مجموعة Pest تغطي مسار التخليص كاملاً مقابل بيئة الاختبار
ما تحصل عليه
الشيفرة كاملة بلا ملفات مشفّرة. حزمة Composer مع تطبيق Laravel تجريبي موصول من طرف إلى طرف، ودليل التسجيل التشغيلي، وملفات XSD المستخدمة في الاختبارات. وستة أشهر من التحديثات كلما راجعت الهيئة المواصفة.
لا توجد مراجعات بعد. كن أول من يراجع هذا المنتج!
