Borgerindsats.AktivitetService (2024-2)

Denne service anvendes ved oprettelse af aktiviteter til den generelle plan (hovedplanen).

Forretningsbeskrivelse

AktivitetsService opretter og vedligeholder aktiviteter til en borgers Min plan, Aktiviteter omfatter følgende indsatser virksomhedsrettet indsats, kursus aktiviteter, hjælpemidler, personlig assistance, mentor, helbredsindsats, og socialindsats. Aktiviteterne vil blive tilknyttet en Min plan version og hvis ikke historisk odløser også en ny version af Min plan. Det vil endvidere sikres, at aktiviteterne overlever evt. plantypeskift, f.eks. fra uddannelsesplan til jobplan samt en evt. genaktivering at en Min plan hvis denne har været sat inaktiv i forbindelse med kontaktgruppeskift.

En aktivitet vil altid være en del af en Min plan. Samme aktivitet vil kunne findes på flere Min plan versioner hen over aktivitetens levetid. Nye aktiviteter oprettes via Borgerindsats.AktivitetService. Nye aktiviteter vil kunne ses af borgeren på Jobnet, så snart de er oprettet. Aktiviteter vil også kunne ses af jobcentre samt evt. a-kasse, hvis borger en medlem og plan samt aktiviteten er af en type a-kassen må se.

A-kassernes adgang til aktiviteter

A-kassen må oprette aktiviteter af mentortypen og kursusaktiviteter af typen/afholdelseskategori "A-kasse aktivitet" og bevillingsramme (Borgerindsats.KursusallokeringsTypeCodeList) "A-kasse aktivitet". Ved forsøg på registrering med andre end de nævnte id'er kastes fejl 9378.

A-kasserne kan ikke læse/hente aktiviteter registreret af jobcentret af aktivitetstypen mentor, hjælpemidler, socialindsatser, sundhedsindsatser, personlig assistance, og/eller aktivitetstypen kursus med følgende afholdelseskategorier (Borgerindsats.KursusTypeCodeList):

  • 34 - Mentor, individuel

  • 35 - Mentor, plads

  • 38 - Andet 

  • 42 - Udskrivningskoordinator, individuel

  • 43 - Udskrivningskoordinator, plads

  • 44 - Danskuddannelse, introduktionsforløb

  • 48 - Danskuddannelse, selvforsørgelses- og hjemrejseprogrammet eller introduktionsprogrammet

Oversigt over aktivitetstyper som a-kasserne må se afhængigt af hvilken plantype aktiviteten er oprettet under

Se link Oversigt over aktivitetstyper som a-kasserne må se.


Jobcentre og kommuners adgang til aktiviteter

Det er kun a-kasser, der kan oprette aktiviteter med afholdelseskategori "A-kasse aktivitet" (id 52) og bevillingsramme "Aktivitet oprettet af a-kassen" (id 16). Ved forsøg på registrering med de nævnte id'er kastes fejl 9378.

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

A-kasse filtrering - overblik



Dobbeltregistrering af aktiviteter (dublet validering)

For at forhindre dobbeltregistrering af borgers aktiviteter, foretages der ved oprettelse en sammenligning med eksisterende, ikke-annullerede aktiviteter. Der foretages i første omgang alene validering for CourseActivity, CompanyActivity og MentorActivity. Følgende felter benyttes i sammenligningen: 

  • Aktivitetstypen

  • Startdato 

  • Udbyder (CVR og Pnr)

  • Timer pr. uge

  • Minutter pr. uge

Hvis der er tale om en kursusaktivitet, så sammenlignes ligeledes også på:

  • Kursustypen (CourseType)

  • Kursustitel (CourseTitle)

Hvis der er tale om en mentoraktivitet, så sammenlignes (fra 2024-2r02) også på:

  • Mentor titel

Hvis alle felter er identiske, vil oprettelsen blive afvist. Fejlkode 9388 - Activity already exists.

Ferieregistrering

Det er tilladt både for borger og sagsbehandler at registrere ferie for bevillingsramme "Aktivitet oprettet af a-kassen" (id 16).

Gæsteadgang

