ETA e-invoicing: setup

ekPOS issues e-invoices and e-receipts to the Egyptian Tax Authority (ETA), and credit notes for returns. This page covers the one-time setup; Submitting documents covers day-to-day use.

Open Integrations → ETA. The page has three tabs: Setup, Submissions and Item Codes.

Invoice or receipt?#

ekPOS decides for each sale:

Before you start: your data#

ETA rejects documents with missing identity details. Check these first:

1. Connection to ETA#

1. In the ETA portal, open Taxpayer Profile → ERP registration and register or regenerate your ERP credentials.
2. In ekPOS, choose the Environment — Sandbox (Pre-production) for testing or Production.
3. Enter the Client ID (a GUID such as 11111111-2222-3333-4444-555555555555, not your login email) and the Client Secret. Leave the secret blank later to keep the stored one.
4. Click Test Connection.

The same credentials cover e-invoices and e-receipts. The badge at the top changes from Not Connected once the connection works.

2. Document signing (e-seal)#

Your e-seal lives on a USB token, so documents are signed on the computer the token is plugged into, by a small program called ekSigner:

1. On that Windows computer, click Download ekSigner and run the installer. The file comes from ekSigner's public release page on GitHub. When the page shows the file's size and SHA-256, you can check the downloaded file against them; if GitHub can't be reached at that moment, the button still works but shows neither. Windows warns that the publisher is unrecognised; choose More info → Run anyway, and only for the file downloaded from this page.
2. Start ekSigner and reload the ETA page.
3. Pair ekPOS with ekSigner, using the pairing code shown on ekSigner's own page.
4. Load certificates, then choose your organisation's e-seal certificate.

Until a certificate is chosen, Sign & submit stays greyed out.

3. Document preparation#

Choose what ekPOS prepares automatically:

• Prepare an e-invoice when a B2B sale is completed.
• Prepare an e-receipt when a B2C sale is completed.
• Prepare a credit note when a return is finalized.

Set the Default Activity Code if it differs from the one in Business Settings.

Service item for shipping and extra charges#

ETA has no field for shipping or extra charges, so ekPOS sends them as a line under a service item of your own. Register one with ETA (usually an EGS code, written EG-<your tax registration number>-<your code>), then enter its Code type, Item code and Unit here.

4. Per-branch POS device#

e-Receipts must carry a device serial that ETA issued to you. Register a POS device for each branch in the ETA portal, then enter its Device serial here. The placeholder serial ekPOS generates keeps receipts well-formed but ETA rejects it (error CF317). The device Client ID and Secret are stored for future use.

Click Save; the connection is re-checked.

Item codes#

Every product on an ETA document needs an item code that ETA has approved.

• A product with a GS1 barcode code: set Code Type GS1 and the ETA Item Code on the product.
• Otherwise register an EGS code: on the Item Codes tab, click Register with ETA (EGS) on the product.

A registered code stays Pending until an ETA reviewer approves it, and ETA doesn't notify you. Click Check pending codes from time to time; codes move to Approved or Rejected. Filter by status to see which products still need a code.

Who can do this#