Kontaktforloeb.AfholdtSamtaleService (2023-4)

Forretningsbeskrivelse

Denne service anvendes til at registrere afholdte samtaler og hente den fulde information om disse.

I brugtagning

Kan anvendes fra: 2023-1

Skal senest anvendes fra: 2023-4

Samtaletyper og myndigheder

For de enkelte myndigheder er det muligt at registrere de relevante samtaletype for den pågældende myndighed. For oversigt over hvilke samtaletyper og kontaktgrupper der kan registreres, se Afholdelse af samtaler og øvrige møder. Gennemgang af hvilke myndigheder der må registrere hvad findes under forretningsregler for metoderne nedenfor.

A-kasse filtrering

Der vil være filtrering på servicens get-metoder svarende til filtreringskravene på PersonStatusService (se kollektionen PersonInterviewInfo):

Samtaletyper a-kasse har adgang til at se

Der filtreres på SamtaleTypeCode

  • 7 - Jobsamtale (afholdt på dato hvor borger har været i KG1)
  • 8 - Henvisning
  • 9 - Informationsmøde
  • 10 - CV samtale
  • 11 - Formidlingssamtale
  • 12 - Anden samtale
  • 13 - Informationsmøde uden mødepligt
  • 15 - Rådighedssamtale
  • 17 - Jobsamtale med a-kasse (afholdt på dato hvor borger har været i KG1)

Bookinger og afholdte samtaler 

For en afholdt samtale er det muligt at knytte til en booking (mødeindkaldelse), dette kan ske i forbindelse med registrering af den afholdte samtale. Der kan alene oprettes en relation til ikke-aflyste mødeindkaldelser.

Bookinger GDPR-slettes, når de har en vis alder. Der kan derfor på den afholde samtale være reference til en booking, der ikke længere findes i DFDG.

Min plan versioner og registrering af afholdte samtaler

En afholdt samtale, der registreres af en given myndighedstype (a-kasse eller jobcenter) og som er nulstillende, vil udløse at der dannes en ny version af Min plan. Der er dog den undtagelse at hvis der er tale om en efterregistrering, vil der ikke blive dannet en ny version af Min plan.

Afholdte samtaler og deres registreringspraksis

En afholdt samtale bør forretningsmæssigt registreres så hurtigt efter afholdelsen som muligt og i den korrekte kronologiske rækkefølge. Dette er vigtigt af hensyn til borgers generelle forståelse for hvad der er aftalt med jobcentret og/eller a-kassen, opdatering af aftaler i Min plan, mulighed for beregning af vejledende samtaledatoer, simplificerer jobcenterflytninger eller skift i a-kasse medlemskab m.v.

A-kasse eller jobcenter skal i forhold registrering i den korrekt kronologiske rækkefølge kun se dette ud fra sin egen myndighedstype.     

Det er dog muligt at indberette afholdte samtaler som en efterregistering (op til 1 år (365 dage) efter den dato hvor samtalen er afholdt) af hensyn til borgeren og evt. opfølgning på samtaleafholdelse. En efterregistrering kan anvendes i tilfælde af, at der fx er sket en fejl, forglemmelse eller anden hændelse, som har medført, at en afholdt samtale ikke er blevet registreret i den normale kronologiske rækkefølge for den pågældende myndighedstype. 

En afholdt samtale betragtes som en efterregistrering, hvis den ligge før en allerede registreret 0-stillende afholdt samtale for den pågældende myndighedstype. Hvis en samtale er efterregistreret, vil den ikke danne en ny version af Min plan. Ej heller vil en efterregistreret samtale blive knyttet til evt. historiske Min planversioner, da borger i regi af Min plan ikke har haft mulighed se og forholde sig til aftalen (samtalen). Borgeren kan dog på Jobnet se de efterregistrerede samtaler i sin historik. Her vil de være markeret som efterregistreringer.



WSRM

WSRM'er om afholdte samtaler

  • GetPersonInterviewVersion9 
  • GetPersonInterviewVersion10 

Adgang og filtrering

Adgang beskrives i snitfladen under de enkelte metoder.

Der er filtrering på a-kassernes adgang til afholdte samtaler:

Samtaler a-kasse har adgang til at se

Der filtreres på SamtaleType (tidl. InterviewTypeIdentifier)

