# Turn Egyptian Tax Authority e-Services into an API

> Read the invoices behind your نموذج 10 VAT return, your submitted returns and your withholding transactions from the e-tax portal with one API call each. Or have a workflow total last month's sales and purchases invoices and email you the result each month.

Page: https://fous.com/automate/egyptian-tax-authority-e-services
Updated: 2026-11-12

Works with your own Egyptian Tax Authority e-Services account. Fous is an independent product.

## What you can build on the e-tax portal

### List VAT invoices for a tax period

Reads عرض الفواتير (view invoices) under القيمة المضافة (VAT) for one tax period, sales or purchases.

- Takes: Tax period (month and year), sales or purchases
- Returns: Invoice number, invoice date, counterparty name, counterparty registration number, amount before tax, VAT

### List submitted returns

Reads عرض الإقرارات (view returns) under القيمة المضافة or ضريبة الدخل (income tax) for the years you name.

- Takes: Tax type (VAT or income tax), year
- Returns: Form number, tax period, submission date, tax due

### List withholding transactions

Reads عرض التعاملات (view transactions) under الخصم والتحصيل (withholding and collection), or only the rows listed in عرض التعاملات الخاطئة (view erroneous transactions).

- Takes: Tax period, all or erroneous only
- Returns: Transaction date, counterparty name, counterparty registration number, amount, tax withheld, error

### Add a withholding transaction

Opens اضافة تعامل (add transaction) under الخصم والتحصيل, fills in one transaction and saves it.

- Takes: Counterparty registration number, transaction date, amount, tax withheld
- Returns: Counterparty name, transaction date, amount, tax withheld, saved or error

## Automate the e-tax portal with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Last month's VAT invoices, totalled for finance

Starts: On the 3rd of every month at 9:00, Cairo time

1. Get last month's sales invoices and purchases invoices from عرض الفواتير.
2. An AI step totals amount before tax and VAT for each side and lists the ten largest invoices.
3. Email you the totals and the list before the نموذج 10 return is prepared.

### New erroneous withholding transactions

Starts: Every Monday at 8:00, Cairo time

1. Read the current period's rows in عرض التعاملات الخاطئة.
2. Keep the rows that were not there on the last run.
3. Post each one, with counterparty, amount and the error, to your accounting system's webhook.

### New VAT and income tax returns in عرض الإقرارات

Starts: On the 1st of every month at 10:00, Cairo time

