إعداد ZATCA المرحلة الثانية
ZATCA (هيئة الزكاة والضريبة والجمارك) المرحلة الثانية هي مرحلة الربط والتكامل للفوترة الإلكترونية في المملكة العربية السعودية. بموجب هذا النظام، يجب على الشركات إنشاء فواتير إلكترونية بتنسيق XML منظم، وتوقيعها رقميًا بختم تشفيري، وتقديمها لأنظمة ZATCA للتصفية (B2B) أو الإبلاغ (B2C). يتولى شاري هذه العملية بالكامل بمجرد إكمال الإعداد الموضح في هذه الصفحة.
تكامل ZATCA المرحلة الثانية متاح في خطة المؤسسات. تظهر بطاقة إعدادات ZATCA في الإعدادات > التكاملات فقط بعد تفعيل الميزة لمستأجرك.
المتطلبات الأساسية
قبل بدء إعداد ZATCA، تأكد من توفر ما يلي:
- خطة المؤسسات --- يجب أن يكون مستأجرك على اشتراك المؤسسات.
- التسجيل الضريبي --- يجب أن تمتلك شركتك رقم تسجيل ضريبي صالح مكون من 15 خانة مُدخل في إعدادات الحساب.
- معلومات الشركة --- يجب إكمال اسم الشركة والعنوان ورقم السجل التجاري في إعدادات الحساب.
- حساب بوابة ZATCA --- تحتاج إلى الوصول إلى بوابة فاتورة التابعة لـ ZATCA لإكمال خطوات التسجيل المعينة.
لا تحاول التسجيل في ZATCA بمعلومات شركة غير مكتملة. يعتمد إنشاء CSR وإصدار CSID على بيانات VAT والسجل التجاري والعنوان الدقيقة. الأخطاء في هذه المرحلة قد تتطلب إعادة بدء العملية.
تفعيل ZATCA لمستأجرك
يتطلب تكامل ZATCA تفعيل علامتي إعداد:
- بوابة الميزة --- يجب تفعيل ميزة ZATCA المرحلة الثانية لمستأجرك. يتم هذا عادةً أثناء تفعيل خطة المؤسسات أو بالتواصل مع دعم شاري.
- إعداد ZATCA --- بمجرد تفعيل بوابة الميزة، تظهر بطاقة إعدادات ZATCA في إعداداتك، ويمكنك بدء عملية التسجيل.
عندما تكون كلتا العلامتين مفعلتين، تظهر بطاقة تكامل ZATCA تحت الإعدادات > التكاملات.
اختيار البيئة
قبل إنشاء الشهادات، اختر بيئة ZATCA التي تريد الاتصال بها:
| البيئة | الغرض |
|---|---|
| بيئة الاختبار | بيئة اختبار للتطوير والاختبار الأولي. الفواتير المقدمة هنا ليست حقيقية. |
| المحاكاة | بيئة ما قبل الإنتاج تحاكي سلوك الإنتاج. استخدمها للتحقق النهائي قبل الإطلاق. |
| الإنتاج | نظام ZATCA الفعلي. الفواتير المقدمة هنا ملزمة قانونيًا ومُبلغ عنها لـ ZATCA. |
ابدأ بـ بيئة الاختبار لاختبار تكاملك دون أي مخاطر. بمجرد التحقق من أن الفواتير يتم إنشاؤها وتقديمها بشكل صحيح، انتقل إلى المحاكاة للتحقق النهائي، ثم إلى الإنتاج عندما تكون مستعدًا للإطلاق.
إنشاء CSR
الخطوة التقنية الأولى في تسجيل ZATCA هي إنشاء طلب توقيع شهادة (CSR). يحتوي CSR على معلومات عملك ويُستخدم للحصول على شهادة الامتثال من ZATCA.
ينشئ شاري CSR تلقائيًا بناءً على معلومات الشركة في إعدادات حسابك. العملية:
- انتقل إلى الإعدادات > إعداد ZATCA.
- انقر على إنشاء CSR.
- ينشئ شاري CSR باستخدام الرقم الضريبي لشركتك ورقم السجل التجاري والعنوان المسجل.
- يُقدّم CSR إلى API الخاص بـ ZATCA للحصول على CSID الامتثال (معرّف الختم التشفيري).
CSID الامتثال و CSID الإنتاج
تتضمن عملية التسجيل الحصول على CSID اثنين:
CSID الامتثال
يُصدر CSID الامتثال من ZATCA بعد التحقق من CSR الخاص بك. يُستخدم خلال مرحلة الاختبار والتحقق لتوقيع فواتير نموذجية والتأكد من أن نظامك ينتج مخرجات متوافقة.
CSID الإنتاج
بمجرد اكتمال اختبار الامتثال، تُصدر ZATCA CSID الإنتاج. هذه هي الشهادة المستخدمة لتوقيع الفواتير الحقيقية في بيئة الإنتاج. CSID الإنتاج هو ما يجعل فواتيرك صالحة قانونيًا بموجب ZATCA المرحلة الثانية.
خطوات التسجيل
يرشدك شاري عبر عملية تسجيل من 5 خطوات:
الخطوة 1: التحقق من معلومات الشركة
تحقق من صحة اسم شركتك والرقم الضريبي ورقم السجل التجاري والعنوان. تُستخلص هذه التفاصيل من إعدادات الحساب.
الخطوة 2: إنشاء CSR
إنشاء طلب توقيع الشهادة. يتولى شاري التفاصيل التقنية --- عليك فقط التأكيد والمتابعة.
الخطوة 3: إصدار CSID الامتثال
تقديم CSR إلى ZATCA واستلام CSID الامتثال. تتضمن هذه الخطوة الاتصال بـ API الخاص بـ ZATCA.
الخطوة 4: اختبار الامتثال
تقديم فواتير نموذجية إلى ZATCA باستخدام CSID الامتثال. يتحقق هذا من أن فواتيرك تستوفي جميع متطلبات التنسيق والتوقيع والمحتوى. يُجري شاري هذه الاختبارات تلقائيًا.
الخطوة 5: إصدار CSID الإنتاج
بعد اجتياز اختبار الامتثال، اطلب CSID الإنتاج من ZATCA. بمجرد إصداره، يكون مستأجرك مسجلاً بالكامل وجاهزًا لتقديم فواتير حقيقية.
يجب إكمال كل خطوة بالترتيب. لا يمكنك تخطي الخطوات أو العودة إلى خطوة سابقة دون إعادة بدء العملية. يُحفظ تقدم التسجيل، لذا يمكنك الإيقاف والاستئناف في أي وقت.
الاختبار مع بيئة الاختبار
بيئة الاختبار مثالية للاختبار الأولي. عند الاتصال بالبيئة الاختبارية:
- يمكنك إنشاء وتقديم فواتير دون أي تبعات قانونية.
- يتحقق API بيئة اختبار ZATCA من تنسيق فاتورتك ويعيد رسائل خطأ مفصلة إذا كان هناك خطأ.
- يمكنك اختبار جميع أنواع الفواتير: الفواتير القياسية، إشعارات الائتمان، إشعارات الخصم، والفواتير المبسطة.
- تُنشأ رموز QR لكنها ليست صالحة قانونيًا.
استخدم بيئة الاختبار للتحقق من:
- صحة بنية XML للفاتورة.
- تطبيق التوقيعات الرقمية بشكل صحيح.
- ترميز رموز QR لعلامات TLV المطلوبة.
- إشارة إشعارات الائتمان والخصم إلى فواتيرها الأصلية بشكل صحيح.
الإطلاق مع الإنتاج
عندما تكون واثقًا من صحة إعداداتك:
- أكمل عملية التسجيل ذات الـ 5 خطوات باستخدام بيئة الإنتاج.
- احصل على CSID الإنتاج.
- سيستخدم شاري تلقائيًا CSID الإنتاج لتوقيع جميع الفواتير اللاحقة.
- كل فاتورة معتمدة تُقدّم إلى ZATCA:
- فواتير B2B تمر بعملية التصفية --- تتحقق ZATCA من الفاتورة وتختمها قبل وصولها إلى المشتري.
- فواتير B2C تمر بعملية الإبلاغ --- يتم الإبلاغ عن الفاتورة لـ ZATCA خلال 24 ساعة.
بمجرد التحول إلى الإنتاج، كل فاتورة معتمدة تُقدّم إلى ZATCA كمستند ملزم قانونيًا. تأكد من صحة معلومات شركتك والرقم الضريبي وقوالب الفواتير قبل الإطلاق. التصحيحات بعد التقديم تتطلب إصدار إشعارات ائتمان أو خصم.