ربط السيستم بمنظومة الفاتورة الإلكترونية: التوقيع الإلكتروني وأكواد الأصناف خطوة بخطوة

ربط السيستم بمنظومة الفاتورة الإلكترونية يعني أن برنامج الحسابات أو نظام ERP هو الذي يرسل كل فاتورة وإشعار دائن وإشعار مدين بين الشركات إلى مصلحة الضرائب المصرية، كمستند منظم موقّع إلكترونياً وبأكواد أصناف تعترف بها المنظومة، بدلاً من أن يعيد موظف إدخالها يدوياً. الخطوات الأساسية: تسجيل السيستم على ملف الممول في المنظومة، والحصول على بيانات الدخول وشهادة الختم الإلكتروني، وتسجيل أكواد الأصناف (GS1 أو EGS)، وبناء المستند والتوقيع كما تحدد الوثائق الفنية بالضبط، ثم الإرسال عبر الواجهات البرمجية ومتابعة حالة كل مستند.

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

في هذا الدليل نشرح الربط خطوة بخطوة من زاوية صاحب الشركة: ما الذي يجهزه فريقك، وما الذي يبنيه المبرمج، وما الذي يجب اختباره، بالاعتماد على الوثائق الفنية الرسمية لمنظومتي الفاتورة والإيصال الإلكتروني (SDK).

الخلاصة السريعة

• الربط المباشر يتم عبر واجهات REST API الخاصة بمصلحة الضرائب: يسجّل السيستم دخوله، ويرسل المستندات الموقعة، ويقرأ حالتها.
• كل سطر في الفاتورة يحتاج كود صنف من نوع GS1 أو EGS. أكواد EGS تأخذ الشكل EG-رقم التسجيل الضريبي-الكود الداخلي، وتُربط بكود GPC من المستوى الرابع (Brick) وتعتمدها المصلحة.
• المستندات توقَّع بشهادة ختم إلكتروني (eSeal) بصيغة CAdES-BES على بصمة SHA-256 للنسخة المعيارية من المستند.
• الإرسال غير متزامن: المنظومة تستقبل الدفعة أولاً ثم تتحقق منها، لذلك يجب أن يعود السيستم لمعرفة الحالة النهائية.
• مُهل الإلغاء والرفض تحددها المصلحة لكل نوع مستند، والربط الجيد يقرؤها من الواجهة البرمجية ولا يكتبها ثابتة في الكود.

أين تقف الفاتورة الإلكترونية في 2026؟

بدأت مصلحة الضرائب تطبيق الفاتورة الإلكترونية بين الشركات في 15 نوفمبر 2020 بمجموعة أولى من كبار الممولين، ثم أضافت مجموعات أخرى في 2021، ومدّت الالتزام إلى الشركات المسجلة في ضريبة القيمة المضافة لمعاملات B2B خلال 2022 و2023، وفق ملخص VATupdate (فبراير 2026). أما المبيعات للمستهلك النهائي فتغطيها منظومة مختلفة هي الإيصال الإلكتروني، ولها قواعدها وقوائم انضمامها.

هناك طريقتان لإصدار الفاتورة الإلكترونية: كتابتها على بوابة المصلحة، أو ربط نظام ERP عبر الواجهات البرمجية. البوابة تكفي لعدد قليل جداً من الفواتير، والربط هو الخيار العملي الوحيد عندما تكثر الفواتير أو تطول أسطرها أو يجب أن تتطابق تلقائياً مع المخزون والحسابات.

الخطوة الأولى: تسجيل السيستم في منظومة الضرائب

بحسب دليل البدء في الوثائق الرسمية، يشمل الانضمام:

1. تسجيل الملف الرقمي للممول لدى المصلحة.
2. استلام دعوة لإنشاء حساب مدير الممول الذي يدير الملف.
3. دعوة المفوضين وتسجيل سيستم ERP أو نقاط بيع (POS) أو أكثر ستتصل بالواجهات البرمجية.
4. الحصول على بيانات الدخول للواجهات البرمجية وضبطها في كل سيستم.
5. الحصول على شهادة ختم إلكتروني (eSeal X.509) وضبطها في السيستم الذي يوقّع المستندات ويرسلها.

عملياً، يتولى صاحب الشركة أو المدير المالي الملف والشهادة، ويستلم المبرمج بيانات الدخول لبيئة الاختبار وبيئة التشغيل. احفظ هذه البيانات في مكان إعدادات آمن، لا في شيت إكسيل أو رسائل بريد.

