ExternalOperatorRegistrationService (2020-3)

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

Forretningsbeskrivelse

Den sjette version af ExternalOperatorRegistrationService er en fundamental ny service. Begreber som ramme- og del-aftaler eksisterer ikke længere i DFDG med denne version af servicen. Det er KSS systemerne, der selv udstiller den funktionalitet til jobcentrene, hvis der er behov for understøttelse af ramme- og delaftaler.

DFDG anvender henvisningen til at validere for, om anden aktør - uanset om denne 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.

I version 6 er det således kun muligt at operere på selve anden aktør henvisningen. Da STAR i den nye model ikke er vidende om indholdet i de aftaler som jobcentre og anden aktører har indgået, er muligheden/behovet for i DFDG at validere således mærkbart formindsket. 

WSRM

Bemærk, at DFDG efter aftale med KSS, alene danner WSRM'er om anden aktør henvisninger i situationer, hvor DFDG afkorter eller annullerer henvisningen pga. CPR-flytning mellem kommuner eller pga. borgerens dødsfald. Se nærmere på forretningssiden for WsrmMessageService.

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

A-kasser

CreateExternalOperatorReferral

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. 

UpdateExternalOperatorReferral

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 (PartialAgreementIdentifier, StartDate og EndDate)
• Det er ikke muligt at ændre CVR og P-Nr ved Update, da det skal ske via metoden ChangeExternalOperatorReferralOwnership.

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 CancelExternalOperatorReferral. Derefter skal den korrekte henvisning oprettes ved hjælp af Create-metoden. Dette flow vil alene blive håndteret i KSS.

CancelExternalOperatorReferral

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.
• Et annulleret AA-forløb kan ikke opdateres efterfølgende.

ChangeExternalOperatorReferralOwnership

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. Da man opdaterer for et antal af gangen, så vil den MessageIdentifier man får retur i svaret ikke repræsentere en forekomst af en ændret anden aktør henvisning. Den værdi i MessageIdentifier man får tilbage, er tilfældigt genereret og kan kun bruges til at verificere at hele operationen er gennemført.

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 validerer ikke for dette.

GetExternalOperatorJobcenterList

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.

GetExternalOperatorList

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.