Skip to content

User Manual

Add-on

ETA — Egypt e-invoicing

Submit B2B invoices to Egypt's Tax Authority. Upload your certificate, map your codes, and have every sale clear the ETA portal automatically.

Route
/dashboard/addons/eta
Roles
Add-ons permission to set up; no permission needed to ring up sales once it's live.
01

Overview

Egypt's ETA requires every B2B invoice to be mapped to item and customer codes, signed, and submitted to the authority portal. The add-on builds the ETA document structure, signs it with your uploaded certificate, and tracks its status from Draft → Submitted → Valid (or Invalid, with errors attached for you to fix).

02

Activation

  1. 1Dashboard → Add-ons → ETA → Activate.
  2. 2Open the ETA page. If you have multiple locations, pick the one you're configuring — ETA is per-location because tax branches differ.
  3. 3Three tabs: Settings, Onboarding, Invoices. Settings first.
03

Settings

  • Tax Registration Number, Activity Code, Branch ID.
  • Company name in Arabic and English.
  • Full Egyptian address: governorate, region/city, street, building number, postal code, floor, room.
  • Environment: Preproduction for testing, Production for live.
  • API Credentials: Client ID and Client Secret from your ETA developer account.

Prefill & copy

Like ZATCA, you can Prefill address from the location and Copy from another location if more than one branch shares a legal entity.

04

Certificate & connection

  1. 1Step 1: Configure Settings — this is ticked once you've saved a valid settings tab.
  2. 2Step 2: Upload Certificate — upload a PKCS#12 (.p12 or .pfx) certificate and enter the password. Once uploaded, the card shows the serial, issuer, and expiration date.
  3. 3Step 3: Test Connection — Momentfy hits the ETA API with your credentials and certificate. Green Completed means live.
05

Submitting & cancelling

The Invoices tab lists every ETA invoice with its current state. Filters: Draft, Pending, Submitted, Valid, Invalid, Cancelled.

  • Submit Now pushes all Draft/Pending invoices in one batch.
  • Per-row Send button submits a single invoice.
  • For Submitted or Valid invoices, the ✕ button opens a Cancel dialog — type a reason and confirm. The ETA portal accepts cancellations with reason codes.
  • The invoice detail modal shows the internal ID, ETA UUID, Long ID, full error list, and per-attempt submission timeline.

Invalid needs fixing

Invalid status means ETA rejected the document — usually a missing item or customer code. Fix the sale, then click Retry Submit on the invoice.

06

Tips

  • Map all your top-selling SKUs to ETA item codes before going live. An unmapped item at the counter blocks the submission.
  • Run a few sandbox submissions end-to-end before switching to Production — most rejections come from schema surprises, not from your setup.
  • The hourly retry handles transient failures; don't keep re-pressing Submit.