Zatca Erpgulf
Implementation of Zatca Phase-2 E-Invoicing - for FrappeCLoud
- Author: ERPGulf
- Repository: https://github.com/ERPGulf/zatca_erpgulf
- GitHub stars: 58
- Forks: 85
- License: MIT
- Category: Localization
- Maintenance: Actively Maintained
- Frappe versions: develop
Install Zatca Erpgulf
bench get-app https://github.com/ERPGulf/zatca_erpgulf
Add the Frappe Gems badge to your README
Maintain Zatca Erpgulf? Paste this into your README:
[](https://frappegems.com/gems/apps/ERPGulf/zatca_erpgulf)
About Zatca Erpgulf
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
🔹Version 3.0 Enhancements ✨ Saves XML files directly without temporary storage → frees up hard disk space ✨ Improved performance for invoice generation & submission ✨ Enhanced error handling and logging for failed submissions ✨ Optimized QR code generation and attachment ✨ Updated compliance checks for latest ZATCA regulations 🔹 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! 🎯
✅ 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
🔹Version 3.0 Enhancements ✨ Saves XML files directly without temporary storage → frees up hard disk space ✨ Improved performance for invoice generation & submission ✨ Enhanced error handling and logging for failed submissions ✨ Optimized QR code generation and attachment ✨ Updated compliance checks for latest ZATCA regulations 🔹 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! 🎯
Related Localization apps for Frappe & ERPNext
- Wiki — Free and Open Source Wiki built on top of Frappe
- India Compliance — Simple, yet powerful compliance solutions for Indian businesses
- Nepal Compliance — Open source ERP for Nepal with HR, Payroll & Accounting compliance, based on ERPNext by Frappe Technologies.
- Erpnextswiss — ERPNext application for Switzerland-specific use cases
- Erpnext Germany — ERPNext customizations for German companies
- Ksa Compliance — KSA Compliance App for KSA E-invoice
- Kenya Compliance — KRA eTIMS Tax Compliance Integration This app works to integrate ERPNext with KRA's eTIMS via the Online Sales Control Unit (OSCU) to allow for the sharing of information with the revenue authority.via OSCU with ERPNext
- India Banking — Integrates ERPNext with ICICI, HDFC, AXIS, YES, Kotak Mahindra, HSBC, Union Bank and Bank of Baroda for INR transactions. Vendor Payouts, Payroll Payouts, Statement Reconciliation, Virtual Account for Receipts are handled as suported by specific banks