دليل · السعودية

ربط نظام الكاشير والمحاسبة بالفاتورة الإلكترونية في زاتكا (المرحلة الثانية)

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

من يجب أن يربط، ومتى

مرحلة الإصدار والحفظ (المرحلة الأولى) سارية من 4 ديسمبر 2021. مرحلة الربط والتكامل (المرحلة الثانية) تأتي على مجموعات، ويسميها الناس موجات. الهيئة تحدد كل مجموعة حسب الإيراد الخاضع للضريبة، وتبلّغ أصحابها قبل الموعد بستة أشهر على الأقل، عبر البريد الإلكتروني ورسائل SMS المسجلة لديها.

المجموعة 24 (الموجة 24): إيراد خاضع للضريبة فوق 375,000 ريال في 2022 أو 2023 أو 2024. آخر موعد كان 30 يونيو 2026، وفات.
المجموعة 25 (الموجة 25): إيراد خاضع للضريبة فوق 187,500 ريال في أي سنة من 2022 إلى 2025. الهيئة حددت موعد الربط: 1 فبراير 2027.

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

الاعتماد والإرسال

لكل نوع من الفواتير طريق. أدلة الهيئة تكتب «الفاتورة الضريبية (B2B)» و«الفاتورة المبسطة (B2C)»، والاسم القانوني الفاتورة الضريبية والفاتورة الضريبية المبسطة. والإشعارات الدائنة والمدينة تمشي على طريق الفاتورة اللي ترتبط بها.

الاعتماد (Clearance) للفاتورة الضريبية. ترسلها للهيئة قبل أن تصل للمشتري. الهيئة تفحصها، وتضع عليها ختم التشفير الخاص بها، وترجعها مع رمز الاستجابة السريعة. الفاتورة ما تصير صالحة إلا بعد الاعتماد.
الإرسال (Reporting) للفاتورة الضريبية المبسطة. العميل يستلم الفاتورة مباشرة، ونظامك يرسلها للهيئة خلال 24 ساعة من إصدارها. الهيئة ما تختمها، فنظامك يضع ختم التشفير ورمز الاستجابة السريعة بنفسه.

المستندات تروح للهيئة بصيغة XML. ونسخة العميل ممكن تكون XML أو PDF/A-3 فيه ملف XML مدمج.

خطوات التسجيل بكلام بسيط

كل وحدة تصدر فواتير (جهاز أو سيرفر، ولها تسلسل فواتير واحد، وتسميها الهيئة EGS) تمشي على نفس الخطوات.

كلمة المرور لمرة واحدة (OTP). شخص عندك ينشئها في منصة فاتورة. صالحة لمدة ساعة، وما في API لها، فهذه الخطوة تبقى يدوية.
طلب توقيع الشهادة (CSR). الوحدة تنشئ زوج مفاتيح وترسل الطلب. كل الحقول إلزامية: الرقم الضريبي من 15 رقم، والرقم التسلسلي للوحدة، والفرع، ونوع الفواتير (ضريبية أو مبسطة أو الاثنين). أي حقل ناقص ممكن يرفض الطلب.
شهادة الفحص (Compliance CSID). الهيئة ترد بشهادة تسمح للوحدة بتشغيل فحوصات التوافق.
فحوصات التوافق. الوحدة ترسل مستندات تجريبية: فاتورة ضريبية وإشعار مدين وإشعار دائن، أو النسخ المبسطة منها، حسب النوع اللي تصدره. إذا فشل مستند واحد، تبدأ من جديد بـ OTP وCSR جديدين.
شهادة الإنتاج (Production CSID). بعد نجاح الفحوصات، الهيئة تصدرها، والوحدة تستخدمها للدخول على واجهات الإنتاج. مدتها تصل إلى 5 سنوات، والتجديد يلغي الشهادة القديمة.

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

ما يحمله كل مستند

رقم التعريف الموحد (UUID). رقم فريد من 128 بت ينشئه النظام لكل مستند، غير رقم الفاتورة التسلسلي.
عداد الفواتير (ICV). رقم يزيد واحد مع كل مستند. الهيئة تقول إن قيمة العداد ما تذكر على مستند ثاني.
دالة التشفير للفاتورة السابقة (PIH). كل مستند يحمل قيمة hash بصيغة SHA-256 للمستند اللي قبله في تسلسل الوحدة. هكذا تتكون سلسلة، ولو حذفت فاتورة أو بدلتها تنكسر. أول مستند يستخدم قيمة بداية ثابتة.
ختم التشفير. وحدتك تضعه على الفاتورة المبسطة. أما الفاتورة الضريبية فالهيئة تضع ختمها عند الاعتماد.
رمز الاستجابة السريعة (QR). فيه خمسة حقول من المرحلة الأولى: اسم البائع، والرقم الضريبي، والوقت، والإجمالي مع الضريبة، والضريبة. والمرحلة الثانية تضيف أربعة: hash ملف XML، والتوقيع، والمفتاح العام، وللفاتورة المبسطة توقيع الهيئة على مفتاح الختم.

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

