زاتكا — الفوترة الإلكترونية السعودية

كل منشأة مسجلة للضريبة في السعودية ملتزمة بقواعد ZATCA للفوترة الإلكترونية — المرحلة الأولى لفواتير قابلة للطباعة/PDF مختومة بـ QR، والمرحلة الثانية لمستندات UBL موقّعة تُرسَل فوريًا. هذه الإضافة تعالج كل ذلك: توليد طلب توقيع الشهادة، تحميل CSID، توقيع الفواتير، ختم QR، وإرسال كل فاتورة مع تتبع الحالة.

يعمل كل شيء على خادمك الخاص — المفاتيح الخاصة لا تغادر بنيتك التحتية.

1. 1افتح لوحة التحكم → الإضافات وابحث عن ZATCA.
2. 2اضغط "تفعيل". تظهر الإضافة في الإضافات → ZATCA في شريطك الجانبي.
3. 3افتح ZATCA. إن كان لديك أكثر من فرع، اختر الفرع الذي تضبطه — لكل فرع شهادته.
4. 4الصفحة بها ثلاث تبويبات: الإعدادات، الإعداد، الإرسال. نفذها بالترتيب.

تبويب الإعدادات يحتوي على كل ما تحتاجه ZATCA عن الكيان القانوني وراء هذا الفرع.

• اسم المنشأة بالعربية والإنجليزية.
• الرقم الضريبي (15 رقمًا) ورقم السجل التجاري.
• عنوان الشارع الكامل: الشارع، المدينة، الحي، الرمز البريدي، رقم المبنى، الرقم الإضافي.
• مفتاح البيئة: Sandbox للاختبار، Production للإنتاج.

تستخدم ZATCA نظام شهادتين — شهادة الامتثال للاختبار أولاً، ثم شهادة الإنتاج للإرسال الحي. الإضافة ترشدك عبر المصافحة كاملة.

1. 1توليد CSR — يُنشئ Momentfy طلب توقيع شهادة مربوطًا برقمك الضريبي وسجلك التجاري.
2. 2شهادة الامتثال — ألصق OTP من بوابة فاتورة. يبادله Momentfy بشهادة امتثال.
3. 3فحص الامتثال — يرسل Momentfy فواتير عينة لـ ZATCA sandbox. شارة خضراء "مكتمل" تعني أن الخط يعمل.
4. 4شهادة الإنتاج — بعد نجاح الامتثال، ارتقِ لشهادة إنتاج. من هذه اللحظة فواتيرك تعمل حيًا.

بمجرد وجود الشهادات، كل بيع يولد فاتورة ZATCA تلقائيًا. تبويب الإرسال هو لوحة التحكم.

• بطاقات إحصاء: معلّقة، مقبولة، مرفوضة، تحذير، الإجمالي.
• "أرسل الآن" يدفع كل الفواتير المعلقة إلى ZATCA في دفعة واحدة.
• "عرض الفواتير" يفتح قائمة كاملة — ابحث، صفّي بالحالة، افتح أي فاتورة لرؤية UUID، ICV، الحالة، والأخطاء.
• إجراءات لكل صف: إعادة توليد وإرسال، إعادة محاولة — مفيد حين تفشل فاتورة واحدة.

نسبة صغيرة من الفواتير ستكون مرفوضة أو في حالة تحذير — الخطأ مرفق بتفاصيل الفاتورة. أسباب شائعة: خطأ في رقم ضريبي لعميل، عنوان ناقص، أو خطأ شبكة مؤقت من ZATCA.

• أخطاء الشبكة المؤقتة تعاد تلقائيًا عبر cron كل ساعة.
• الرفض الصارم (بيانات ناقصة) يبقى معلقًا حتى تصلح البيع وتضغط "إعادة توليد وإرسال".
• كل محاولة تُحفظ على سجل الفاتورة، لضمان أثر مراجعة دائم.

• ابدأ دائمًا في Sandbox. فحص امتثال فاشل هناك مجاني؛ فاتورة إنتاج فاشلة تصليح بيع.
• بدّل الشهادات قبل الانتهاء بوقت — ضع تذكيرًا في التقويم قبل شهر.
• شغّل "أرسل الآن" نهاية اليوم — cron يعالج الأمر خلفيًا، لكن الدفعة اليدوية تلتقط أي عالق.