Egypt ETA E-Invoicing for Magento 2

Key Features

Real-time submission of B2B invoices to the ETA portal in the official ETA JSON/XML document schema, triggered by Magento's sales_order_invoice_save_after observer

Electronic seal / digital signature integration (CAdES signing via HSM or USB token through the ETA signing component) applied to every document before submission

GS1 / EGS product code mapping per catalog item, with admin tooling to assign GTIN or EGS codes to Magento products and fallbacks for uncoded SKUs

Egypt VAT (14%) and table-tax (T1) handling mapped to Magento tax classes and ETA tax sub-types, including exemptions and reverse-charge scenarios

Per-invoice UUID, long ID, and submission-status tracking (Valid / Invalid / Submitted / Cancelled) persisted and surfaced on the Magento order and invoice grids

Service contract API (Ecosire\EgyptEtaEinvoicing\Api\EtaSubmissionInterface) for clean dependency-injection consumption and unit testing

Admin configuration via system.xml: production vs. preprod ETA endpoints, taxpayer RIN, client ID/secret, branch and activity codes, encrypted credential storage

ACL-gated admin controllers and order-grid actions so only authorized roles can submit, view, or cancel ETA documents

Cron-based retry and status-polling worker that re-queries pending documents and reprocesses Invalid/Rejected submissions with exponential backoff

REST and GraphQL endpoints exposing clearance status and UUID for ERP, POS, or headless PWA Studio storefronts

Structured logging and an admin submission log so every ETA request/response (including validation errors from the portal) is auditable

Compatible with both Magento Open Source and Adobe Commerce; multi-store and multi-website aware so each store view can map to the correct ETA taxpayer profile

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

You order

Start with a one-time build price. We scope it with you at kickoff.

We build & install

ECOSIRE builds, configures and installs it on your Magento 2.

Go live + support

You go live in about 2–4 weeks, with a post-launch support window.

About this Product

This is not an instant Adobe Commerce Marketplace download. It is a build-to-order Magento 2 module that ECOSIRE engineers, installs under app/code/Ecosire/EgyptEtaEinvoicing, and supports directly on your Magento Open Source or Adobe Commerce instance.

Egyptian VAT-registered merchants are mandated to issue cleared B2B e-invoices through the ETA (Egyptian Tax Authority) system before they are legally valid. Magento core has no concept of ETA clearance, the electronic seal, or EGS/GS1 item coding — so every native invoice you generate is non-compliant on its own. We close that gap inside your existing order-to-invoice workflow.

When a Magento invoice is created, an observer on the sales_order_invoice_save_after event queues the document. A service contract (Ecosire\EgyptEtaEinvoicing\Api\EtaSubmissionInterface) maps the order to the ETA JSON document schema, resolves each line to its EGS / GS1 (GTIN) code, applies 14% VAT plus table-tax lines, signs the payload with your electronic seal (HSM or USB token via the ETA signing component), authenticates against the ETA API, and submits. The returned UUID, long ID, and submission status are persisted and shown on the order grid via a plugin/interceptor and an admin ACL-gated controller. A cron job polls pending/invalid documents and retries failures with backoff.

Everything is delivered with di.xml wiring, system.xml configuration (production vs. preprod ETA endpoints, taxpayer RIN, client credentials), and REST/GraphQL endpoints so your ERP, POS, or headless front end can read clearance state. We tune it to your tax profile, product catalog, and seal hardware, then hand over with documentation and a support window.

What you get

A custom Magento 2 module installed under app/code/Ecosire/EgyptEtaEinvoicing on your store, wired via di.xml, events.xml, and system.xml

ETA integration configured end-to-end against the ETA preprod (sandbox) environment, then cut over to production with your taxpayer RIN and client credentials

Electronic seal signing integrated with your HSM or USB token, including the signing component setup and a verified test clearance

EGS/GS1 code mapping applied to your live catalog, with an admin workflow for assigning codes to new products

REST + GraphQL endpoints documented for your ERP/POS/headless integration

Installation, configuration, and operator runbook documentation plus a short handover/training session

A defined post-delivery support window for bug fixes and ETA schema-change updates

Who this is for

Egyptian B2B Wholesaler / Distributor

A VAT-registered merchant selling to other businesses who must issue cleared e-invoices through the ETA portal. Needs every Magento invoice to carry a valid UUID and electronic seal so customers can deduct input VAT and the business stays compliant.

Finance / Tax Manager

Owns VAT filing and ETA compliance. Wants 14% VAT and table-tax mapped correctly, invalid submissions flagged and retried automatically, and a full audit log of every request and response to the Tax Authority for inspection.

Magento Developer / Systems Integrator

Maintains the store and downstream ERP/POS. Wants clean service contracts, di.xml-wired code, ACL-gated admin actions, and REST/GraphQL endpoints rather than a black-box extension, so ETA clearance state flows into existing systems.

How Egypt ETA E-Invoicing for Magento 2 Compares

Criterion	ECOSIRE	Custom Build	Competitor
Real-time ETA portal clearance from inside Magento invoice flow	Included	Partial support	Partial support
Electronic seal / digital signature (HSM or USB token) integration	Included	Partial support	Partial support
EGS / GS1 product code mapping tied to your live catalog	Included	Partial support	Partial support
Egypt 14% VAT and table-tax mapping to Magento tax classes	Included	Partial support	Partial support
Built, installed and supported on your specific store by the vendor	Included	Not included	Not included
Tailored to your tax profile, seal hardware and catalog	Included	Included	Not included
REST + GraphQL endpoints for ERP / POS / headless consumption	Included	Partial support	Partial support
Instant self-serve Marketplace download	Not included	Not included	Included

Frequently Asked Questions about Egypt ETA E-Invoicing for Magento 2

Is this an instant download from the Adobe Commerce Marketplace?

No. This is a build-to-order engagement. ECOSIRE builds the module for your specific Magento Open Source or Adobe Commerce instance, installs it under app/code, configures it against your ETA taxpayer profile and seal hardware, and supports it. There is no instant Marketplace download or self-serve install.

How long until it is live on my store after I order?

Typical delivery is around 2 to 4 weeks. We first integrate and test against the ETA preprod (sandbox) environment, map your catalog to EGS/GS1 codes, and validate a real signed clearance, then cut over to production. Timeline depends on the state of your catalog coding, your seal/HSM setup, and how quickly ETA portal credentials and access are provided on your side.

What do I need to provide before you start?

You need an active ETA taxpayer registration (RIN), client ID/secret and access to the ETA developer portal, your electronic seal certificate with its HSM or USB token, and admin/SSH access to your Magento environment (or a staging copy). We handle the module engineering, signing integration, and configuration.

Will you handle ongoing updates and support after delivery?

Yes. Delivery includes a defined support window covering bug fixes and updates for ETA schema or endpoint changes. After that window, ongoing maintenance is available as a support retainer so the integration keeps clearing invoices as the ETA system, Magento version, and tax rules evolve.

Does it work with Adobe Commerce and headless / PWA Studio storefronts?

Yes. The module is built on standard Magento 2 architecture (service contracts, observers, plugins, di.xml) and runs on both Magento Open Source and Adobe Commerce. Clearance status and UUIDs are exposed via REST and GraphQL, so a headless PWA Studio front end, ERP, or POS can read ETA state without touching the back end internals.