Falska meddelanden har skickats ut i Skatteförvaltningens namn. Läs mer om falska meddelanden.

Att sköta ärenden för någon annans räkning via Vero API-gränssnitt

Om du har en fullmakt kan du anmäla uppgifter eller lämna en förfrågan om dem för din egen eller någon annan organisations räkning via ett Vero API-gränssnitt. Om gränssnittsanvändaren sköter ärenden för den egna organisationens räkning behövs inte någon separat Suomi.fi-fullmakt för att använda gränssnitten. Om du däremot använder gränssnittet för att sköta ärenden för någon annan organisations räkning, kan du behöva en separat Suomi.fi-fullmakt. Behovet av en Suomi.fi-fullmakt anges alltid seprat i dokumentationen i API-portalen för gränssnittet i fråga.

Vero API-gränssnitten använder Suomi.fi-fullmaktstjänsten som tillhandahålls av Myndigheten för digitalisering och befolkningsdata (MDB). Via fullmaktsjänsten kan personer och företag bevilja andra personer eller företag fullmakt att sköta ärenden för deras räkning i olika myndighetsärenden, såsom skatteärenden. Suomi.fi-fullmakter kan begäras och beviljas i MDB:s tjänst Suomi.fi. Läs mer om fullmakter att sköta skatteärenden här Så här ger du fullmakt - vero.fi.

Nedan finns exempel på användningsfall: Hur ärenden kan skötas antingen för din organisations eller någon annan organisations räkning.

Exempel 1: Det är fråga om en bokföringsbyrå som har ett bokförings- och löneprogram som använder gränssnittet API för förfrågan om brev. Bokföringsbyrån använder gränssnittet för att sköta sina egna skatteärenden och för att skicka förfrågningar om brev som kommit från Skatteförvaltningen endast till bokföringsbyrån själv. I detta fall sköter bokföringsbyrån den egna organisationens ärenden och inte andra företags skatteärenden via gränssnittet i fråga. Förfrågningar om brev skickas alltså inte för andra organisationers räkning och då behöver bokföringsbyrån inte separat ansöka om Suomi.fi-fullmakter för att få använda gränssnittet.

Exempel 2: Det är fråga om en bokföringsbyrå som har ett bokförings- och löneprogram som använder gränssnittet API för förfrågan om brev. Bokföringsbyrån sköter skatte- och bokföringsärenden för andra företag och använder gränssnittet i fråga som hjälp i detta syfte. Bokföringsbyrån använder gränssnittet till att skicka förfrågningar om de brev som bokföringsbyråns företagskunder fått från Skatteförvaltningen. Bokföringsbyrån kan efter att ha hämtat breven reagera på dem på det sätt som behövs. Bokföringsbyrån sköter i detta fall ärenden för någon annan organisations räkning och behöver en Suomi.fi-fullmakt för att använda gränssnittet.

Suomi.fi-fullmakter behövs i följande Vero API-gränssnitt för tillfället:

  • Gränssnitten för brev och beslut
  • Uppdatering av uppgifter om rollregistrering
  • Förfrågan om bransch och räkenskapsperiod
  • Förfrågan om uppgifter om skatteperiod
  • Förfrågan om saldouppgifter
  • Transaktionssökning
  • Gränssnitt för bilbeskattningsbeslut och för förfrågan om deklarationsstatus
  • EMCS-gränssnitt
  • Punktskatter
  • Anmälan om hushållsavdragsuppgifter
  • Anmälan om pensions- och förmånsuppgifter samt förfrågan om förskottsinnehållningsuppgifter till utbetalare om pensioner och förmåner
  • Gränssnitt för moms och sammandragsdeklaration
  • Gränssnitt för samfundsbeskattning (förskottsskatt, vinstutdelning, värdeuppgifter om aktie)

Notisen börjar.

Dokumentation av gränssnitt

Mer information om gränssnittet, schemat för meddelandet och närmare beskrivningar om parametrarna hittar du på portalen Vero API.

Notisen slutar

Faser i användningen av fullmaktstoken

  • 1

    Fastställ och samla ihop en förteckning över de kunder som du behandlar i programmet.

  • 2

    Hämta på en gång fullmaktstoken för alla de kunder som behövs genom att skicka anropet GetToken med alla de kunders beteckningar som behövs eller hämta token satsvis, 3 000 kunder åt gången, för att få den bästa nyttan av hastigheten i GetToken API.

  • 3

    Svaret från gränssnittet GetToken ska endast innehålla token för de kunder vars fullmakter den som anropar har i kraft vid tidpunkten för anropet.

  • 4

    Administrera token och kundbeteckningar som anknyter till vissa kunder och ställ rätt token i headern Vero-Authorizationtoken i varje Vero API anrop som kräver användning av Suomi.fi-fullmakter.

  • 5

    Genomför alla Vero API-anrop inom 60 minuter när token ännu är aktiv. När giltighetstiden för token går ut ska du anropa GetToken-gränssnittet på nytt och hämta nya ersättande token.


Sidan har senast uppdaterats 7.10.2025