Sist endret: 9. jul. 2025

Tjenesteeiersystem-integrasjon

Slik kommer du i gang med å sende varsler fra et tjenesteeiersystem

1. Kom i gang som tjenesteeier i Altinn

For å komme i gang med Altinn Varslinger, må din virksomhet være registrert som tjenesteeier i Altinn. For en trinn-for-trinn-guide, se guiden Kom i gang med Altinn.

Dette trinnet er kun nødvendig for nye virksomheter som ennå ikke har etablert seg som tjenesteeiere på Altinn-plattformen. Hvis du allerede er en etablert tjenesteeier, kan du gå direkte videre til de neste trinnene for å begynne å bruke Altinn Varslinger.

2. Registrer din Maskinporten-klient med riktige scopes

For å kunne ta i bruk Altinn Notifications API, må du ha en Maskinporten-klient med riktig scope.

Scope altinn:serviceowner/notifications.create er påkrevd for at klienter skal få tilgang til Varslings-API-et.

Alle registrerte tjenesteeiere har fått delegert dette scopet av Digdir og skal kunne finne det i sin liste over scopes i Samarbeidsportalen.

For en veiledning om hvordan du registrerer en ny Maskinporten-integrasjon i Samarbeidsportalen, se Altinn Autorisasjon

3. Se over policy for relevante ressurser i Altinn Ressursregister

Koblingen av et varsel til en ressurs, ved å benytte resourceId-attributtet, innebærer at ressursens policy brukes for å identifisere de korrekte mottakerne av varselet. Alle tiltenkte mottakere må ha read-tilgang gjennom ressursens policy.

Om ressurser og hvem som mottar1 varsler:

  • Varsler til privatpersoner (fødselsnummer), eksplisitt e-postadresse eller telefonnummer -> resourceId har ingen effekt
  • Varsler til organisasjonsnummer:
    • Organisasjonens lovpålagte kontaktinformasjon (på virksomhetsnivå) brukes alltid
    • Uten spesifisert resourceId -> kun lovpålagt kontaktinformasjon brukes
    • Med resourceId -> i tillegg til den lovpålagte mottakeren varsles enhver person som oppfyller alle kriteriene under:
      • Personen må ha konfigurert sin “egendefinerte kontaktinformasjon” for mottakerorganisasjonen
      • Personen må ha read-tilgang til ressursen gjennom ressursens policy 2
      • Personen må ikke ha valgt bort varsler for denne tjenesten 3

Om ressurser og policyer

En ressurs kan i dette tilfellet både være en Altinn App eller en ressurs (tjenesteeierressurs).

En ny Altinn-ressurs kan registreres i Altinn Studio eller gjennom et API. Se Altinn Ressursadministrasjon for instruksjoner om hvordan du oppretter en ny ressurs.

Policyen for både Altinn Apps og andre Altinn-ressurser kan administreres i Altinn Studio. Se Altinn Studio-dokumentasjonen for hvordan du gjør dette.

  1. Se Adresseoppslag for flere detaljer om hvordan adresseoppslag fungerer. ↩︎

  2. For Altinn Apps må du også sikre at tilgangssubjektet har read-tilgang for alle relevante oppgaver og hendelser. ↩︎

  3. Brukere velger aktivt inn tjenester, noe som betyr at tjenester som ikke er valgt inn, regnes som valgt bort. Dette innebærer at dersom en bruker har valgt inn en Altinn 2-tjeneste på et tidspunkt, har de i praksis valgt bort alle andre tjenester - inkludert en eventuell re-implementering i Altinn 3. Alle Altinn 2-ressurser (tjenester) overføres over til Altinn 3, men brukeren har derfor ofte (uten å være klar over det) effektivt valgt å ikke motta varsler for den nye Altinn 3-ressursen. ↩︎

4. Gjør deg kjent med retningslinjene og beste praksis for sending av varsler

For å sikre effektiv kommunikasjon er det viktig å strengt definere hva som kvalifiserer som et varsel og unngå å overvelde brukere med for mange meldinger.

Gjør deg kjent med våre retningslinjer for å forstå hva varsler bør og ikke bør inneholde, for å fremme digital sikkerhet og forhindre varslingstretthet.

5. Integrer mot Varslings-API-et

Du er nå klar til å starte integrasjonen mot Varslings-API-ene, se utviklerguidene for neste trinn.