هندسة البرمجيات
الربط مع منصة فاتورة: تطبيق المرحلة الثانية من الفوترة الإلكترونية لأنظمة ERP ونقاط البيع والأنظمة المخصّصة
الربط مع منصة فاتورة لأنظمة ERP ونقاط البيع والفوترة والمتاجر الإلكترونية: XML بمعيار UBL 2.1، وختم التشفير، والحصول على CSID، والاعتماد والإبلاغ وفق المرحلة الثانية.
أبرز النقاط
- بدأ إلزام المرحلة الأولى (الإصدار والحفظ) في 4 ديسمبر 2021، وتُطبَّق المرحلة الثانية (الربط والتكامل) على مجموعات منذ 1 يناير 2023.
- أعلنت الهيئة في 24 يوليو 2026 المجموعة الخامسة والعشرين: المنشآت التي تجاوزت إيراداتها الخاضعة للضريبة 187,500 ريال خلال 2022–2025، ابتداءً من 1 فبراير 2027.
- الفواتير الضريبية بين المنشآت تُعتمد من الهيئة قبل وصولها للمشتري، والفواتير المبسطة يُبلَّغ عنها خلال 24 ساعة.
- تحتاج كل وحدة فوترة إلى معرّف ختم تشفير (CSID) من بوابة فاتورة واجتياز فحوص الامتثال قبل التشغيل.
- تبدأ الغرامات المعلنة من 5,000 ريال لعدم إصدار الفواتير إلكترونياً و10,000 ريال لحذفها أو تعديلها.
الربط مع منصة فاتورة هو توصيل نظام الفوترة في منشأتك، سواء كان نظام ERP أو منصة فوترة أو نقاط بيع أو متجراً إلكترونياً، بمنصة "فاتورة" التابعة لهيئة الزكاة والضريبة والجمارك، بحيث تصدر كل فاتورة إلكترونية بصيغة XML المعتمدة، وتحمل ختم التشفير، ويتم اعتمادها أو الإبلاغ عنها وفق متطلبات المرحلة الثانية.
تصمّم أمواج للحلول هذا الربط وتبنيه وتدعمه للأنظمة المخصّصة وأنظمة المنشآت الكبيرة في المملكة، من تطبيق فوترة واحد إلى بيئات ERP متعددة الكيانات والفروع ونقاط البيع. في هذه الصفحة نشرح متطلبات المرحلة الثانية من الفوترة الإلكترونية، ومن يلزمه الربط ومتى، وكيف يُنفَّذ المشروع. المواعيد النظامية محدّثة حتى أكتوبر 2026.
ما الفرق بين المرحلة الأولى والمرحلة الثانية من الفوترة الإلكترونية؟
بحسب هيئة الزكاة والضريبة والجمارك، بدأ إلزام المرحلة الأولى (مرحلة الإصدار والحفظ) في 4 ديسمبر 2021، وتلزم المكلفين المقيمين بإصدار الفواتير والإشعارات الدائنة والمدينة وحفظها عبر حل إلكتروني متوافق، ولا تُعد الفاتورة الورقية الممسوحة ضوئياً فاتورة إلكترونية. أما المرحلة الثانية (مرحلة الربط والتكامل) فبدأت في 1 يناير 2023 وتُطبَّق على مجموعات، وتشترط ربط الحل الإلكتروني بأنظمة الهيئة وإصدار الفواتير بصيغة محددة مع عناصر إضافية.
| المتطلب | المرحلة الأولى: الإصدار والحفظ | المرحلة الثانية: الربط والتكامل |
|---|---|---|
| تاريخ الإلزام | 4 ديسمبر 2021 | من 1 يناير 2023 على مجموعات |
| المشمولون | جميع المكلفين المقيمين المسجلين في ضريبة القيمة المضافة ومن يصدر الفواتير نيابة عنهم | المنشآت التي تبلغها الهيئة بانضمامها إلى إحدى المجموعات |
| صيغة الفاتورة | إلكترونية عبر حل متوافق، دون صيغة ملف محددة | XML مبنية على UBL 2.1، أو PDF/A-3 يتضمن ملف XML |
| الاتصال بالهيئة | لا يوجد | ربط عبر واجهات برمجية (API) مع منصة فاتورة |
| الفاتورة الضريبية (B2B) | تصدر وتُرسل للمشتري مباشرة | تُعتمد من الهيئة قبل مشاركتها مع المشتري |
| الفاتورة الضريبية المبسطة (B2C) | تصدر مع رمز الاستجابة السريعة (QR) | تُسلَّم للعميل ثم يُبلَّغ عنها خلال 24 ساعة |
| عناصر الأمان | منع التعديل أو الحذف بعد الإصدار | ختم التشفير، وسلسلة تجزئة الفواتير، وعدّاد الفواتير، والمعرّف الفريد UUID |
| تهيئة الأجهزة | غير مطلوبة | تهيئة كل وحدة فوترة عبر بوابة فاتورة للحصول على معرّف ختم التشفير (CSID) |
للاطلاع على صورة أشمل للأنظمة، راجع دليلنا للفاتورة الإلكترونية في السعودية.
من يلزمه الربط مع هيئة الزكاة، ومتى؟
تحدد الهيئة كل مجموعة بحسب الإيرادات الخاضعة لضريبة القيمة المضافة، وتُبلغ المنشآت المستهدفة قبل موعد الربط بستة أشهر على الأقل. شملت المجموعة الأولى، ابتداءً من 1 يناير 2023، المنشآت التي تجاوزت إيراداتها الخاضعة للضريبة 3 مليارات ريال في 2021، ثم انخفض الحد تدريجياً:
| المجموعة | الإيرادات الخاضعة للضريبة أكثر من | سنوات الاحتساب | موعد الربط |
|---|---|---|---|
| الأولى | 3 مليارات ريال | 2021 | ابتداءً من 1 يناير 2023 |
| الثانية والعشرون | مليون ريال | 2022–2024 | حتى 31 ديسمبر 2025 |
| الثالثة والعشرون | 750,000 ريال | 2022–2024 | حتى 31 مارس 2026 |
| الرابعة والعشرون | 375,000 ريال | 2022–2024 | حتى 30 يونيو 2026 |
| الخامسة والعشرون | 187,500 ريال | 2022 أو 2023 أو 2024 أو 2025 | ابتداءً من 1 فبراير 2027 |
أعلنت الهيئة معيار المجموعة الخامسة والعشرين في 24 يوليو 2026، وهي أول مجموعة تُحتسب فيها إيرادات 2025، ما يعني أن منشآت تأسست في 2025 قد تكون مشمولة. وإن كانت منشأتك ضمنها، فالموعد العملي أبكر من موعد الربط، لأن التطوير والاختبار في البيئة التجريبية والتهيئة يجب أن تكتمل قبله.
ما الفرق بين اعتماد الفواتير والإبلاغ عنها؟
الاعتماد (Clearance): الفواتير الضريبية بين المنشآت والجهات الحكومية
يُنشئ نظامك الفاتورة ويرسلها إلى الهيئة لحظياً عبر الواجهة البرمجية، فتتحقق منها الهيئة وتضع ختمها وتعيدها. ولا يجوز مشاركة الفاتورة مع المشتري إلا بعد اعتمادها. وتسري الآلية نفسها على الإشعارات الدائنة والمدينة المرتبطة بالفواتير الضريبية.
الإبلاغ (Reporting): الفواتير الضريبية المبسطة للمستهلكين
تُوقَّع الفاتورة بختم التشفير الخاص بمنشأتك وتُسلَّم للعميل عند البيع، ثم يُبلَّغ عنها إلى الهيئة خلال 24 ساعة. هذا يحافظ على سرعة البيع في التجزئة والمطاعم والمتاجر الإلكترونية، لكنه يتطلب نظاماً يجدول الإرسال ويعيد المحاولة ويراقب الحالة بدقة.
ما الذي يجعل فاتورة المرحلة الثانية متوافقة تقنياً؟
- ملف XML بمعيار UBL 2.1 مع الامتدادات وقواعد الأعمال الخاصة بالمملكة، بما فيها رموز نوع الفاتورة والمعاملة الصحيحة.
- ختم التشفير: توقيع رقمي بخوارزمية ECDSA بمفتاح خاص يحتفظ به الحل، ويُمنع تصديره، لذا فإن تخزين المفتاح قرار أمني في التصميم لا تفصيل لاحق.
- سلسلة التجزئة والعدّاد: تحمل كل فاتورة قيمة تجزئة الفاتورة السابقة وعدّاداً تسلسلياً، فيُكتشف أي نقص أو تغيير في الترتيب.
- رمز الاستجابة السريعة (QR): مرمّز بصيغة TLV وBase64، ويتضمن في المرحلة الثانية بيانات التجزئة والتوقيع.
- الحفظ: أرشفة ملف XML المختوم، أو ملف PDF/A-3 يتضمنه، طوال المدة النظامية.
كيف تتم تهيئة الأجهزة والحصول على CSID عبر بوابة فاتورة؟
- تسجيل الدخول إلى بوابة فاتورة وإنشاء رمز تحقق لمرة واحدة (OTP) لكل وحدة فوترة. صلاحية الرمز قصيرة، لذا نُعدّ خطوات التهيئة مسبقاً.
- إنشاء طلب توقيع شهادة (CSR) من الوحدة يتضمن الرقم الضريبي وبيانات الوحدة.
- إرسال الطلب مع رمز التحقق للحصول على معرّف ختم التشفير الخاص بالامتثال.
- اجتياز فحوص الامتثال لدى الهيئة بإرسال نماذج من كل نوع فاتورة وإشعار ستصدره.
- طلب معرّف ختم التشفير للإنتاج والانتقال إلى بيئة التشغيل الفعلية.
- مراقبة تاريخ انتهاء الشهادة وتجديدها قبل انتهائها حتى لا يتوقف الإرسال.
ما الأنظمة التي تربطها أمواج مع منصة فاتورة؟
- أنظمة تخطيط الموارد (ERP): عبر إضافات مدمجة أو طبقة تكامل وسيطة بين النظام ومنصة فاتورة. نقارن بين الأسلوبين في مقالنا عن ربط أنظمة المنشآت مع هيئة الزكاة.
- أنظمة الفوترة المخصّصة ومنصات SaaS: بناء منطق XML والتوقيع ورمز QR والواجهات البرمجية داخل نظامك، مع فصل واضح يحصر أثر أي تحديث مستقبلي في مواصفات الهيئة.
- أنظمة نقاط البيع: طوابير إبلاغ تتحمّل انقطاع الاتصال للفواتير المبسطة في جميع الفروع. راجع دليلنا عن أنظمة نقاط البيع المتوافقة مع هيئة الزكاة.
- المتاجر الإلكترونية: إصدار الفواتير المرتبط بأحداث الطلب والاسترجاع والدفع.
وحين تكون الفوترة جزءاً من منصة أكبر، يتكامل هذا العمل غالباً مع خدماتنا في أنظمة ERP والبرمجيات المخصّصة.
ما مراحل مشروع الربط مع منصة فاتورة؟
- تحديد النطاق وتحليل الفجوات: أنواع الفواتير وأحجامها والفروع والأنظمة وجودة البيانات، مقارنةً بحقول المرحلة الثانية.
- تصميم البنية: ربط مدمج أم طبقة وسيطة، وعدد وحدات الفوترة، وتخزين المفاتيح، ومعالجة الأعطال.
- التطوير: مطابقة البيانات، وإنشاء XML، والتوقيع، ورمز QR، وواجهات الاعتماد والإبلاغ، وسجل تدقيق كامل.
- الاختبار في البيئة التجريبية: التحقق من كل سيناريو للفواتير والإشعارات في بيئة الهيئة التجريبية.
- التهيئة: إصدار معرّفات ختم التشفير واجتياز فحوص الامتثال لكل وحدة.
- الإطلاق والمراقبة: لوحات متابعة للرفض والتحذيرات والفواتير المتأخرة في الإبلاغ.
- الدعم المستمر: تجديد الشهادات ومواكبة تحديثات مواصفات الهيئة.
ما أكثر أسباب رفض الفواتير شيوعاً؟
- غياب الرقم الضريبي للمشتري أو خطأ صيغته في الفواتير الضريبية.
- عدم تطابق مجاميع البنود والضريبة والتقريب مع إجمالي الفاتورة.
- انقطاع سلسلة التجزئة أو فجوات في العدّاد، غالباً بسبب الإصدار المتوازي أو ترحيل البيانات.
- فشل التوقيع بسبب تعديل المستند بعد حساب التجزئة، أو استخدام معرّف الامتثال في بيئة الإنتاج.
- إشعارات دائنة أو مدينة لا تشير إلى الفاتورة الأصلية بشكل صحيح.
- الإبلاغ عن الفواتير المبسطة بعد انقضاء مهلة 24 ساعة.
تفرّق ردود الهيئة بين التحذيرات، التي تُقبل معها الفاتورة، والأخطاء التي تُرفض بسببها. ونحن نتعامل مع الاثنين بوصفهما أحداثاً تخضع للمراقبة، لا سجلات مهملة.
ما غرامات مخالفة الفوترة الإلكترونية؟
حددت قائمة مخالفات وغرامات الفوترة الإلكترونية التي أعلنتها الهيئة في 16 نوفمبر 2021 غرامة تبدأ من 5,000 ريال لعدم إصدار الفواتير إلكترونياً، ومن 10,000 ريال لحذف الفواتير الإلكترونية أو تعديلها بعد إصدارها. أما عدم إضافة رمز QR للفاتورة المبسطة، وعدم تضمين الرقم الضريبي للمشتري في الفاتورة الضريبية، وعدم إبلاغ الهيئة بأي عطل يعيق الإصدار، فتبدأ بإنذار. وتتصاعد الغرامات مع تكرار المخالفة. وفي المرحلة الثانية هناك كلفة تشغيلية أيضاً: الفاتورة الضريبية التي لا تُعتمد لا يمكن إرسالها للعميل، فيتأخر التحصيل.
ولأن مفتاح الختم وبيانات الفواتير حساسة، نصمّم الربط بالمعايير نفسها التي نطبّقها في خدمات الأمن السيبراني والامتثال، ونتابع تفاصيل مراحل التطبيق كما تنشرها الهيئة.
الخطوة التالية: اطلب استشارة وأرسل لنا أنظمتك وحجم فواتيرك وإشعار المجموعة إن وصلك، وسنرد خلال 24–48 ساعة عمل بخطة لنطاق المشروع.
الربط مع منصة فاتورة (الفوترة الإلكترونية)
الأسئلة الشائعة
من المنشآت الملزمة بالمرحلة الثانية من الفوترة الإلكترونية؟
تنطبق المرحلة الثانية على المكلفين المقيمين المسجلين في ضريبة القيمة المضافة على مجموعات تُحدَّد بحسب الإيرادات الخاضعة للضريبة، وتُبلغ الهيئة كل مجموعة قبل موعد ربطها بستة أشهر على الأقل. وحتى أكتوبر 2026، تشمل أحدث مجموعة معلنة، وهي الخامسة والعشرون، المنشآت التي تجاوزت إيراداتها 187,500 ريال في 2022 أو 2023 أو 2024 أو 2025، ابتداءً من 1 فبراير 2027.
ما الفرق بين الاعتماد والإبلاغ في الفاتورة الإلكترونية؟
الاعتماد يخص الفواتير الضريبية بين المنشآت ومع الجهات الحكومية، إذ تُرسل الفاتورة إلى الهيئة لحظياً ولا تُشارك مع المشتري إلا بعد التحقق منها وختمها. أما الإبلاغ فيخص الفواتير الضريبية المبسطة للمستهلكين، حيث تُسلَّم الفاتورة للعميل فوراً ثم يُبلَّغ عنها إلى الهيئة خلال 24 ساعة.
ما هو معرّف ختم التشفير CSID وكيف أحصل عليه؟
معرّف ختم التشفير شهادة تصدرها الهيئة لكل وحدة فوترة إلكترونية لتتمكن من توقيع الفواتير والاتصال بواجهات منصة فاتورة. تُنشئ رمز تحقق لمرة واحدة من بوابة فاتورة، ثم ترسل طلب توقيع شهادة للحصول على معرّف الامتثال، وتجتاز فحوص الامتثال بنماذج فواتير، ثم تطلب معرّف الإنتاج.
هل يمكن جعل نظام ERP أو نقاط البيع الحالي متوافقاً مع المرحلة الثانية؟
غالباً نعم. بعض أنظمة ERP ونقاط البيع توفر وحدات جاهزة للمرحلة الثانية، وبعضها يحتاج إضافة مخصّصة أو طبقة وسيطة تُنشئ ملف XML وتضع ختم التشفير وتتولى الاعتماد والإبلاغ. ويعتمد الأسلوب المناسب على إصدار النظام، وعدد الفروع والأجهزة التي تصدر الفواتير، ومدى التحكم الذي تحتاجه في معالجة الأخطاء.
ماذا يحدث إذا رفضت منصة فاتورة الفاتورة؟
الفاتورة الضريبية المرفوضة لا تُعتمد، فلا يمكن إرسالها للمشتري حتى يُصحَّح الخطأ وتُرسل من جديد. والفواتير المبسطة المرفوضة يجب تصحيحها والإبلاغ عنها وفق القواعد. أما التحذيرات فلا تمنع القبول لكن يُستحسن معالجتها. والربط الجيد يعرض الحالتين في لوحة متابعة واضحة بدلاً من سجلات لا يراجعها أحد.
ما غرامات عدم الالتزام بالفوترة الإلكترونية في السعودية؟
حددت قائمة المخالفات المنشورة من هيئة الزكاة والضريبة والجمارك غرامة تبدأ من 5,000 ريال لعدم إصدار الفواتير إلكترونياً، ومن 10,000 ريال لحذفها أو تعديلها بعد الإصدار. وبعض المخالفات، مثل غياب رمز QR في الفاتورة المبسطة أو الرقم الضريبي للمشتري، تبدأ بإنذار، وتتصاعد الغرامات مع التكرار.
كم يستغرق مشروع الربط مع منصة فاتورة؟
يعتمد ذلك على عدد الأنظمة وأنواع الفواتير والفروع والأجهزة، وعلى جودة البيانات. فربط نظام فوترة مخصّص واحد أسرع بكثير من ربط بيئة ERP متعددة الكيانات مع عشرات أجهزة نقاط البيع. خطّط لإنهاء التطوير والاختبار التجريبي والحصول على معرّفات التشفير قبل موعد مجموعتك بوقت كافٍ، لا في يومه.