Portal das Finanças¶
Portal das Finanças is Portugal's tax authority portal (AT — Autoridade Tributaria). FaturaSync can emit recibos verdes (green receipts) directly through it using browser automation.
How this is different
Unlike InvoiceXpress, Moloni, and Vendus, Portal das Finanças does not have a public API. FaturaSync uses secure browser automation to fill in and submit the recibo verde form on your behalf. This means emissions are processed as background jobs rather than instant API calls.
Setup¶
You need AT (tax authority) credentials for each property:
| Field | Description |
|---|---|
| NIF | Your tax identification number (Número de Identificação Fiscal) — 9 digits |
| AT Password | Your Portal das Finanças password (senha de acesso) |
Where to find your credentials¶
- NIF — Your 9-digit Portuguese tax number. You can find it on any official tax document, your Cartão de Cidadão, or by logging in at portaldasfinancas.gov.pt
- AT Password — This is the password you use to log in to Portal das Finanças. If you've forgotten it, you can request a new one at the portal (Finanças will send it by post to your fiscal address)
AT password vs. Portal password
The AT password (senha de acesso) is specifically for the Autoridade Tributária portal. It's different from your Chave Móvel Digital or any other government authentication. Make sure you use the correct one.
Connect to FaturaSync¶
- Go to Settings in FaturaSync
- Select Portal das Finanças as your invoicing provider
- For each property, enter the NIF and AT Password
- Click Save
Per-property credentials
Each property can have its own NIF and AT password. This is useful if different properties are registered under different tax numbers (e.g. personal NIF vs. company NIF).
How emission works¶
- You select bookings and click Create Draft
- FaturaSync creates an emission job for each booking
- Each job goes through these stages:
| Status | Meaning |
|---|---|
| Pending | Job is queued and waiting to be processed |
| Processing | FaturaSync is filling in the recibo on the portal |
| Completed | Recibo was successfully emitted |
| Failed | Something went wrong — see error details |
The Jobs panel¶
After creating emissions, the Jobs panel appears showing real-time status of each recibo:
- View the status of each emission
- Download the PDF of completed recibos
- See error messages for failed emissions
- Retry failed jobs
Check back in a few minutes
Browser automation takes longer than API calls. Each recibo typically takes 15-30 seconds to process. You can leave the page and come back — the status updates automatically.
What's included in the recibo¶
| Field | Value |
|---|---|
| Service description | Alojamento Local (AL) |
| Amount | Base price (net of commission, before IVA) |
| IVA rate | Based on your property's location (4% Madeira/Azores, 6% mainland) |
| Reference | AL (Alojamento Local) |
| Client NIF | Guest NIF if provided, otherwise generic consumer |
Security¶
Your credentials are secure
Your AT password is stored encrypted and is only used during the emission process. FaturaSync never stores or accesses any other data from your Portal das Finanças account.
Troubleshooting¶
- "Invalid credentials" — Verify your NIF and AT password are correct. Try logging in at Portal das Finanças manually to confirm.
- Job stuck on "Processing" — This can happen if the portal is slow or undergoing maintenance. Wait a few minutes and check again.
- "Failed" status — Click the job to see the error details. Common causes:
- Portal das Finanças is temporarily unavailable
- The NIF/password combination is incorrect
- The tax activity for AL is not active on your NIF
- Missing PDF — PDFs are only available for completed emissions. If the job failed, fix the issue and retry.