المواقع والبرمجيات

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

بقلم فريق ITCM · آخر تحديث أكتوبر 2026

المرحلة الثانية من الفوترة الإلكترونية، أو مرحلة الربط والتكامل، تُلزم المنشآت المسجلة في ضريبة القيمة المضافة بربط نظام الفوترة أو المحاسبة لديها مع منصة فاتورة التابعة لهيئة الزكاة والضريبة والجمارك (ZATCA)، بحيث تُعتمد الفواتير الضريبية بين المنشآت (B2B) قبل إرسالها للمشتري، وتُبلَّغ الفواتير المبسطة للأفراد (B2C) خلال 24 ساعة. وتطبّق الهيئة هذه المرحلة على موجات، وتبلّغ كل منشأة مستهدفة قبل موعد ربطها بستة أشهر على الأقل. في هذا الدليل نشرح من تشمله المتطلبات، وما تعنيه المتطلبات التقنية فعليًا، وكيف يتم تسجيل الوحدات والحصول على CSID واختبار الـ API، وكيف تخطط لمشروع ربط نظام المحاسبة مع الزكاة دون فواتير مرفوضة.

المرحلة الأولى والمرحلة الثانية: ما الذي تغيّر في مرحلة الربط والتكامل؟

تمر الفوترة الإلكترونية في المملكة (فاتورة) بمرحلتين. بدأت مرحلة الإصدار والحفظ في 4 ديسمبر 2021، وتُلزم المكلفين بإصدار الفواتير الضريبية والإشعارات الدائنة والمدينة وحفظها عبر حل إلكتروني متوافق، مع رمز QR على الفواتير المبسطة، ومنع الفواتير اليدوية أو المعدّلة يدويًا. والفاتورة الورقية الممسوحة ضوئيًا أو المصوّرة لا تُعد فاتورة إلكترونية.

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

من تشمله المتطلبات وكيف تُعلَن الموجات؟

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

لا تُدخل الهيئة الجميع في المرحلة الثانية دفعة واحدة، بل تعلن موجات بحسب الإيرادات الخاضعة لضريبة القيمة المضافة في سنوات مرجعية محددة، وتبلّغ كل مكلف مستهدف مباشرة قبل موعد ربطه بستة أشهر على الأقل. وقد خُفّض الحد تدريجيًا في الموجات الأخيرة: شملت الموجة الرابعة والعشرون من تجاوزت إيراداتهم الخاضعة للضريبة 375,000 ريال في 2022 أو 2023 أو 2024 بموعد ربط أقصاه 30 يونيو 2026، وشملت الموجة الخامسة والعشرون المعلنة في يوليو 2026 من تجاوزت إيراداتهم 187,500 ريال في أي سنة من 2022 إلى 2025، وتشير المواعيد المنشورة من الهيئة إلى مطلع 2027 (نحو 1 فبراير 2027)، لذا تأكد من موعدك الدقيق في الإشعار الذي يصلك من الهيئة.

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

الاعتماد (Clearance) والإبلاغ (Reporting): فواتير B2B وB2C

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

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

متطلبات هيئة الزكاة للفوترة الإلكترونية بلغة مبسطة

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

• صيغة XML: تتبع الفواتير تطبيق الهيئة لمعيار UBL 2.1، مع التحقق من ترتيب الوسوم ووجود العناصر الإلزامية. ويُقبل ملف PDF/A-3 مقروء مضمّن فيه ملف XML لتبادل الفاتورة مع المشترين.
• المعرّف الفريد UUID: يولّده نظامك ويُحفظ داخل كل مستند XML.
• عدّاد الفواتير: رقم تسلسلي لكل وحدة EGS لا يستطيع المستخدمون إعادة ضبطه أو تعديله.
• تجزئة الفاتورة السابقة: يحمل كل مستند تجزئة المستند الذي قبله، فتتكوّن من مستندات الوحدة الواحدة سلسلة واحدة لا يمكن تغيير ترتيبها، ولا يُسمح بأكثر من تسلسل واحد لكل وحدة.
• ختم التشفير: توقيع رقمي مبني على ECDSA باستخدام زوج مفاتيح وشهادة تصدر عند التسجيل، ويجب حماية المفتاح الخاص وعدم السماح بتصديره إطلاقًا.
• رمز QR: نص مرمّز بصيغة TLV ثم Base64. وإلى جانب اسم البائع والرقم الضريبي والتاريخ والوقت والإجمالي ومبلغ الضريبة المطلوبة في المرحلة الأولى، تضيف المرحلة الثانية تجزئة الفاتورة والتوقيع والمفتاح العام، وتوقيع الهيئة في الفواتير المبسطة.
• اتصال بالإنترنت واستدعاءات API آمنة لمنصة فاتورة، مع تسجيل كل طلب واستجابة.

تسجيل الوحدات والحصول على CSID عبر بوابة فاتورة

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

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

بيئة الاختبار وبوابة المطورين وبوابة المحاكاة

توفّر الهيئة بوابة مطورين عامة تضم بيئة اختبار للربط (Sandbox)، وتوثيق واجهات API، وأداة SDK للتحقق من ملفات XML وتوليد التجزئة ورمز QR وتوقيع فواتير الاختبار. وتتيح بيئة الاختبار تجربة استدعاءات التسجيل والامتثال والاعتماد والإبلاغ دون المساس بالبيانات الفعلية، علمًا أن شهادات CSID الصادرة منها لا تُستخدم في الإنتاج.

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

ثلاثة خيارات لربط نظام المحاسبة مع الزكاة

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

خطة مشروع الربط مع منصة فاتورة وقائمة التحقق

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

