Falska meddelanden har skickats ut i Skatteförvaltningens namn. Läs mer om falska meddelanden.
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.
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.
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:
Fastställ och samla ihop en förteckning över de kunder som du behandlar i programmet.
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.
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.
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.
Genomför alla Vero API-anrop inom 8 timmar 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.