# Turn the Portal das Finanças into an API

> Read the documents you issued in e-Fatura, your Dívidas em Execução Fiscal and your Certidão de dívida e não dívida from the Portal das Finanças with one API call each. A workflow hands last month's documents to accounting before the 5th.

Page: https://fous.com/automate/portal-das-financas
Updated: 2026-11-12

Works with your own Portal das Finanças account. Fous is an independent product.

## What you can build on the Portal

### Get issued documents from e-Fatura

Reads Consultar Documentos (look up documents) under e-Fatura, Faturação, Emitente for a date range: the invoices, credit notes and debit notes your company communicated.

- Takes: Start date, end date, document type (optional)
- Returns: Document number, ATCUD, document date, document type, customer NIF, net total, tax payable, gross total

### Check Dívidas em Execução Fiscal

Reads Consulta Dívidas Fiscais, Dívidas em Execução Fiscal (tax debts under enforcement) and returns each debt the page lists.

- Takes: Nothing
- Returns: Each listed debt with its details and amount owed, total owed

### Request a Certidão de dívida e não dívida

Goes to Certidão, Pedir Certidão, selects Dívida e não dívida (debt and no-debt certificate), confirms, and reads the certificate that is issued.

- Takes: Nothing
- Returns: Regularised or not, amount in debt, issue date, valid until

### Enter a document directly in e-Fatura

Registers one invoice by direct entry in e-Fatura, for a company that communicates its invoice data on the Portal itself.

- Takes: Document type, document number, ATCUD, document date, customer NIF, net total, VAT rate, tax payable, gross total
- Returns: Document number, document date, gross total, confirmation message

## Automate the 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 e-Fatura documents, handed to accounting

Starts: Every month on the 2nd at 8:00, Lisbon time

1. Get issued documents from e-Fatura for the whole of the previous month.
2. Keep every document with its number, ATCUD, type and totals.
3. Post the list to your accounting system's webhook, to check against your billing before the 5th.

### New Dívidas em Execução Fiscal, every Monday

Starts: Every Monday at 8:00, Lisbon time

1. Check Dívidas em Execução Fiscal.
2. Keep the debts that were not there on the last run.
3. Email you each new debt with the details the page shows and its amount owed.

### Certidão de dívida e não dívida status, every month

Starts: Every month on the 1st at 9:00, Lisbon time

