متطلبات الفاتورة الإلكترونية المصرية: المعايير والمواصفات التقنية

التعامل مع المتطلبات التقنية لمنظومة الفاتورة الإلكترونية المصرية يُشكّل تحدياً حقيقياً لكثير من الشركات والمطورين. مصلحة الضرائب المصرية (ETA) وضعت مواصفات تقنية دقيقة لضمان التوافق الكامل بين أنظمة الفوترة المختلفة وبوابة ETA.

فهم هذه المتطلبات التقنية ليس حكراً على المطورين والمتخصصين التقنيين فحسب، بل يُعين أصحاب القرار في الشركات على اختيار الحلول البرمجية الصحيحة والتفاوض بكفاءة مع مزودي الحلول التقنية.

في هذا المقال، سنستعرض المواصفات التقنية لمنظومة الفاتورة الإلكترونية المصرية بأسلوب مبسط ومنظم، بدءاً من بنية الـ XML وصولاً إلى متطلبات التوقيع الإلكتروني ومعايير التكامل مع الـ API.

تنسيق الفاتورة الإلكترونية: XML المعياري

الفاتورة الإلكترونية المصرية يجب أن تُرسَل بتنسيق XML وفق المخطط (Schema) المحدد من مصلحة الضرائب. هذا الـ Schema متاح للتنزيل من بوابة المطورين sdk.invoicing.eta.gov.eg.

الـ XML ليس مجرد صيغة ملف، بل هو هيكل بيانات منظم يضمن أن كل معلومة في الفاتورة لها مكانها المحدد وشكلها المحدد. أي انحراف عن المخطط يؤدي إلى رفض الفاتورة من المنظومة.

البنية العامة للـ XML تتضمن: رأس الفاتورة (Header)، بيانات المُصدِر، بيانات المستلم، سطور الفاتورة (Line Items)، الملخص الضريبي، والتواقيع الإلكترونية. كل قسم من هذه الأقسام له حقول إلزامية وأخرى اختيارية.

الحقول الإلزامية في الفاتورة الإلكترونية

تُصنَّف الحقول الإلزامية في الفاتورة الإلكترونية المصرية إلى عدة مجموعات:

بيانات الفاتورة الأساسية:

• نوع الوثيقة (فاتورة / إشعار دائن / إشعار مدين)
• رقم الفاتورة الداخلي التسلسلي
• تاريخ ووقت الإصدار بتنسيق ISO 8601
• العملة (EGP أو عملة أجنبية مع سعر الصرف)

بيانات المُصدِر (البائع):

• الرقم الضريبي (TIN) — إلزامي دائماً
• اسم المنشأة باللغة العربية
• عنوان المنشأة مفصّلاً (محافظة، مدينة، شارع، رقم)
• رقم التسجيل في ضريبة القيمة المضافة (إن وجد)

بيانات المستلم (المشتري):

• الرقم الضريبي للمشتري (إلزامي لمعاملات B2B)
• اسم المشتري
• عنوان المشتري (مطلوب للشركات)
• في حالة الأفراد: الرقم القومي بديلاً عن الرقم الضريبي

بيانات الأصناف (سطور الفاتورة):

• كود الصنف وفق تصنيف GS1 أو EGS (الكود المصري الموحد)
• وصف الصنف
• الكمية ووحدة القياس
• سعر الوحدة قبل الضريبة
• الخصومات (إن وجدت)
• نسبة ضريبة القيمة المضافة المطبَّقة
• إجمالي الصنف قبل وبعد الضريبة

نظام ترميز الأصناف: EGS وGS1

أحد أكثر المتطلبات التقنية التي تُشكّل تحدياً هو نظام ترميز الأصناف. مصلحة الضرائب تطلب تصنيف كل صنف وفق نظام معياري:

GS1 International: نظام الترميز الدولي المعتمد عالمياً، يشمل GTIN (الكود الشريطي العالمي). مناسب للمنتجات المصنّعة والسلع ذات باركود دولي.

EGS (Egyptian General System): النظام المصري الموحد للأصناف، طوّرته مصلحة الضرائب للأصناف والخدمات التي لا يوجد لها تصنيف دولي معياري. يُستخدم خاصةً للخدمات المهنية والسلع المحلية.

قبل بدء إصدار الفواتير الإلكترونية، يجب على الشركة مراجعة قائمة أصنافها ومنتجاتها وتحديد الكود المناسب لكل منها وفق نظام GS1 أو EGS. هذا العمل الأولي يستغرق وقتاً لكنه يُنجز مرة واحدة.

التوقيع الإلكتروني: الضمان التقني للأمان

التوقيع الإلكتروني هو العنصر التقني الذي يُثبت هوية مُصدِر الفاتورة ويضمن عدم التلاعب بمحتواها. المنظومة المصرية تدعم نوعين من التوقيع:

التوقيع بشهادة رقمية (PKI Signature): يستخدم شهادة رقمية صادرة من مزود معتمد. الشهادة تتضمن المفتاح الخاص (Private Key) المستخدم للتوقيع والمفتاح العام (Public Key) الذي تستخدمه ETA للتحقق. هذا النوع من التوقيع مناسب للشركات التي لديها نظام ERP متكامل.

USB Token (Hardware Security Module): بعض مزودي الشهادات يقدمون الشهادة على شكل USB Token (جهاز تشفير مادي)، وهو الأكثر أماناً لأن المفتاح الخاص لا يمكن نسخه. يُلائم الشركات الصغيرة التي تُصدر فواتير يدوياً عبر بوابة ETA.

واجهة برمجة التطبيقات (API) لمنظومة ETA

التكامل مع منظومة ETA يتم عبر API RESTful يوفر عدة نقاط نهاية (Endpoints) رئيسية:

نقطة إرسال الفواتير: POST /api/v1/documentsubmissions — ترسل مجموعة من الفواتير (حتى 100 في الطلب الواحد) وتستقبل إقراراً فورياً يتضمن UUID لكل فاتورة مقبولة.

نقطة الاستعلام عن الفاتورة: GET /api/v1/documents/{uuid} — تستعلم عن حالة فاتورة معينة بمعرفة UUID الخاص بها.

نقطة إلغاء الفاتورة: PUT /api/v1/documents/{uuid}/state — تُستخدم لإلغاء فاتورة لم يمضِ على إصدارها أكثر من 24 ساعة.

المصادقة (Authentication): تستخدم المنظومة OAuth 2.0 مع Client Credentials Flow. يجب الحصول على Client ID و Secret من بوابة ETA وتجديدهما دورياً.

متطلبات البيانات الرقمية والدقة الحسابية

مصلحة الضرائب تشترط دقة حسابية معينة في قيم الفاتورة لتفادي أخطاء التقريب:

القيم النقدية تُعبَّر عنها بـ 5 خانات عشرية كحد أقصى (مثال: 14.28571). المجاميع يجب أن تتطابق رياضياً مع مجموع سطور الفاتورة — أي فارق ولو بفلس واحد يُسبب رفض الفاتورة.

نسب الضريبة تُكتب كأرقام عشرية (0.14 للنسبة 14%، لا الرقم 14). الخصومات تُدخَل كقيمة موجبة يُطرح منها من الإجمالي.

الأسئلة الشائعة