7 - Jobsamtale
8 - Henvisning
9 - Informationsmøde
10 - CV samtale
11 - Formidlingssamtale
12 - Anden samtale
13 - Informationsmøde uden mødepligt
15 - Rådighedssamtale
17 - Jobsamtale med a-kasse

CPR-skiftere

For borgere, der skifter CPR- nr., vil registrerede oplysninger i DFDG (Kontaktforløb) om afholdte samtaler blive overført fra borgers gamle til borgers aktuelle cpr.nr. Dette vil ske fra 2023-1, hvorfra registreringsmetoderne på ny REST-service (IAfholdtSamtaleService) reelt anvendes i produktion uanset om eksterne kalder InterviewService eller PersonRegistrationService  i DFDG ifm. registrering af afholdte samtaler eller AfholdtSamtaleService i Kontaktforløb domænet.

A-kasser og jobcentre kan abonnere på (for tiden WSRM-beskeden) GetCprChanged, hvis der er behov for, at vide, hvornår DFDG flytter pegepinden til data om borger fra gammelt til nyt cpr nr.

Nye DFDG forretningsdomæner

For de nye DFDG forretningsdomæner gælder:

  • I nye DFDG forretningsdomæner flyttes data (pegepinden til data) til at være borgers aktuelle cpr,nr, når borger skifter cpr.nr
  • I nye DFDG forretningsdomæner kan der alene registreres og opdateres data ved kald med borgers aktuelle cpr.nr
  • Fra 2023-3:
    • Ved opstart af nye DFDG forretningsdomæner indlæser STAR data fra den ældre del af DFDG i det nye forretningsdomæer uanset borgers CPR-status (bl.a. af hensyn til aflevering af data til Rigsarkivet) og af hensyn til bl.a. jobcentres og a-kassers behov for at kunne læse historiske data om en borger eller et medlem)
    • Serviceaftagere kan hente/læse data i de nye forretningsdomæner uanset om der kaldes med borgers aktuelle eller historisk cpr nr - også hvis borger er død.
    • For de allerede opstartede DFDG forretningsdomæner foretages efterkonvertering / indlæsning af data for de CPR-statusser som i første indlæsning blev udeladt, således at databestanden er komplet.
    • Ved registreringskald til nye DFDG forretningsdomæner med ikke-aktuelt CPR nummer kaster DFDG (ny) fejlkode med oplysning om at borgers aktuelle cpr nr skal anvendes (frem for nuværende brug af fejlkode om at cpr nr ikke findes) - fejlkode 9460 - "Det er ikke tilladt at registrere oplysninger på borgers ikke-aktuelle personnummer"
  • Fra 2023-4
    • I servicen Virksomhedsindsats.PersonStatusService (version 1). GetPersonStatus er der fra 2023-4 releasen foretaget ændring i ansvarligJobcenterKode - Feltet vil fremover bestå af myndighedskode og organisationstype.

DFDG (classic)

For den ældre del af DFDG, der ikke er omlagt til nye DFDG forretningsdomæner, gælder:

  • I DFDG (classic) forbliver data (som hidtil) på det cpr.nr., hvor registreringen oprindeligt er sket
  • Fra DFDG (classic) kan data udlæses på det cpr.nr hvor registreringen oprindeligt er sket
  • Det er muligt for aftagerne at opdatere allerede registrerede data i DFDG (classic) ved kald med ikke aktuelt cpr nr fsva data registreret på det pågældende cpr.nr, det gælder fx afslutning af allerede registreret fravær og lukning af borgers kontaktgruppe
  • Ved registrering / opdatering af data med brug af ikke aktuelt cpr nr., dannes afledte WSRM'er / webservicebeskeder på dette ikke-aktuelle cpr.nr
  • For SOAP services, som stiller igennem til REST services i en overgangsperiode (såkaldte converters), vil det ikke være muligt at opdatere på gammelt personnummer, da data bor i de nye forretningsdomæner, hvor alene aktuelt cpr nr kan anvendes ved registrering / opdatering


Metoder

GetAfholdteSamtaler / GetAfholdtSamtale{Id} (tidl. GetInterviewInfo)

Metode til at hente den fulde InterviewInfo om afholdte samtaler (i modsætning til at der kun vil være et status-udsnit i den kommende statusservice PersonEngagementStatusService med status for booking, interview, frister og anden aktør)

