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

Blog

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

For freelancers

CIRS 8010, 8011, and 8012: Tax Obligations for Private Tutors, Trainers, and Teachers in Portugal

Three CIRS Art. 151 codes cover freelance education work in Portugal: 8010 (explicadores, private tutors), 8011 (formadores, trainers), 8012 (professores, teachers). All three carry the same taxable coefficient and the same withholding from Portuguese clients that keep organised accounting. Here is how to pick between them and what they mean for IRS, Social Security, and VAT.

Read more →
For freelancers

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

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

Read more →
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

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 calendar, and Social Security has its own portal. 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 1320 is a CIRS code, not a CAE registration code. 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 →
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 AT registered you for NHR, you keep it for your 10-year window. If you became resident from 2024, you might be on IFICI, on NHR under the transitional rules, or on standard rates. What each regime means for your tax filing, including the 7 qualifying routes, why you have to keep qualifying every year, 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 unavailable in Lagos. Empresa Online 2.0 running out of data to display for me. 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 your Portuguese company builds software products, the IRC simplified regime has two very different paths: 0.10 (other services) or 0.75 (listed professions). Sole proprietors face the same split under IRS, at 0.35 or 0.75. Which one applies to a SaaS isn't settled: 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's Empresa Online 2.0 lets you form a company online from €220, registered within days. On paper, one of the fastest company formation systems in Europe. A Swedish founder in the Algarve decides to test it.

Read more →