قائمة مراجعة التكامل مع ZATCA للشركات التي تستخدم Zoho Books في المملكة العربية السعودية

معظم حالات عدم الامتثال لمتطلبات هيئة الزكاة والضريبة والجمارك (ZATCA) في Zoho Books ليست مشكلات في البرنامج نفسه. إنها مشكلات في الإعداد.

Zoho Books منصة معتمدة من ZATCA. فهي تنشئ ملف XML بالصيغة الصحيحة، وتولّد المعرّفات الفريدة (UUID)، وتطبّق الأختام التشفيرية، وترسل الفواتير إلى بوابة فاتورة في الوقت الفعلي. أي أن المنصة تعمل كما ينبغي.

لكن ما لا يعمل دائماً هو الإعدادات الموجودة خلفها.

• الشركة التي تتخطى خطوة الربط عبر طلب توقيع الشهادة (CSR) لا تستطيع إرسال الفواتير.
• الشركة التي لم تُعدّ حقول عنوان البائع باللغة العربية سيتم رفض جميع فواتيرها.
• الشركة التي تنتقل إلى التشغيل الفعلي دون اختبار في بيئة التجربة (Sandbox) ستكتشف أخطاءها من خلال فواتير مرفوضة على معاملات حقيقية.

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

القسم الأول: المتطلبات قبل التكامل

قبل البدء في Zoho Books، تأكد من توفر ما يلي. غياب أي منها يسبب تأخيرات لا يمكن حلها من داخل البرنامج.

1.1 التسجيل لدى ZATCA

• الشركة مسجلة في ضريبة القيمة المضافة لدى ZATCA وتمتلك رقماً ضريبياً (TRN) صالحاً
• صيغة الرقم الضريبي صحيحة: 15 رقماً يبدأ بالرقم 3 وينتهي بالرقم 3
• الوصول إلى بوابة فاتورة التابعة لـ ZATCA مفعّل وبيانات الدخول متوفرة
• الشركة على علم بتاريخ إشعار الموجة الخاصة بها والموعد النهائي للتكامل
• تم تسجيل فترة الإعفاء من الغرامات لدى ZATCA: ممتدة حالياً حتى 30 يونيو 2026 لشركات الموجة 24

1.2 جاهزية بيانات الشركة

• الاسم القانوني للمنشأة بالعربية: تماماً كما هو مسجل لدى ZATCA
• الاسم القانوني للمنشأة بالإنجليزية
• رقم السجل التجاري (CR)
• رقم التسجيل في ضريبة القيمة المضافة (TRN)
• العنوان المسجل الكامل بالعربية
• المدينة والرمز البريدي
• معرّف نقطة البيع (للشركات ذات الفروع أو المواقع المتعددة)

1.3 التأكد من باقة Zoho Books

• اشتراك Zoho Books على باقة Standard أو أعلى: إمكانية الفوترة الإلكترونية وفق ZATCA متاحة بدءاً من باقة Standard
• المنشأة مُعدّة على نسخة المملكة العربية السعودية: وليس نسخة الإمارات أو النسخة العالمية
• عملة المنشأة مضبوطة على الريال السعودي (SAR)

القسم الثاني: إعداد المنشأة في Zoho Books

فيما يلي قائمة مراجعة إعداد المنشأة في Zoho Books لمتطلبات ZATCA.

2.1 إعداد المنشأة

• موقع النشاط مضبوط على المملكة العربية السعودية: وهذا يفعّل وحدة ضريبة القيمة المضافة الخاصة بـ ZATCA
• الرقم الضريبي (TRN) مُدخل بشكل صحيح في إعدادات المنشأة
• الاسم القانوني بالعربية مُدخل في حقل الاسم العربي: وهو حقل إلزامي من ZATCA على كل فاتورة
• العنوان المسجل بالعربية مُدخل بالكامل: الشارع والحي والمدينة والرمز البريدي جميعها مطلوبة
• تاريخ بداية السنة المالية مضبوط بشكل صحيح
• العملة الأساسية مؤكدة على الريال السعودي (SAR)

2.2 إعداد ضريبة القيمة المضافة

• ضريبة القيمة المضافة مفعّلة في الإعدادات ضمن قسم الضرائب
• النسبة الأساسية مضبوطة على 15%
• فئات الضريبة الصفرية مُعدّة: الصادرات، والنقل الدولي، والخدمات المالية المؤهلة
• فئات الإعفاء مُعدّة عند الحاجة
• إعداد الاحتساب العكسي (Reverse Charge) مفعّل لأنواع المعاملات المنطبقة
• حقل الرقم الضريبي مربوط بسجلات العملاء والموردين