Ift. adgang til servicen, hvor der normalt kun er adgang 120 dage tilbage i tid for egne medlemmer er dog specifikt for denne metode 1 år (365 dage) bagud i tid således, at adgangsfiltreringen ikke forhindrer hentning af data på efterregistreringerne.

Visning på Jobnet

For nogle samtaletyper er der begrænsninger i udstillingen på Jobnet:

  • Møder af typen "Anden samtale" udstilles kun, hvis de er afholdt efter den 28. januar 2014.
  • Møder af typen "Opfølgningssamtale" eller "Anden samtale ifm. opfølgning" udstilles kun, hvis de er afholdt efter den 1. juli 2014.


CreateAfholdtSamtale (tidl. CreateInterview)

Denne servicemetode benyttes til at registrere (oprette) en afholdt samtale samt registrering af deltagere på denne.

Tilladte samtaletyper pr. kontaktgruppe: Indkaldelser, samtaleregistrering og kontaktgrupper

Bemærk at a-kasse adgang vil være til alle borgere men metoden tillader kun at a-kassen kan registrere samtaler i de perioder hvor borger har været medlem.

Forretningsregler vedrørende registrering af afholdte samtaler

Generelle forretningsregler:
  • Afholdte samtaler bør forretningsmæssigt fortsat registreres kronologisk af hensyn til borger, Min plan, mulighed for beregning af vejledende samtaledata m.v. DFDG tillader dog, at der kan ske en efterregistrering og dermed kan der ske en indberetning af afholde samtaler, selvom de ikke registreres kronologisk således, at målinger i "A-kasse indblik" og "Jobindsats.dk" ikke undervurderer antallet af faktisk afholdte samtaler.
  • Der bør som hovedregel ikke registreres flere nulstillende samtaler som værende afholdt på præcist samme tidspunkt, men ifm. a-kasseforsøg er dog dog tilladt, at der kan holdes fx CV-samtale og jobsamtale samtidig, så DFDG validerer ikke længere mod en sådan registrering. A-kassernes anvendelse af cv-samtaler udgår dog forretningsmæssigt 1.1.2024.
  • Samtalen skal på afholdelsesdagen være tilladt for borgeren, dvs. kontaktgruppen (i forhold til EventTime på kontaktgruppen), evt. fravær og medlemskab af a-kasse skal tillade en registrering af den pågældende samtaletype.  
  • Samtaler med samme samtaletype og afholdelsestidspunkt er ikke tilladt.
  • For samtaler, hvor der er angivet en IndkaldelseId (BookingIdentifier), skal denne i forvejen være kendt på borgeren i DFDG. Der kan ikke relateres til IndkaldelseId (bookingidentifier) på en annulleret indkaldelse.
  • Afholdelsestidspunkt kan i DFDG godt være forskellig fra det planlagte afholdelsestidspunkt på den indkaldte samtale / den selvbookede samtale.
  • Der kan ikke registreres afholdte samtaler med udgåede (kodelisteværdier for) afholdelsesform
Forretningsregler vedr. dagpengemodtagere
  • Registrering af en opfølgningssamtale på en dagpengemodtager kan kun ske, hvis borgeren har et sygdomsfravær på samtaleafholdelsesdatoen.
  • Det er kun A-kasser, der kan registrere CV-samtaler og rådighedssamtaler på dagpengemodtagere. Personen skal blot have været i kontaktgruppe 1 på samtaleafholdelsesdatoen. A-kassernes anvendelse af cv-samtaler udgår dog forretningsmæssigt 1.1.2024.
  • A-kasse kan registrere afholdte nulstillende samtaler af typerne jobsamtaler (id 7 og 17), CV-samtaler og rådighedssamtale, som værende afholdt på samme tidspunkt (præcis samme dato og klokkeslæt), hvis der blot er tale om forskellige samtaletyper. 

  • For deltagere i a-kasseforsøg gælder dette også jobsamtale (id 7) og fælles jobsamtale med dagpengemodtager (id 17)