كيف يرتبط نظام كاشير أو محاسبة سحابي

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

الوسيط يسحب كل عملية بيع من API النظام، أو يستقبلها عبر webhook عند اكتمال البيع أو المرتجع أو الإلغاء. ويحتاج كل سطر، وفئة الضريبة لكل سطر، وبيانات العميل في الفواتير الضريبية، ومرجع الفاتورة الأصلية للمرتجعات.
وحدة الإصدار في الربط الوسيط هي سيرفر الوسيط نفسه، وهو اللي يحمل الشهادة، وشهادة واحدة لكل تسلسل فواتير.
الوحدة تمشي على خطوات التسجيل أعلاه: OTP، ثم CSR، ثم فحوصات التوافق، ثم شهادة الإنتاج.
الوسيط يبني كل مستند بصيغة XML من نوع UBL 2.1 حسب معيار الهيئة، مع UUID وقيمة العداد التالية وPIH. الفاتورة المبسطة يختمها ويبني رمز QR ويرجعه للكاشير ليظهر على الإيصال، ثم يرسلها للهيئة خلال 24 ساعة. والفاتورة الضريبية يرسلها للاعتماد قبل أن تصل للمشتري، ثم يرجع XML المختوم من الهيئة مع رمز QR لنظام الكاشير أو المحاسبة.
الوسيط يحفظ الردود: XML المرسل، ورد الهيئة، والتحذيرات، وXML المعتمد. على صاحب المنشأة حفظ الفواتير وبياناتها، والهيئة تحقق في التحذيرات المتكررة، فالتحذيرات تستاهل المتابعة.
إعادة المحاولة والانقطاع. على أخطاء HTTP 429 و500 و503 و504 يعيد الوسيط إرسال نفس المستند. على 400 يصحح المستند ويرسله كمستند جديد. على 401 يفحص الشهادة. وإذا انقطع الربط وصار يمنعك من الالتزام، عند الهيئة نموذج للإبلاغ عن الأعطال.
المرتجعات تصدر بإشعار دائن يشير إلى الفاتورة الأصلية ويذكر السبب. والفواتير بالسالب ترفضها الهيئة.

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

لما يتعطل الربط

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

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

أسئلة شائعة

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

المرحلة الأولى (مرحلة الإصدار والحفظ) سارية من 4 ديسمبر 2021، وتطلب إصدار الفواتير وحفظها بشكل إلكتروني مع رمز QR على الفواتير المبسطة. المرحلة الثانية (مرحلة الربط والتكامل) تضيف الربط مع منصة فاتورة: الفاتورة الضريبية (B2B) تعتمدها الهيئة قبل ما تصل للمشتري، والفاتورة المبسطة (B2C) ترسلها للهيئة خلال 24 ساعة. وكل مستند XML فيه UUID وسلسلة hash وختم تشفير.

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

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

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

لا تفترض ذلك. الهيئة مددت مبادرة إلغاء الغرامات إلى 31 ديسمبر 2026، لكن إشعارها بتاريخ 29 يونيو 2026 ما يذكر غرامات الفوترة الإلكترونية، ويستثني الغرامات المرتبطة بإقرارات يحل موعدها بعد 30 يونيو 2026. اسأل محاسبك أو الهيئة إذا كانت المبادرة تشمل حالتك.

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

المصادر

معلومات الهيئة في هذه الصفحة من منشوراتها هي، والتواريخ والحدود كما نشرتها وقت آخر مراجعة لنا في 24 أكتوبر 2026. خطوات الخدمة الوسيطة تصف الطريقة اللي نقترحها للربط، وليست مطلوبة من الهيئة.

اعرف ما يحتاجه نظامك قبل الموعد.

ابدأ بجلسة تقييم 30 دقيقة. تطلع منها وأنت تعرف إن كان نظامك الحالي يقبل الربط، وما يلزم لذلك، وكم يكلف، سواء تعاملت معنا أو لا.

احجز تقييم الأتمتة