إذا كانت منشأتك تصدر فواتيرها من نظام مخصص أو نظام تخطيط موارد مؤسسة (ERP) طُوّر داخليًا، فإن ربط الفاتورة الإلكترونية في المرحلة الثانية يعني أن يصبح نظامك نفسه قادرًا على إنتاج الفاتورة بصيغة XML وفق المواصفات، وختم الفواتير المبسطة تشفيريًا، وإرسال كل فاتورة إلى منصة «فاتورة» في المسار الصحيح، وحفظ سلسلة الفواتير دون أي ثغرة. والحديث هنا موجّه إلى مدير التقنية وفريق التطوير: ما الوحدات التي تُبنى، وأين تقع قرارات التصميم الحاسمة، وما معيار القبول قبل الانتقال إلى الإنتاج.
آخر تحقق: 23 أكتوبر 2026
متى يحتاج النظام المخصص ربطًا مباشرًا مع منصة فاتورة؟
بدأت المرحلة الثانية، مرحلة الربط والتكامل، في 1 يناير 2023، وتُطبَّق على موجات تحددها هيئة الزكاة والضريبة والجمارك. وأحدث موجة منشورة حتى تاريخ هذا المقال هي الموجة 25، وتشمل من تجاوزت إيراداتهم الخاضعة للضريبة 187,500 ريال خلال 2022 أو 2023 أو 2024 أو 2025، وموعد ربطها الأقصى 1 فبراير 2027. ولتفاصيل الشمول والإخطار والخطة الزمنية راجع دليل المرحلة الثانية وموعد الموجة 25.
البرنامج المحاسبي الجاهز يعالج الربط غالبًا بتحديث من مورده. أما النظام المخصص فلا أحد سيفعل ذلك نيابة عنك. وأمامك عمليًا مساران: أن تبني الربط داخل نظامك، أو أن تضع بين نظامك والمنصة حلًا وسيطًا يتولى الصيغة والختم والإرسال. وفي المسارين تبقى مسؤولية صحة البيانات التي يخرجها نظامك عليك.
مكونات ربط الفاتورة الإلكترونية في المرحلة الثانية: XML وUBL 2.1 والختم وQR
وفق الدليل التفصيلي للهيئة، تُنشأ الفاتورة الضريبية بصيغة XML، أو PDF/A-3 مع XML مضمّن، وتُرسل إلى المنصة بصيغة XML عبر واجهات برمجية (APIs). ويتبع معيار تنفيذ الفاتورة بصيغة XML الذي تنشره الهيئة تسلسل وعناصر معيار UBL 2.1. وهذا يعني أن نظامك يحتاج إلى المكونات التالية بوصفها وحدات واضحة الحدود، لا تعديلات متفرقة داخل شاشة الفاتورة:
- مولّد XML: يحوّل بيانات الفاتورة في قاعدة بياناتك إلى ملف مطابق للمعيار، بحقوله وترتيبه وقيمه المرمّزة.
- وحدة التحقق المسبق: تفحص الملف قبل إرساله، كالحقول الإلزامية وصحة المجاميع والضريبة، حتى لا تكتشف الخطأ من رد المنصة.
- وحدة الختم: تختم الفواتير المبسطة تشفيريًا وتولّد رمز الاستجابة السريعة (QR) لها.
- عميل الواجهات البرمجية: يرسل الفواتير إلى المنصة ويستقبل ردها ويحفظه.
- مخزن الفواتير: يحفظ الملف المرسل والرد المستلم وحالة كل فاتورة، دون إمكانية تعديلها.
ولتفاصيل بنية الملف وعناصره من منظور المطوّر، راجع فاتورة XML ومعيار UBL 2.1.
الاعتماد (Clearance) مقابل الإبلاغ (Reporting) في التصميم
الفاتورة الضريبية تُرسل إلى المنصة لاعتمادها، فتتحقق المنصة من مطابقتها ثم تضيف إليها الختم التشفيري ورمز QR. أما الفاتورة الضريبية المبسطة فيختمها حل المكلف نفسه بشهادة الختم، ثم يرسلها للإبلاغ خلال 24 ساعة من إصدارها، ولا تخضع للاعتماد المسبق. وهذا الفرق ليس إجرائيًا فقط، بل يفرض تصميمين مختلفين داخل نظامك:
- مسار الاعتماد متزامن: لا تُسلَّم الفاتورة الضريبية للمشتري قبل عودة رد المنصة. فيجب أن يتعامل النظام مع الرفض بوضوح، فيُظهر سببه للمستخدم ويمنع تسليم الفاتورة، ويتيح تصحيح البيانات وإعادة الإرسال.
- مسار الإبلاغ غير متزامن: تُسلَّم الفاتورة المبسطة للعميل فورًا، ثم تدخل طابور إرسال (Queue) يعيد المحاولة تلقائيًا عند انقطاع الاتصال، وينبّه المسؤول قبل اقتراب مهلة 24 ساعة.
- مراقبة موحدة: لوحة تعرض الفواتير المعلقة والمرفوضة والمتأخرة في المسارين، لأن الفاتورة التي فشل إرسالها بصمت هي أخطر ما في المشروع.
ولشرح المسارين وشهادة الختم من منظور المحاسب والمدير المالي، راجع الفاتورة الضريبية والمبسطة: الاعتماد والإبلاغ وشهادة CSID.
شهادة CSID وتسلسل الفواتير (Hash وUUID)
تصدر الهيئة شهادة الختم التشفيري (CSID) التي يستخدمها حلك لختم الفواتير المبسطة. وعمليًا هي سرّ تشغيلي يجب أن يُعامل كما تُعامل مفاتيح التشفير: تخزين محمي، وصلاحية وصول محدودة، وإجراء مكتوب لتجديدها أو استبدالها قبل أن يتوقف الإصدار بسببها.
أما التسلسل، فلكل فاتورة معرّف فريد (UUID) يولّده الحل ويُخزَّن داخل ملف XML، وترتبط كل فاتورة بالتي قبلها بإدراج قيمة التجزئة (Hash) للفاتورة السابقة. ويترتب على ذلك قرارات تصميم يغفل عنها كثير من الفرق:
- التزامن: إذا كان أكثر من مستخدم أو فرع يصدر فواتير في اللحظة نفسها، فيجب أن يضمن النظام أن كل فاتورة تأخذ قيمة التجزئة الصحيحة للسابقة، دون تكرار أو قفز. والحل المعتاد أن يُسلسَل الإصدار داخل كل سلسلة بقفل في قاعدة البيانات أو طابور واحد، لا أن يُترك لتوقيت الطلبات.
- تعدد مصادر الإصدار: حدد بوضوح هل لكل نقطة بيع أو فرع سلسلة مستقلة، وراجع ذلك مع المواصفات الرسمية قبل البناء.
- عدم إعادة الاستخدام: لا يُعاد توليد UUID لفاتورة صادرة، ولا تُعاد كتابة قيمة التجزئة بعد حفظها.
- النسخ الاحتياطي والاستعادة: استعادة قاعدة بيانات قديمة قد تكسر السلسلة، فاختبر سيناريو الاستعادة قبل التشغيل.
بيئة المحاكاة والاختبار قبل الإنتاج
لا تجعل بيئة التشغيل الفعلية أول مكان يرى فيه نظامك ردود المنصة. يتداول المطورون اسم «منصة محاكاة فاتورة» للبيئة التي يجرَّب فيها الربط قبل التشغيل، لكننا لم نتحقق من مصدر رسمي من تفاصيلها وخطوات التسجيل فيها حاليًا. لذلك راجع قسم مطوري الأنظمة في موقع الهيئة لمعرفة البيئات المتاحة وخطواتها قبل التخطيط.
وأيًّا كانت البيئات الرسمية المتاحة، جهّز داخليًا ثلاث بيئات منفصلة: بيئة تطوير، وبيئة اختبار ببيانات تشبه الواقع، وبيئة إنتاج. وصمم حالات الاختبار لتغطي ما لا يظهر في الأيام العادية: فاتورة مرفوضة، وانقطاع الاتصال لساعات، وإشعار دائن، وفواتير متزامنة من فرعين، وانتهاء صلاحية الشهادة.
الوظائف المحظورة التي يجب منعها في نظامك
يحدد الدليل التفصيلي وظائف محظورة في حلول الفوترة. والمهم للأنظمة المخصصة أن هذه المحظورات قد تمس النظام كله لا وحدة الفوترة وحدها. والجدول التالي يحوّل كل محظور إلى ضابط تقني:
| الوظيفة المحظورة | الضابط التقني المقترح في نظامك |
|---|---|
| الدخول دون هوية | إلغاء أي حساب مجهول أو مشترك، وربط كل عملية بمستخدم محدد |
| كلمات المرور الافتراضية | فرض تغيير كلمة المرور عند أول دخول، ومنع الحسابات الافتراضية في الإنتاج |
| غياب إدارة جلسات المستخدم | انتهاء الجلسة بعد الخمول، وتسجيل الدخول والخروج |
| تعديل الفواتير أو حذفها بعد إصدارها | قفل الفاتورة عند الإصدار على مستوى قاعدة البيانات لا الواجهة فقط، والتصحيح بإشعار دائن ثم إعادة الإصدار |
| تعديل سجلات النظام أو حذفها | سجلات تدقيق لا تقبل إلا الإضافة، وصلاحيات قاعدة بيانات تمنع التعديل على حسابات التطبيق والمشرفين، مع نسخ السجلات إلى مخزن منفصل أو ربطها بقيم تجزئة تكشف أي تغيير، لأن مدير قاعدة البيانات يملك تقنيًا صلاحية أعلى |
والنقطة الأخيرة تحديدًا تكشف أنظمة داخلية كثيرة يملك فيها مدير النظام صلاحية مطلقة على الجداول. فإذا كان ذلك ممكنًا في نظامك، فعالجه قبل الربط لا بعده.
بناء الربط داخليًا أم عبر مزود حل؟
لا توجد إجابة واحدة، لكن أربعة معايير تحسم القرار غالبًا:
- الفريق: هل لديك مطورون يعرفون بنية النظام ولديهم خبرة في XML والتشفير والتكامل عبر الواجهات البرمجية؟
- مصادر الإصدار: كلما زادت نقاط البيع والفروع والقنوات، زاد تعقيد التسلسل والإرسال، وزادت قيمة حل وسيط مجرّب.
- الوقت: المسافة إلى موعد موجتك تحدد هل يتسع الجدول لبناء واختبار كاملين.
- المتابعة: من سيطبّق أي تحديث تصدره الهيئة على المواصفات بعد التشغيل؟
وإذا اخترت مزودًا، فلا تكتفِ بقوله إن حله «متوافق»، واطلب إجابات مكتوبة عن إدارة الشهادة ومعالجة الرفض وحفظ السجلات. أما المفاضلة الكاملة من منظور صاحب القرار، بالتكلفة والمخاطر وأسئلة التعاقد، ففي دليل اختيار مزود حلول الفوترة الإلكترونية أو تطوير الحل داخليًا.
قائمة تحقق قبل التشغيل
استخدم القائمة التالية معيار قبول نهائي للمشروع، ولا تنتقل إلى الإنتاج قبل اجتياز كل بند فيها:
- حصر كل مصادر إصدار الفواتير في المنشأة وتصنيف ما يصدر عنها إلى ضريبية ومبسطة.
- ملف XML يجتاز التحقق المسبق لكل أنواع المستندات، بما فيها الإشعارات الدائنة.
- UUID فريد لكل فاتورة وسلسلة Hash سليمة تحت إصدار متزامن من أكثر من مستخدم.
- مسار اعتماد يمنع تسليم الفاتورة الضريبية قبل اعتمادها ويعالج الرفض بوضوح.
- طابور إبلاغ للفواتير المبسطة يعيد المحاولة وينبّه قبل مهلة 24 ساعة.
- شهادة الختم محفوظة بأمان، مع إجراء مكتوب لتجديدها.
- الوظائف المحظورة معالجة على مستوى النظام كله، مع سجلات تدقيق غير قابلة للتعديل.
- اختبار سيناريوهات الانقطاع والاستعادة من النسخ الاحتياطي.
- لوحة مراقبة للفواتير المعلقة والمرفوضة، ومسؤول محدد يتابعها يوميًا.
- تدريب المستخدمين على الإشعارات الدائنة وإجراء التعطل.
الأسئلة الشائعة
كيف أربط نظامي المخصص بمنصة فاتورة؟
ابنِ داخل نظامك، أو في حل وسيط، مكونات تولّد XML مطابقًا للمعيار، وتختم الفواتير المبسطة بشهادة CSID، وترسل الفواتير الضريبية للاعتماد والمبسطة للإبلاغ خلال 24 ساعة. ثم أضف إدارة التسلسل بقيمة Hash وUUID، وامنع الوظائف المحظورة في النظام كله. واختبر كل ذلك في بيئة منفصلة قبل الإنتاج.
ما هي مراحل الربط والتكامل؟
رسميًا، المرحلة الثانية نفسها هي مرحلة الربط والتكامل، وتُطبَّق على موجات حسب الإيرادات. أما مشروع الربط داخل المنشأة فيمر عادة بالحصر والتقييم، ثم التصميم والتطوير، ثم الاختبار، ثم التسجيل والتشغيل والمراقبة. وتختلف مدة كل مرحلة حسب حالة النظام وعدد مصادر الإصدار.
ما الفرق بين منصة فاتورة ومنصة محاكاة فاتورة؟
منصة «فاتورة» هي البيئة الرسمية التي تُعتمد فيها الفواتير الضريبية ويُبلَّغ فيها عن المبسطة. أما «منصة المحاكاة» فاسم يتداوله المطورون لبيئة تجريب الربط قبل التشغيل الفعلي، ولم نتحقق من تفاصيلها الحالية من مصدر رسمي. راجع قسم مطوري الأنظمة في موقع الهيئة لمعرفة البيئات المتاحة وخطوات استخدامها.
ما هي الأخطاء الشائعة التي تسبب رفض منصة فاتورة للفواتير؟
لم نجد مصدرًا رسميًا يحصر أسباب الرفض، لكن الأسباب المتوقعة تقنيًا تشمل ملف XML لا يطابق المعيار، وبيانات إلزامية ناقصة أو غير صحيحة، ومجاميع وضريبة غير متسقة، وكسرًا في سلسلة Hash. لذلك ابنِ تحققًا مسبقًا داخل نظامك، واحفظ رد المنصة لكل فاتورة مرفوضة لتحليله.
ماذا يحدث للفاتورة الضريبية إذا تعذر الاتصال بمنصة فاتورة؟
الفاتورة الضريبية تحتاج اعتماد المنصة قبل تسليمها للمشتري، لذلك يجب أن يحفظها نظامك في حالة «بانتظار الاعتماد» ويعيد المحاولة دون تغيير رقمها أو موقعها في سلسلة Hash. أما الفاتورة المبسطة فتُسلَّم بعد ختمها محليًا، وتبقى في طابور الإبلاغ حتى تُرسل خلال 24 ساعة. وإذا طال التعطل فراجع إرشادات الهيئة، لأن عدم الإبلاغ عن تعطل الحل مخالفة مستقلة.
معيار القبول قبل موعد موجتك
ربط النظام المخصص بمنصة «فاتورة» مشروع هندسي له مكونات واضحة: توليد XML، والختم، ومساران مختلفان للاعتماد والإبلاغ، وتسلسل لا يحتمل الخطأ، وضوابط تمتد إلى النظام كله. ابدأ بالحصر، واجعل قائمة التحقق السابقة شرط الانتقال إلى الإنتاج، واترك وقتًا كافيًا للاختبار قبل موعد موجتك.
وإذا احتاج فريقك إلى دعم في البناء أو المراجعة، فإتمام تقدم خدمة بناء وتطوير الأنظمة وحلولًا برمجية مخصصة للشركات مصممة لتتكامل مع الأنظمة الحالية، ويمكنها مراجعة بنية نظامك مقابل قائمة التحقق. اطلب استشارة تقنية من إتمام قبل أن تبدأ التطوير.
المصادر: هيئة الزكاة والضريبة والجمارك – صفحة الفوترة الإلكترونية، هيئة الزكاة والضريبة والجمارك – إعلان الموجة 25 للربط والتكامل، هيئة الزكاة والضريبة والجمارك – الدليل التفصيلي للفوترة الإلكترونية، هيئة الزكاة والضريبة والجمارك – معيار تنفيذ الفاتورة الإلكترونية بصيغة XML
هذا المقال للتوعية العامة ولا يُعد استشارة قانونية أو تنظيمية. راجع النصوص الرسمية أو مختصًا قبل اتخاذ القرار.
لربط نظامك المخصص بمنصة فاتورة قبل موعد موجتك، تعرّف على خدمة ربط الفاتورة الإلكترونية لنظامك من إتمام.
