ERPNext Egypt Compliance (ETA Integration)

A comprehensive integration module for ERPNext that streamlines and automates Egyptian tax compliance processes by connecting directly with the Egyptian Tax Authority's (ETA) systems.

🧩 About the Integration

The EG Compliance integration with ERPNext ensures businesses in Egypt can meet tax obligations accurately and on time—minimizing errors, reducing preparation time, and automating the submission of key documents like VAT returns and electronic invoices.

This integration equips ERPNext users with the necessary tools to comply with Egyptian tax laws efficiently by embedding real-time compliance within ERPNext, simplifying the tax process from start to finish.

🔑 Key Features

• VAT Calculation and Returns - Automated VAT calculation and return filing
• Electronic Invoicing - Generate and submit e-invoices to ETA
• Tax Return Filing - Streamlined tax return submission process
• Tax Document Management - Centralized management of all tax-related documents
• Real-time ETA Integration - Direct connection with Egyptian Tax Authority systems
• Dashboard & Reporting - Comprehensive status reports and monitoring
• Invoice Signing - Digital signature integration for compliance
• E-Invoice Download - Easy access to official e-invoice documents

🚀 Installation

Prerequisites

• ERPNext installation (version 14 or higher recommended)
• ETA Portal registration
• Valid Egyptian Tax Authority credentials
• Python 3.8+ (if installing from source)
• Git (if installing from source)

Installation

# Navigate to your Frappe bench directory
cd /path/to/your/frappe-bench

# Install the app using bench
bench get-app erpnext_egypt_compliance https://github.com/Axentorllc/erpnext_egypt_compliance.git

# Install the app on your site
bench --site your-site.com install-app erpnext_egypt_compliance

# Build assets
bench build

# Restart the bench
bench restart

Post-Installation Setup

After installation, you need to configure the integration:

1. Register ERPNext on ETA Portal
2. Configure the ETA Connector in ERPNext
3. Company Setup
4. Connect Customers, Items, and UOM to ETA Portal
5. Sales Taxes and Charges Template Setup
6. Create User in ERPNext
7. Install ETA Application Windows

Verification

To verify the installation:

1. Check if the app appears in your ERPNext Apps list
2. Verify that ETA-related menus and options are available
3. Test the connection to ETA portal
4. Create a test invoice to ensure functionality

▶️ Usage

Creating and Submitting E-Invoices

1. Create a Sales Invoice in ERPNext
2. Sign the Sales Invoice Using the ETA Windows App
3. Submit the Invoice to ETA

Managing E-Invoices

• Download E-Invoice - Retrieve official e-invoice documents
• Cancel E-Invoice - Cancel submitted invoices when necessary

Monitoring and Reporting

• ETA Sales Invoices Status Report - Track invoice submission status
• Dashboard ETA - Real-time monitoring of compliance activities

🌟 Benefits

• Automated Compliance - Reduces manual errors and ensures timely submissions
• Time Savings - Streamlines tax processes and reduces preparation time
• Real-time Integration - Direct connection with ETA systems for immediate feedback
• Comprehensive Reporting - Detailed dashboards and status tracking
• Regulatory Compliance - Ensures adherence to Egyptian tax laws and regulations

📚 Documentation

For detailed documentation, visit: EG Compliance Documentation

📹 Videos

• ERPNext Egypt Compliance App by Axentor

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

📞 Support

For support and questions, please refer to the official documentation or contact the development team.

---

Note: This integration is specifically designed for businesses operating in Egypt and requires proper ETA registration and credentials.