Descodify is invitation-only and opens to new users in January 2027. Read your IRS declaration free, no sign-up needed →
descodify
← Back to blog
For freelancers

Why Portuguese tax automation doesn't work for expat freelancers

By Mikael

When I set up as a freelancer in Portugal, I assumed the Portuguese tax system would just work for me the same way it works for my Portuguese neighbours. They manage their invoicing through the AT portal and it syncs with everything automatically. Their expenses show up pre-filled in e-Fatura. Some of them click one button and their IRS is done.

I do not have that experience. Not even close.

The reason isn't complexity or bureaucracy (though there's plenty of that). The reason is that the Portuguese tax automation infrastructure was built around a specific scenario: a Portuguese person providing services to Portuguese clients, paying Portuguese suppliers, with no foreign income and no foreign tools. The moment you break any of those assumptions, the automation breaks with it.

Most expat freelancers break all of them at once.


The five places where it breaks

The situation I'm describing is Sara's situation. She moved to Lisbon from Amsterdam two years ago, registered as a sole trader, and has one EU-based design client in Berlin. She pays for Stripe, Google Workspace, and Adobe Creative Cloud. She's on the simplified regime, under €15,000.00 revenue, and genuinely trying to do things correctly. She researches Portuguese tax, reads that it's automated and simple, and then discovers that none of that applies to her.

Here's where it breaks.

1. Her invoicing software isn't AT-certified

Sara was already using a nice invoicing tool from her Amsterdam days. Clean interface. Good multi-currency support. She kept using it in Portugal.

Those invoices don't meet the Portuguese rules.

If you invoice with software at all, that software must be certified by the AT (Autoridade Tributária e Aduaneira). The obligation sits in Article 4 of Decreto-Lei 28/2019, and it applies at any turnover. Certified software communicates with AT systems, assigns ATCUD codes (unique document identifiers) to every invoice, and generates the SAF-T audit file. Invoicing from uncertified software breaches that article, so you can't build your Portuguese bookkeeping on it.

Invoicing tools built for other markets were not made for this. Before you invoice from one, look it up on AT's list of certified programs. This catches a lot of expats who arrive with existing tools and don't realize they may need to start over.

The alternative is the AT portal itself (Portal das Finanças), which lets you issue Recibos Verdes directly. It's free, and as AT's own system it is a lawful alternative to certified software. It's also a Portuguese government web portal from approximately 2009, so your mileage may vary.

If you're a developer registered under CIRS 1332, the activity-code mechanics layer onto this. See how CAE vs CIRS works and what code 1332 means for your obligations.

2. Foreign suppliers can pull her into a VAT return, even on Art. 53

Sara's revenue is under €15,000.00, so she's on the Art. 53 IVA exemption. No VAT charged on domestic work, and no VAT returns for it. Simple.

Her Berlin client is a registered EU business, so the design work she does for them falls outside Portuguese VAT. Her invoice carries the "IVA - autoliquidação" mention. And since 1 July 2025 she has no Declaração Recapitulativa to file for it: DL 35/2025 removed that obligation for Art. 53 taxpayers. If she were in the normal VAT regime she would still report that service in the recapitulativa.

What does catch her is the other direction. When Sara buys a business service of the general kind (a software subscription, say) from a business that has no seat, establishment or domicile in Portugal, Art. 2.º n.º 1 e) CIVA makes her, the buyer, liable for the Portuguese VAT. She self-assesses it, and it goes on a Declaração Periódica for the periods in which she has such purchases. The supplier doesn't collect it. Whether a given Stripe or Google Workspace invoice is caught depends on the invoice itself, so read it before you assume.

Most Portuguese freelancers with exclusively Portuguese suppliers don't encounter this. Their suppliers are in the AT system. The VAT is handled at source. For Sara, there's no source to handle it. The "no VAT admin below the threshold" assumption only holds for the domestic leg.

3. She cannot use IRS Automático

In Portugal, many IRS filers get a pre-filled declaration that they can approve with a single click. It pulls in their employment income, applies the right brackets, accounts for standard deductions, and produces a result. Many people describe Portuguese IRS as essentially automatic.

Sara is not those people.

IRS Automático covers employees and pensioners. It also covers some simplified-regime freelancers, under conditions set by Decreto Regulamentar 3/2024. Among them: being registered only for activities in the Art. 151 table (none under the catch-all code 1519), invoices issued exclusively on the AT portal, income only from Portuguese payers who report it to AT, Portuguese tax residence for the whole year, and not being on NHR.

Sara misses at least two of those on her own. The rule only covers income from payers who report it to AT, and her Berlin client doesn't: excluded. And an invoicing tool of her own, instead of the AT portal, takes her out of the second condition. The Google Workspace and Stripe expenses need manual entry in Anexo B regardless.

