Certifikat för produktion
Ibruktagande av gränssnitt för produktionsmiljön
Anvisningen är indelad i åtgärder i den organisation som använder gränssnitt och åtgärder som vidtas av programvaruutvecklaren.
Organisation som använder gränssnitt
Den organisation som använder gränssnitt, användaren av programvaran, ska ha ett produktionscertifikat. Produktionscertifikatet fungerar som identifieringsuppgift om användaren. Användaren av gränssnitt kan vara en kund, det vill säga den anmälningsskyldige själv, eller en part som kunden har befullmäktigat enligt användarvillkoren för gränssnitt.
Programvaruutvecklare
Programvaruutvecklaren registrera sin programvara i API-portalen och välja de gränssnitt som programvaran använder, innan användningen i produktionsmiljön inleds. Den registrerade programvaran får en API-nyckel. API-nyckeln är specifik för varje programvara och fungerar som identifierare för programvaran. API-nyckeln är inte avsedd att administreras av användare av programvaran, utan programvaruutvecklaren ska bygga in behandling av nyckeln i programvaran.
Programvaruutvecklaren säkrar den tekniska funktionen i programvarans produktionsanslutning och API-nyckeln mot de gränssnitt som programvaruutvecklaren använder. Säkringen görs på egen hand mot den adress för verifiering av integrationen (verifiering av URL Integration) som har angetts i API-portalen.
Efter att integrationen har verifierats är programvaran färdig för produktionsmiljön.
Läs mer om registrering av programvaror
Ansökan om certifikat för produktion sker enligt följande:
Organisationen som ansöker om ett certifikat för produktionen ska ha ett direkt tjänsteavtal med kunden enligt användarvillkoren för gränssnittstjänsterna. Om din programvara är avsedd att användas av exempelvis bokföringsbyråer eller andra tjänsteleverantörer och inte direkt av de anmälnings- eller skattskyldiga ska användarorganisationen ansöka om certifikat.
Ansökan görs i inkomstregistrets e-tjänst.
- i e-tjänsten ska man välja det företag för vilket certifikatbeställningen görs (ett certifikat för produktion kan endast ansökas av en person med firmateckningsrätt i den ansökande organisationen)
- på företagets sida ska man välja: inställningar > tekniskt gränssnitt
- kontrollera under Gällande rättigheter om där som gränssnittets användningsändamål anges ”Löneuppgifter, anmäler löner som denne själv betalat och Löneuppgifter, anmäler löner för en annan parts räkning” samt i kanalerna ”Löneuppgifter – Web Service” utöver eventuella andra rättigheter
- om där inte redan anges anmäla löneuppgifter som användningsändamål och Web Service som kanal ska en ersättande ansökan göras, välj Gör ersättande ansökan.
- välj i den ersättande ansökan som gränssnittets användningsändamål utöver de nuvarande valen ”Löneuppgifter, anmäler löner som denne själv betalat och Löneuppgifter, anmäler löner för en annan parts räkning” samt som kanal ”Löneuppgifter – Web Service”. Den ersättande ansökan ersätter de tidigare valen, varför ansökan ska innehålla alla användningsändamål och kanaler som organisationen använder.
- efter kontroll av rättighet till gränssnittet, gör den egentliga certifikatansökan: certifikat > ansök om nytt certifikat
- som typ av certifikat för produktion ska man välja ”Löneuppgifter – Web Service”
- användaren av certifikat för produktion ska godkänna och iaktta Användarvillkoren för Skatteförvaltningens och inkomstregistrets gränssnittstjänster (pdf)
- i certifikatansökan ska man ange den tekniska kontaktpersonen. Den tekniska kontaktpersonen sköter den tekniska hämtningen av certifikatet från gränssnittet för certifikattjänsten.
- certifikatansökan skickas med knappen Skicka. Sändningen startar certifikatbeställningen
- de nödvändiga uppgifterna för att hämta certifikatet skickas med säker e-post till den tekniska kontaktpersonen och PIN-koden för att öppna meddelandet skickas som sms till mobiltelefonnumret. PIN-koden skickas efter att man har tryckt på länken ”Öppna meddelandet” i den säkra e-posten som skickats i samband med ansökan om certifikat. Certifikatet kan hämtas från gränssnittet för certifikattjänsten inom 14 dygn från det att ansökan har lämnats.
- productioncertifikatet ska hämtas produktionsadressen för gränssnittet Web Service i certifikattjänsten: https://pkiws.vero.fi/2017/10/CertificateServices (TCP port 443)
- när certifikatet har hämtats är det den tekniska kontaktperson som angetts i certifikatansökan som ansvarar för att mata in certifikatet i programvaran. Utan certifikat returnerar Vero API-gränssnittet inte det material som användarorganisationen bett om.
- Vero API-gränssnitten svarar på anrop gjorda med certifikatet för produktion först när vi har hämtat det skapade certifikatet och installerat det i vår miljö. Certifikat hämtas för Vero API-användning från inkomstregistrets certifikattjänst. Tumregeln är att certifikat för produktion som skapats i certifikattjänsten under tjänstetid (kl. 8.00–16.15) fungerar senast i Vero API-gränssnittens anrop följande dag.
Det finns närmare information om certifikattjänsten på inkomstregistrets webbplats:
Certifikattjänst
Frågor och svar om certifikattjänsten
Det lönar sig också att bekanta sig med anvisningsvideon som inkomstregistret gjort:
Inkomstregistrets informationsproducent - ansök om ett nytt certifikat (på finska)
Vad programutvecklaren ska ta i beaktande:
- Efter att certifikatet hämtats ska programvaruhuset själv handleda användarorganisationen i hur man behandlar certifikatet beträffande programvaran i fråga.
- Certifikatet för användarorganisationen ska matas in i programvaran eftersom certifikatet fungerar som användarorganisationens elektroniska underskrift när den hämtar material.
- Skatteförvaltningen rekommenderar att skapandet och förnyandet av ett certifikat för produktionen införs som en del den programvara som utnyttjar certifikatet.
Produktionsmiljö
Dokumenten om Vero API-gränssnitten och URL för produktionsmiljön finns i Vero API.