Forretningsbeskrivelse

Denne service anvendes til at indberette indkaldelser til DFDG og udtrække disse, så myndigheder kender til hinandens indkaldelser af en borger, og kan undvige dobbeltbooking. 

I brugtagning

Kan anvendes fra: 2022-3

Skal senest anvendes fra: 2023-4 ift. Create og Update af indkaldelser. GetIndkaldelse dog fra 2022-3. Se nærmere i varslingstasks for 2022-3 epic 999.3.

Frister for selvbook - borger må ikke forvirres af at have en frist og en (fristindfriende) booking, eller flere bookinger samtidig

Dette er relevant for samtaletyperne Jobsamtale (7) og Opfølgningssamtale (4).

Der valideres i BookingService på at man ikke må have en fremtidig aftale med samme samtaletype. Så snart starttidspunktet på en eksisterende booking er overskredet, kan en ny oprettes.

Hvis borger har en booking så kan man godt udstede en frist, denne vil så blot blive indfriet omgående af bookingen.

Tilsvarende kan man godt lave en indkaldelse selv om der er udstedt en frist - den vil så blot indfrie fristen.

Mere om frister på Obligatorisk selvbooking og frist til booking

Kvitteringsmails sendt til borgeren ved opdatering af indkaldelse fra KSS, planner-system eller selv- og ombook fra Jobnet (og altså meget specifikt IKKE når indkaldelsen handler om en a-kasse-samtale)

Ved ændringer til en indkaldelse fra IndkaldelseService og BorgerBookingService bliver der sendt kvitteringsmails til borgeren ved benyttelse af følgende metoder:

IndkaldelseService: CreateIndkaldelse, UpdateIndkaldelse og DeleteIndkaldelse.

BorgerBookingService: CreateBooking, CreateOmbooking og DeleteBooking

Følgende flettefelter bliver benyttet til udarbejdelse af disse kvitteringsmails:

• [MeetingAddress] - Adresse hvor borgeren skal til møde ifbm. mødeindkaldelsen
• [StartTime] - Starttidspunktet for mødeindkaldelsen i format dd-MM-yyyy kl. HH:mm
• [RebookDeadline] - Frist for ombook af mødeindkaldelsen i format dd-MM-yyyy kl. HH:mm
• [PhoneNumber] - Telefonnummer som borgeren skal benytte ved telefonisk mødeindkaldelse

Den enkelte E-mail kvitteringstekst kan tilrettes af STAR f.eks. via LSS under "Stamoplysninger" -> "Kvitteringstekster". Mere om Huskeservice på Tekster i SMS- og e-mailservice (Huskeservice)

I nedenstående tabel er det dokumenteret hvilke ændringer i en booking der medfører huskeserviceudsendelse. Der er ikke lavet automatik til at vise for borger hvad der er ændret på indkaldelsen.

Feltet Selvbooket (SelfBooked)

Det er hensigten at dette flag sættes, når selvbookingen foretages fra Jobnet eller anden selvbetjeningsløsning.

Det er således ikke hensigten, at indkaldelser registreres som værende selvbookede, når sagsbehandlerne indkalder eller ombooker, selvom de gør det sammen med borgeren eller på foranledning af borgeren (med mindre det sker fra Jobnet eller anden selvbetjeningsløsning).

Adgang og filtrering

Rettigheder til at kalde metoderne er angivet ifm. snitfladebeskrivelserne.

A-kasse filtrering

Der vil være filtrering på servicens get-metoder:

CPR-skiftere

For borgere, der skifter CPR- nr., vil registrerede oplysninger i DFDG (Kontaktforløb) om indkaldelser blive overført fra borgers gamle til borgers aktuelle cpr.nr. Dette vil ske fra 2022-3, hvorfra registreringsmetoderne på ny REST-service (IndkaldelseService) reelt anvendes i produktion uanset om eksterne kalder BookingService i DFDG eller IndkaldelseService 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

CreateIndkaldelse

Giver adgang til at oprette en mødeindkaldelse i DFDG

Forretningsregler:

