Versions Compared

Version Old Version 6 New Version 7
Changes made by

Carsten Olsen

Carsten Olsen

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Formål med service

KontaktinformationVerifikationsService giver STAR mulighed for at få borger til at verificere borgerens email adresse.

Forretningsregler 

Når en borger f.eks. i forbindelse med sine almindelig kontaktinformationer eller jobagenter ønsker at anvende en email skal denne verificeres af borger selv itte nden den kan anvendes af STAR. Dette sker for at sikre at det er den korrekte modtager der sendes til.

Link til snitfladebeskrivelse

Child pages (Children Display)
sorttitle

Link til

forretningsbeskrivelser

forretningsbeskrivelser9

Search Results
spacekeyLOG
queryPersonNotificationReminderService

Metoder

CreateKontaktinformation

CreateVerifikationskode (POST /v1/verifikationskode/

kontaktinformation

email)

Denne metode opdaterer borgeres kontaktinformation. Disse omfatter pt. mobiltelefon, fastnet telefon og mailadresseopretter en verfikationskode og sender den til borgers email.

Forretningsregler:

De kontaktdatatype (Borgerkommunikation.KontaktdataCodelList), der angives i kaldet oprettes og hvis kontaktdatatype allerede findes, overskrives den gamle værdi.
  • Angives en kontaktdatatype med NULL i kontaktinformation, anses dette som en sletning af kontaktinformationen.
  • Hvis kontaktdatatype angives med NULL i kontaktinformation valideres om borger er pligtig til har et søgbart CV (jobparate borgere), i givet fald fås en fejl.
    Valideringen sikre at borger eller andre ikke kan slette kontaktinformation der er en forudsætning for at have et søgbart CV
  • Hivis der oprettes eller ændres i e-mailadresse og/eller mobiltelefonnummer fra en sagsbehandler og ikke borger selv via Jobnet sættes kodelisteværdien kontaktdatastatus (Borgerkommunikation.KontaktdataStatusCodelList) til Id 4 ”Oprettet af sagsbehandler". 
  • Hvis der er abonnement på e-mail, fåes en fejl, hvis den pågældende type af kontaktinformation sættes til NULL.
    Valideringen sikre at borger eller andre ikke kan slette email hvor der er knyttet et huskeservice abonnement
    Der er ikke validering mod telefon, da borger modtager SMS via NemSMS og der en fall back i forhold til huskeservice abonnement
  • Der valideres på værdien i kontaktdata, således at der kun kan registreres valide mobiltelefonnumre, valide fastnet telefonnumre samt valide mailadresser. Valideringen udføres på baggrund af kontaktdatatype.
    For modiltelefon valideres kun om de er valide i forhold til danske, svenske og tyske mobiltelefonnummere, for andre nationaliteter validere ikke om der et tale om et validt mobiltelefonnummer
  • Der udsendes WSB GetPersonContactInfo - WSRM  ved opdatering af en borges kontaktinformationer. 

    • UpdateKontaktinformation (POST /v1/kontaktinformation/verifisering)

    Metoden sætter kontaktinfo status til ”Verificeret af Borger” (Borgerkommunikation.KontaktdataCodelList = 3), hvis verifikationskoden, der angives, er korrekt. 

    Forretningsregler:

    • Der kan kun valideres kontaktoplysninger af typen MailAdresse (KontaktdataCodelList = 3), øvrige vil fejle.
    • Koder der er mere end 2 dage gamle er udløbet, dvs. koder for dagsdato og de foregående 2 dage er valide.  Antallet af dage er konfigurerbart. 
    • Der sendes ikke WSB, når der status på kontaktinformationer ændres i forbindelse med verifikation af kontaktoplysninger.

    GetKontaktinformation (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

    Denne metode udsøger borgere, der er tilmeldt huskeservice med et givet mobilnummer og den periode personen har været tilmeldt med det pågældende mobilnummer. Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger. 

    GetKontaktinformation (GET /v1/kontaktinformation/emailaddress/{email })

    Denne metode udsøger borgere, der er tilmeldt huskeservice med en given e-mailadresse og den periode personen har været tilmeldt med den pågældende e-mailadresse.  Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger. 

    UpdateKontaktinformation (POST /v1/kontaktinformation/status)

    Denne metode giver mulighed for at ændre status (kontaktdatastatus) på en borgers mailadresse eller mobiltelefonnummer.

    Forretningsregler: 

    • Sættes status til 2 "Ikke verificeret til huskeservice" på borgerens mailadresse, sendes en mail indeholdende en verifikationskode, som borgeren kan bruge til at verificere sin mailadresse.
    • Sættes status til 2 "Ikke verificeret til huskeservice" på borgerens mobiltelefonnummer, sendes en SMS indeholdende en verifikationskode, som borgeren kan bruge til at verificere sit mobiltelefonnummer.
    • Der udsendes ikke WSRM når status opdateres.

      En verfikationskoden sendes til den angivne email for borger.

    • Verfikationskoden vil være valid i 24 timer

    • Verfikationskoden kan være koblet til en borger via cprnummer og email eller email alene.  

    GetVerifikationskode (Get /v1/verifikationskode/email)

    Denne metode verificerer om en verfikationskode er valid for borgers email.

    Forretningsregler:

    • Hvis den pågældende verifikationkode er kendt og aktiv via cprnummer og email (bruges til almindelige kontaktinformationer) eller email alene (bruges til jobagenter) retuneres der positivt tilbage ellers retuneres negativt tilbage.