Gæsteadgang for en dag ad gangen kan for jobcentersagsbehandlere opnås med Borgerkommunikation.GaesteadgangService for følgende metoder:

  • GetAktivitet (GET /v1/Aktivitet/{AktivitetIdentifier})

  • GetAktiviteter (GET /v1/Aktiviteter)

Webservicebeskeder (WSB) og WSRM

WSRM beskeder på aktiviteter (GetActivityGenerelEventVersion ogGetActivitySpecialEventVersion1) anvendes alene af a-kasser.

WSB beskder på aktiviteter (Aktivitet.WSB (2024-2)) er tynd og generisk og kan anvendes af alle aftagere.

Historiske aktiviteter

Der sendes ikke WSRM (GetMyPlanVersionNotificationEventVersion1) eller WSB (Aktivitet.WSB (2024-2)) ved oprettelse eller ændring af afsluttede aktiviteter også kaldet historiske aktiviteter, dvs. hvor slutdatoen ligger i fortiden - eller hvor aktiviteten oprettes med status afsluttet (id 8) uanset om aktiviteten datomæssigt ligger helt eller delvist i fremtiden.

WSB kontra WSRM

Afsendelse af WSRM erstattes af webservicebeskeder. Der vil være i samme situationer der umiddelbart sendes webservicebeskeder, dog med et tyndt indhold. Selve beskederne er pt ikke defineret da det afvente STAR webservicebesked model er endelig og og afklaring ne serviceaftager om der er behov for data i en besked body.

Mentor

Mentor-aktiviteter registreres med aktivitetstypen MentorActivity. Der kan gives støtte til

  • en mentorfunktion til en enkelt person (individuel mentor), eller til

  • flere personer på virksomheden eller uddannelsesinstitutionen (mentor pr. plads)

og afhængigt af dette registreres den konkrete mentor-aktivitet med den relevante typeangivelse (MentorTypeIdentifier).

Krydsvalidering mellem anvendte afholdelseskategorier (Borgerindsats.KursusTypeCodeList) og bevillingsrammer (Borgerindsats.KursusallokeringsTypeCodeList)

Der foretages i DFDG krydsvalidering mellem anvendte afholdelseskategorier og bevillingsrammer, for lovlig kombinationer se Lovlige bevillingsrammer for kurser i forhold til kursets afholdelseskategorier

Bemærk: Bevillingsrammer er udgåede vil i forbindelse med oprettelse af kursusaktivitet/ændring af bevillingsrammen på eksisterende aktivitet blive afvist af anden validering.   

 

Krydsvalidering mellem anvendte jobtilbudstyper (Borgerindsats.JobtilbudsTypeCodeList) og aktiveringspuljer (Borgerindsats.AktiveringspuljeTypeCodeList)

Der foretages i DFDG krydsvalidering mellem anvendte jobtilbudstypen og aktiveringspuljer, for lovlige kombinationer se Lovlige aktiveringspuljer i forhold til typen af jobtilbud

Bemærk:  Nye registreringer med aktiveringspuljer id 1-5 kan ikke ske. Der kan ske opdatering af allerede registrerede aktiviteter, hvor aktiveringspuljer id 1-5 er anvendt ved tidligere registrerede aktiviteter.

Krydsvalidering mellem anvendte jobtilbudstyper(Borgerindsats.JobtilbudsTypeCodeList) og timetilskudssater (Borgerindsats.TimetilskudsatsTypeCodeList)

Der foretages i DFDG krydsvalidering mellem anvendte jobordretyper og timetilskudssater, for lovlig kombinationer se Lovlige timetilskudssater i forhold til typen af jobtilbud


Aktivitets-status

Gældende status-koder:

  • Annulleret (id 3)

  • Afbrudt (id 4)

  • Aftalt (id 9)

Annulleret (id 3) og Afbrudt (id 4) bruges i forbindelse med at en aktivitet afsluttet unormalt og dette styrer bl.a. afsendelse af NUPH til a-kassen.

Formålskoder

