Integrasjonsguide Maskinporten

Denne guiden hjelper deg å integrere mot de API-er til Tolletaten som bruker Maskinporten for autentisering.

Guiden er skrevet for både norske virksomheter (med norsk organisasjonsnummer) og utenlandske virksomheter (uten). Fremgangsmåten er i hovedsak den samme, men skiller seg særlig ved hvilken type sertifikat som kreves.

Slik henger det sammen

En integrasjon settes opp i tre steg:

  1. Bestille sertifikat – skaff et sertifikat som identifiserer virksomheten din.
  2. Onboarding – registrer deg hos Tolletaten og Digdir, og opprett selve integrasjonen.
  3. Teknisk integrasjon – hent et access token fra Maskinporten, veksle det til et Toll-signert token, og kall Toll-API-ene.

To roller er involvert i en integrasjon: virksomheten som eier sertifikatet og inngår avtalene (steg 1 og 2), og systemleverandøren som utvikler selve integrasjonen (steg 3).

Er du usikker på hva Maskinporten er, start med Hva er Maskinporten?