• Starttidspunkt på indkaldelse må ikke være før dags dato
• Sluttidspunkt må ikke være før starttidspunkt
• IndkaldelseId er en unik GUID som kan medsendes fra det oprettende system. Hvis den ikke medsendes, opretter DFDG.
• Frist for ombooking og frist for aflysning må ikke være efter starttidspunkt (moedeStarttidspunkt)
• Frist for ombooking og aflysning må ikke være udfyldt med mindre at det er tilladt at foretage ombooking respektive aflysning
• Længden (start og slut) på en booking må ikke overstige én dag.
• Adresse er optionel, men skal udfyldes med adressen for mødets afholdelse hvis mødet er med samtaleform ”Personlig kontakt”.
• Hvis adresse er udfyldt skal postnummer være et validt postnummer.
• Elementet mellemnavn for afholdendeSagsbehandler skal enten udelades eller udfyldes med mindst 1 tegn.
• Mødets sluttid skal angives med enten moedeSluttidspunkt eller moedevarighed.
• Ved mødetypen Telefon (Id 2) skal der angives om det er borger der skal ringe ind med feltet borgerRingerOp i kontaktinformation og telefonnummer skal udfyldes.
• For samtaletyperne "Fælles jobsamtale med dagpengemodtager" (id 17) og "Samtale i rehabiliteringsteam" (id 18) må det ikke være muligt at ombooke (dvs. ombookingMulig skal være "false"). Ellers returneres fejlkode 8270.
• Man kan kun have 1 samtale ad gangen af typerne Opfølgningssamtale (id 4) og Jobsamtale (id 7 og 17). Valideringen går på om der ligger en fremtidig samtale på tidspunktet for indkaldelsens oprettelse.
  • NB. Hvis borger har et aktivt fravær af typen "Kontaktforløb er hos a-kassen" (id 75) er det tilladt borgers a-kasse at lave flere fremtidige Jobsamtaler (id 7).
• For samtaletypen "Samtale i rehabiliteringsteam" (id 18) returneres fejlkode 9121 hvis borgeren ikke er i en af følgende kontaktgrupper:
  
  • "Kontanthjælpsmodtager" (2),
  • "Introduktionsydelsesmodtager" (3),
  • "Revalidering" (4),
  • "Sygedagpengemodtager" (id 6),
  • "Fleksjobvisiteret" (id 7),
  • "Uden ydelse" (id: 8).
  • "Fleksjobansat" (id: 10),
  • "Rehabilitent" (id 11),
  • "Uddannelsesydelsesmodtager" (12),
  • "Jobafklaring" (id 13),
  • "Førtidspensionister" (id: 14),
  • "Unge u. 18" (id: 16),
  • "Selvforsørgede, ikke i beskæftigelse" (id: 17),
  • "Selvforsørgende udlændinge efter Integrationsloven" (id: 18),
  • "Indvandrere i introduktionsforløb" (id: 19),
  • "Beskæftigede" (id: 20),
  • "Voksenelever" (id: 21),
  • "Jobrotation" (id: 22),
  • "Seniorjob" (id: 23),
  • "Sygedagpengemodtager fra beskæftigelse" (id 24)
  • "Sygedagpengemodtager fra ledighed" (id 25).
  • "Integrationsydelsesmodtager" (id 26)
  • "Integrationsydelsesmodtager omfattet af introduktionsprogrammet" (id 27)
  • "Integrationsydelsesmodtager med uddannelsepålæg" (id 28)

• For alle samtaletyper returneres fejlkode 8058 (The specified interviewtype is not coherent with the current contactgroup) hvis borgeren er i en kontaktgruppe hvor samtaletypen ikke er tilladt. Tilladte samtaletyper pr. kontaktgruppe: Indkaldelser, samtaleregistrering og kontaktgrupper
• Der kan ikke bookes flere jobsamtaler til afholdelse samme dag - fejlkode 90109 'Borger har allerede en indkaldelse samme dag til samtale af samme type'.
• Starttidspunkt må ikke ligge efter fremtidig kontaktgruppeslutdato
• Der foretages i DFDG ingen validering af myndighedsdeltageres roller
• Der foretages i DFDG ingen validering for, om a-kasse indkaldes eller ikke afhængigt af registrerede borger ønsker om a-kassens deltagelse eller a-kassens til- og fravalg af deltagelse i fælles jobsamtaler (id 17)
• Borgere i KG10 har nu mulighed for at få en opfølgningssamtale (type ID 4). Dette tillader 'fast track' opfølgning i forbindelse med sygdom, før de officielt bliver sygedagpengemodtagere.