Formål med virksomhedspraktik angives med formålskoder (Borgerindsats.FormaalskodeTypeCodeList). Dette sker for  at få bedre sammenhæng med VITAS-registreringer:

  • Formåls-felt” skal udfyldes med én formålskode, når der er tale virksomhedspraktik og for alle kontaktgruppe bortset fra sygedagpengemodtagere fra beskæftigelse (KG 24)

  • For nuværende validerer DFDG ikke for om feltet er udfyldt

DFDG-validering på statusser

Ved oprettelse af aktiviteter med startdato i dag eller fremtidig er "Aftalt" lovlig.

Eksisterende status forbliver uændret på eksisterende aktiviteter og kun hvis status ændres, skal de nye valideringer overholdes i forbindelse med en update. Fx kan timetal og start- og slutdatoer opdateres på allerede registrerede aktiviteter uden at opdatere status-

Der foretages ikke konvertering af statusser, da DFDG tillader, at aktiviteter med de udfasede statusser kan beholdes eller flyttes til alle gyldige statusser. Hvis status på en aktivitet opdateres, skal status ændres til en af gældende (Aftalt, Afbrudt eller Annulleret). 

NUPH - negative underretningspligtige hændelser fra jobcenter til a-kassen vedr. aktiviteter

Det fremgår på siden Underretning af a-kasse (NUPH) 2023-1 (forventes anvendt i prod. fra 2023-4), hvornår der udløses NUPH afhængigt af aktivitetens status og de anvendte

  • afholdelseskategorier og bevillingsrammer for kursusaktiviteter (kursusaktivitet)

  • jobordretyper og aktiveringspuljer for virksomhedsrettede aktiviteter (virksomhedsrettetAktivitet)

Bevillinger af tilskudsansættelse, virksomhedspraktik og nyttteindsats m.v.

Bemærk: Da Vitas endnu ikke er fastlagt i moderniseringsscope bibeholdes dette indtil dette sker.

Bevillinger af tilskudsansættelse, virksomhedspraktik og nyttteindsats m.v fra Vitas, der oprettes som aktiviteter via jobcentersystemerne kan i livsforløbet fra ansøgningen over bevilling til aktivitet strække sig over længere periode. For at kunne honorere at en af virksomheden valgt stillingsbetegnelse i ansøgningen kan bibeholdes hele vejen igennem forløbet, vil det altid være muligt for denne type af aktiviteter, der oprettes på baggrund af en bevilling i Vitas, at beholde den oprindelige stillingsbetegnelse.



Link til snitfladebeskrivelse

Snitfladebeskrivelse på Confluence

Swagger

https://borgerindsatst4.startest.dk/swagger/index.html?urls.primaryName=Aktivitet%20V1

Link til forretningsbeskrivelser 

Found 1 search result(s) for AaktivitetsService.

Metode

Createaktivitet (POST /v1/Aktivitet)

Oprette aktiviteten. Samtidig knytte DFDG aktiviteten til Min plan og hvis aktiviteten har en fremtidig slutdato oprettes en ny version af Min plan.

