🟢 مفتوح المصدر · مرخّص MIT · مجاني

ZATCA High Speed
تطبيق ERPNext للربط الكامل مع زاتكا

حلّ متكامل يربط ERPNext v15 مباشرة بنظام الفوترة الإلكترونية لهيئة الزكاة والضريبة والجمارك بدون أنظمة وسيطة. إرسال مباشر للفواتير، رمز QR، تجهيز CSID، وتقارير ضريبة القيمة المضافة — جاهز للسوق السعودي.

v15ERPNext / Frappe
Phase 2ZATCA
AR + ENواجهة كاملة
MITLicense
⭐ افتح المستودع على GitHub ⚡ بدء التثبيت

📦ما هو ZATCA High Speed؟

تطبيق ERPNext أصيل (native app) طوّرناه في HIGH SPEED IT خصيصاً للتجار السعوديين الذين يستخدمون ERPNext كنظام محاسبي. التطبيق يضيف طبقة كاملة لإدارة الفوترة الإلكترونية حسب متطلبات هيئة الزكاة والضريبة والجمارك، من تجهيز شهادة CSID وحتى الإرسال اللحظي للفواتير وتتبّع حالاتها — كل ذلك من داخل ERPNext دون الحاجة لأي نظام خارجي.

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

كل ما يحتاجه التاجر للالتزام بمتطلبات زاتكا، مبنية بمعايير ERPNext الأصلية.

🚀

إرسال مباشر للفواتير

ثلاثة أوضاع: مباشر تلقائي، دفعات في الخلفية، أو يدوي بنقرة من المستخدم.

🧙

معالج التفعيل الذكي

يقود التاجر خطوة بخطوة: فحص الجاهزية، OTP، إصدار CSID للاختبار ثم للإنتاج.

🔄

اختبار آمن بدون تلويث

فحوصات الامتثال المؤقتة تُنفّذ داخل معاملة قاعدة بيانات تُلغى تلقائياً — صفر أثر على الدفاتر.

📱

رمز QR للمرحلة 2

يُرسم QR التشفيري المبني على رد زاتكا، وليس QR نصي بسيط.

🖨️

طباعة A4 والحراري

قوالب طباعة ثنائية اللغة لفواتير ضريبية ومبسّطة وإشعارات الدائن والمدين.

💳

دعم الدفعات المقدمة

يحوّل مدفوعات العملاء إلى فواتير دفعة مقدمة، يربطها بالفاتورة النهائية ويحسب VAT بدقة.

📊

تقرير ضريبة القيمة المضافة

تقرير جاهز يجمع المبيعات، المرتجعات، المشتريات، القيود اليدوية، والدفعات المقدمة.

📋

لوحة حالة الإرسال

تتبّع لحظي لحالات: مقبولة، مرفوضة، معلّقة، فشل — مع XML والتوقيع والـ UUID.

🔍

تحقّق قبل الإرسال

تحذيرات تظهر قبل الحفظ والإرسال — اكتشف الأخطاء قبل رفض زاتكا لها.

🎯

تصنيف تلقائي للنوع

يميّز النظام تلقائياً بين الفاتورة القياسية والمبسّطة بناءً على حالة VAT للعميل.

🇸🇦

ترجمة عربية كاملة

الواجهة، رسائل التحقق، الـ workspace، وحالات زاتكا — كلها مترجمة احترافياً.

🏢

إعدادات على مستوى الشركة

كل شركة في ERPNext تُعدّل إعدادات زاتكا الخاصة بها — لا إعدادات عامة مربكة.

🧾أنواع الفواتير المدعومة

تغطية كاملة لكل ما تطلبه زاتكا في المرحلة الثانية.

🧾فاتورة ضريبية قياسية 🧾فاتورة ضريبية مبسّطة ↩️إشعار دائن ↪️إشعار مدين 💰فاتورة دفعة مقدمة

⚙️البنية التقنية

بُني على أدوات Frappe الأصلية، ولا يطلب أي خدمة سحابية مدفوعة.

🐍

Python 3.10+

لغة الخادم الأساسية
⚡

Frappe v15

Framework
📊

ERPNext v15

ERP layer
📜

JavaScript

واجهات النماذج
☕

Java Runtime

