أداة تصدير الفواتير الإلكترونية
إضافة Chrome تُصدِّر كل الفواتير وبنودها من بوابة الفواتير الإلكترونية الوطنية في مصر إلى ملف Excel منسَّق، باستخدام واجهة البوابة نفسها بدل تصفّح الصفحات واحدة تلو الأخرى.
لا يمكن نشر أي لقطات شاشة من هذا المشروع: فهو يتعامل مع بيانات مالية أو شخصية، لذلك كل الرسوم هنا توضيحية ولا تحتوي على أي سجلات حقيقية.
تتوفر نسخة قابلة للتنزيل لهذا المشروع.
المشكلة
تتطلّب مصلحة الضرائب بشكل متزايد تقديم الفواتير إلكترونيًا عبر بوابة حكومية، لكن تلك البوابات مبنية للتعامل مع فاتورة واحدة في كل مرة. ولذلك يعني إعداد بيانات سنة كاملة لأغراض المراجعة أو المطابقة فتح آلاف الصفحات يدويًا. وقد اشتمل سير العمل المرجعي لهذا المشروع على تصدير 3487 صفحة يدويًا.
المنهج
يتم الاستعلام من البوابة عبر واجهة API الداخلية نفسها التي يستخدمها واجهتها الأمامي، مع جلب التفاصيل بوحدات تنفيذ متوازية، ثم تُكتب النتيجة في ملف عمل يحاكي التنسيق الذي تعمل به فرق المالية فعلًا: الورقتان نفساهما، وترتيب الأعمدة نفسه، والعناوين العربية نفسها، وترميز الألوان نفسه للحالات. ولأن الإضافة تعمل داخل تبويب البوابة مستخدمةً جلسة المستخدم القائمة، فلا توجد بيانات دخول تُدخَل، ولا تخرج أي بيانات من الجهاز.
ما تم تنفيذه
- تصدير مجمَّع لكل الفواتير الصادرة والواردة خلال نطاق زمني محدَّد
- تفاصيل كاملة لبنود كل فاتورة: الضرائب حسب النوع والخصومات وبيانات البائع والمشتري والعملة وروابط المشاركة
- ملف Excel بورتين مطابق لملف مرجعي: 58 عمودًا لكل فاتورة و64 لكل بند
- تنسيق الأوراق من اليمين إلى اليسار مع تثبيت صف العناوين وعروض الأعمدة والحدود وترميز ألوان الحالات
- تصفية حسب النطاق الزمني وتاريخ التقديم مقابل تاريخ الإصدار والاتجاه والحالة ونوع المستند
- تصفية برقم التسجيل على جهة الإرسال أو الاستقبال أو كليهما، بمطابقة دقيقة للمُعرِّف تستبعد مطابقات الأسماء التقريبية
- تصدير أكواد الأصناف المسجَّلة من صفحة أكواد الاستخدام في البوابة
- جلب التفاصيل بشكل متوازٍ مع إمكانية الإيقاف المؤقت والاستئناف والإلغاء
- استئناف العمل بعد انقطاع دون إعادة جلب الفواتير المكتملة
- تنزيل اختياري لملف PDF الرسمي لكل فاتورة مجمَّعة
- إجراء «نسخ تقرير التشخيص» الذي ينسخ لقطة تشخيصية كاملة لأغراض الدعم الفني
الحالة الحالية والقيود
- يعتمد المشروع على واجهة API داخلية تابعة لبوابة حكومية، وهي ليست عقدًا عامًا. فقد تتغيّر البوابة دون إشعار، ووثائق استكشاف الأخطاء موجودة تحديدًا لأن ذلك حدث فعلًا.
- التصدير المجمَّع بطيء بطبيعته: نحو 43 ألف فاتورة تعني 43 ألف طلب تفاصيل، ويُتوقَّع أن تستغرق عشرات الدقائق على اتصال عادي.
- لا توجد مجموعة اختبارات آلية ولا سير عمل CI.
- لا يوجد ملف ترخيص منشور.
- الأداة تتعامل مع بيانات دافعين حقيقية، لذلك لا يمكن نشر أي لقطة شاشة منها إطلاقًا — وكل رسم في هذه الصفحة توضيحي.
التقنيات
- Chrome Manifest V3
- JavaScript
- ExcelJS
- REST API
- Service Worker
- IndexedDB
الروابط
- المستودع(يفتح في تبويب جديد)
github.com/mohamedrepo/eta-invoice-exporter
- التوثيق(يفتح في تبويب جديد)
- تنزيل الإصدار(يفتح في تبويب جديد)
- الحالة
- إصدار منشور
- آخر مراجعة
- 2026-10-15
أعمال ذات صلة
هل تواجه مشكلة مشابهة؟
إن كان هذا قريبًا من شيء تتعامل معه، صِف لنا حالتك وسنقول لك إن كانت مناسبة لنا أم لا.