Forretningsregler 

  • Regler for hvilke Min plan versioner aktiviteten knyttes til se Aktiviteter i forbindelse med Min plan

  • Regler for krydsvalidering se 

  • Validering på CVR- og p-nr. 

    • Det valideres, om det anvendte CVR- og p-nr. er på hhv. 8 og 10 tegn. Hvis ikke kastes fejlkode 1014 (Failed to validate message)

    • Der valideres fortsat ikke for, om det anvendte CVR- og p-nr. findes i CVR-registeret. Der er således tale om en validering af det tekniske format – og ikke af, om de anvendte CVR- og p-nr. er forretningsmæssigt valide. For tilbud/aktiviteter, der gennemføres hos virksomheder m.v. uden CVR-nr., kan som CVR-nr. fx anvendes 00000000 (8 stk. 0’er) og som p-nr. fx anvendes 0000000000 (10 stk. 0’er).

  • Hvis dagpengemodtager og aktivitetens JobOrderTypeIdentifier er nyttejob (46, 47, 48 eller 49), så skal det være aktiviteten være markeret som et rådighedsafprøvende tilbud. 

  • For kursusaktiviteter med kursustypen (CourseTypeIdentifier) som "Mentor, individuel" (Id 34) eller "Mentor, Plads" (Id 35) skal følgende felter være udfyldt

    • Aktivitetsbeskrivelse (ActivityDescription) skal være udfyldt

    • Begrundelse (ReasonForActivity) skal være udfyldt

    • Kontaktinformation på mentor skal være udfyldt (ContactInformation)

      • Navn (PersonGivenName og PersonSurnameName) er mandatory i WSDL hvis kontaktinfomation angives Mellemnavn (PersonMiddleName) er optional og skal forsat være optionalt

      • Telefon (TelephoneNumberIdentifier) er valgfri at udfylde

      • E-mail er valgfri at udfylde

    • Adresse (ActivityLocationAddress) skal være udfyldt

      • Kun inkl. de felter der allerede er mandatory i types, ikke mandatory felter kan stadig undlades

  • For kursusaktiviteter (CourseActivity), virksomhedsrettede aktiviteter (CompanyActivity) og mentoraktiviteter (MentorActivity) skal som minimum antallet af timer eller antallet minutter pr. uge være udfyldt). Der kastes fejlkode: 9391 - "Either hours or minutes per week has to be entered for the activity to be valid" - hvis ikke mindst ét af felterne er udfyldt med en værdi større end 0.

  • A-kassen må oprette kursusaktiviteter (CourseActivity) med afholdelseskategori "A-kasse aktivitet" og bevillingsramme (CourseAllocation) "A-kasse aktivitet". Ved forsøg på registrering med andre end de nævnte id'er kastes fejl 9378 - CourseType or CourseAllocationType not coherent with impersonated authority.

  • A-kassen må ikke oprette eller opdatere virksomhedsrettede tilbud (CompanyActivity), personlig assistance (PersonalAssistanceActivity) eller hjælpemidler (HelpingDeviceActivity). Fejlkode 9387 - UnemploymentFunds are only allowed to create or update courseactivities.

  • JobCenter, AndenAktør, Kommune må oprette alle afholdelseskategorier bortset fra afholdelseskategorier (CourseTypeIdentifier = Id 52) "A-kasse aktivitet" og bevillingsramme (CourseAllocationTypeIdentifier = Id 16) "A-kasse aktivitet"

  • Der kan oprettes aktiviteter, hvor både start- og slutdato er historiske (før d.d.).

  • En aktivitet kan kun oprettes med en stillingsbetegnelse, der er aktiv

    • Undtagelse ved aktiviteter med startdato før dags dato: Stillingsbetegnelsen skal være aktiv på starttidspunktet. Det er op til sagsbehandleren at sikre dette, da DFDG ikke validerer. 

    • Undtagelse i forbindelse med Vitas:
      Hvis en aktivitet indeholder en ekstern reference af typen Id 2 "Tilskudsansættelses ansøgning" i ExternalReferenceCollection, vil være muligt oprette aktiviteten med en ikke aktiv stillingsbetegnelse på starttidspunket for aktiviteten.
      Det er kun lovligt at benytte den eksterne reference af typen Id 2 "Tilskudsansættelses ansøgning", når en aktivitet oprettes fra en bevilling i Vitas.

Særligt om timetilskudssatser

DFDG validerer ikke for, at:

  • timetilskudssatserne registreres korrekt ift. de enkelte målgrupper - og de tilskudssatser, der er mulige ift. de enkelte målgrupper (kontaktgrupper)

  • timetilskudssats er angives, hvis JobOrderTypeIdentifierType = ansættelse med løntilskud (id 18, 33, 34, 35, 36, 37), jobrotation (id 50, 51, 52, 53, 54, 55, 56, 57, 58, 59) eller voksenelev (id 7, 8, 9, 19, 20)

DFDG validerer for, at

  • timetilskudssats for ansættelse med løntilskud kun kan angives, hvis JobOrderTypeIdentifierType = ansættelse med løntilskud (id 18, 33, 34, 35, 36, 37).

  • timetilskudssats for voksenlærlinge kun kan angives, hvis JobOrderTypeIdentifierType = voksenelev (id 7, 8, 9, 19, 20).

  • timetilskudssats for jobrotation kun kan angives, hvis JobOrderTypeIdentifierType = jobrotation (id 50, 51, 52, 53, 54, 55, 56, 57, 58, 59).

