الربط مع هيئة الزكاة والضريبة والجمارك

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

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

ما معنى «الربط» في المرحلة الثانية من الفوترة الإلكترونية؟

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

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

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

نوعا الفواتير في الربط: المعتمَدة والمبلَّغ عنها

قبل الدخول في تفاصيل التكامل، عليك فهم أن الهيئة تتعامل مع نوعين من الفواتير بطريقتين مختلفتين تمامًا. النوع يحدد مسار الفاتورة داخل عملية الربط.

الفاتورة الضريبية القياسية (B2B): تُستخدم في المعاملات بين المنشآت. تخضع لآلية «الاعتماد» (Clearance). يرسل نظامك الفاتورة إلى منصة فاتورة، تتحقق الهيئة منها وتختمها وتعيدها معتمَدة، وبعدها فقط يمكنك تسليمها للمشتري. هذه عملية لحظية تتم قبل وصول الفاتورة إلى العميل.

الفاتورة الضريبية المبسّطة (B2C): تُستخدم في البيع للمستهلك النهائي. تخضع لآلية «الإبلاغ» (Reporting). يصدر نظامك الفاتورة ويسلّمها للعميل فورًا مع رمز الاستجابة السريعة، ثم يبلّغ الهيئة بها خلال 24 ساعة. لا تنتظر اعتمادًا مسبقًا.

الفارق مهم في تصميم الربط. فواتير B2B تتطلب اتصالًا متزامنًا وانتظار ردّ الهيئة قبل إتمام البيع، بينما فواتير B2C تسمح بإتمام البيع أولًا ثم الإبلاغ لاحقًا. تعرّف على التفاصيل في دليل أنواع الفواتير الإلكترونية.

المكوّنات التقنية للفاتورة المربوطة

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

• الختم التشفيري (Cryptographic Stamp): توقيع رقمي يُنشأ باستخدام شهادة بنية المفتاح العام (PKI) الصادرة عن الهيئة. يثبت أن الفاتورة صادرة من نظام مصرّح له.
• المعرّف الفريد (UUID): رقم تعريفي فريد لكل فاتورة، يمنع التكرار ويتيح التتبع.
• تجزئة الفاتورة السابقة (Hash): بصمة رقمية للفاتورة التي سبقتها، تربط الفواتير في سلسلة متصلة تمنع الحذف أو التلاعب.
• رمز الاستجابة السريعة (QR Code): يحوي بيانات الفاتورة والتوقيع، ويتيح التحقق الفوري من صحتها.
• التنسيق المهيكل: الفاتورة تُولَّد بصيغة XML وفق معيار UBL 2.1 الذي اعتمدته الهيئة، لا بصيغة PDF عادية.

هذه العناصر لا تُكتب يدويًا. يولّدها النظام تلقائيًا في كل فاتورة وفق مواصفات الهيئة. أي خطأ في توليدها يعني رفض الفاتورة من منصة فاتورة.

كيف يتم الربط تقنيًا عبر واجهة برمجة التطبيقات (API)؟

الربط في جوهره هو حوار آلي بين نظامك وخوادم الهيئة عبر واجهة برمجة التطبيقات. تتيح الهيئة مجموعة من نقاط النهاية (API endpoints) التي يستدعيها نظامك في مراحل مختلفة. فهم هذه النقاط يوضّح ما يحدث خلف الكواليس في كل عملية بيع.

1. نقطة الامتثال (Compliance)

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

2. نقطة الإصدار (Onboarding وإصدار الشهادة)

هنا يطلب نظامك شهادة CSID من الهيئة. يبدأ بإنشاء طلب توقيع شهادة (CSR) يحوي بيانات المنشأة، ثم يرسله مع رمز التفعيل (OTP) الذي تحصل عليه من بوابة فاتورة. ترد الهيئة بالشهادة التي يستخدمها النظام لتوقيع كل فاتورة لاحقة.

3. نقطة الاعتماد (Clearance) للفواتير القياسية

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

4. نقطة الإبلاغ (Reporting) للفواتير المبسّطة

عند إصدار فاتورة B2C، يسلّمها النظام للعميل فورًا، ثم يبلّغ الهيئة بها عبر نقطة الإبلاغ خلال 24 ساعة. ترد الهيئة بإقرار الاستلام.

كل هذه الاستدعاءات تتم في الخلفية خلال أجزاء من الثانية في نظام مصمَّم جيدًا. الكاشير أو المحاسب لا يرى منها شيئًا سوى ظهور رمز QR والختم على الفاتورة النهائية.

شهادة CSID: حجر الأساس في الربط

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

تمرّ الشهادة بدورة حياة واضحة:

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

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

الخطوات العملية للربط خطوة بخطوة

إذا أردت أن تصف عملية الربط لمدير تقنية المعلومات في منشأتك، فهذه هي الخطوات بالترتيب الذي تحدث به فعليًا:

الخطوة 1: التأكد من جاهزية النظام