1. Request a Certidão de dívida e não dívida.
2. Keep whether the situation is regularised, the amount in debt and the valid until date.
3. Post the result to your webhook for the team that answers tenders and customer requests.

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 “Get issued documents from e-Fatura” 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": "www.portaldasfinancas.gov.pt/get_issued_documents",
    "input": {
      "start_date": "2026-10-01",
      "end_date": "2026-10-31",
      "document_type": "FT"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "issuer_nif": "111111111",
    "documents": [
      {
        "document_number": "FT 2026A/1042",
        "atcud": "JFT7K2PQ-1042",
        "document_date": "2026-10-28",
        "document_type": "FT",
        "customer_nif": "222222222",
        "net_total": 1250,
        "tax_payable": 287.5,
        "gross_total": 1537.5
      }
    ],
    "total_documents": 2
  }
}
```

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 Portal’s own options

AT offers an e-Fatura webservice (SOAP) for billing software: it registers, changes and deletes invoices, conference documents and receipts, and since version 3.0 of its manual (October 2025) it looks up invoices by issuer or acquirer. It signs in with the taxpayer's Portal credentials. Debts and certificates are on the Portal itself.

| Option | What it covers | What it takes |
| --- | --- | --- |
| e-Fatura webservice | Registers, changes the status of and deletes invoices, conference documents and receipts. Looks up invoices by issuer or acquirer NIF for a period. | Billing software that calls it over SOAP with the taxpayer's Portal credentials or a sub-user's. |
| SAF-T file upload | Communicates invoice data in a multi-document file based on SAF-T. | A file from your billing software, uploaded through the Portal or from the command line. |
| The Portal by hand | Consultar Documentos and direct entry in e-Fatura, Dívidas em Execução Fiscal, and Pedir Certidão for the Certidão de dívida e não dívida. | A NIF and senha de acesso, or the Cartão de Cidadão or Chave Móvel Digital. |

Read on November 12, 2026: [Manual de Integração de Software, e-Fatura, Comunicação por Webservice](https://info.portaldasfinancas.gov.pt/pt/apoio_ao_contribuinte/Outras_entidades/Suporte_tecnologico/Webservice/e_Fatura/Documents/Comunicacao_dos_elementos_dos_documentos_de_faturacao.pdf), [Questões Frequentes: Comunicação Elementos Faturas](https://info.portaldasfinancas.gov.pt/pt/apoio_contribuinte/questoes_frequentes/pages/faqs-00624.aspx), [Certidão de dívida e não dívida](https://info.portaldasfinancas.gov.pt/pt/apoio_ao_contribuinte/Dividas_e_coimas/Dividas/Certidao_de_divida_e_nao_divida/Paginas/default.aspx).

## Signing in to the Portal

The Portal signs you in on AT's authentication page with your NIF and senha de acesso, or with the Cartão de Cidadão or Chave Móvel Digital. With Fous you sign in once with your NIF and password through that page with your own account: the login is sealed with AES-256, and an expired session is signed back in.

## Worth knowing

- **Invoice data is due by the 5th**: Documents issued from 1 January 2023 must be communicated to AT by the 5th of the following month, by webservice, SAF-T file upload or direct entry on the Portal.
- **Sub-users with the WFA profile**: A sub-user created in the Portal's user management with the profile WFA - Comunicação de dados de faturas reaches the e-Fatura area. The taxpayer stays responsible for what a sub-user does.
- **The posted password works once**: A new senha de acesso arrives by letter through CTT at your tax address and can be used only once, so you set your own at the first sign-in. It needs at least 8 characters with upper and lower case, a digit and a special character.
- **The certificate lasts 3 months**: A Certidão de dívida e não dívida is available at once as a PDF and is valid for 3 months. When the situation is not regularised, it states the exact amount in debt.

## More in Government: Southern, Eastern and Nordic Europe, EU

- [Telemaco](https://fous.com/automate/telemaco.md)
- [EUDR Information System](https://fous.com/automate/eudr-information-system.md)
- [Road Transport Posting Declaration Portal](https://fous.com/automate/road-transport-posting-declaration-portal.md)
- [EU Funding & Tenders Portal](https://fous.com/automate/eu-funding-and-tenders-portal.md)
- [Cégkapu](https://fous.com/automate/cegkapu.md)
- [UETS](https://fous.com/automate/uets.md)
- [EPREL](https://fous.com/automate/eprel.md)
- [e-Zamówienia](https://fous.com/automate/e-zamowienia.md)
- [Mercell](https://fous.com/automate/mercell.md)
- [NEN](https://fous.com/automate/nen.md)
- [Plataforma de Contratación del Sector Público](https://fous.com/automate/plataforma-de-contratacion-del-sector-publico.md)
- [Prozorro](https://fous.com/automate/prozorro.md)
- [TRACES NT](https://fous.com/automate/traces-nt.md)
- [e-ΕΦΚΑ](https://fous.com/automate/e-efka.md)
- [PUE ZUS](https://fous.com/automate/pue-zus.md)
- [Segurança Social Direta](https://fous.com/automate/seguranca-social-direta.md)
- [SGK İşveren Sistemi](https://fous.com/automate/sgk-isveren-sistemi.md)
- [Sociálna poisťovňa e-Služby](https://fous.com/automate/socialna-poistovna-e-sluzby.md)
- [Dijital Vergi Dairesi](https://fous.com/automate/dijital-vergi-dairesi.md)
- [myAADE](https://fous.com/automate/myaade.md)
- [e-Beyanname](https://fous.com/automate/e-beyanname.md)

Other industries: [impots.gouv.fr espace professionnel](/automate/impots-gouv-fr-espace-professionnel), [The Compliance Engine](/automate/the-compliance-engine), [Teraview](/automate/teraview), [EDGAR Filer Management](/automate/edgar-filer-management), [eVA](/automate/eva), [NY Business Online Services](/automate/ny-business-online-services).

## Frequently asked questions

### Does the Portal das Finanças have an API?

Partly. AT's e-Fatura webservice lets billing software register, change and delete invoices, conference documents and receipts, and look up invoices by issuer or acquirer, using the taxpayer's Portal credentials. Dívidas em Execução Fiscal and the Certidão de dívida e não dívida are read on the Portal.

### Where do I see the invoices my company communicated to e-Fatura?

In e-Fatura, under Faturação, Emitente, Consultar Documentos. The webservice's invoice lookup returns the same kind of record: document number, ATCUD, date, type, net total, tax payable and gross total.

### How do I get a Certidão de dívida e não dívida?

Go to Certidão, Pedir Certidão, select Dívida e não dívida and confirm. The certificate is available at once as a PDF, is valid for 3 months, and shows the exact amount in debt if your tax situation is not regularised.

### Where can I check my company's tax debts?

On the Portal, under Consulta Dívidas Fiscais, then Dívidas em Execução Fiscal. You sign in with your NIF and senha de acesso. For questions about an enforcement process, AT answers through e-balcão.

### Is Fous affiliated with Autoridade Tributária e Aduaneira?

No. Fous is an independent product. You use it with your own Portal das Finanças 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 Portal das Finanças (Autoridade Tributária e Aduaneira). 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.