الخطوة الثانية: تجهيز أكواد الأصناف وتسجيلها

أكواد الأصناف هي المكان الذي تضيع فيه أغلب مشروعات الربط وقتها. تنص مواصفات الفاتورة في الوثائق الفنية على أن نوع كود كل سطر يجب أن يكون GS1 أو EGS؛ أكواد GS1 موجهة للسلع، بينما تغطي أكواد EGS السلع والخدمات معاً.

كود GS1 أم كود EGS؟

	GS1 (GTIN)	EGS
ما هو	رقم باركود عالمي للمنتج	كودك الداخلي مسجلاً على منظومة الضرائب
الشكل	GTIN قياسي	EG-رقم التسجيل الضريبي-الكود الداخلي
التصنيف	مرتبط بتصنيف GS1 للمنتجات	يجب أن يشير إلى كود GPC من المستوى الرابع (Brick) كأصل له
التكلفة	يُشترى من GS1 مصر	بلا رسوم للكود، لكن بجهد داخلي ومراجعة من المصلحة
الاستخدام المعتاد	المنتجات ذات العلامة التجارية والمستوردون	الخدمات والخامات والأصناف الخاصة

تتيح واجهة تسجيل أكواد EGS أن يرسل السيستم طلبات الأكواد باسم إنجليزي واسم عربي وكود GPC الأصل وتاريخ التفعيل، ثم يراجعها موظفو المصلحة ويعتمدونها قبل استخدامها في المستندات. وعلى الشركات المستوردة أن تنتبه إلى أنه منذ يوليو 2023 أصبح المستورد يحتاج أكواد GS1 على فواتير المورد الإلكترونية لإنهاء الإفراج الجمركي عبر منصة نافذة، كما أوضحت Deloitte في 2023.

نظّف بطاقات الأصناف أولاً

• احذف الأصناف المكررة، وادمج الأشكال التي هي في الحقيقة المنتج نفسه.
• أضف في بطاقة الصنف حقلاً لنوع كود الضرائب والكود نفسه، منفصلاً عن الكود الداخلي (SKU).
• اربط كل صنف بكود GPC Brick الصحيح؛ الخطأ هنا يعني رفض طلب الكود.
• حدد من المسؤول عن الأصناف الجديدة، حتى لا يُباع منتج قبل اعتماد كوده.

الخطوة الثالثة: بناء المستند بشكل صحيح

الفاتورة في المنظومة مستند منظم بصيغة JSON أو XML. بعيداً عن الإجماليات والضرائب الواضحة، هذه الحقول هي أكثر أسباب الرفض:

• نوع المستند وإصداره، مثل النوع "i" بالإصدار "1.0" للفاتورة، ولإشعارات الدائن والمدين أنواعها الخاصة.
• نوع المُصدر والمستلم: B لشركة في مصر، وP لشخص طبيعي، وF لأجنبي. بيانات هوية المستلم مطلوبة إلا لمشترٍ فرد تحت مبلغ محدد.
• كود النشاط: النشاط الذي نتج عنه البيع، من قائمة أكواد المصلحة.
• تاريخ ووقت الإصدار بتوقيت UTC، ولا يجوز أن يكون في المستقبل؛ لذلك يهم ضبط ساعة السيرفر والمنطقة الزمنية.
• كود الفرع كما هو مسجل في المصلحة، للشركات متعددة الفروع.
• أنواع الضرائب وأنواعها الفرعية لكل سطر من جداول أكواد المصلحة.
• التقريب: يجب أن تتطابق إجماليات الأسطر والخصومات والضرائب تماماً، وإلا رُفض المستند.

الخطوة الرابعة: التوقيع الإلكتروني للمستند

يشرح دليل إنشاء التوقيع في الوثائق الرسمية العملية: يُحوَّل المستند إلى صيغة معيارية تحتفظ فقط بالبيانات المهمة (أسماء الحقول وقيمها)، ثم تُحسب بصمة SHA-256، ثم تُوقَّع البصمة بصيغة CAdES-BES بشهادة الختم الإلكتروني، ويُضاف التوقيع بترميز Base64 داخل المستند قبل الإرسال.

أين توضع شهادة التوقيع؟