Updateaktivitet (PUT /v1/Aktivitet)

Denne metode opdaterer en eksisterende aktivitet.

Forretningsregler 

  • Reglen for statusskift og andre regler vil altid tage udgangspunkt i den aktive aktivitet. (se logisk beskrivelse Aktiviteter i forbindelse med Min plan)

    • Ved opdatering af en aktivitet i status afbrudt, kan slutdato (EndDate) ikke sættes senere end den eksisterende slutdato (fejlkode 8041 - The specified activity status is not allowed).

    • Når feltet ActivityStatusTypeIdentifier er enten Annulleret (ID=3) eller Afbrudt (ID=4), så er feltet ActivityStatusCauseTypeIdentifier forretningsmæssigt påkrævet. Hvis det ikke er udfyldt kastes fejlkode 8090 - "ActivityStatusCauseTypeIdentifier is required"

  • Bemærk at i version 3 skal SustenanceTypeIdentifier være sat når aktiviteten opdateres.

  • Uanset hvem der har oprettet en aktivitet, kan systemer / myndigheder der har adgang til borgeren og den pågældende aktivitet rette i den pågældende aktivitet.

  • A-kassen må ikke oprette eller opdatere virksomhedsrettede tilbud (CompanyActivity), personlig assistance (PersonalAssistanceActivity) eller hjælpemidler (HelpingDeviceActivity). Fejlkode 9387 - UnemploymentFunds are only allowed to create or update courseactivities.

  • For kursusaktiviteter (CourseActivity), virksomhedsrettede aktiviteter (CompanyActivity) og mentoraktiviteter (MentorActivity) skal som minimum antallet af timer eller antallet minutter pr. uge være udfyldt). Der kastes fejlkode: 9391 - "Either hours or minutes per week has to be entered for the activity to be valid" - hvis ikke mindst ét af felterne er udfyldt med en værdi større end 0.

  • A-kassen må oprette kursusaktiviteter (CourseActivity) med afholdelseskategori "A-kasse aktivitet" og bevillingsramme (CourseAllocation) "A-kasse aktivitet". Ved forsøg på registrering med andre end de nævnte id'er kastes fejl 9378 - CourseType or CourseAllocationType not coherent with impersonated authority.

  • Mentoraktiviteter, der (før v5 af ActivityService) er oprettet som CourseActivity skal ved opdatering også opdateres som CourseActivity, dvs. mentor-aktiviteten ikke kan opdateres med MentorActivity-aktivitetstypen.

  • En aktivitet kan opdateres, uanset om stillingsbetegnelse er aktiv eller ej og uanset om slutdato er i fortiden, i dag eller fremtidig. Stillingsbetegnelsen skal dog findes i ESCO STAR.

    • Det er ikke muligt at ændre til en inaktiv stillingsbetegnelse med mindre startdato er i fortiden.

    • Hvis startdato er i fortiden skal stillingsbetegnelsen være aktiv på starttidspunktet. Det er op til sagsbehandleren at sikre dette, da DFDG ikke validerer.

Getaktiviteter (GET /v1/Aktiviteter)

Returnerer en list over alle unikke aktiviteter (nye som gamle) i deres seneste state for en borger. 

Getaktiviteter (GET /v1/Aktiviteter/Jobcenter)

Denne metode bruges til at udsøge aktiviteter tilknyttet et specifikt jobcenter. Den kan specifikt benyttes i forbindelse med beregning og kontrol af tilskudsudbetalinger til virksomheder.

For ikke at overbelaste DFDG benyttes en paging funktion til at indskrænke resultsættet. Den maximale pagingsize er som udgangspunkt sat til 1000 aktiviteter.

Der udsøges aktiviteter for det jobcenter som sagsbehandleren kalder på vegne af.


Forretningsregler 