مطلوب لـ ZATCA CLI
📦

ZATCA CLI

إعداد تلقائي

🚀التثبيت في 5 خطوات

افترضنا أن لديك ERPNext v15 شغّال على bench. لاصق الأوامر التالية:

shell
# ١) جلب التطبيق من GitHub (فرع الإنتاج)
$ bench get-app https://github.com/fuhaed/zatca_high_speed \
        --branch production

# ٢) تثبيت التطبيق على موقعك
$ bench --site your-site.local install-app zatca_high_speed

# ٣) ترحيل قاعدة البيانات + بناء الأصول
$ bench --site your-site.local migrate
$ bench build --app zatca_high_speed

# ٤) إعادة تشغيل لتفعيل المساحة
$ bench restart

🎛️خيارات الإعداد

الإعدادات على مستوى الشركة في ERPNext — كل شركة بإعداداتها المنفصلة.

🌐بيئة الاتصال بزاتكا

  • Sandbox — بيئة التطوير الأولية
  • Simulation — اختبار قبل الإنتاج
  • Production — البيئة الحيّة الرسمية

📨نوع الفاتورة

  • Auto — يقرّر النظام حسب VAT العميل
  • Simplified — كل الفواتير مبسّطة
  • Standard — كل الفواتير قياسية

⚡وضع الإرسال

  • Live — إرسال فوري عند الاعتماد
  • Batch — دفعات مجدولة في الخلفية
  • Manual — المستخدم يقرر متى يُرسل

✅خيارات التحقق

  • تحقق محلي بـ CLI
  • حجب XML غير الصالح
  • تحذيرات قبل الحفظ

📍خطوات الإقلاع الأول

بعد تثبيت التطبيق، اتبع هذه الخطوات لربط شركتك بزاتكا.

  1. تفعيل تكامل زاتكا على نموذج الشركة

    افتح Company → فعّل "ZATCA Integration" واحفظ.

  2. تحقّق من بيانات الشركة

    الدولة: السعودية، العملة: SAR، الرقم الضريبي: 15 رقماً يبدأ وينتهي بـ 3، السجل التجاري موجود.

  3. اربط عنواناً سعودياً صحيحاً

    المدينة، الرمز البريدي، رقم المبنى، الحي — كلها مطلوبة لـ ZATCA.

  4. افتح معالج التفعيل

    من workspace "ZATCA High Speed" → Activation Wizard. اختر البيئة المناسبة.

  5. أكمل OTP واطلب Compliance CSID

    أدخل OTP من بوابة فاتورة، اطلب شهادة الامتثال، شغّل فحوصات الفواتير المؤقتة.

  6. اطلب Production CSID وابدأ

    حين تمر فحوصات الامتثال، اطلب شهادة الإنتاج وابدأ في إرسال الفواتير الفعلية.

🛡️متطلبات الصحة قبل الإرسال

التطبيق يفحص هذه القائمة تلقائياً ويُنبّه قبل أن ترفضها زاتكا.

✓رقم ضريبي 15 رقماً يبدأ وينتهي بـ ٣
✓العملة SAR وموقع الشركة "السعودية"
✓عنوان كامل: مدينة، حي، رمز بريدي، رقم مبنى
✓بيانات VAT صحيحة للعملاء (للفاتورة القياسية)
✓بنود وكميات وأسعار صحيحة
✓جدول الضرائب يحوي ضريبة القيمة المضافة
✓طريقة الدفع لها Mode of Payment معتمد
✓XML يطابق مخطط زاتكا قبل الإرسال

💚لماذا فتحنا المصدر؟

الالتزام بمتطلبات هيئة الزكاة والضريبة والجمارك ليس ميزة تنافسية — هو حق أساسي لكل تاجر سعودي. لذلك أصدرنا التطبيق مفتوح المصدر بترخيص MIT، حتى يستطيع أي تاجر يستخدم ERPNext الالتزام بزاتكا دون رسوم اشتراك أو ارتباط بمزود واحد. الكود متاح للمراجعة والمساهمة والتعديل من المجتمع.

جاهز للبدء؟

حمّل التطبيق من GitHub مجاناً، أو تواصل معنا للحصول على دعم تركيب وتجهيز شركتك.

⭐ GitHub 📧 [email protected]