Vero.fi — intégration fiscale OmaVero + APIs

Vero.fi est le portail public de Verohallinto, l'administration fiscale finlandaise. Il opère le portail self-service OmaVero, les déclarations TVA mensuelles (Arvonlisävero-ilmoitus), le reporting intra-UE (équivalent finlandais des DEB/DES françaises), et fournit depuis 2024 des APIs REST publiques pour soumission programmatique et pré-remplissage automatique depuis les flux Finvoice.

Verohallinto — gouvernance

Verohallinto est l'administration fiscale finlandaise, agence de l'État sous tutelle du ministère des Finances (Valtiovarainministeriö). Elle administre l'ensemble des impôts directs et indirects :

TVA (Arvonlisävero, ALV) — base de la déclaration mensuelle structurée.
Impôt sur les sociétés (Yhteisövero) — taux uniforme 20 %.
Impôt sur le revenu — barème progressif, prélèvement à la source via le système Tulorekisteri (registre des revenus).
Cotisations sociales employeur — collectées conjointement, déclarées via OmaVero.
Droits de timbre, donations, successions, taxes foncières — secondaires.

OmaVero — portail unifié

OmaVero (omavero.vero.fi) est le portail self-service de Verohallinto, accessible à toute personne physique ou morale finlandaise. Authentification via Suomi.fi (équivalent FranceConnect), avec Mobile Citizen Certificate (mobiilivarmenne), Pankkitunnus (identifiant bancaire) ou Katso (certificat entreprise).

OmaVero centralise pour les entreprises :

Déclaration mensuelle TVA (Arvonlisävero-ilmoitus).
Déclaration mensuelle cotisations sociales employeur (Työnantajan vakuutusmaksuilmoitus).
Récapitulatif intra-UE (Yhteenvetoilmoitus tavaroista ja palveluista).
Déclaration annuelle impôt sur les sociétés (Yhteisön veroilmoitus).
Consultation du compte fiscal (Verotili), soldes, remboursements TVA, paiements.
Demande de certificat de bonne foi fiscale (Veroista vapaaksi todistus).

ALV-ilmoitus — déclaration TVA

La déclaration TVA finlandaise mensuelle est très structurée — elle décompose obligatoirement les opérations par taux (25,5 % standard, 14 % réduit, 10 % super-réduit, 0 % zéro-rated) et par nature (Kotimaa = national, EUKauppa = intra-UE, Vienti = exports hors UE).

xml alv-ilmoitus-exemple.xml

<!-- Schéma simplifié d'une déclaration ALV mensuelle finlandaise -->
<!-- Soumise via OmaVero (formulaire web) ou API "Apitietopalvelu" -->
<AlvIlmoitus version="2.0" kausi="2026-04">
  <Ilmoittaja>
    <Ytunnus>1234567-1</Ytunnus>
  </Ilmoittaja>
  <Kotimaa>
    <Veron25_5Prosenttia>
      <Vero>30600.00</Vero>
      <Peruste>120000.00</Peruste>
    </Veron25_5Prosenttia>
    <Veron14Prosenttia>
      <Vero>1400.00</Vero>
      <Peruste>10000.00</Peruste>
    </Veron14Prosenttia>
    <Veron10Prosenttia>
      <Vero>500.00</Vero>
      <Peruste>5000.00</Peruste>
    </Veron10Prosenttia>
  </Kotimaa>
  <EUKauppa>
    <TavarakauppaEU>
      <Myynti>45000.00</Myynti>
      <Osto>28000.00</Osto>
      <OstojenVero>7140.00</OstojenVero>
    </TavarakauppaEU>
  </EUKauppa>
  <VahennettavaVero>15300.00</VahennettavaVero>
  <MaksettavaVero>24340.00</MaksettavaVero>
</AlvIlmoitus>

Délai : dépôt au plus tard le 12 du mois suivant pour les déclarations mensuelles (ex. avril → 12 mai). Si le 12 est férié, report au jour ouvré suivant.
Paiement : le solde TVA dû doit être payé à la même échéance (12 du mois suivant), via virement bancaire sur le compte Verotili spécifique à l'entreprise.
Sanction retard : intérêts de retard (viivästyskorko, ~7 %/an), pénalité pour défaut (myöhästymismaksu) €15 à €15 000 selon le retard et le montant.