• توكن USB على جهاز واحد. بسيط، لكن هذا الجهاز يصبح نقطة تعطل واحدة وعنق زجاجة.
• خدمة توقيع على الشبكة. خدمة صغيرة على سيرفر متصل به التوكن توقّع لكل مستخدمي نظام ERP، وهي أكثر اعتمادية للأنظمة متعددة المستخدمين.
• جهاز HSM. وحدة أمان مادية تناسب الأحجام الكبيرة والشركات الأكبر.

في كل الأحوال يجب تسجيل خطوة التوقيع، ولا يجوز أن تظهر فاتورة على أنها "مُرسلة" في السيستم إذا فشل توقيعها.

الخطوة الخامسة: الإرسال ثم متابعة الحالة

واجهة إرسال المستندات في المنظومة تُجري فحوصاً بسيطة فقط وترد بالكود 202، وتعطي رقم دفعة (Submission ID)، ولكل مستند إما UUID ورقماً طويلاً من المصلحة (مقبول للمعالجة) أو تفاصيل خطأ (مرفوض فوراً). التحقق الكامل يتم بعد ذلك، لذلك يجب أن يقوم نظام ERP بما يلي:

1. حفظ رقم الدفعة وUUID كل مستند مع الفاتورة.
2. الاستعلام عن الحالة النهائية (صحيح أو غير صحيح) وعرضها في شاشة الفاتورة.
3. تنبيه المحاسب بالمستندات غير الصحيحة مع رسالة الخطأ بلغة مفهومة.
4. تجنب إعادة إرسال نفس البيانات خلال فترة قصيرة، فالمنظومة تكتشف الإرسال المكرر خلال عشر دقائق.

إلغاء المستند ورفض المشتري

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

قائمة اختبار الربط

• فاتورة وإشعار دائن وإشعار مدين مقبولة على بيئة الاختبار.
• فاتورة بخصم وأكثر من نوع ضريبة وسطر بعملة أجنبية.
• مشترٍ فرد تحت حد إثبات الهوية وفوقه.
• صنف بكود GS1 وصنف بكود EGS.
• خدمة التوقيع متوقفة: المستند في قائمة الانتظار، والمستخدم منبَّه، ولا تكرار عند إعادة المحاولة.
• المنظومة بطيئة أو متوقفة: إعادة محاولة متدرجة وقائمة انتظار ظاهرة.
• إلغاء داخل المهلة وخارجها.
• تنزيل المستندات الواردة من الموردين ومطابقتها مع فواتير المشتريات.
• تقرير شهري يطابق مبيعات السيستم مع المستندات الصحيحة على المنظومة.

يشير ملخص VATupdate أيضاً إلى الاحتفاظ بسجلات الفاتورة الإلكترونية خمس سنوات. احفظ UUID المصلحة والحالة والمستند الموقَّع مع الفاتورة نفسها، لا في سجل منفصل قد يضيع.

كيف تساعدك Nilex

تدمج Nilex Digital Systems ربط الفاتورة الإلكترونية داخل أنظمة ERP المخصصة التي تبنيها. نعمل مباشرة على واجهات REST API الخاصة بمصلحة الضرائب، ونحفظ كل دفعة وحالة مع الفاتورة، ونحتفظ بسجل كامل لمن أصدر أو ألغى أو عدّل ماذا. ربط الفاتورة الإلكترونية جزء من باقة Enterprise ويمكن تحديد نطاقه لمشروعات أخرى.

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

هل أصدر الفاتورة الإلكترونية من البوابة بدل ربط السيستم؟

نعم، البوابة تسمح بالإصدار اليدوي وتناسب الأعداد القليلة جداً. أما مع الفوترة المنتظمة فالإدخال اليدوي يكرر العمل، ويسبب اختلافات مع الحسابات، ويصعّب التحكم في الإشعارات الدائنة والإلغاء.

كم يستغرق اعتماد كود EGS؟

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

هل أحتاج توكن USB لتوقيع الفاتورة الإلكترونية؟

تحتاج شهادة ختم إلكتروني، وتُحفظ عادة على توكن USB، لكن يمكن وضعها على سيرفر توقيع أو جهاز HSM. الاختيار يعتمد على عدد فواتيرك وعدد من يُصدرونها.

ماذا يحدث إذا ظهرت الفاتورة "غير صحيحة"؟

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

هل يمكن ربط الإكسيل أو برنامج ديسكتوب قديم بالمنظومة؟

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

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

هذا المقال معلومات عامة وليس استشارة قانونية أو ضريبية؛ راجع التفاصيل الخاصة بشركتك مع متخصص.