Følgende felter er primært rettede imod de kommunale sagsbehandlingssystemers brug, DFDG tillægger det ikke betydning hvis de udfyldes ved bookninger til møder i a-kasse: 

• indkaldelseAccepteret
• indkaldelseAccepteretTidspunkt
• visSagsbehandlernavnForBorger

Begrænsning i samtaletyper for a-kasser

A-kasser må kun oprette bookninger med InterviewTypeIdentifier

• "Jobsamtale" (Id 7)
• ”Informationsmøde” (Id 9)
• ”CV samtale” (Id 10), dog kun med planlagt samtaledato før 1.7.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, i lov nr. 727 af 13.06.2023)
• ”Anden samtale” (Id 12)
• ”Informationsmøde uden mødepligt” (Id 13)
• ”Rådighedssamtale” (Id 15)
• "Fælles jobsamtale" (Id 17)

For Jobsamtale (id 7) og Fælles jobsamtale (id 17) gælder, at a-kassen kun kan indkalde denne når borger er i KG 1 Dagpengemodtager eller KG 8 Uden Ydelse.

A-kasse forsøg, fravær 75 

For samtaletype "Jobsamtale" (id 7) og "Fælles jobsamtale med dagpengemodtager" (id 17) må A-kasser kun indkalde borgere til de to samtaletype hvis borgeren har et aktivt fravær "Kontaktforløb er hos a-kassen" (id 75). Ellers returneres fejlkode 9377 (Unemployment funds can only book and register InterviewType 7 and 17 for citizens with absence id 75).

Fremtidige indkaldelser til møder af typen "Jobsamtale" (id 7) og "Fælles jobsamtale med dagpengemodtager" (id 17) i a-kassen aflyses af DFDG, når fraværet afsluttes.

Begrænsning i samtaletyper for jobcentre

Jobcentre må ikke indkalde borger imens borgeren har kontaktforløb i a-kassen (har et aktivt fravær "Kontaktforløb er hos a-kassen" (id 75) OG er i kontaktgruppe 1 - Dagpengemodtager). Fejlkode 9379 (A citizen with absence 75 may not book or get booked for meetings in jobcenter). Hvis borger er i anden kontaktgruppe ned KG1 må jobcentret gerne indkalde.

Jobcentret må ikke indkalde til CV samtale (id 10) for KG 8 - Uden Ydelse. Fejl:  4575 - You are not authorized

Fælles Jobsamtale med dagpengemodtager - sammenhæng med borgers ønske vedrørende deltagelse af gæstende myndighed:

Oprettelsen af en myndighedsdeltager af den type som gæstende myndighed er, indikerer at man forventer at gæstende myndighed deltager ved den fælles jobsamtale (idet hverken borger eller gæstende myndighed har indikeret at gæstende myndighed skal holde sig væk).

Den gæstende myndighed opdaterer indkaldelsen med stillingtagen til egen deltagelse.

Selvom borgeren ikke ønsker gæstende myndigheds deltagelse i jobsamtalen, skal fælles jobsamtaler registreres som Fælles jobsamtale med dagpengemodtager (id 17).

Hvis gæstende myndighed forventes at deltage oprettes der en myndighedsdeltager af den tilsvarende type på indkaldelsen.

Mødebeskrivelse mister HTML hvis feltet bliver for langt til at indkaldelsen vil kunne udlæses

DFDG stripper HTML fra indkaldelsens mødebeskrivelse hvis den indeholder HTML og DFDG kan se at den ifm. encoding bliver over de 500 tegn som er maks-længde ved udlæsning. 

Selvbookede samtaler

Det er muligt at oprette, rette og aflyse indkaldelser som er selvbookede med IndkaldelseService. Ved indberetninger fortaget af borgeren forventer DFDG at RequestUserTypeIdentifier i requestheaderen sættes til 1 - Citizen og at UserIdentifier sættes til borgeren personnummer. I selve request for CreateIndkaldelse forventes feltet selvbooket sat til true. Ved CreateIndkaldelse valideres ligeledes at bookingen overholder en eventuel frist (for samtaler til afholdelse i jobcenterregi). DFDG validerer ikke på om det gøres muligt at ombooke eller aflyse bookingen, disse flag og deadlines må det kaldende system sætte op selv. Fx giver det god mening at ikke tillade aflysning af en booking hvis den indfrier en frist.