Reporting intra-UE (VIES)

Les opérations intra-UE B2B (livraisons de biens et prestations de services à un assujetti UE) doivent être déclarées via le Yhteenvetoilmoitus (récapitulatif intra-UE), équivalent finlandais de la DEB/DES française. Périodicité mensuelle si CA > €50K/trimestre, trimestrielle sinon.

Le récapitulatif est exclusivement électronique depuis 2010 — pas de version papier. Les données sont transmises à VIES (VAT Information Exchange System) de la Commission européenne et consultables par les autres administrations fiscales UE.

APIs publiques Vero

Depuis 2024, Vero.fi ouvre une API publique Apitietopalvelu.vero.fi pour les éditeurs de logiciels et les grandes entreprises souhaitant soumettre leurs déclarations programmatiquement (sans portail OmaVero) :

Authentification : OAuth 2.0 client_credentials, JWT signé Verohallinto.
Endpoints principaux :
- POST /alv-ilmoitus/v1/submit — déclaration ALV
- POST /yhteenvetoilmoitus/v1/submit — récapitulatif intra-UE
- GET /verotili/v1/saldo — solde du compte fiscal
- GET /yritys/v1/{ytunnus}/tila — statut TVA d'un Y-tunnus
Rate limits : 100 req/min par client, possibilité d'augmenter sur demande pour les opérateurs Tieke.
Test environment : apitietopalvelu-test.vero.fi pour la validation pré-production.

text vero-api-sample.txt

# API publique Vero — Apitietopalvelu (apitietopalvelu.vero.fi)
# OAuth2 client_credentials grant, JWT token 1h.
# Documentation : vero.fi/tietoa-verohallinnosta/yhteystiedot-ja-asiointi/avoin-data/

POST /alv-ilmoitus/v1/submit
Content-Type: application/json
Authorization: Bearer <jwt-token>

{
  "kausi": "2026-04",
  "ytunnus": "1234567-1",
  "kotimaa": {
    "vero255": { "vero": 30600.00, "peruste": 120000.00 },
    "vero14":  { "vero":  1400.00, "peruste":  10000.00 },
    "vero10":  { "vero":   500.00, "peruste":   5000.00 }
  },
  "euKauppa": {
    "tavarakauppaMyynti": 45000.00,
    "tavarakauppaOsto":   28000.00,
    "ostojenVero":         7140.00
  },
  "vahennettavaVero": 15300.00,
  "maksettavaVero":   24340.00
}

# Response 201
{
  "ilmoitusId": "ALV-2026-04-1234567-1",
  "tila": "VASTAANOTETTU",
  "vastaanottoAika": "2026-05-12T08:14:32+03:00"
}

Pièges courants

Confondre Y-tunnus et FI VAT. Y-tunnus = 1234567-1, FI VAT = FI12345671. Les APIs Vero acceptent les deux, mais retournent souvent le format différent dans la réponse.
Oublier le taux 25,5 %. Le taux standard a été relevé de 24 % à 25,5 % le 1ᵉʳ septembre 2024. Les déclarations antérieures à septembre 2024 utilisent encore vero24, celles ultérieures vero255. Erreur fréquente dans les migrations ERP.
Ne pas découper Kotimaa vs EUKauppa. Une livraison intra-UE B2B doit être ventilée séparément, exonérée à 0 % côté vendeur (avec mention du FI VAT du client), et déclarée au Yhteenvetoilmoitus. Beaucoup d'ERP étrangers déclarent à tort sur Kotimaa au taux 0 %, ce qui fausse les contrôles VIES.
Oublier le seuil de périodicité. Un CA qui dépasse €100K sur 12 mois roule de trimestriel à mensuel — la bascule est automatique chez Vero, mais l'entreprise doit ajuster son calendrier interne (et son ERP).
Croire que les APIs sont publiques pour tout. Les APIs Apitietopalvelu sont publiques pour soumission, mais en lecture (statut, historique) elles nécessitent un mandat OmaVero — le software vendor doit avoir reçu une délégation explicite de l'entreprise.

Fondamentaux

Standards

Messages phares

Outils