Denne service indeholder webservicekald til at registrere og hente oplysninger vedrørende anden aktør og henvisninger til anden aktør, nærmere betegnet håndtering af anden aktør henvisninger.

Forretningsbeskrivelse

Alene borger henvisninger til anden aktør. Begreber som ramme- og del-aftaler eksisterer ikke i DFDG. Det er KSS systemerne, der selv udstiller den funktionalitet til jobcentrene, hvis der er behov for understøttelse af ramme- og delaftaler.

DFDG anvender de indberettede anden aktør henvisningen til at validere for, om anden aktør kan læse- eller opdatere oplysninger i DFDG via KSS systemerne. Dette uanset om anden aktør varetager myndighedsopgaver for jobcentret eller ikke - eller fx en kursusleverandør kan læse- eller opdatere oplysninger i DFDG:

• for det pågældende jobcenter
• for den pågældende borger
• på det pågældende tidspunkt, hvor anden aktør foretager sin læse- eller skriveoperation

DFDG vil alene have kendskab til datointerval for henvisningsperiode, til hvilken anden aktør (angivet ved CVR- og p-nummer) henvisningen er til, samt evt. en reference til en delaftale til brug for KSS.

STAR har således kun muligt at operere på selve anden aktør henvisningen. Da STAR i denne model ikke er vidende om indholdet i de aftaler som jobcentre og anden aktører har indgået, har STAR ingen valideringer i DFDG for disse forhold og dette varetages derfor lokalt i KSS systemerne. 

Webservicebeskeder

DFDG vil efter aftale med KSS, alene danner beskeder om anden aktør henvisninger i situationer, hvor DFDG afkorter eller annullerer henvisningen pga. CPR-flytning mellem kommuner eller pga. borgerens dødsfald. 

CPR-skiftere

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

CreateHenvisning (POST /v1/Henvisning)CreateHenvisning (POST /v1/AndenAktoerHenvisning)

Denne metode opretter en anden aktør henvisning for en borger til den angivne anden aktør.

Forretningsregler:

• Jobcenter kan kun henvise på egne borgere i den periode hvor borger tilknyttet jobcenter.
• Det tjekkes, om det angive CVR-nr er validt/eksisterende (Fejlkode 4353)
• Det tjekkes, om det angive P-nr er validt/eksisterende (om P-nr er ugyldigt/ikke findes og den situation at P-nr findes, men ikke tilhører det angivne CVR-nr (Fejlkode 4903))
• Se øvrige valideringer under Fejlkoder.

Når anden aktør henvisningen oprettes i DFDG vil DFDG ud fra RequestUserMetadata tilføje hvilken myndighed der er henvist fra. 

UpdateHenvisning (PUT /v1/AndenAktoerHenvisning/{henvisningId})

Denne metode opdaterer en borgers anden aktør henvisning. Det er muligt at opdatere start- og/eller slutdato, samt den eksterne reference. 
Der kan angives en kommentar vedr. opdateringen.

Forretningsregler:

• Det er ikke muligt at opdatere en annulleret anden aktør henvisning (Fejlkode 4938)
• Metoden opdaterer alle felter (eksternSystemAftaleId, startDato og slutDato)
• Det er ikke muligt at ændre CVR og P-Nr ved Update, da det skal ske via metoden SkiftAndenAktør (PUT /v1/AndenAktoerHenvisning/action/SkiftAndenAktør)

Hvis en anden aktør henvisning er (fejl)oprettet hos en forkert anden aktør, skal den forkerte henvisning dog annulleres ved at slette den fejloprettede vha. metoden AfslutHenvisning (PUT /v1/Henvisning/{henvisningId}/action/Afslut). Derefter skal den korrekte henvisning oprettes ved hjælp af Create-metoden. Dette flow vil alene blive håndteret i KSS.

AfslutHenvisning (PUT /v1/AndenAktoerHenvisning/{henvisningId}/action/Afslut)

Denne metode annullerer en anden aktør henvisning for en borger til en given anden aktør. 
Metoden bruges i forbindelse med at en anden aktør henvisning er fejloprettet eller man af anden grund øjeblikkeligt vil fjerne anden aktør adgang og visning fra Jobnet.

Forretningsegler:

• Der kræves en kommentar i forbindelse med brug af denne operation.
• En annulleret anden aktør henvisning kan ikke opdateres efterfølgende.

GetAndenAktoerHenvisninger

Denne metode læser anden aktør henvisninger for en borger.

Kommuner og a-kasser adgang til for alle egne borgere. Mulighed for gæsteadgang. Anden aktør har adgang for henviste borgere.

Filtrering ift. a-kasser: Se beskrivelse på forretningsiden for PersonStatusService.

GetAndenAktoerHistorik

Denne metode læser historik for anden aktør henvisninger for en borger

Kommuner og a-kasser adgang til for alle egne borgere. Mulighed for gæsteadgang. Anden aktør har adgang for henviste borgere.

Filtrering ift. a-kasser: Se beskrivelse på forretningsiden for PersonStatusService.

SkiftAndenAktør (PUT /v1/AndenAktoerHenvisning/action/SkiftAndenAktør)

Denne metode opdaterer en borgers anden aktør henvisning. Mere specifikt bliver anden aktør referencen (CVR-nr og/eller P-nr) opdateret. Forretningsmæssigt kan det f.eks. ske, når en anden aktør overtager en anden anden aktør. 
Der kræves en kommentar i forbindelse med brug af denne operation.

Det er muligt at angive et antal af anden aktør henvisninger, som man ønsker at opdatere. Det skal nævnes at enten bliver alle anden aktør henvisninger opdateret eller også fejler alle. 

Forretningsregler:

• Det valideres, om det angive CVR-nr er validt (Fejlkode 4353)
• Det valideres, om det angive P-nr er validt, her tænkes både på den situation at P-nr er ugyldigt/ikke findes og den situation at P-nr findes men tilhøre ikke det angivet CVR-nr (Fejlkode 4903)

Forretningsmæssigt er det for aktive anden aktør henvisninger, dvs. henvisninger med slutdato efter "i dag", der skal overflytter i forhold til DFDG. Anden aktør henvisninger, hvor slutdato er overskredet eller som er annulleret, skal ikke overflyttes. DFDG validere ikke for dette.

GetJobcentre GET /v1/AndenAktoerHenvisning/Jobcentre?cvrEnhedsid={cvrEnhedsid}&pNummer={pNummer}

Metoden returnerer en liste med de jobcentre hvor en give anden aktør har aktive anden aktør henvisninger. Med aktive anden aktør-henvisninger menes der en anden aktør henvisning hvor slut dato >= dags dato. Listen med anden aktør er distinct pr. hovedjobcenter, dvs. der anvendes ikke subjobcenter.

Forretningsregler:

• Hvis ProductionUnitIdentifier ikke er angivet hentes alle jobcentre på CVR-nummeret uanset P-nr, hvis P-nr er med hentes kun på det konkrete CVR-nr og P-nr.
• Hvis CVR-nr og/eller P-nr ikke findes i anden aktør henvisningstabellen, returneres blot en tom liste, der valideres ikke på om det er et validt CVR-nr eller P-nr.

GetHenvisninger GET /v1/AndenAktoerHenvisning/AndenAktoer?jobcenterkode={jobcenterkode}

Metoden returnerer en liste med registrerede anden aktører for alle jobcentre. Alternativt kan spørges på et enkelt jobcenter via request-parametrene.
Med registrerede anden aktører menes alle dem, hvor der en aktiv/fremtidig anden aktør-henvisning.