Så här tas gränssnitt i bruk
På den här sidan har vi samlat en lista över olika faser i ibruktagandet av Vero API-gränssnitten. Vi har listat de olika faserna och anvisningarna till dem i den ordning som vi rekommenderar att följa.
1. Bekanta dig med gränssnittstjänsten Vero API
Vi rekommenderar att du bekantar dig med de allmänna och tekniska anvisningarna innan du inleder utvecklingen av en gränssnittsintegration och testningen.
- Allmänna anvisningar: Vad är gränssnitt? - vero.fi
- Tekniska anvisningar: Tekniska anvisningar - vero.fi
- Att sköta ärenden för någon annans räkning och fullmakter: Att sköta ärenden för någon annans räkning - vero.fi
2. Testa i sandlådan
I sandlådan kan utvecklarna ta del av Skatteförvaltningens nuvarande och framtida Vero API-gränssnittstjänster.
- URL för gränssnitten: api-sandbox.vero.fi
- Användaren ska registrera sig separat för sandlådan och får då en API-nyckel (Subscription key) som endast fungerar i sandlådan.
3. Registrering av programvara på API-portalen och API-nyckel
Syftet med registreringen av programvarorna är att förbättra användarupplevelsen av gränssnitten och integrationernas kvalitet med hjälp av ett formbundet förfarande vid införandet och en riktad styrning.
- Användaren ska registrera programvaran på portalen och får därefter en API-nyckel som behövs i produktionsbruk.
- Vi rekommenderar att du registrerar dig på portalen innan du inleder testningen.
Registrering av programvara och godkännandeförfarande - vero.fi
4. Testning av gränssnitt och ansökan om testcertifikat
Genom att testa säkerställer du att integration mellan programvaran och Skatteförvaltningen fungerar.
- En organisation som använder gränssnitten måste ha ett giltigt Vero API-gränssnittsavtal.
- Ansökan om testgränssnitt görs via testcertifikatsektionen i Skatteförvaltningens certifikattjänst.
- Certifikattjänsten kan också användas för att kontrollera om testgränssnittsavtalet är giltigt.
- Du behöver ett testcertifikat från certifikattjänsten.
- API-nyckeln från API-portalen ges i Vero-SoftwareKey headern.
- Dokumentationen för gränssnitten och adresserna till testmiljön hittar du på Vero API-portalen (URL Test).
5. Godkännandetestning för produktionsbruk och produktionscertifikat
Produktionsbruket av gränssnitten förutsätter en godkännandetestning av programvarorna. Godkännandetestningen av en programvara ska genomföras som självbetjäning på API-portalen.
- Förfarandet vid godkännandetestningen är inte samma sak som att testa att den egentliga integrationen fungerar. Godkännandetestningen görs när programvaran är utvecklad och testad i sin helhet.
- En organisation som använder gränssnitten måste ha ett giltigt Vero API-gränssnittsavtal.
- Ansökan om produktionsgränssnitt görs via produktionscertifikatsektionen i Skatteförvaltningens certifikattjänst.
- Certifikattjänsten kan också användas för att kontrollera om produktionsgränssnittsavtalet är giltigt.
- Du behöver ett produktionscertifikat från certifikattjänsten.
- API-nyckeln ges i Vero-SoftwareKey headern.
- Adresserna till godkännandetestningen hittar du på Vero API-portalen (URL Verifiering av integrationen)
Registrering av programvara och godkännandeförfarande - vero.fi
6. Produktionsbruk av gränssnitt
För produktionsbruk av gränssnitten ska användaren utföra och beakta följande:
- Applikationen har registrerats på API-portalen och godkännandetestningen är gjord.
- En organisation som använder gränssnitten måste ha ett giltigt Vero API-gränssnittsavtal.
- Ansökan om produktionsgränssnitt görs via produktionscertifikatsektionen i Skatteförvaltningens certifikattjänst.
- Certifikattjänsten kan också användas för att kontrollera om produktionsgränssnittsavtalet är giltigt.
- Användaren av gränssnitten har ansökt om produktionscertifikat från certifikattjänsten.
- Programvaran placerar API-nyckeln i Vero-SoftwareKey headern.
- Produktionsadresserna till gränssnitten finns på Vero API-portalen (URL Produktion)