السعودية فقط. تطبّق هذه الوحدة نموذج "فاتورة" السعودي الخاص بهيئة الزكاة والضريبة والجمارك (نموذج تصديق وإبلاغ عبر جهة مركزية). أما الفوترة الإلكترونية في الإمارات فهي وحدة منفصلة (نموذج Peppol ذو "الزوايا الخمس" عبر مزوّد خدمة معتمد) — راجع خطة الإطلاق لديك في الإمارات. وكل مكلّف سعودي مسجّل في ضريبة القيمة المضافة يسجّل شركته هو برمز التحقق الخاص به؛ ولا تحتفظ ColorsX74 برمز التحقق أو بمفاتيحك إطلاقًا.
كيف تترابط الأجزاء
المسودة ليست مستندًا ضريبيًا. تُنشأ الفاتورة الإلكترونية عند إصدار الفاتورة — لا عند حفظ مسودة. تحمل المسودة مرجعًا مؤقتًا يبدأ بـDRFT-، ولا تُرحِّل أي قيد يومية، ولا تنتج فاتورة إلكترونية ولا تستهلك عدّاد الفواتير ولا تضيف حلقة إلى سلسلة التجزئة. وبمجرد إصدارها تُنشأ فاتورة إلكترونية واحدة بالضبط تحمل رقم الفاتورة النهائي. وإن تركت المسودة أو حذفتها فلن يكون شيء قد استُهلك — فيبقى التسلسل المُبلَّغ عنه متصلًا بلا فجوات.
الفوترة الإلكترونية ZATCA إضافة مرخّصة. عند تفعيلها لشركة ما تظهر الوحدة باسم الفوترة الإلكترونية (ZATCA) في الشريط الجانبي (/einvoicing-zatca)، وتُقدَّم واجهتها البرمجية على /api/v1/einvoicing-zatca. تحوّل الوحدة كل فاتورة إلى ملف XML بصيغة ZATCA UBL 2.1 الإلزامية، وتحسب تجزئة الفاتورة، وتحافظ على عدّاد وحدة الإصدار (EGS) وسلسلة تجزئة الفاتورة السابقة، ثم توقّعها تشفيريًا (XAdES) بشهادة شركتك وترسلها إلى الهيئة.
انتقل إلى: المرحلتان · تفعيل الوحدة · التسجيل برمز التحقق من بوابة فاتورة · البيئات وبوابة الأمان · توقيع الفواتير وإرسالها · حالات الفاتورة · ملاحظات للمشغّل.
مرحلتا الفوترة الإلكترونية لدى ZATCA
المرحلة الأولى (الإصدار). تحمل كل فاتورة رمز QR الإلزامي بصيغة TLV المشفّرة بـ Base64 — ويظهر كصورة QR قابلة للمسح مباشرةً في جدول المستندات (امسحه بكاميرا أي هاتف أو بتطبيق ZATCA للتحقق من اسم البائع والرقم الضريبي وختم الوقت بتوقيت السعودية والإجماليات) — وتُحفظ الفاتورة كمستند إلكتروني منظَّم. ولا حاجة إلى حساب لدى الهيئة — تعمل هذه المرحلة فور تفعيل الوحدة.
المرحلة الثانية (الربط والتكامل). تُحوَّل كل فاتورة إلى صيغة ZATCA UBL 2.1، وتُربط بسلسلة تجزئة (العدّاد ICV مع تجزئة الفاتورة السابقة)، وتُوقَّع تشفيريًا بشهادة CSID الخاصة بشركتك، ثم تُرسل إلى الهيئة إما لـالتصديق (الفاتورة الضريبية/B2B — تُصدَّق قبل مشاركتها مع المشتري) أو لـالإبلاغ (الفاتورة المبسطة/B2C — يُبلَّغ عنها خلال 24 ساعة، ولا يتوقف البيع بانتظارها). وتتطلب المرحلة الثانية شهادة CSID لشركتك، وتحصل عليها بالتسجيل الذاتي الموضّح أدناه.
تفعيل الوحدة
من الفوترة الإلكترونية (ZATCA) ← الإعدادات (E-Invoicing (ZATCA) → Settings): فعّل خيار تفعيل الفوترة الإلكترونية ZATCA، واختر البيئة (ابدأ بالبيئة التجريبية Sandbox)، ويمكنك اختياريًا تجاوز اسم البائع أو الرقم الضريبي (وإلا فسيؤخذان من سجل الشركة). ثم احفظ. ومن هذه اللحظة تحصل كل فاتورة مبيعات تلقائيًا على رمز QR للمرحلة الأولى وعلى مستند فاتورة إلكترونية.
يجب أن يكون الرقم الضريبي لشركتك رقمًا من 15 خانة يبدأ بالرقم "3" وينتهي به — إذ تشترط الهيئة ذلك في طلب الشهادة.
التسجيل برمز التحقق (OTP) من بوابة فاتورة — خدمة ذاتية
لتتمكن من التوقيع والإرسال (المرحلة الثانية) تحتاج شركتك إلى CSID (معرّف الختم التشفيري) من الهيئة، وتحصل عليه بنفسك من بوابة فاتورة الخاصة بشركتك:
- سجّل الدخول إلى بوابة فاتورة (fatoora.zatca.gov.sa) بحساب شركتك المسجّلة في ضريبة القيمة المضافة، ثم أنشئ رمز تحقق (OTP) لربط حلّ فوترة إلكترونية. وصلاحية الرمز نحو ساعة واحدة.
- داخل النظام، افتح الفوترة الإلكترونية (ZATCA) ← ربط CSID (التسجيل)، والصق رمز التحقق، ثم اضغط طلب CSID. يُرسل الرمز مرة واحدة ويُستخدم فورًا، ولا يُخزَّن ولا يُعرض مرة أخرى.
- ينفّذ النظام مسار الهيئة كاملًا تلقائيًا: يولّد طلب الشهادة، ويجلب شهادة الامتثال (Compliance CSID)، وينفّذ فحوصات الامتثال المطلوبة من الهيئة، ثم يجلب شهادة الإنتاج (Production CSID). ويعرض الجدول الزمني للحالة كل خطوة على حدة.
- عندما تصبح الحالة مُسجَّلة (Onboarded) تكون شهادة شركتك فعّالة ومخزَّنة مشفّرة. وتظهر بصمة الشهادة وتاريخ انتهائها في الصفحة نفسها.
هذه هي خطوة "جاهز فور إدخال بيانات فاتورة الخاصة بك" كاملةً — دون أي تدخّل من فريق ColorsX74، ويبقى رمز التحقق ومفاتيحك داخل شركتك.
البيئات وبوابة الأمان
لدى الهيئة ثلاث بيئات، لكل منها بيانات اعتماد وعنوان أساسي خاص بها:
- البيئة التجريبية (Sandbox) — اختبار مفتوح للمطوّرين ويقبل بيانات وهمية. لا أثر قانوني لها. استخدمها لتجربة المسار.
- بيئة المحاكاة (Simulation) — ما قبل الإنتاج، وتتطلب رمز تحقق حقيقيًا من محاكاة بوابة فاتورة. لا أثر قانوني لها.
- بيئة الإنتاج (Production) — فواتير إلكترونية حقيقية ومُلزِمة قانونًا.
بوابة البيئة الصارمة. لا يمكن أبدًا استخدام شهادة صادرة من البيئة التجريبية أو من بيئة المحاكاة للإرسال إلى بيئة الإنتاج — يرفض النظام أي عدم تطابق. كما يجب أن يُفعِّل مشغّلٌ أول إرسال حقيقي إلى الإنتاج صراحةً (زر "Arm live Production submission" في شاشة التسجيل)، فحتى الشركة المسجَّلة بشكل صحيح في بيئة الإنتاج لن ترسل شيئًا إلى الهيئة قبل أن تفعّل ذلك بنفسك. سجّل شركتك في البيئة التي تنوي استخدامها فعلًا.
توقيع الفواتير وإرسالها
بعد ربط شهادة الإنتاج CSID، يمكن إرسال كل فاتورة إلكترونية إلى الهيئة (بإجراء "إرسال إلى ZATCA" في قائمة المستندات، أو تلقائيًا ضمن مسار الفوترة لديك):
- الفاتورة الضريبية / B2B (التصديق). تُصدَّق الفاتورة لدى الهيئة قبل مشاركتها مع المشتري. وإن رفضتها الهيئة فلا يجوز إصدارها قانونًا — صحّح البيانات وأعد الإرسال. وتحصل الفاتورة المصدَّقة على المستند المصدَّق الذي تعيده الهيئة.
- الفاتورة المبسطة / B2C (الإبلاغ). يُصدَر إيصال نقطة البيع فورًا برمز QR الخاص به، ويُبلَّغ عن الفاتورة إلى الهيئة خلال 24 ساعة. والإبلاغ لا يعطّل عملية البيع إطلاقًا.
الإرسال لا يتكرر أثره وآمن لإعادة المحاولة: يمكن إعادة المحاولة بعد انقطاع شبكة عابر دون كسر سلسلة التجزئة (تستبعد الهيئة التكرار اعتمادًا على معرّف الفاتورة UUID)، ولا يُعاد إرسال فاتورة سبق تصديقها أو الإبلاغ عنها.
حالات الفاتورة
GeneratedLocal / UblGenerated — أُنتج رمز QR للمرحلة الأولى وملف UBL. Signed — موقّعة بصيغة XAdES بشهادتك. Submitting — قيد الإرسال إلى الهيئة. Cleared — مصدَّقة ومقبولة من الهيئة للفواتير بين المنشآت (وهي المستند القانوني). Reported — مُبلَّغ عنها لفواتير الأفراد. ClearanceRejected / ReportingRejected — رفضتها الهيئة (راجع الرسالة). SubmissionFailed — فشل عابر أو محجوب (مثل عدم تفعيل الإرسال المباشر أو خطأ في البيئة) — يمكن إعادة المحاولة بأمان بعد المعالجة.
ملاحظات للمشغّل
- شركة واحدة، شهادة CSID واحدة. تُسجَّل كل شركة على حدة برمز التحقق الخاص بها. انتقل إلى الشركة أولًا ثم سجّلها.
- تبقى الأسرار مشفّرة. المفتاح الخاص وشهادة CSID والسر المرافق لها مشفّرة أثناء التخزين، ولا تُعرض ولا تُسجَّل ولا تعيدها الواجهة البرمجية — ولا يظهر سوى بصمة الشهادة وتاريخ انتهائها، وهما غير سرّيين.
- تجديد الشهادة. تنتهي صلاحية شهادات CSID (بعد سنة تقريبًا). وتعرض صفحة التسجيل تاريخ الانتهاء؛ أعد التسجيل قبل انقضائه.
- الإشعارات الدائنة تُصنَّف وتُرسَل تلقائيًا كمستند إشعار دائن لدى الهيئة.
- عند رفض إنشاء الفاتورة الإلكترونية، تُوضّح الرسالة السبب الآن. قد يُرفض الإنشاء لأربعة أسباب مختلفة — أن تكون الفاتورة لا تزال مسودة، أو أن تكون قد أُلغيت، أو ألّا تكون الفوترة الإلكترونية مفعّلة للمنشأة، أو ألّا تكون الفاتورة موجودة. وكانت هذه الحالات تُبلَّغ برسالة واحدة لا تذكر سوى السببين الأخيرين، فيبحث المشغّل عن خلل في الإعدادات لا وجود له بينما الفاتورة ببساطة لم تُصدَر بعد. أمّا الآن فيُذكر كل سبب على وجه التحديد.