قبل البدء: ما تحتاجه
قبل الشروع في إعداد ZATCA على أودو 17، تأكد من توفر المتطلبات التالية:
- بيئة أودو 17 محدّثة مع وحدة المحاسبة مفعّلة
- بيانات اعتماد ZATCA للمنشأة: رقم السجل التجاري، رقم ضريبة القيمة المضافة
- عنوان بريد إلكتروني صالح مرتبط بحساب ZATCA لاستقبال الشهادة الرقمية
- صلاحيات مدير على نظام أودو
إعداد ZATCA ينقسم إلى مرحلتين رئيسيتين: تسجيل الوحدة ثم استخراج شهادة CSID.
الخطوة الأولى: تفعيل وحدة ZATCA في أودو
- من القائمة الرئيسية، انتقل إلى التطبيقات (Apps)
- ابحث عن Saudi Arabia - E-invoicing أو l10n_sa_edi
- ثبّت الوحدة وانتظر اكتمال التثبيت
- بعد التثبيت، انتقل إلى المحاسبة ← الإعدادات ← الفوترة الإلكترونية السعودية
في هذه الشاشة ستجد حقلين أساسيين:
- بيئة ZATCA: اختر “Sandbox” للاختبار أولاً، ثم “Production” عند الجاهزية
- OTP الأولي: سيُطلب لاحقاً عند استخراج الشهادة
الخطوة الثانية: إعداد بيانات الشركة
انتقل إلى الإعدادات ← الشركات وتأكد من اكتمال بيانات منشأتك بدقة:
- الاسم القانوني الكامل مطابقاً للسجل في ZATCA
- رقم ضريبة القيمة المضافة (15 رقماً)
- العنوان: المنطقة، المدينة، الحي، الشارع، الرمز البريدي
- رقم السجل التجاري (CR Number)
ملاحظة مهمة: أي خطأ في هذه البيانات سيؤدي إلى رفض الفاتورة من منصة Fatoora. تحقق منها مقارنةً بشهادة ضريبة القيمة المضافة الصادرة من ZATCA.
الخطوة الثالثة: توليد طلب شهادة CSR
شهادة CSR (Certificate Signing Request) هي الطلب الذي ترسله لـ ZATCA للحصول على شهادة CSID الرقمية.
من شاشة إعدادات الفوترة الإلكترونية:
- انقر على توليد CSR (Generate CSR)
- أدخل معلومات المنشأة المطلوبة (اسم الجهاز، نوع الحل)
- سيُولّد النظام ملف CSR تلقائياً
الخطوة الرابعة: تسجيل الجهاز واستخراج CSID
- سجّل دخولك إلى بوابة Fatoora (fatoora.zatca.gov.sa)
- انتقل إلى الأجهزة ← تسجيل جهاز جديد
- الصق محتوى ملف CSR في الحقل المخصص
- ستتلقى OTP مؤقتاً على البريد الإلكتروني المسجل
- عُد إلى أودو وأدخل OTP في حقل “OTP الأولي”
- انقر على استخراج الشهادة — سيتلقى أودو CSID مباشرة من ZATCA
الخطوة الخامسة: اختبار في بيئة Sandbox
قبل الانتقال إلى بيئة الإنتاج، أجرِ اختبارات شاملة:
أنواع الفواتير الواجب اختبارها:
- فاتورة ضريبية عادية (B2B)
- فاتورة مبسّطة (B2C)
- إشعار دائن (Credit Note)
- إشعار مدين (Debit Note)
تحقق من أن كل فاتورة:
- تحصل على ختم تشفير من ZATCA
- تتضمن رمز QR صحيح
- يمكن تنزيلها بصيغة XML و PDF
الخطوة السادسة: الانتقال إلى الإنتاج
بعد نجاح الاختبارات:
- غيّر بيئة ZATCA من Sandbox إلى Production
- أعد توليد CSR لبيئة الإنتاج
- سجّل جهازاً جديداً في بوابة Fatoora (بيئة الإنتاج)
- استخرج CSID الإنتاجية
الآن أنت جاهز لإصدار فواتير ZATCA المرحلة الثانية من أودو مباشرة.
المشكلات الشائعة وحلولها
| المشكلة | السبب الأرجح | الحل |
|---|---|---|
| رفض CSID | خطأ في بيانات الشركة | تحقق من مطابقة البيانات مع سجل ZATCA |
| فاتورة بدون ختم | انقطاع الاتصال | تحقق من إعدادات جدار الحماية لـ API Fatoora |
| خطأ في QR | نسخة أودو قديمة | حدّث إلى آخر نسخة من أودو 17 |
| رفض المبلغ | خطأ في ضريبة القيمة المضافة | تحقق من إعداد ضريبة 15% على المنتجات |
هل تريد من يتولى الإعداد نيابةً عنك؟
الإعداد الكامل يستغرق يوماً إلى يومين من العمل ويتطلب خبرة تقنية بأودو ومنصة Fatoora. أخطاء الإعداد في بيئة الإنتاج قد تؤدي إلى توقف الفوترة أو رفض الفواتير من ZATCA.
نحن في الآفاق العالمية نتولى الإعداد الكامل: من استخراج CSID، مروراً بالاختبار، حتى التدريب على الاستخدام اليومي — بدون أي توقف في عملياتك.