2.3 سجلات العملاء والموردين

• أرقام TRN لجميع العملاء المسجلين في ضريبة القيمة المضافة مُدخلة: إلزامية للفواتير الضريبية القياسية بين الشركات (B2B)
• سجلات العملاء مصنّفة حسب نوع الفاتورة: B2B (فاتورة ضريبية قياسية) أو B2C (فاتورة ضريبية مبسطة)
• أرقام TRN للموردين المسجلين في ضريبة القيمة المضافة مُدخلة
• سجلات الموردين الدوليين محددة بشكل صحيح لمعالجة الاحتساب العكسي

القسم الثالث: الربط مع واجهة ZATCA البرمجية (API)

هذا هو القسم الأكثر أهمية من الناحية التقنية. تربط عملية الربط عبر الواجهة البرمجية Zoho Books ببوابة فاتورة. ويجب إكمال كل خطوة بالتسلسل.

3.1 إنشاء طلب توقيع الشهادة (CSR)

• انتقل في Zoho Books إلى الإعدادات، ثم التكاملات، ثم الفوترة الإلكترونية ZATCA
• أنشئ طلب توقيع الشهادة (CSR) من داخل Zoho Books: لا تنشئه خارج المنصة
• تأكد من أن الـ CSR يتضمن الرقم الضريبي الصحيح واسم المنشأة ومعرّف الجهاز
• نزّل ملف الـ CSR لتقديمه إلى ZATCA

3.2 التقديم عبر بوابة ZATCA

• سجّل الدخول إلى بوابة فاتورة باستخدام بيانات منشأتك
• انتقل إلى قسم الربط (Onboarding) وقدّم ملف الـ CSR
• تصدر ZATCA معرّف الختم التشفيري للامتثال (Compliance CSID): نزّله واحفظه
• أدخل الـ Compliance CSID في Zoho Books لإكمال ربط التكامل

3.3 معرّف الإنتاج (Production CSID)

• بعد تأكيد الـ Compliance CSID، قدّم طلب الحصول على Production CSID من بوابة فاتورة
• أدخل الـ Production CSID في Zoho Books
• تأكد من أن حالة التكامل تظهر “نشط” في إعدادات ZATCA داخل Zoho Books
• دوّن معرّف الجهاز الممنوح: فهو مطلوب لأي إعادة ربط مستقبلية إذا احتاج التكامل إلى إعادة ضبط

القسم الرابع: إعداد قالب الفاتورة

تفرض ZATCA حقولاً محددة على كل فاتورة. وأي فاتورة ينقصها حقل إلزامي سيتم رفضها في بوابة فاتورة. لذا اضبط القوالب قبل بدء الاختبار.

4.1 الحقول الإلزامية في الفاتورة

• رقم الفاتورة: تسلسلي دون أي فجوات
• المعرّف الفريد (UUID): يولّده Zoho Books تلقائياً لكل فاتورة، تأكد من أنه مفعّل
• تاريخ الفاتورة ووقتها: ختم زمني بالصيغة الصحيحة
• رمز نوع الفاتورة: فاتورة ضريبية قياسية (388) للـ B2B، وفاتورة ضريبية مبسطة (381) للـ B2C
• الرقم الضريبي للبائع: يُسحب تلقائياً من إعدادات المنشأة
• اسم البائع بالعربية
• عنوان البائع بالعربية
• الرقم الضريبي للمشتري: مطلوب في جميع الفواتير الضريبية القياسية بين الشركات
• وصف بنود الفاتورة
• سعر الوحدة والكمية لكل بند
• نسبة ضريبة القيمة المضافة لكل بند
• مبلغ ضريبة القيمة المضافة لكل بند
• الإجمالي دون الضريبة
• إجمالي مبلغ الضريبة
• الإجمالي شاملاً الضريبة
• رمز الاستجابة السريعة (QR): يولّده Zoho Books ويتضمن الرقم الضريبي للبائع وإجمالي الفاتورة ومبلغ الضريبة والختم الزمني
• الختم التشفيري: يطبقه Zoho Books عند الاعتماد

4.2 صيغة الفاتورة

• صيغة ملف PDF مضبوطة على PDF/A-3: وفق ما تشترطه لوائح ZATCA
• تأكيد تضمين ملف XML داخل ملف PDF
• المخرجات ثنائية اللغة: الحقول العربية موجودة بجانب الإنجليزية في قالب الفاتورة
• مراجعة قالب الفاتورة من قِبل أحد أعضاء الفريق المالي المطلعين على متطلبات ZATCA قبل بدء الاختبار