FÆLLES JOBSAMTALE MED DAGPENGEMODTAGER
  • For "Fælles jobsamtale med dagpengemodtager" (id 17) skal gaestendeMyndighedIndkaldt være sat til True. 
    • - og moededeltagelseStatusTypeskal angive om den gæstende (ikke-indkaldende) myndighed har deltaget. Ellers returneres fejlkode 9126.
    • - hvis det er angivet at anden myndighed har deltaget og moededeltagelseStatusType er sat til 1 eller 7, skal det også angives, hvem der har deltaget fra anden myndighed ved oprettelse af en moededeltager.
  • For "Fælles jobsamtale med dagpengemodtager" (id 17) vil borgerens og a-kassens eller jobcentrets eventuelle mødedeltagelsesfravalg blive nulstillet ved registrering af afholdt samtale.
Særlige forretningsregler vedrørende a-kasserne:
  • A-kasser kan kun registrere
    • CV-samtaler (Id 10) (med afholdelsesdato før 1. juli 2024 Cv-samtaler anvendes fra 2024 på dagpengemodtagere, der skal have kontaktforløb efter de før 1.1.2024 gældende regler, jf. § 5, stk. 2, lov nr. 727 af 13.06.2023)
    • rådighedssamtaler (id 15)
    • informationsmøde (id 9)
    • anden samtale (id 12)
    • informationsmøde uden mødepligt (id 13)
  • For deltagere i a-kasseforsøg kan a-kasse dog også registrere
    • jobsamtale (id 7)
    • fælles jobsamtale med dagpengemodtager (id 17).
    • Det afgørende er her at medlemmet er forsøgsdeltager på afholdelsesdatoen, eller at den nuværende indplacering (målt på gradingDate i dagpengetællerne) ligger forud for samtaledatoen, og borgeren på samtaleregistreringsdatoen har et fravær 75.
  • Tilsvarende kan der efterregistreres jobsamtale og fælles jobsamtale efter ophør i forsøget når blot personen var medlem og havde fravær 75 på afholdelsesdagen 
  • A-kasser kan kun registrere afholdte samtaler (generelt) på dagpengemodtagere og der kan dog også registreres Cv-samtaler på dimittender, men der er givet mulighed for registrering af samtaler på egne medlemmer, da a-kasserne bortset fra ved tilmelding ikke kan påvirke medlemmets kontaktgrupperegistrering. Dette for at a-kasserne samtaleregistrering ikke hindres af fx fejlregistreringer af kontaktgruppe i jobcentret.
  • A-kasser kan kun registrere afholdte samtaler på egne medlemmer.
  • Hvis DFDG ikke kender til medlemskabet på forhånd, skal medlemskabets starttidspunkt ligge før tidspunktet for samtalens afholdelse, for at DFDG kan modtage registreringen af den afholdte samtale - medlemsskabets starttidspunkt sættes af a-kassen via UnemploymentFundMembershipService med metoden MembershipRegistration).
Særlige forretningsregler vedrørende jobcentrene:
  • Jobcentre kan kun registrere samtaler på borgere, der har jobcentertilknytning i pågældende jobcenter.
  • For samtaletypen "Samtale i rehabiliteringsteam" (id 18) kan det angives om borgeren har deltaget. Hvis det angives, skal moededeltagelseStatusType være 5 eller 6, ellers returneres fejlkode 9125.
  • Jobcentre (ved kald ind som jobcenter, STAR, Kommunerne, anden aktør osv.) kan registrere afholdte samtaler, hvis blot samtaletypen er valid på mindst 1 af de kontaktgrupper som personen er eller har været registreret med på samtaleafholdelsesdatoen.
  • Der kan ikke registreres CV-samtale for
    • KG 8 Uden Ydelse
    • ledige fleksjobvisiterede (KG 7) og
    • fleksjobansatte (KG 10)
