ما هي المرحلة الثانية من زاتكا؟

تُلزم هيئة الزكاة والضريبة والجمارك (زاتكا) بتطبيق المرحلة الثانية ("مرحلة الربط") من الفوترة الإلكترونية منذ يناير 2023. يجب أن تُصدر كل فاتورة داخل المملكة كمستند XML موقّع بصيغة UBL 2.1، مع تجزئة (hash) مرتبطة بتجزئة الفاتورة السابقة، وختم برمز QR مرمّز بصيغة TLV، وأن تُصدَّق آنياً (B2B) أو يُبلَّغ عنها خلال 24 ساعة (B2C) إلى منصة فاتورة التابعة لزاتكا.

يوفّر هذا التطبيق المسار الكامل بشكل أصلي داخل أودو: من توليد زوج مفاتيح EC secp256k1 وطلب CSR، مروراً بالتأهيل عبر رمز OTP إلى /compliance/csid، وتنفيذ جميع سيناريوهات الامتثال الاثني عشر الإلزامية، واستخراج شهادة الإنتاج Production CSID، وصولاً إلى توقيع كل فاتورة عميل وإرسالها دون مغادرة واجهة أودو.

الميزات الرئيسية

كيف يعمل التأهيل

1. افتح المحاسبة -> الإعدادات -> زاتكا -> التأهيل، وأدخل الرقم الضريبي للشركة (15 رقماً، يبدأ بـ 3)، والسجل التجاري CR (10 أرقام)، والاسم الشائع لجهاز EGS.
2. انقر على "إنشاء CSR" ليتم توليد زوج مفاتيح EC secp256k1 وطلب CSR متوافق مع زاتكا وتخزينهما على الجهاز.
3. سجّل الدخول إلى بوابة زاتكا على fatoora.zatca.gov.sa، واختر "تسجيل جهاز جديد"، وانسخ رمز التحقق OTP المكوّن من 6 أرقام.
4. الصق رمز OTP في الخطوة 3 ليقوم التطبيق باستبدال CSR + OTP بشهادة الامتثال Compliance CSID.
5. تُنفَّذ في الخطوة 4 سيناريوهات الامتثال الإلزامية الاثني عشر تلقائياً.
6. تستبدل الخطوة 5 شهادة الامتثال Compliance CSID بشهادة الإنتاج Production CSID، ليصبح الجهاز جاهزاً للعمل الفعلي.

سيناريوهات الامتثال المشمولة

ما الذي يتضمنه التطبيق

• مولّد فواتير UBL 2.1 مكتوب بلغة Python بالكامل (باستخدام cryptography وlxml)
• موقّع رقمي XML من نوع XAdES B-B باستخدام EC secp256k1
• أداة بناء CSR متوافقة مع زاتكا تتضمن كامل معرّفات OID الإلزامية ومعرّفات OID الخاصة بزاتكا
• مُرمِّز QR بصيغة TLV / Base64 (5 حقول لـ B2C، 9 حقول لـ B2B)
• عميل HTTP لواجهات Compliance CSID وProduction CSID والتصديق (Clearance) والإبلاغ (Reporting) وفواتير اختبار الامتثال
• خطاف ما بعد الترحيل في Account.move: تجزئة، تسلسل، توقيع، QR، إرسال - تلقائياً مع كل فاتورة عميل
• معالج التأهيل ومعالج فحص الامتثال
• تقارير QWeb ثنائية اللغة بصيغة A4 و80 مم حرارية مع رمز QR مضمّن
• نقاط نهاية في بوابة العميل لتحميل XML / QR
• تسميات ثنائية اللغة عربي/إنجليزي تظهر مباشرة في الواجهة وتقارير الفاتورة QWeb / الحرارية
• قواعد سجلات متعددة الشركات ومجموعات أمان مخصصة لزاتكا

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

هل يعمل التطبيق مع أودو 18 وأودو 19؟

نعم، يتم صيانة فرعين منفصلين 18.0 و19.0، ولكل منهما رقم إصدار مناسب في ملف manifest.