Følgende regler for retursvar i forhold til input parameter: 

  • Kun aktiviteter fra det angivende jobcenter medtages. Der kan kun søges på det hovedjobcenter borgeren er tilknyttet (for fx København, der har subjobcentre 10101, 10102, 10103 osv. skal der søges på 101)

  • Kun aktiviteter i status Aftalt, Annulleret, Afbrudt medtages (Af de gamle status medtages også Optaget, Henvist, I gang og Afsluttede men ikke Planlagt)

  • Søgeperioden (perioden for fra- og til-dato) må max være 90 dage

  • Det kan angives om alle eller kun aktiviteter, der er ændret i perioden, skal returneres.

  • Type af aktiviteter:

    • Hvis type af aktiviteter er angivet (virksomhedsrettet / kurser / hjælpemidler / personlig assistance) i form af ActivityTypeIdentifier, så returneres kun aktiviteter af den angivne type

    • Hvis type af aktiviteter ikke er angivet (Null), returneres alle aktivitetstyper

  • Alle eller kun ændrede aktiviteter:

    • Hvis alle aktiviteter ønskes, så aktiviteter der har en slutdato >= fradato, og en startdato <= tildato

    • Hvis kun ændrede aktiviteter ønskes, så aktiviteter der har en ændringsdato >= fradato, og <= tildato (obs. der skal ses på tværs af alle ændringer og ikke bare seneste ændringsdato) 

    • I begge tilfælde returneres kun aktivitetsidentifier og dermed implicit aktiviteten i dens seneste juridiske tilstand.

Initialt load af data:

  • I forbindelse med opstart af løsningen hos aftager kan servicen ikke bruges til et totalt load af data pga. performance og belastning af produktionsmiljø.

Getaktiviteter (GET /v1/Aktivitet/Tilskudsansaettelser)

Giver en SubsidyJobInfo collection: Udvalgte, ikke-annullerede tilskudsjob, dvs. status afbrudt eller aftalt

Kollektionen indeholder oplysninger om forskellige typer job med tilskud, der ikke kan indgå i a-kassemedlemmers optjening eller genoptjening af retten til dagpenge. 

Følgende Jobtyper (for udfaldsrum se Borgerindsats.JobtilbudTypeCodeList) medtages i kollektionen:

Identifikator

Navn

Beskrivelse

Startdato

Slutdato

Identifikator

Navn

Beskrivelse

Startdato

Slutdato

3

Voksenelev

Voksenelev

03-07-2006

01-07-2100

4

Fleksjob for personer med nedsat erhvervsevne

Fleksjob for personer med nedsat erhvervsevne

20-12-2007

01-07-2100

7

Ansættelse med løntilskud

Ansættelse med løntilskud

07-09-2011

01-07-2100

9

Rotationsvikar (særlige grupper)

Rotationsvikar (særlige grupper med videregående uddannelse)

01-12-2013

01-07-2100

10

Rotationsvikar, almindelig

Almindelig rotationsvikar

01-12-2013

01-07-2100



Der returneres samtlige støttede job, der er registreret i DFDG (der tages ikke hensyn til kontaktgruppe, tilmelding, a-kassetilhørsforhold eller lignende. Annullerede jobs filteres fra.

Getaktiviteter (GET /v1/Aktivitet)

Forretningsregler

  • Returnerer en specifik aktivitet i relation til en Min planversion. Angives Min planversion ikke returneres aktiviteten fra seneste Min plan version aktiviteten ligger på.

  • Såfremt cprnr. ikke angives, bliver aktiviteten hentes på baggrund af aktivitetsnøglen udelukkende. Der vil dog fortsat valideres på at aktiviteten tilhører en borger fra den organisation, der kalder ind. 

Getaktiviteter (GET /v1/Aktivitet/Virksomhedsaktivitet)

(Gl. GetCompanyActivitySummaries)

Servicen returnerer en list over alle historiske aktiviteter for en bestemt virksomhed.

Forretningsregler 

  • Servicen vil returnerer fejlkode 8085 hvis ens søgning giver anledning til mere end 1000 resultater. Reducer i så fald periode i søgekriterier (start- og slutdato).

  • Angivelse af start- og slutdatoer: De angvine datoer (i request) er ikke inklusive, men eksklusive.