Særlige forretningsregler vedrørende efterregistrering af samtaler (dvs. samtaler der registreres som afholdt før seneste nulstillende samtale for den pågældende myndighedstype)
  • En efterindberetning af afholdte samtaler skal kunne registreres op til 365 dage bagud i tid
  • En efterregistrering er defineret ved at der er tale om en samtaleregistrering hvor afholdelsesdatoen ligger før seneste nulstillende samtale registreret af samme myndighedstype (jobcenter eller a-kasse)
  • En efterindberettet afholdt samtale vises ikke i Min plan (fordi aftaler/referat fra tidligere afholdte samtaler i Min plan så ville fremgå som mere aktuelle end senere afholdte samtaler).
  • En efterindberettet afholdt samtale vil ligeledes ikke fremgå af tidligere Min plan versioner  (fordi borger ikke har kunnet forhold sig til den pågældende aftale(samtale) korrekt tidsmæssigt)
  • En efterindberettet afholdt samtale skal ikke validere ift. senere kontaktgruppe skift m.v., men samtaletypen skal blot være lovlig i kontaktgruppe m.v. som personen havde på afholdelsestidspunktet se Afholdelse af samtaler og øvrige møder
  • En efterindberettet samtale skal kunne registreres af a-kassen, selvom personen aktuelt er medlem af en anden a-kasse, hvis blot personen var medlem af den registrerede a-kasse på afholdelsestidspunktet, dog tages hensyn til perioden hvor der må registreres bagud i tid.
  • For deltagere i a-kasseforsøg kan a-kassen dog også efterregistrere jobsamtale (id 7) og fælles jobsamtale med dagpengemodtager (id 17), dette forudsætter dog også at borger har fravær "Kontaktforløb er hos a-kassen" (Id 75) .
  • En efterindberetning af samtale kan også foretages af jobcentret, selvom jobcentret ikke mere er borgers eget jobcenter (pga. CPR-flytning mellem kommuner). Dette kan det ske ved at "overtage" jobcenter-tilhørsforhold, foretage en registrering og derefter "skubbe" personen retur til sit jobcenter i CPR-kommunen.

120 dages reglen for egne medlemmer ændres til at være 1 år (365 dage) bagud i tid således at adgangsfiltreringen ikke forhindrer efterregistreringerne. 

UpdateAfholdtSamtale (Tidl. UpdateInterview)

Denne servicemetode benyttes til at opdatere en afholdt samtale. 

Der ses bort fra indhold i moededeltagere ved Update. Der skal i stedet benyttes CreateMoedeDeltager, UpdateMoededeltager og DeleteMoededeltager (tidl. Add- Update- og DeleteInterviewParticipant)-metoderne til dette.

Ved opdatering er der ikke validering på, at moededeltagere og moededeltagelsesStatus stemmer overens.

Idet der henvises til de soapfaults, som metoden kan kaste, angives alene her enkelte af valideringsreglerne:

Forretningsregler
  • Hvis IndkaldelsesId på den samtale, der forsøges opdateret, ikke findes, kastes fejlkode 4768 
  • Identifikationsnøglen på den afholdte samtale kan ikke opdateres (fejlkode 8186)
  • A-kasser kan ændre samtaletypen på egne tidligere indberettede afholdte samtale som følger, idet samtaletypen stadig skal være lovlig ift. borgerens kontaktgruppe:
    - Opdatere imellem CV samtale (id 10) og rådighedssamtale (15) 
    - For borgere a-kasseforsøgOpdatere imellem jobsamtale (id 7), CV-samtale (id 10) og rådighedssamtale (id 15)
    Opdateringer udenfor disse rammer eller for andre myndigheder, vil medføre fej
    lkode 8187.
  • Hvis det forsøges at opdatere samtalens starttidspunkt, så samtalen ændrer karakter fra efterregistrering til nulstillende eller omvendt, kastes fejlkode 9415.
Særlige forretningsregler vedrørende a-kasserne:
  • Hvis personen ikke er medlem af a-kassen kan kastes fejlkode 4575 eller 4385.
  • Fra den 1. juli 2024 eller efter denne dato vil A-kasser ikke længere have mulighed for at indberette CV-samtaler.

CreateMoedeDeltager (tidl. AddInterviewParticipant)

Metoden tilføjer en deltager til en eksisterende afholdt samtale.

UpdateMoededeltager (tidl. UpdateInterviewParticipant)

Metoden opdaterer en given deltager på en eksisterende afholdt samtale. Det vil være muligt at opdatere navnet samt det eksterne ID på deltageren.

WSRM-beskeden GetPersonInterview fremsendes ikke ved opdatering eller sletning af deltagere på det afholdte interview. 

InterviewParticipantCollection (som alligevel blev ignoreret) er fjernet.

DeleteMoededeltager (tidl. DeleteInterviewParticipant)

Metoden sletter en given deltager fra en eksisterende afholdt samtale.

WSRM-beskeden GetAfholdtSamtale / GetPersonInterview fremsendes ikke ved opdatering eller sletning af deltagere på det afholdte interview.