4.3 الإشعارات الدائنة والمدينة

• اختبار إعداد الإشعار الدائن: يُولَّد رقم مرجعي للفاتورة (IRN) للإشعارات الدائنة ويجب إرسالها أيضاً إلى بوابة فاتورة
• اختبار إعداد الإشعار المدين: ينطبق عليه المتطلب نفسه
• الإشارة إلى رقم الفاتورة الأصلية في جميع الإشعارات الدائنة والمدينة

القسم الخامس: إعداد تفضيلات الإرسال

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

5.1 تفضيلات الإرسال المتاحة

التفضيل	ماذا يفعل	الأنسب لـ
الإنشاء كمسودة	تُنشأ الفاتورة كمسودة ويتم إرسالها يدوياً عبر زر “إرسال إلى بوابة فاتورة”	الشركات ذات الحجم المنخفض التي تراجع كل فاتورة قبل إرسالها
الإنشاء والإرسال إلى البوابة ثم إرسالها للمشتري	تُرسل الفاتورة إلى بوابة فاتورة تلقائياً عند الاعتماد، ثم تُرسل إلى المشتري	سير عمل B2B القياسي: يضمن إتمام الاعتماد قبل استلام المشتري للفاتورة
الإنشاء والتحصيل والإرسال إلى البوابة ثم إرسالها للمشتري	تُحصَّل الفاتورة وتُرسل إلى البوابة وإلى المشتري تلقائياً	سير عمل الاشتراكات والفوترة المتكررة

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

5.2 إعداد الفواتير المتكررة

• إذا كانت الفواتير المتكررة قيد الاستخدام، تأكد من أن تفضيل الإرسال ينطبق عليها تلقائياً
• اختبر فاتورة متكررة في بيئة التجربة قبل التفعيل في بيئة الإنتاج

القسم السادس: الاختبار في بيئة التجربة (Sandbox)

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

6.1 إعداد بيئة التجربة

• الحصول على بيانات اعتماد بيئة التجربة الخاصة بـ ZATCA من بوابة فاتورة
• إعداد بيئة تجريبية في Zoho Books باستخدام معرّف CSID الخاص ببيئة التجربة
• فصل بيئة التجربة عن بيئة الإنتاج طوال فترة الاختبار

6.2 اختبارات الفاتورة الضريبية القياسية (B2B)

• إنشاء فاتورة اختبار بجميع الحقول الإلزامية مكتملة
• إرسال الفاتورة إلى بيئة التجربة في بوابة فاتورة: تأكيد أن حالة الاعتماد “مقبولة”
• تنزيل الفاتورة المعتمدة ومراجعتها: التأكد من وجود رمز QR والختم التشفيري والـ UUID
• اختبار الرفض: إرسال فاتورة بخطأ معروف (صيغة رقم ضريبي خاطئة): استلام الرفض وتدوين رسالة الخطأ
• اختبار التصحيح وإعادة الإرسال: تصحيح الفاتورة وإعادة إرسالها بنجاح

6.3 اختبارات الفاتورة الضريبية المبسطة (B2C)

• إنشاء فاتورة ضريبية مبسطة
• إرسال الفاتورة إلى العميل (أو إلى مستلم تجريبي)
• إرسال الفاتورة إلى بيئة التجربة في بوابة فاتورة خلال 24 ساعة: تأكيد حالة الإبلاغ
• التأكد من وجود رمز QR في الفاتورة المبسطة

6.4 اختبارات الإشعارات الدائنة والمدينة

• إنشاء إشعار دائن مقابل فاتورة اختبار
• إرسال الإشعار الدائن إلى بيئة التجربة: توليد IRN وتأكيد الاعتماد
• اختبار الإشعار المدين بالطريقة نفسها

6.5 اختبارات الحالات الخاصة

• فاتورة ببنود ذات ضريبة صفرية: مبلغ الضريبة صفر ويتم توليد رمز QR مع ذلك
• فاتورة بالعربية فقط: جميع الحقول العربية الإلزامية تظهر بشكل صحيح
• فاتورة ببنود متعددة بنسب ضريبة مختلفة
• فاتورة بقيمة كبيرة: عدم وجود مشكلات في تنسيق الأرقام داخل ملف XML

القسم السابع: الاستعداد للتشغيل الفعلي

وأخيراً، قائمة المراجعة قبل التشغيل الفعلي لضمان عدم حدوث أي مشكلة.

7.1 الانتقال إلى بيئة الإنتاج

