Användning av Suomi.fi-fullmakt i Vero API gränssnitt
Användaren av gränssnittet ska hämta Suomi.fi-fullmakten med GetToken-gränssnittet innan hen anropar de gränssnitt som kräver en Suomi.fi-fullmakt. GetToken-gränssnittet skickar fullmaktstoken i retur.
- Fullmaktstoken är en undertecknad teknisk datastruktur som innehåller de Suomi.fi-fullmakter som beviljats gränssnittsanvändaren. Den tekniska datastrukturen har implementerats enligt mallen JSON Web Token. Fullmaktstoken ger rätt att uträtta ärenden för en annan organisations räkning i 60 minuter från och med den tidpunkt då den skapats.
Avgörandet fullmaktstoken
Suomi.fi-fullmaktstoken hämtas för alla de kunder på vilkas vägnar gränssnittsärendehantering utförs inom följande timme med ett gränssnittsanrop Vero API GetToken. Fullmaktstoken fås som svar från gränssnittet för varje kund vars Suomi.fi-ärendefullmakt anroparen har. Den egna fullmaktstoken för varje kund ställs i headern vero-autorizationtoken i det egentliga Vero API-anropet. Användningen av fullmaktstoken påskyndar svarstiden för Vero API med 300–500 ms. per anrop och minskar belastningen bland annat för Myndigheten för digitalisering och befolkningsdata (MDB). Med hjälp av gränssnittet Vero API GetToken kan det anropande systemet kontrollera att ärendefullmakten existerar innan andra gränssnittsanrop görs.
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
Användningen av Suomi.fi-fullmaktstoken är obligatorisk i alla de Vero API-gränssnitt där ärendehantering på någon annans vägnar förutsätter en Suomi.fi-fullmakt. Fullmaktstoken kommer att ersätta kontrollen av fullmakterna direkt från fullmaktstjänsten hos MDB i samband med varje gränssnittsanrop.
Att fullmaktstoken blir obligatorisk gäller inte de gränssnitt där ingen Suomi.fi-fullmakt förutsätts för tillfället. Ändringen gäller inte heller i situationer där användaren av gränssnittet behandlar sina egna uppgifter. Om användningen av gränssnittet förutsätter en Suomi.fi-fullmakt anges detta i dokumentationen av gränssnittet. Dokumentationen av gränssnitten finns på portalen Vero API.
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)
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.