هل يتطلب اتصالاً بالإنترنت؟

نعم، لإرسال الفواتير إلى واجهتي التصديق (Clearance) والإبلاغ (Reporting) لدى زاتكا. تُخزَّن المحاولات الفاشلة محلياً ويُعاد إرسالها عبر مهمة مجدولة (cron) كل 30 دقيقة.

هل يدعم تعدد الشركات؟

نعم. لكل شركة في أودو سجل جهاز زاتكا خاص بها يتضمن CSR وCSID وسلسلة PIH مستقلة.

هل رمز QR صالح لتطبيق التحقق الرسمي التابع لزاتكا؟

نعم. يتبع تنسيق TLV بدقة الدليل الفني التفصيلي لزاتكا الإصدار 3: 5 حقول إلزامية للفواتير المبسطة، و9 حقول تشمل تجزئة XML والتوقيع والمفتاح العام وبصمة الختم للفواتير العادية.

ما الترخيص الذي يصدر التطبيق بموجبه؟

OPL-1 (ترخيص أودو الخاص).

المتطلبات

• أودو 18.0 أو 19.0 - الإصدار المجتمعي / المؤسسي
• بايثون: lxml وcryptography وqrcode وrequests وPillow
• شركة سعودية مسجلة بضريبة قيمة مضافة مكوّنة من 15 رقماً

كيف يتصل هذا التطبيق بزاتكا (BYOK)

هذا التطبيق هو أداة لتوليد الصيغة ونقلها. فهو يُنشئ ملف XML بصيغة UBL 2.1 المتوافقة مع زاتكا، ويوقّعه بمفتاحك الخاص من نوع EC secp256k1، ويرسله إلى زاتكا باستخدام بيانات اعتماد Compliance وProduction CSID الخاصة بك، والتي تحصل عليها بنفسك مباشرة من بوابة فاتورة الرسمية أثناء التأهيل (أحضر مفاتيحك الخاصة / أحضر بيانات اعتمادك الخاصة).

• أنت المكلّف المسجّل. العلاقة القانونية للفوترة الإلكترونية هي بين شركتك وزاتكا. نحن مزوّد برمجيات فقط، ولسنا مزوّد خدمة معتمداً لدى زاتكا أو جهة تكامل أو وكيل تصديق، ولا نتصرف نيابة عنك أمام الهيئة أبداً.
• مفاتيحك وبيانات اعتمادك تبقى في قاعدة بياناتك. يتم توليد المفتاح الخاص وCSR ورموز CSID والأسرار وتخزينها على مثيل أودو الخاص بك؛ ولا يمر شيء عبر خوادمنا.
• يتم التأهيل من قبلك باستخدام المعالج داخل التطبيق مع رمز OTP الذي تنسخه من بوابة زاتكا الرسمية.

هذه الأداة تُنشئ فاتورة UBL 2.1 المتوافقة مع هيئة الزكاة والضريبة والجمارك (زاتكا) وتوقّعها بمفتاحك الخاص وترسلها باستخدام بيانات اعتمادك (CSID) التي تحصل عليها بنفسك من منصة فاتورة الرسمية. أنت المكلّف المسجّل، ونحن مزوّد برمجيات فقط ولسنا مزوّد خدمة معتمداً لدى الهيئة.

الدعم وسياسة الاسترداد

يُقدَّم الدعم عبر البريد الإلكتروني على pokutsoft.com. نستجيب لطلبات التثبيت والإعداد وإصلاح الأخطاء للإصدارين المدعومين 18.0 و19.0 من أودو. وبما أن هذا كود مصدري قابل للتحميل، فإن الاسترداد يخضع لسياسة متجر تطبيقات أودو: تواصل معنا أولاً وسنعمل على حل أي عيب حقيقي؛ وإذا تعذّر حل المشكلة المُبلَّغ عنها فسيتم إصدار استرداد وفقاً لتلك السياسة.