← Back to help Vat-app

Suomi.fi authorisation guide

Who does this step? The person with legal authority to act on behalf of your company — typically the CEO or a named signatory. You'll need your personal Finnish online banking credentials or mobile certificate (mobiilivarmennus).

What you're granting — and to whom

You are granting your company's right to file VAT returns via API to the following registered business:

Naapurin Nettishamaani Y-tunnus: 3010501-4
Registered IT services provider, Espoo · Kaupparekisteri & Verohallinto

This is a specific, limited authorisation for VAT filing via the Vero API only. It does not give access to your tax account, bank accounts, or any other information. You can revoke it at any time.

Step by step — the actual wizard

Suomi.fi's authorisation wizard has 7 steps. Here's exactly what to choose at each one.

1
Go to suomi.fi/valtuudet and log in Log in with your Finnish online banking credentials or mobiilivarmennus. Make sure you're acting on behalf of your company, not yourself personally.
Open suomi.fi/valtuudet →
2
Click "Anna valtuuksia" (Grant authorisations) You'll see a menu with "Anna valtuuksia" and "Pyydä valtuuksia". Choose Anna valtuuksia.
3/7
Wizard step 1 · Valtuustyyppi Select "Asiointivaltuus" This grants an organisation the right to act on your company's behalf. The other options (Valtuutusoikeus, Edustamisvaltuus) are for different purposes — choose Asiointivaltuus.
4/7
Wizard step 2 · Osapuolet Add Naapurin Nettishamaani as the authorised party Your company appears as the Valtuuttaja (grantor). Under "Lisää valtuutetut", click Lisää yritys and enter:
3010501-4
This is Naapurin Nettishamaani's Y-tunnus. You can verify it at ytj.fi.
5/7
Wizard step 3 · Valtuusasiat Search for and select the VAT filing role Search for "rajapinta" to narrow the list, then find and select:
Verotukseen liittyvien tietojen ilmoittaminen, päivittäminen ja hakeminen rajapinnan kautta
6/7
Wizard step 4 · Valitut valtuusasiat Confirm the selected role You'll see a summary of what you've chosen. Verify the role name is correct and click Next.
7/7
Wizard steps 5–7 · Vahvistajat, Voimassaolo, Yhteenveto Set duration and confirm Step 5 asks about confirmers — leave as default. Step 6 asks how long the authorisation is valid — select a period that suits you (1–2 years is typical). Step 7 is a summary — review and confirm.
8
Return to Vat-app and continue Once confirmed, come back here and click the button to continue to the certificate step.

Frequently asked questions

Can I revoke it later?
Yes — at any time from suomi.fi/valtuudet → Annetut valtuudet. Filing will stop immediately once revoked.

What if I can't find the role in step 3?
Search for "rajapinta" — this narrows the list significantly. Copy the full role name exactly using the button above.

Does this give Naapurin Nettishamaani access to my tax account?
No. The role is scoped specifically to filing VAT declarations via the API. It cannot view, modify, or retrieve any other tax information.

Why a 7-step wizard for something so simple?
Suomi.fi's authorisation system is designed to handle many different types of authorisations for many different services. VAT filing is one specific use case in a much larger system. The wizard looks complex but most steps are just clicking Next.

← How it works Certificate guide →