När du loggar in i MinSkatt får du i fortsättningen din skattepost endast elektroniskt. Läs mer om ändringen.
Genomför och testa i testmiljön
Du kan börja programvaruutveckling utifrån gränssnittsbeskrivningarna.
En programvaruutvecklare ska hämta ett testcertifikat för att testa Vero API-gränssnitten. Med testcertifikatet är det möjligt att testa anmälning via gränssnittet och mottagning av information i Skatteförvaltningens testmiljö, som returnerar statiska svar. Du kan använda testmiljön genom att anropa testadressen för gränssnitten med ett testcertifikat.
Observera‑avsnittet börjar
För testningen behöver du:
- ett testcertifikat
- ett program som registrerats i API-portalen.
Observera-avsnittet slutar
Gränssnittsansökan och testcertifikat
Lämna en ansökan om gränssnitt för testning och beställ ett testcertifikat i Skatteförvaltningens certifikattjänst i sektionen testcertifikat.
-
1
Logga in i tjänsten
-
I Skatteförvaltningens certifikattjänst i sektionen Testcertifikat ska du fylla i ansökan om gränssnitt och beställa det testcertifikat som behövs vid testningen.
Identifiera dig i tjänsten med bankkoder, mobilcertifikat eller certifikatkort. Du behöver ingen Suomi.fi-fullmakt.
- När du loggar in för första gången ska du ange din e-postadress och ditt telefonnummer.
- Du kan fortsätta till tjänsten efter att du har bekräftat din e-postadress via ett meddelande som skickats till dig.
-
2
Lämna ansökan om gränssnitt för testning
-
Välj Vero API av Skatteförvaltningens gränssnitt och mata in de uppgifter som tjänsten begär.
-
3
Beställ testcertifikat
-
I e-tjänsten ska du välja knappen Beställ ett nytt testcertifikat och skriva in de uppgifter som tjänsten begär.
-
4
Den tekniska kontaktpersonen hämtar testcertifikatet
-
Den tekniska kontaktpersonen ansvarar för att hämta certifikatet och ta det i bruk
Efter att du lämnat in certifikatbeställningen får den angivna tekniska kontaktpersonen information om hur certifikatet ska hämtas. Certifikatet kan därefter hämtas inom 14 dygn.
- när testcertifikatet har hämtats är det den tekniska kontaktperson som angetts i certifikatansökan som ansvarar för att mata in testcertifikatet i programvaran. Utan testcertifikat 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 testning först när vi har hämtat det skapade testcertifikatet och installerat det i vår miljö. Certifikat hämtas för Vero API-användning från Skatteförvaltningens certifikattjänst. Tumregeln är att certifikat för testing som skapats i certifikattjänsten under tjänstetid (kl. 8.00–16.15) fungerar senast i Vero API-gränssnittens anrop följande dag.
-
Om certifikatet inte hämtas inom 14 dygn ska du lämna en ny certifikatbeställning i Skatteförvaltningens certifikattjänst.
Läs mer:
Skatteförvaltningens certifikattjänst
Testcertifikat
Testmiljö
Dokumentation rörande gränssnitten Vero API och URL för testmiljö finns på portalen Vero API.
Förnyelse av certifikat i certifikattjänstens gränssnitt
Denna anvisning beskriver ett sätt på vilket certifikat som utfärdats av Skatteförvaltningens certifikattjänst kan förnyas och signeras med hjälp av PKI-systemets Web Service-gränssnitt i Skatteförvaltningens certifikattjänst. På basis av exemplet kan man införa förnyelse av certifikat i den egna programvaran.
I anvisningen beskrivs förnyelse av testcertifikat. Anvisningen kan också tillämpas på förnyelse av produktionscertifikat. Då används genuina kunduppgifter och certifikattjänstens produktionsadress Produktionens kunduppgifter får inte användas i testmiljön.
- Om certifikatet hinner gå ut, beställ ett nytt certifikat för organisationen i certifikattjänstens e-tjänst.