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 freelancer, 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 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 is not legal in Portugal
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 are not legally valid.
Every invoicing platform used to issue documents in the Portuguese system must be certified by the AT (Autoridade Tributária e Aduaneira) under Portaria 363/2010. Certified software communicates with AT systems, assigns ATCUD codes (unique document identifiers) to every invoice, and generates the SAF-T audit file. If you issue an invoice from an uncertified tool, that document doesn't exist in the Portuguese tax system. Your client's accountant can't deduct it. You can't reconcile it. It is not a Portuguese invoice.
Stripe Invoicing is not AT-certified. QuickBooks is not AT-certified. FreshBooks, Wave, Xero, your Shopify billing page: none of them are AT-certified. This catches a lot of expats who arrive with existing tools and don't realize they 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, it's certified, and it works. 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. She has to file a VAT declaration, even on Art. 53
Sara's revenue is under €15,000, so she's on the Art. 53 IVA exemption. No VAT charged. No quarterly VAT returns. Simple.
Except her Berlin client is a registered EU business. Under the reverse charge mechanism, Sara needs to report that cross-border service transaction in a separate quarterly filing: the Declaração Recapitulativa. This is an EU-specific reporting document for intra-community B2B services. It tracks the VAT obligations that have been shifted to the buyer's country.
It is separate from the standard VAT declaration. It exists regardless of whether you're on Art. 53. And it is required from your first EU invoice.
For most Portuguese freelancers with domestic clients, this filing doesn't exist. For Sara, it does. The "no VAT admin under €15,000" assumption only holds for the domestic leg.
There's also the reverse charge on what Sara buys. Stripe charges her for payment processing. Google charges her for Workspace. These are EU businesses providing services to a Portuguese-resident business customer. Under Art. 2(1)(g) CIVA, Sara may owe Portuguese reverse-charge VAT on those purchases, which needs to appear in her Declaração Periódica. The suppliers don't collect it. She accounts for it herself.
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.
3. She cannot use IRS Automático
In Portugal, about one third of 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 has covered employees and pensioners for years. Since 2024 it also covers some simplified-regime freelancers with specific Art. 151 activity codes, all invoices issued via the AT portal, Portugal-source income only, and no NHR or IFICI status.
Sara hits every knock-out simultaneously. NHR status requires Anexo L: excluded. The Berlin client means foreign income requiring Anexo J: excluded. The Google Workspace and Stripe expenses require manual entry in Anexo H regardless.
She files a Modelo 3 with Anexo B for self-employment income, Anexo SS for the Social Security reconciliation, and potentially Anexo L for her NHR regime. 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 two options: register each invoice manually on the e-Fatura portal as the acquiring party (registar fatura as adquirente), or declare them directly in Anexo B, Quadro 17 of her IRS Modelo 3 filing. She keeps the originals and payment proof for 10 years (Art. 52 CIVA). The 4-year figure cited on many Portuguese banking and blog sites is the AT's caducidade, the window AT has to reassess a return, not the document-retention obligation. 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
Portuguese clients paying for Art. 151 professional services are required to withhold IRS at source: currently 23% under the simplified regime. That money goes directly to the AT. Sara's taxes are being paid in real time, invoice by invoice. At year-end, most of it is already settled.
Sara's Berlin client does not withhold anything. 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 Declaração Recapitulativa. 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 certified invoicing: AT-certified documents with ATCUD codes, correct exemption codes for foreign clients (code 090 for EU/non-EU B2B, code 122 for Art. 53 domestic), multi-currency support, and the SAF-T communication the AT requires.
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, 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 freeWorking for yourself in Portugal - monthly
Invoicing, VAT, Social Security, expenses, and tax, explained simply. One email a month.