Tilgjengelighet og utrullingsplan

Kom i gang med Avfallsdeklarering API

Avfallsdeklarering-APIet gjør det mulig for systemleverandører og virksomheter å integrere deklarasjonshåndtering direkte i egne fagsystemer. Tilgang styres gjennom Maskinporten, og autentisering skjer via JWT-tokens utstedt av ID-porten.

Testmiljø

APIet er tilgjengelig for testing på følgende adresse:

Autentisering med Maskinporten 

Tilgang til APIet krever et gyldig token fra Maskinporten. For å komme i gang finnes det et eksempel på en konsollapplikasjon som viser hvordan man genererer en JWT for systembruker-flyten og henter et tilgangstoken:

Maskinporten-klienten bør settes opp på den organisasjonen som faktisk skal opptre i APIet. Når token hentes, leser avfallsdeklarering organisasjonsnummeret fra organisasjonen klienten er registrert på – det er derfor viktig at klienten settes opp på riktig organisasjonsnivå. Feil organisasjon kan føre til manglende tilgang, feil fullmaktsoppsett eller at organisasjonen ikke gjenkjennes som riktig produsent eller mottaker.

Intern bruk vs. eksponering mot andre organisasjoner

Dersom APIet kun skal brukes internt i egen organisasjon, er Maskinporten alene tilstrekkelig – det er ikke nødvendig å opprette systemtilgang og systembrukere.

Dersom løsningen skal eksponeres mot og brukes av andre organisasjoner, må det i tillegg opprettes systemtilgang og systembrukere via Altinn. Dette er aktuelt for systemleverandører som tilbyr integrasjoner på vegne av sine kunder.

Opprette systemtilgang og systembrukere

Veiledning for oppsett av systemtilgang og systembrukere finnes i Altinns dokumentasjon:

For manuell registrering av systembrukere kan Altinns testmiljø benyttes direkte:

Ofte stilte spørsmål