🇸🇦 Saudi Arabian E-Invoicing (ZATCA Phase-2) – A Frappe ERPNext App

A Frappe ERPNext app for businesses in Saudi Arabia, ensuring compliance with ZATCA Phase-2 e-invoicing regulations.

🚀 Features

✅ Compliance with ZATCA E-Invoicing Phase-2
✅ Integration with ZATCA APIs for clearance & reporting
✅ Automatic CSR generation & compliance checks
✅ Secure authentication & token management
✅ Invoice submission for clearance & reporting
✅ Support for standard invoices, credit notes, debit notes
✅ Retrieve and attach QR Codes to invoices
✅ Logging for audit trails & error handling
✅ Reports to compare invoices with ZATCA portal statistics

🔹 Compatibility
🌐 ERPNext Version13, 14 and 15
🖥️ Platforms Ubuntu, Centos, Oracle Linux

🛠 Installation Configuration & Setup

🔹 For Frappe Cloud Users

Frappe Cloud users can install the app directly from the Marketplace.

🔹 Build cloud server in Jeddah or Riyadh with ERPNext & Zatca using Claudion https://saudi.claudion.com/onboarding

🔹 For Self-Hosted ERPNext Users

Follow the standard Frappe app installation process:

Get the app from GitHub

bench get-app https://github.com/ERPGulf/zatca_erpgulf.git

Install the app on your site

bench --site yoursite.erpgulf.com install-app zatca_erpgulf

Apply necessary migrations

bench --site yoursite.erpgulf.com migrate

Restart bench or supervisor

bench restart or sudo service supervisor restart

🔹 Verify Installation
1. Login to ERPNext.
2. Navigate to Help → About.
3. Ensure the ZATCA app is listed.

📈 Project Status

Feature Details 🔓 License MIT (Or another license)
🌍 Website https://erpgulf.com
🛠 Maintenance
✅ Actively Maintained
🔄 PRs Welcome
✅ Contributions Encouraged
🏆 Open Source ✅

📺 Video Tutorial https://www.youtube.com/watch?v=P0ChplXoKYg
📺 Detailed documentation https://docs.claudion.com/zatca%20pdf-a3
📺 Handling Error messages from ZATCA https://docs.claudion.com/Claudion-Docs/ErrorMessage1
📺 Coding policy https://docs.claudion.com/Claudion-Docs/Coding%20Policy

🎥 Watch our step-by-step tutorial on YouTube:

🌟 Development & Contributions

We welcome contributions! To contribute:
1. Fork this repository.
2. Make your changes (improve the code, add features, fix bugs).
3. Submit a Pull Request for review.
4. If you find issues, please report them via the Issues section.

Your contributions help make this project better! 🙌

📩 Support & Customization

For implementation support or customization, contact: 📧 support@ERPGulf.com

👥 Social

🚀 Now you’re ready to be fully ZATCA-compliant! 🎯