• استبدال CSID بيئة التجربة بـ Production CSID في إعدادات ZATCA داخل Zoho Books
• التأكد من أن حالة التكامل “نشط” في بيئة الإنتاج
• إبلاغ الفريق المالي بتاريخ التشغيل الفعلي وسير عمل الفواتير الجديد

7.2 تدريب الموظفين

• تدريب الفريق المالي على تفضيل الإرسال المستخدم
• معرفة الفريق بشكل رسالة رفض الفاتورة وكيفية معالجتها
• تحديد مسار تصعيد واضح: من يجب التواصل معه إذا فشل الإرسال وتعذر حله داخلياً
• مراجعة الحقول العربية في قوالب الفواتير من قِبل أحد أعضاء الفريق الناطقين بالعربية

7.3 إعداد المراقبة

• إعداد تنبيه الرفض: تحديد من يستلم الإشعارات عند فشل إرسال فاتورة
• وضع عملية فحص يومية خلال أول أسبوعين: التأكد من أن جميع فواتير اليوم السابق لها حالة “معتمدة”
• تحديد عملية مطابقة شهرية: إجمالي الفواتير المرسلة مقابل إجمالي الفواتير المعتمدة

القسم الثامن: الصيانة بعد التشغيل الفعلي

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

8.1 التزامات الامتثال المستمرة

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

8.2 حفظ السجلات

• جميع الفواتير المرسلة محفوظة في Zoho Books مع حالة الاعتماد: التأكد من إمكانية الوصول إليها عند التدقيق
• نسخ XML للفواتير متاحة من داخل سجل كل فاتورة
• سجل التدقيق (Audit Trail) مفعّل ويعرض جميع أحداث إنشاء الفواتير وتعديلها وإرسالها

8.3 أنواع الفواتير والمنتجات الجديدة

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

أخطاء الإعداد الشائعة في ZATCA التي يجب تجنبها

استناداً إلى خبرة التنفيذ الفعلي في الرياض وجدة والدمام، هذه هي أكثر أخطاء الإعداد شيوعاً التي تواجهها Al Fahad عند مراجعة إعداد ZATCA القائم في Zoho Books:

الخطأ	سبب حدوثه	طريقة الإصلاح
اسم البائع بالعربية غير موجود	تم الإعداد بالإنجليزية فقط وترك الحقل العربي فارغاً	إضافة الاسم القانوني بالعربية في إعدادات المنشأة
صيغة الرقم الضريبي خاطئة	إدخال الرقم الضريبي مع مسافات أو بعدد أرقام غير صحيح	إعادة إدخاله كرقم من 15 خانة دون مسافات
إرسال فواتير B2B دون اعتماد	تفضيل الإرسال مضبوط على المسودة، والفريق يرسل الفواتير يدوياً قبل إرسالها إلى البوابة	تغيير تفضيل الإرسال أو فرض الموافقة الإلزامية قبل الإرسال
عدم إرسال الإشعارات الدائنة	الفريق غير مدرك أن الإشعارات الدائنة تتطلب أيضاً الإرسال إلى بوابة فاتورة	الإعداد والتدريب: الـ IRN مطلوب لجميع الإشعارات الدائنة
إنشاء CSR خارج Zoho Books	استخدام أداة خارجية لإنشاء الـ CSR ثم استيراده	إعادة إنشاء الـ CSR داخل Zoho Books: يجب أن يتطابق معرّف الجهاز
تخطي بيئة التجربة واكتشاف الأخطاء في فواتير حقيقية	التشغيل الفعلي دون اختبار للالتزام بموعد نهائي	اختبر دائماً: الأخطاء في الفواتير الحقيقية تحمل مخاطر امتثال

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

احصل على مساعدة الخبراء في التكامل مع ZATCA

Al Fahad IT Consulting هي شريك Zoho المعتمد المتميز تقدم تنفيذ تكامل Zoho Books مع ZATCA للشركات في الرياض وجدة والدمام.

نطبّق هذه القائمة في كل مشروع Zoho Books في المملكة، بما في ذلك تدقيق الإعدادات القائمة التي تم إعدادها دون اتباع عملية منظمة.

احجز مراجعة لتكامل ZATCA ←

💬 تواصل معنا مباشرة عبر واتساب

نتحدث العربية. تواصل معنا عبر واتساب لمراجعة إعداد زوهو بوكس ومتطلبات التكامل مع هيئة الزكاة والضريبة والجمارك

Al Fahad IT Consulting هي شريك Zoho المعتمد المتميز وعضو في شبكة شركاء Oracle، وتقدم خدمات الامتثال لـ ZATCA في Zoho Books في المملكة العربية السعودية والإمارات والبحرين.