IRS filing season is open. File your IRS for free (early access) →
descodify

Blog

Guides, tips, and insights for solo entrepreneurs in Portugal.

For freelancers

NHR Is Closed: IFICI Is Portugal's Tax Regime for New Arrivals

NHR (Non-Habitual Resident) closed to new applicants at the end of 2023. Arriving in Portugal in 2025 or 2026? IFICI is the regime that replaced it: the same 20% flat rate, a 10-year window, and a different eligibility structure. Who qualifies, how to apply, and what changed.

Read more →
For freelancers

CAE vs CIRS Portugal: What Activity Code Do You Actually Need as a Designer?

You searched 'CAE 1336 Portugal' or 'activity code designer Portugal' and landed here. The confusion is the same one programmers run into with 1332: CAE and CIRS are two separate systems, and designers use CIRS, not CAE. Here's what CIRS 1336 covers, how it affects your IRS coefficient and withholding, and what changes when your clients are outside Portugal.

Read more →
For freelancers

How to File Taxes in Portugal as a Freelancer

Portugal has three separate tax obligations for freelancers and expats: IRS (income tax), IVA (VAT), and Social Security. Each has its own portal and its own calendar. This post explains what each one is, when it's due, and where to file it.

Read more →
For freelancers

CAE vs CIRS Portugal: What Activity Code Do You Actually Need as a Consultant?

You searched 'CIRS 1320 Portugal' or 'activity code consultant Portugal' and landed here. The confusion is the same one programmers run into with 1332: CAE and CIRS are two separate systems, and consultants use CIRS, not CAE. Here's what CIRS 1320 covers, how it affects your IRS coefficient and withholding, and what changes when your clients are outside Portugal.

Read more →
For freelancers

Why Portuguese tax automation doesn't work for expat freelancers

IRS Automático, e-Fatura, and AT-certified invoicing tools are built around a Portuguese freelancer with Portuguese clients. The moment you add a foreign client, a foreign supplier, or a non-Portuguese invoicing tool, the automation breaks. Here's exactly where it breaks and why.

Read more →

Why building privacy-first is finally practical

For years, building privacy-first meant accepting slower development. You either bolted on a dozen SaaS suppliers and shipped fast, or you did it properly and fell behind. That tradeoff is gone. Here's why, and what it looks like in practice at Descodify.

Read more →

EU data sovereignty, the hard way

Keeping your data under EU jurisdiction is harder than the normal way of building software. What EU data sovereignty looks like in practice at Descodify: no AWS or Google Cloud, no Google Analytics, as few third parties as possible, and an honest look at the gaps.

Read more →

Why every Portuguese invoice has a QR code

Every invoice issued in Portugal carries a QR code. Here is what it encodes, how the AT-certified software system works, and why Portugal built this infrastructure years before most of Europe started thinking about it.

Read more →
For freelancers

Your First IRS Filing in Portugal: A Starter's Guide

New to Portugal and not sure if you even need to file IRS? This guide covers partial-year tax residency under CIRS Art. 16, how residency starts from your first day of stay, split-year income, two Modelo 3 declarations, IFICI timing, and the mistakes that catch first-time filers off guard.

Read more →
For freelancers

NHR vs IFICI in 2026: What Expat Freelancers Need to Know

If you moved to Portugal before 2024, you're likely on NHR. After 2024, you might be on IFICI, or on standard rates. Here's what each regime means for your tax filing, including the full 7 qualifying routes, the per-year recertification trap, and what happens if you miss the January deadline.

Read more →
Part of: Registering a Company in PortugalFor companies

Company Registration: Heard of SOLVIT?

Empresa Online 2.0 silently rejects non-Portuguese EU citizens despite accepting CMD login. The EU single market fix is SOLVIT, a free complaint network almost nobody knows exists. Here's how I used it.

Read more →
Part of: Registering a Company in PortugalFor companies

Company Registration: One Step Forward, Many Steps Sideways

Name approved after six days. CMD activated in twenty minutes. Empresa na Hora suspended in Lagos. Empresa Online 2.0 running out of data to display for EU citizens. A day of Portuguese company registration that didn't go as the brochure suggested.

Read more →
Part of: Bootstrapping a Startup in PortugalFor companies

Portugal SaaS Tax Regime: Which IRC Coefficient Applies If You Build Software?

If you're a freelancer or sole proprietor in Portugal who builds software products, the IRC simplified regime has two very different paths: 0.10 (other services) or 0.75 (listed professions). Which one applies to you isn't settled. Here's what the law says, where it's ambiguous, and what to ask your contabilista.

Read more →
Part of: Registering a Company in PortugalFor companies

Starting a Business in Portugal in 24 Hours

Portugal launched Empresa Online 2.0 in 2024, EU-funded, 10 minutes to submit, €220. On paper, one of the fastest company formation systems in Europe. A Swedish founder in the Algarve decides to test it.

Read more →