She files a Modelo 3 with Anexo B for self-employment income and Anexo SS for the Social Security reconciliation. Where the Berlin income goes on top of that is a question for her contabilista certificado. None of it is automatic. All of it requires understanding what each campo does and filling it correctly.

4. Her expenses disappear

When a Portuguese freelancer buys something from a Portuguese supplier, that transaction flows through the AT's e-Fatura system automatically. The supplier's AT-certified software communicates the invoice to the tax authority. The buyer's NIF is on the document. The expense appears in the buyer's e-Fatura account, ready to be categorized and used as a deductible expense.

Sara's Google Workspace invoice has no Portuguese NIF on it. It doesn't go through an AT-certified system. It never appears in her e-Fatura.

Same with Stripe. Same with Adobe. Same with any subscription, service, or tool from outside the Portuguese AT system.

If she wants those expenses to count toward the 15% documented expense requirement, she has to declare them herself in Anexo B, Quadro 17 of her IRS Modelo 3 filing. For purchases from a supplier in another EU member state, that is Quadro 17A, campo 17002, which the statute reserves for exactly this. How a purchase from outside the EU counts toward the 15% is not settled, so ask your contabilista certificado about those. She keeps the originals and payment proof for 10 years (Art. 52 CIVA). There's no automatic aggregation. There's no pre-filled list. She maintains her own expense records for everything she buys from foreign suppliers.

This is not complicated. But it is manual in a way that Portuguese-domestic expenses are not. And if nobody tells you this is how it works, you assume your expenses are being captured and discover in April that they weren't.

5. Nobody withholds tax for her

A Portuguese client that keeps organised accounting (a company, for instance) is required to withhold IRS at source on the professional activities listed in the Art. 151 table: currently 23%. That money goes directly to the AT. For a freelancer with companies as clients, taxes are paid in real time, payment by payment, and the withholding is credited against the IRS due at year-end.

Sara's Berlin client does not withhold anything. A foreign client normally has no Portuguese organised-accounting obligation, and that, not its nationality, is why it doesn't withhold. The full invoice amount lands in her account. No tax has been sent to anyone.

She still owes IRS on that income at filing time. The difference is that she needs to have set it aside herself, because no mechanism pre-paid it. That's a cash flow discipline issue, not a legal one, but it's one more thing that works automatically for domestic income and manually for foreign income.


Why it matters for the tools you choose

The way the Portuguese system works has a direct consequence for which tools are useful to an expat freelancer.

Any tool that only handles the simplified domestic case, which is most of the market, leaves Sara managing the foreign legs herself. The invoicing software that's great for a Portuguese consultant with Portuguese clients doesn't help with the reverse charge on foreign supplier invoices. The expense tracker that pulls from e-Fatura misses every foreign supplier invoice. The IRS helper that walks you through Anexo B doesn't address NHR or foreign income.

The gap between "great for a Portuguese freelancer" and "actually handles my situation" is exactly the cross-border friction described above.


What Descodify handles for the expat case

The reason we built Descodify the way we did is that these five friction points are not edge cases for our users, they are the baseline. The majority of expat freelancers in Portugal invoice at least one foreign client, pay at least one foreign subscription, and have at least one complication that the standard automation doesn't cover.

The free tier covers invoicing: documents with ATCUD codes, correct exemption codes for foreign clients (code 115 for EU B2B services, code 122 for Art. 53 domestic) and multi-currency support. Descodify's AT software certification is still in progress, and until it holds one, issue your invoices from the AT portal or another certified program.

Completo (€19/month) handles the full picture: expense capture including foreign supplier invoices, quarterly VAT and Social Security calculations, the Declaração Recapitulativa for EU clients if you are in the normal VAT regime, and IRS preparation through Modelo 3 with Anexo B and Anexo SS. It surfaces the withholding delta so you know what to budget for.

The goal is not to make Portuguese tax simple, because it genuinely isn't, once you add cross-border. The goal is to make sure you're not surprised by obligations that apply to you specifically, because of how your business is actually structured.

If you're just starting out and want to understand whether these five points apply to your situation, the VAT guide for solo entrepreneurs covers the Art. 53 cross-border mechanics in detail. The invoicing software comparison explains the AT certification requirement and what to look for. And if you're on NHR or IFICI, the NHR vs IFICI guide covers the filing implications.

Related: VAT in Portugal as a solo entrepreneur

Related: Best invoicing software for Portuguese freelancers in 2026

Related: Invoicing foreign clients as a solo entrepreneur in Portugal

Descodify handles invoicing, VAT, and IRS reporting so you can focus on your work.

Try Descodify free

Working for yourself in Portugal - monthly

Invoicing, VAT, Social Security, expenses, and tax, explained simply. One email a month.