Jobsamtaler (id 7) i jobcenteret kan selvbookes af fra Jobnet inden for de mødetilbud jobcentret har opsat i sit planner-system.

Fælles jobsamtaler (id 17) i jobcenteret kan selvbookes fra Jobnet i det omfang det enkelte jobcenter har valgt dette - og opsat mødetilbud, der understøtter dette (inden for de timeslots det enkelte jobcenter og den enkelte a-kasse aftaler).

UpdateIndkaldelse

Denne metode understøtter mulighed for at opdatere en indkaldelse fra et sagsbehandlersystem. Opdateringer er underlagt de samme restriktioner som oprettelser, og derudover gælder:

Forretningsregler:

• Starttidspunkt på booking må ikke være før dags dato
• Sluttidspunkt må ikke være før starttidspunkt
• Deadline for ombooking må ikke være efter starttidspunkt for booking
• Når GruppemoedeEjersystem er sat, validerer DFDG imod at gruppemødet kan ændres af andre systemer. Tilhørende fejlkode 9025 (You are not allowed to update or cancel this group booking).
• For samtaletyperne "Fælles jobsamtale med dagpengemodtager" (id 17) og "Samtale i rehabiliteringsteam" (id 18) må det ikke være muligt at ombooke (dvs. OmbookingMuligt skal være "false"). Ellers returneres fejlkode 8270 (ReBookingPossible has to be false for bookings with interviewtype Id 17 and Id 18).
• Samtaletype kan ikke opdateres
• Starttidspunkt må ikke ligge efter fremtidig kontaktgruppeslutdato

Begrænsning i samtaletyper for a-kasser

A-kasser kan ikke længere indberette CV-samtaler med planlagt afholdelsesdato 1. juli 2024 eller senere. Forretningsmæssigt udgår a-kasserne anvendelse af cv-samtale typen 1. januar 2024.

DeleteIndkaldelse

Denne metode understøtter muligheden for at aflyse indkaldelser.

Forretningsregler:

• Det er muligt at aflyse historiske og fremtidige indkaldelser
• Der skal altid medsendes en aflysningsårsag
• Såfremt den aflyste booking indfriede en frist (InterviewDeadline) ændres fristens status til IndfrietLukket.
• Hvis bookingen er annulleret, kan den ikke opdateres / annulleres endnu en gang (fejlkode 4768 - The submitted BookingIdentifier is unknown to the system)

DeleteIndkaldelse resulterer i en besked til borgeren i "MIN BESKEDBAKKE" på jobnet. Dette gælder dog ikke for A-kasse møder og aflysning pga. flytning. Beskeder sendes vha. dialogmodulet og med sms eller email hvis borgeren er tilmeldt huskeservice. Der er tre forskellige beskedskabeloner med forskelligt tekstindhold. Hvilken der sendes styres af aflysningsårsag. 

I visse situationer annullerer DFDG indkaldelser i forbindelse med flytning. Forretningsreglerne herfor er beskrevet på siden TransferDataService.

SaveDeltagelsesvalg

Registrering af borgers ønske

Registring af en borgers ønske om, hvorvidt borgeren ønsker gæstende myndigheds deltagelse i møder af typen ”Fælles Jobsamtale med dagpengemodtager”. Under kontaktforløbsansvar i a-kassen vil det være jobcentrets deltagelse borger ønsker registreret. Ved oprettelse og afslutning af fravær "KontakforløbHosAkassen" (Id 75) nulstilles borgerens ønske, ligesom det nulstilles når fælles jobsamtale registreres afholdt.

Hvis deltagelse af den gæstende myndighed frabedes, vil der blive afholdt en samtale af typen fælles jobsamtale med dagpengemodtager (InterviewType 17) uden den gæstende myndighed og på jobnet vil samtalen for borger fremstå som en almindelig jobsamtale.

Hvis det deltagelsesvalg id 3 (Borger ønsker a-kassens deltagelse ved fælles jobsamtale i jobcentret) opdateres til at borger ikke ønsker a-kasse med, fjernes a-kasse fra fremtidigt mødeindkaldelse og der sendes WSRM’er GetWarning og GetMeetingParticipation.