• حصر كل نظام وقناة تصدر فواتير أو إشعارات دائنة أو مدينة، لكل رقم ضريبي وفرع.
• تنظيف البيانات الأساسية: الأرقام الضريبية للمشترين، والسجل التجاري وحقول العنوان لعملاء B2B، وفئات الضريبة للأصناف وأسباب الإعفاء.
• مطابقة كل سيناريو فوترة (ضريبية، مبسطة، دائن، مدين، دفعة مقدمة، تصدير، نسبة صفرية، معفاة) مع قاموس بيانات الهيئة.
• اختيار طريقة الربط وتحديد مسؤولين من المالية وتقنية المعلومات والمورد.
• تصميم إدارة سلسلة التجزئة والعدّاد وUUID لكل وحدة EGS، مع طابور إعادة محاولة وتنبيهات للإرسال الفاشل أو المتأخر.
• حماية المفاتيح الخاصة ومعرّفات CSID، وتقييد الوصول إليها، وتسجيل تواريخ انتهائها.
• الاختبار في بيئة الاختبار، ثم تنفيذ الدورة كاملة في بوابة المحاكاة بسيناريوهات حقيقية.
• تسجيل وحدات الإنتاج برموز OTP، واجتياز فحوصات الامتثال، والحصول على CSID الإنتاج.
• تدريب الموظفين على التصحيح بالإشعارات الدائنة والمدينة، والتعامل مع الرفض، وإجراء التعطل.
• التشغيل الفعلي، ومراقبة الأخطاء والتحذيرات يوميًا في الأسابيع الأولى، ومطابقة ما أُرسل لمنصة فاتورة مع بيانات إقرار ضريبة القيمة المضافة.

الأخطاء الشائعة وأسباب رفض الفواتير وكيف تتجنبها

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

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

• رقم ضريبي للمشتري ناقص أو بصيغة خاطئة، أو عنوان غير مكتمل في الفواتير الضريبية.
• عدم تطابق الحسابات والتقريب بين إجماليات البنود والضريبة وإجمالي الفاتورة.
• ترتيب خاطئ لوسوم XML، أو غياب عناصر UBL إلزامية، أو أخطاء المخطط (XSD).
• انكسار سلسلة التجزئة بعد استعادة نسخة احتياطية، أو وجود تسلسل ثانٍ، أو عمليات متوازية تكتب على وحدة EGS واحدة.
• بناء رمز QR بشكل غير صحيح، مثل كتابة القيم نصًا بدل قيم TLV ثنائية، أو عدم ترميز النص العربي بـ UTF-8.
• استخدام CSID خاطئ أو منتهٍ، أو استخدام شهادة بيئة الاختبار في الإنتاج.
• اختلاف ساعة الخادم: تغيير تاريخ ووقت الحل الإلكتروني من الوظائف المحظورة.

حفظ البيانات والأمان والغرامات

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

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

كيف يساعدك فريق ITCM في الربط مع منصة فاتورة؟

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

تبدأ كل خدماتنا من 100 دولار (375 ريالًا)، والمشاريع الأكبر تُسعَّر لكل مشروع وتُسلَّم على مراحل، ويُتفق على السعر أولًا دون أي دفعة مقدمة: تدفع بعد مراجعة العمل. وفريق ITCM ليس مزود حلول معتمدًا من الهيئة، لكننا نعمل وفق المواصفات المنشورة للهيئة ونتحقق من كل تطوير باستخدام أداة SDK وبيئة الاختبار الخاصة بها قبل التشغيل. احجز مكالمة مجانية لمناقشة موجتك وأنظمتك.

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

ما هي المرحلة الثانية من الفوترة الإلكترونية؟

هي مرحلة الربط والتكامل، وتُطبَّق على موجات منذ 1 يناير 2023. تلتزم المنشآت المبلَّغة بربط حل الفوترة لديها مع منصة فاتورة، وإرسال الفواتير الضريبية للاعتماد قبل مشاركتها، وإبلاغ الفواتير المبسطة خلال 24 ساعة.

كيف أعرف موعد ربط منشأتي مع منصة فاتورة؟

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

ما الفرق بين الاعتماد والإبلاغ؟

الاعتماد يخص الفواتير الضريبية، وغالبًا B2B وB2G: تتحقق الهيئة من الفاتورة وتختمها قبل مشاركتها مع المشتري. والإبلاغ يخص الفواتير المبسطة، وغالبًا B2C: تسلّم الفاتورة للعميل أولًا ثم تبلّغ الهيئة خلال 24 ساعة.

ما هو CSID وكيف أحصل عليه؟

معرّف ختم التشفير هو الشهادة التي توثّق كل وحدة فوترة لدى الهيئة. تولّد رمز OTP من بوابة فاتورة، وتدخله في نظامك، وتجتاز فحوصات الامتثال باستخدام CSID الامتثال، ثم تحصل على CSID الإنتاج. وللمعرّف تاريخ انتهاء ويجب تجديده.

هل يمكن إلغاء الفاتورة الإلكترونية أو تعديلها بعد إصدارها؟

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

هل يمكن ربط نظام المحاسبة الحالي مع الزكاة بدل استبداله؟

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

هل توجد بيئة اختبار للربط مع API هيئة الزكاة؟

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

مقالات وخدمات ذات صلة

• النظام المالي المخصص
• خدمات ERP
• دليل تطوير البرامج المحاسبية المخصصة
• قائمة تدقيق نظام ERP
• دليل تطوير البرمجيات المالية المخصصة
• احجز مكالمة مجانية

→ جميع المقالات