Skip to main content

Getting started with Finbooks in Portugal

⚪️ User guide

This guide takes you from your first login to your tax report: what Finbooks does for Portuguese users, how to add your first connection and how to check your data before you generate the reports for your IRS return.

If you are on the free trial, you have 7 days, so we suggest you have your API keys or exported files ready before you start.


What Finbooks does and doesn't do

Finbooks does:

  • import your transactions from exchanges, wallets and brokers

  • calculate your capital gains and losses and your crypto income following Portuguese rules

  • produce precompiled reports with the figures you need to fill in the annexes of your Modelo 3 IRS declaration and, where it applies, your Stamp Duty (DMIS) declaration

  • apply the FIFO (First In, First Out) method, separately for each asset and for each wallet or exchange, and the 365-day holding rule: crypto sold after being held for at least 365 days is generally exempt from capital gains tax

Finbooks doesn't:

  • file your tax return for you or send anything to the Portuguese Tax Authority: you use the reports to complete and submit your own declarations

  • replace tax advice

To learn which crypto transactions are taxable in Portugal, read the Portugal Tax Guide. To see how gains are calculated, read Portugal Cashout methods.

ℹ️ Reports need a paid plan

Tax reports are not available during the free trial or on a free plan, and can only be generated with a paid plan. Everything else, from connections to portfolio, can be tested during the trial. The free trial lasts 7 days from the creation of your account and includes everything except downloading reports. You don't need to enter payment details and you are not charged. If you don't subscribe when the trial ends, your account moves to the free plan. The free plan allows up to 100,000 transactions per year, so in practice the limits are on features, for example you can't download reports. Read Free accounts limitations.

The free trial allows up to 20,000 transactions. The paid plans are Newbie, Enthusiast, Trader and Unlimited, and they differ in the number of transactions you can import. Read Transaction limit criteria and calculation for the limits, and Regular Plan Upgrade to subscribe or change plan.


Step 1: set up your account

Your tax country

Finbooks calculates your taxes according to your tax country. You set it during the initial onboarding of your account, so choose Portugal when you are asked.

Enable crypto and traditional finance

Crypto and traditional investments are managed in separate sections. If you only see one of them, enable the other:

  1. hover your mouse over the name of your plan, then click on Account

  2. click on the Settings tab

  3. scroll down to Manage active investment type

  4. on the line of the section you need, click on Enable


Step 2: add your first connection

You can import your data in three ways. Which one you can use depends on the platform:

Method

When to use it

Guide

API

the platform offers an API connection

Native file

Finbooks supports the CSV or Excel file exported by the platform

the connection guide of your platform

Custom CSV

the platform is not supported natively

To add a connection:

  1. click on Connections in the left-hand menu

  2. click on Add connection in the top right corner

  3. type the name of your platform in the search field and select it

  4. assign a unique name to the connection

  5. follow the connection guide for your platform: enter the API key and secret, add the public address of your wallet, or upload your file

For files, read How to upload a CSV/Excel file. To see which platforms are supported, check All the connections available on Finbooks.

⚠️ Import your complete history

Import everything from the first day you used each platform, not just recent transactions. Without it, Finbooks can't work out your purchase prices and balances, and your gains can be wrong. In Portugal this also affects the holding period, because the 365-day rule depends on the purchase date. Read Why is it necessary to import the entire transaction history?

ℹ️ Something went wrong?

If your file is rejected, read Why was my CSV file rejected?. If your platform is not supported, read My platform isn't supported: what are my options?.


Step 3: check your data

Once your connections are imported, check that your data is complete before generating anything:

  1. open Transactions and look at the imported transactions for each connection

  2. for file imports, check the Check Import Result step: your files should be Accepted and the Rows count should show the transactions you expect

  3. if you moved crypto between your own wallets or exchanges, link the transfers, otherwise they can show as taxable disposals. Read Why does moving crypto to my own wallet show as a taxable disposal?

  4. check the Action required section for messages, such as Potential transfers, and resolve them

Large API imports can take some time to complete, so let them finish before checking your numbers.


Step 4: generate your report

When your data looks right, you can request the report. Reports require a paid plan, and all paid plans, including Human, can generate them. You can generate reports for any tax year that has transactions in your account.

  1. click on Reports from the main menu on the left

  2. click on the Download a report button at the top right

  3. choose the type of report and the year/period. The reports available for Portuguese accounts are:

  4. choose the format, PDF or CSV

  5. enter the email address where you want to receive the report

  6. click on the Request button, then click on Continue in the modal

  7. when the report is ready, click on Download next to it in the report list

For the download rules, read How to request Finbooks reports.

🚨 Downloading a report ends your right of withdrawal

If you subscribe and then change your mind, you can ask for a refund within 14 days of your first payment, but only if you haven't downloaded any report. Once you download one, the service is considered delivered. Read Right of withdrawal.


Step 5: complete your IRS declaration

The precompiled figures for the annexes of the Modelo 3 IRS declaration come from the Tax return (IRS 3) report. Stamp Duty has its own report, Stamp Duty, which corresponds to the DMIS declaration. You can use the figures directly in your official filings.

  • Annex G, capital gains on crypto held for less than 365 days, through Portuguese platforms or non-custodial wallets

  • Annex G1, tax-exempt capital gains on crypto held for 365 days or more

  • Annex J, staking and mining income generated abroad, and capital gains on foreign platforms for crypto held for less than 365 days

  • Annex B, staking and mining income, for business or professional activity

  • Annex E, other crypto income, for example lending rewards received in fiat currency

  • Stamp Duty (DMIS), only in specific cases, such as fees paid to crypto service providers or crypto received for free, declared monthly

The IRS declaration must be submitted between 01 April and 30 June. Taxes are paid by 31 August.

Read Portugal - Tax Returns for the tables, the information you need to declare for each transaction and the Stamp Duty filing instructions.


Need help?

If you get stuck, contact Finbooks Support by chat or at customer.support@finbooks.com.

Did this answer your question?