1. Get this year's VAT returns and income tax returns from عرض الإقرارات.
2. Keep the returns that were not there on the last run.
3. Email you form number, tax period, submission date and tax due.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “List VAT invoices for a tax period” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "eservice.incometax.gov.eg/list_vat_invoices",
    "input": {
      "tax_period": "2026-10",
      "side": "sales"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "tax_period": "2026-10",
    "side": "sales",
    "invoices": [
      {
        "invoice_number": "INV-2026-1184",
        "invoice_date": "2026-10-07",
        "counterparty_name": "Northwind Trading S.A.E.",
        "counterparty_registration_number": "100-200-300",
        "amount_before_tax": 48500,
        "vat": 6790,
        "currency": "EGP"
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## The e-tax portal’s own options

The Egyptian Tax Authority publishes APIs for e-invoices and e-receipts, for taxpayers' ERP and POS systems. The e-tax portal itself, where VAT, withholding, payroll and income tax returns are filed, has no published API: it takes invoices and withholding transactions as file imports from its own templates, and everything else by hand.

| Option | What it covers | What it takes |
| --- | --- | --- |
| E-invoicing and e-receipt APIs | Submitting and retrieving e-invoices and e-receipts, and retrieving notifications, from an ERP or POS system. | API access credentials set up in your ERP or POS system, an access token from ETA's identity service, and documents signed with a digital signature. |
| File import in the e-tax portal | VAT invoices through استيراد الفواتير and withholding transactions through استيراد التعاملات من الملف. | A signed-in account and the purchases, sales or transactions file templates downloaded from the portal. |
| The e-tax portal by hand | Returns, invoices and withholding transactions per section, payroll forms 2 to 8, extension requests and electronic payment. | A taxpayer or accountant account registered on the portal. |

Read on November 12, 2026: [ETA eInvoicing and eReceipt SDK](https://sdk.invoicing.eta.gov.eg/start/), [E-tax portal (menus and sign-in)](https://eservice.incometax.gov.eg/ETax/Home/About).

## Signing in to the e-tax portal

The e-tax portal signs you in with your user name and password, with a تذكرنى (remember me) option, and resets a forgotten password by email. Taxpayers and accountants register separately, and completing an account's details asks for an activation code sent by email. With Fous you sign in once through the portal's own sign-in, the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Expenses count only through e-invoices**: The portal tells taxpayers that from 1 July 2023 expenses are accepted in the tax return only through the electronic invoice. A purchase without an e-invoice does not count as an expense.
- **Imports have their own error list**: The withholding menu lists عرض التعاملات الخاطئة (view erroneous transactions) beside استيراد التعاملات من الملف (import transactions from file). VAT invoice imports follow the portal's templates and إرشادات إستيراد الفواتير.
- **VAT and withholding close periods separately**: The VAT menu and the withholding menu each have their own غلق الفترة الضريبية (close tax period) entry. None of the methods above closes a period.
- **ETA runs a second taxpayer portal**: eta.gov.eg also links بوابة الممول (taxpayer portal) on workspace.eta.gov.eg, with its own guides for the new main tax system. Check which portal your returns are filed on before you build.

## More in Government: Middle East and Africa

- [CAC Company Registration Portal](https://fous.com/automate/cac-company-registration-portal.md)
- [CIPC eServices](https://fous.com/automate/cipc-eservices.md)
- [GDRFA Dubai Smart Services](https://fous.com/automate/gdrfa-dubai-smart-services.md)
- [eTIMS](https://fous.com/automate/etims.md)
- [Rev360](https://fous.com/automate/rev360.md)
- [Qiwa](https://fous.com/automate/qiwa.md)
- [ICP Smart Services](https://fous.com/automate/icp-smart-services.md)
- [KRA iTax](https://fous.com/automate/kra-itax.md)
- [SARS eFiling](https://fous.com/automate/sars-efiling.md)
- [SIMPL](https://fous.com/automate/simpl.md)
- [ZATCA e-Services](https://fous.com/automate/zatca-e-services.md)
- [uFiling](https://fous.com/automate/ufiling.md)
- [EmaraTax](https://fous.com/automate/emaratax.md)
- [Mudad](https://fous.com/automate/mudad.md)

Other industries: [Plataforma de Contratación del Sector Público](/automate/plataforma-de-contratacion-del-sector-publico), [MOT Testing Service](/automate/mot-testing-service), [Florida Courts E-Filing Portal](/automate/florida-courts-e-filing-portal), [LMS Conveyancer Zone](/automate/lms-conveyancer-zone), [CM/ECF](/automate/cm-ecf), [NC eProcurement](/automate/nc-eprocurement).

## Frequently asked questions

### Does Egyptian Tax Authority e-Services have an API?

Not for returns. ETA publishes APIs for e-invoices and e-receipts, used from your ERP or POS system with credentials and a digital signature. VAT, withholding, payroll and income tax returns on the e-tax portal are filed in the portal, with file imports for invoices and withholding transactions.

### Can I upload many invoices or withholding transactions at once?

Yes, by file. Under القيمة المضافة the portal offers استيراد الفواتير with purchases and sales file templates, and under الخصم والتحصيل it offers استيراد التعاملات من الملف with its own template, next to the عرض التعاملات الخاطئة list.

### Where is the e-tax portal's user guide?

Inside the portal: دليل المستخدم sits in the خدمات (services) menu and opens after you sign in. ETA also publishes per-form guides and videos on eta.gov.eg, written for the new main tax system and its بوابة الممول (taxpayer portal).

### Is Fous affiliated with the Egyptian Tax Authority?

No. Fous is an independent product. You use it with your own e-tax portal account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Egyptian Tax Authority e-Services (Egyptian Tax Authority). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.