Versions Compared

Version Old Version 1 New Version Current
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

BorgerKontaktinformationService (tidl. PeronNotificationReminderService) giver sagsbehandler KontaktinformationVerifikationsService giver STAR mulighed for at redigere borgerens kontaktinfofå borger til at verificere borgerens email adresse.

Forretningsregler 

Sagsbehandler skal selv sikre at borgeren har givet samtykke, før at denne service må benyttes til at oprette kontaktinformation for borgeren. 

Mailadresse og mobiltelefonnummer har status. Når en sagsbehandler opdaterer kontaktinfomation via metoden SavePersonContactData sættes status til  PersonContactDataStatusIdentifierType til Id 4 ”Oprettet af sagsbehandler. Dette medfører at /wiki/spaces/FYS/pages/4394090607 kan benyttes uden at borger skal verificere kontaktoplysningerne. For regler vedr. verifikation af kontaktoplysninger se /wiki/spaces/GI/pages/75540587 XXXXX

Det er muligt for sagbehandler at indberette en e-mailadresse i forbindelse med tilmelding, se nærmere i /wiki/spaces/GI/pages/5308597. XXXXXX   

For regler vedr. udsendelse af huskeservicebeskeder, se XXXXXX /wiki/spaces/GI/pages/77892328 herunder beskrivelse af mapning mellem notifikationer, og de forskellige abonnementer. 

Gamle kontaktinformation bevares som historik af hensyn til at kunne dokumenterer tidligere foretaget kommunikation og hvor dette er sendt 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

search

spacekeyLOG
queryPersonNotificationReminderService

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

Metode
Alle borgere
Egne borgere
Mulighed for gæsteadgang
Beskrivelse
SavePersonNotificationDataJC, AA(JC)SavePersonContactDataJC, AA(JC)GetPersonContactAndNotificationDataJC, AA(JC)GetPersonContactAndNotificationDataHistoryJC, AA(JC)GetPersonByMobilePhoneNumberJCAA(JC)GetPersonByEmailAddressJCAA(JC)SavePersonContactStatusJC, AA(JC)

A-kasser

Metode
Alle personer
Egne medlemmer
Tidligere medlemmer
Mulighed for gæsteadgang
Beskrivelse
SavePersonNotificationDataXSavePersonContactDataXGetPersonContactAndNotificationDataXGetPersonContactAndNotificationDataHistoryXGetPersonByMobilePhoneNumberGetPersonByEmailAddressSavePersonContactStatusX

CreateKontaktinformation (POST /v1/kontaktinformation)

Denne metode opdaterer borgeres kontaktinformation. Disse omfatter pt. mobiltelefon, fastnet telefon og mailadresse.
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.

    Metoder

    CreateVerifikationskode (POST /v1/verifikationskode/email)

    Denne metode opretter en verfikationskode og sender den til borgers email.

    Forretningsregler:

    • 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.  

    GetKontrollerVerifikationskode (Get /v1/KontrollerVerifikationskode/email)

    Denne metode kontrollere 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.