تحقق من أن نظامك المحاسبي يدعم المرحلة الثانية فعلًا. يجب أن يولّد XML وفق UBL 2.1، ويدعم التوقيع التشفيري، وإدارة شهادات CSID، والاتصال بنقاط الـ API. النظام الذي يصدر فواتير PDF فقط غير مؤهّل للربط.

الخطوة 2: تسجيل الدخول إلى بوابة فاتورة

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

الخطوة 3: إنشاء وإصدار شهادة CSID

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

الخطوة 4: اجتياز اختبار الامتثال

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

الخطوة 5: الانتقال إلى الإنتاج

بعد اجتياز الامتثال، ينتقل النظام إلى البيئة الفعلية. تبدأ الفواتير الحقيقية بالمرور عبر الاعتماد أو الإبلاغ حسب نوعها.

الخطوة 6: المراقبة المستمرة

راقب حالة الفواتير المرسلة، وتعامل مع أي فواتير مرفوضة، وتابع صلاحية الشهادات. الربط ليس حدثًا يحدث مرة واحدة، بل عملية تشغيلية مستمرة.

التحديات الشائعة في عملية الربط

كثير من المنشآت تتعثّر في الربط لأسباب تقنية متكررة. معرفتها مسبقًا توفّر عليك أيامًا من المحاولات الفاشلة:

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

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

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

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

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

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

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

الربط الداخلي مقابل النظام المتوافق: أي طريق تختار؟

أمام المنشأة مساران للربط مع منصة فاتورة. المسار الأول بناء تكامل داخلي خاص يتصل بنقاط الـ API مباشرة. المسار الثاني استخدام نظام محاسبي متوافق يتولى الربط جاهزًا. لكل مسار تكلفته ومتطلباته.

بناء تكامل داخلي يمنحك تحكمًا كاملًا، لكنه يفرض أعباء ثقيلة. تحتاج فريق مطورين يفهم معيار UBL 2.1 والتوقيع التشفيري وبنية المفتاح العام. تحتاج بيئة اختبار، ومتابعة دائمة لكل تحديث تصدره الهيئة، وفريق دعم للتعامل مع الفواتير المرفوضة. أي ثغرة في الكود قد تعطّل الفوترة وتعرّضك لمخالفات.

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

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

ماذا يحدث عند رفض الفاتورة؟

لا تُقبل كل فاتورة من أول محاولة. قد ترفض منصة فاتورة فاتورة لأسباب متعددة، وفهم آلية التعامل مع الرفض جزء أساسي من الربط الناجح.

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

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

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

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

أمان البيانات في عملية الربط

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

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

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

متى تحتاج إلى نظام متوافق فورًا؟

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

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

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

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

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

كيف يساعدك قيود

قيود نظام محاسبي سعودي متوافق مع المرحلة الثانية من الفوترة الإلكترونية. يتولى الربط مع منصة فاتورة بالكامل: إصدار شهادة CSID، التوقيع التشفيري، الاعتماد اللحظي للفواتير القياسية، والإبلاغ خلال 24 ساعة للفواتير المبسّطة. أنت تصدر فاتورة بنقرة، والنظام يتولى التفاصيل التقنية في الخلفية.

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

الأسئلة الشائعة عن الربط مع الهيئة

ما الفرق بين الربط والإصدار الإلكتروني؟
الإصدار الإلكتروني (المرحلة الأولى) يعني توليد الفاتورة رقميًا داخل نظامك دون اتصال بالهيئة. الربط (المرحلة الثانية) يعني اتصال نظامك المباشر بمنصة فاتورة لاعتماد كل فاتورة أو الإبلاغ عنها لحظيًا.

ما هي شهادة CSID؟
هي شهادة رقمية تصدرها الهيئة لكل وحدة إصدار، يستخدمها نظامك لتوقيع الفواتير توقيعًا تشفيريًا تقبله منصة فاتورة. بدونها لا يمكن إصدار فواتير معتمَدة.

هل أحتاج إلى مطوّر لإتمام الربط؟
إذا استخدمت نظامًا محاسبيًا متوافقًا مثل قيود، فلا. يتولى النظام الجانب التقني بالكامل. تحتاج إلى مطوّر فقط إذا اخترت بناء تكامل خاص بنظامك الداخلي.

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

ماذا يحدث إذا انتهت صلاحية شهادة CSID؟
يتوقف نظامك عن إصدار فواتير معتمَدة حتى تجدّد الشهادة. النظام المتوافق يتابع الصلاحية ويجدّد الشهادة قبل انتهائها لتجنّب توقف المبيعات.

هل يقدّم قيود الإقرار الضريبي بدلًا مني؟
لا. يجهّز لك قيود ملخص الإقرار الضريبي (مبيعات الضريبة، ضريبة المدخلات، الصافي المستحق)، لكن رفع الإقرار وسداد الضريبة يتمان عبر بوابة الهيئة بنفسك.

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