Validering av mottaker

Valideringstjenesten lar tjenesteeier kontrollere status på bruker i Altinn før en melding eller varsel sendes ut

I Altinn er det mulig å opprette melding og varsel knyttet til et organisasjon- eller personnummer. Men det er ikke alle virksomheter eller personer det er hensiktmessig å opprette en melding eller varsel til. I mange tilfeller vil det være best å sjekke dette FØR man sender melding/varsel.

Valideringstjenesten gir tjenesteeier en mulighet ti å kontrollere følgende forhold før en melding opprettes eller et varsel sendes:

  • Er organisasjonsnummer gyldig?

  • Finnes organisasjonsnummer i Enhetsregisteret?

  • Er organisasjonenen slettet?

  • Er fødselsnummer gyldig?

  • Lever personen fødselsnummer refererer til?

  • Har personen brukerprofil i Atlinn?

  • Har personen reservert seg mot elektronisk post?

Detaljer om tjenesten

Teknisk dokumentasjon finnes her

Request

GET https://www.altinn.no/api/serviceowner/notifications/validaterecipient?organizationNumber={organizationNumber}&socialSecurityNumber={socialSecurityNumber}&lastName={lastName}&serviceCode={serviceCode}&serviceEditionCode={serviceEditionCode} HTTP/1.1
Accept: application/hal+json
ApiKey: myKey

Krav til spørring:

  • OrganizationNumber skal være et norsk organisasjonsnummer. Må oppgis alene.
  • SocialSecurityNumber er et norsk f- eller d-nummer. Må oppgis sammen med lastName.
  • ServiceCode og serviceEdition er valgfrie, men skal alltid oppgis sammen

Respons

Svar på en gyldig spørring vil være:

- "inboxAccessible": true/false,
- "canReceiveNotificationBySms": true/false 
- "canReceiveNotificationByEmail": true/false

Valideringer som ligger bak verdiene som settes


inboxAccessible settes til true hvis:

For Orgnaisasjonsnummer:

  • organisasjonsnummeret er gyldig og eksisterer i Enhetsregistert
  • organisasjonsnummeret er ikke merket som slettet

For Fødselsnummer:

  • fødsels- eller d-nummeret er gyldig
  • første fire tegn av oppgitt “lastName” matcher personens etternavn
  • personen det refererer til lever
  • personen har brukerprofil i Altinn
  • personen har ikke reservert seg mot elektronisk post i KRR

I alle andre tilfeller settes inboxAccessible til false

canReceiveNotificationBySms settes til true hvis:

For organisasjonsnummer:

  • inboxAccessible også er true
  • Organisasjonen har minst en av følgende to ting:
    • Registrert minst ett mobilnr for SMS i KoFuVi
    • Minst en rettighetshaver som har registrert kontaktinformasjon i form av et mobilnr for virksomheten. Denne betingelsen hensyntas kun hvis:
      • Det er oppgitt tjenestekode/utgave i spørringen
      • Rettighetshaveren enten ikke har definert begrensning på varsling tjeneste, eller den aktuelle tjenesten er på listen av tjenester
      • Rettighetshaveren har “les” på oppgitt tjenestekoder/utgave

For fødselsnummer:

  • inboxAccessible også er true
  • Brukeren har registrert et mobilnr for SMS i KRR

I alle andre tilfeller settes canReceiveNotificationBySms til false


canReceiveNotificationByEmailsettes til true hvis:

For organisasjonsnummer:

  • inboxAccessible også er true
  • Organisasjonen har minst en av en følgende to ting:
    • Registrert minst en e-postadresse i KoFuVi
    • Minst en rettighetshaver som har registrert kontaktinformasjon i form av en e-post for virksomhete. Denne betingelsen hensyntas kun hensyntas hvis:
      • Det er oppgitt tjenestekode/utgave i spørringen
      • Rettighetshaveren enten ikke har definert begrensning på varsling tjeneste, eller den aktuelle tjenesten er på listen av tjenester
      • Rettighetshaveren har “les” på oppgitt tjenestekoder/utgave

For fødselsnummer

  • inboxAccessible også er true
  • Brukeren har registrert et en e-postadresse i KRR

I alle andre tilfeller settes canReceiveNotificationByEmail til false