Den indkaldende aktør skal i sin indkaldelse selv tage højde for borgers ønske. DFDG validerer ikke herfor.

Registrering af myndighedens ønske

Metode til registrering af a-kassens (under a-kasse forsøg Jobcentrets) fravalg af deltagelse i første jobsamtale. Ved oprettelse og afslutning af fravær "KontakforløbHosAkassen" (Id 75) nulstilles gæstende myndigheds ønske.

Den indkaldende aktør skal i sin indkaldelse selv tage højde for myndighedens ønske. DFDG validerer ikke herfor.

Forretningsregler:

• Hvis borgeren ikke er tilmeldt, kastes fejlkode 9151.
• Hvis borgeren eller myndigheden fravælger den gæstende myndigheds deltagelse opdateres en fremtidig indkaldelse til et møde af typen ”Fælles Jobsamtale med dagpengemodtager” ved at fjerne den gæstende myndigheds deltagelse. I den forbindelse bliver der, ud over WSRM'er om ændret deltagelsesvalg til begge myndigheder, og ændret booking, også sendt en GetWarningVersion4 WSRM til Jobcenteret med WarningTypeIdentifier 51 - "A-kasse-deltagelse fjernet fra booking" medmindre borgeren har kontaktforløb i a-kassen.
• Når myndighedens ønske opdateres sendes WSRM beskeden GetMeetingParticipationVersion1 om dette til såvel a-kasse som jobcenter.

GetDeltagelsesvalg

Metode til hentning af aktuelle valg om deltagelse i fælles jobsamtale

GetDeltagelsesvalgshistorik

Metode til hentning af historik på valg om deltagelse i fælles jobsamtale

GetIndkaldelser / GetIndkaldelse

Henter en borgers indkaldelser. Kan kaldes med IndkaldelseId for at afgrænse til en specifik indkaldelse.

GetIndkaldelseshistorik

Henter historik for en borgers indkaldelser. Kan kaldes med IndkaldelseId for at afgrænse til en specifik indkaldelse.

CreateMyndighedsdeltager

Bruges til at tilføje myndighedsdeltagere på en fælles jobsamtale (samtaletype id 17)

Hvis der i forvejen findes en myndighedsdeltager med samme rolle, hvor deltagelsesflaget ikke er sat (dvs. hverken er true eller false, men null), kastes fejlkode 90101 'Opdater eksisterende myndighedsdeltagere inden oprettelse af nye'

UpdateMyndighedsdeltager

Bruges til at opdatere gæstende myndigheds deltagelse på en fælles jobsamtale

Hvis der i forvejen findes en myndighedsdeltager med samme rolle, hvor deltagelsesflaget ikke er sat (dvs. hverken er true eller false, men null), kastes fejlkode 90101 'Opdater eksisterende myndighedsdeltagere inden oprettelse af nye'

DeleteMyndighedsdeltager

Bruges til at fjerne en gæstende myndigheds deltager på en fælles jobsamtale

GetSoegning

Metoden kan anvendes til at fremsøge personer, der er indkaldt til fx stormøder på en given dato eller i et givet datointerval. Servicen kan anvendes til synkron udsøgning af aktuelle møder på en given dato eller i et givet datointerval mm. 

Der er implementeret en konfigurationsværdi i DFDG, der sætter en intern grænse for det maksimale antal møder en søgning kan resultere i. Der kan hentes op til 3.000 søgeresultater pr. søgning.

Forretningsregler

Metoden kan anvendes af kommunale systemer og der er følgende forretningsregler:

• Søgning udført af en sagsbehandler må kun resultere i mødeindkaldelser (bookinger) i samme (hoved-)jobcenter som sagsbehandlerens.
• Der er ikke organisatoriske eller geografiske begrænsninger i søgeresultater udført af STAR-brugere.
• Der ses bort fra historiske bookinger, således at de møder der returneres i søgeresultatet har start-dato i dag eller senere.
• Det kan i søgeparametrene vælges, om der ønskes returneret aflyste indkaldelser.
• Søgning udført af anden aktør returnere alle bookinger, som er tilknyttet jobcenter, der laves kald som, samt de borgere med bookinger oprettet af den pågældende anden aktør.