Virksomhedsindsats.JobordreService (CompanyRecruitmentService) (2022-4)

Bemærk Tidligere metodenavne på engelsk er medtaget for at lette læsevenligheden overgangsfasen pt. Disse vil bliver fjernet efter release

Forretningsbeskrivelse

Denne service anvendes til at oprette og vedligeholde landsdækkende ordinære job eller anden henvendelse fra en virksomhed vedrørende formidling af ordinær beskæftigelse m.v. samt formidling af borgere.

Følgende jobordretype behandles af service:

  • Ordinær job / småjob
  • Lærlinge og elevjob
  • Fleksjob
  • IGU-ansættelse

Servicen indeholder funktionalitet både om selve jobordren f.eks. ordinære job samt de formidlinger der sker i forbindelse med denne. Derudover er der funktionalitet til at finde de enkelte jobordre både lokale (interne) og landsdækkende.

Funktionaliteten og valideringer i DFDG er ens for de enkelte jobordretype, selvom de bruges i forskellige forretningsmæssige situationer og sammenhænge. Det er op til serviceaftageren at sikre den korrekte jobordretype anvendes i den kontekst den indgår.

Omkring jobordre af typer Lærlinge og elevjob Id 2, Fleksjob Id 3 og IGU-ansættelse Id 4 vil disse ikke være tilgængelige for virksomheden på JobAG. Dette gælder også formidlinger på disse type af jobordre. Selve ansøgning og bevilingsprocessen af disse type forgår forsat via Vitas og denne proces beskrives ikke ydelige her. Camilla Hagedorn Trolle og Knud de Place (STAR) Er det ok vi skrive sådan mht. Vitas? ellers må igerne hjælpe lidt med hav vi skal skrive (smile)

I forbindelse med servicen er der etableret WSRM-beskeder, der vil blive sendt til berørte jobcentre og a-kasser.

Servicen kan kaldes af STAR, jobcentre, a-kasser og fagforbund.

WSRM'er

I forbindelse med registreringer kan dannes følgende WSRM'er:

  • GetCompanyRecruitmentVersion4 
  • GetCompanyRecruitmentEventVersion2 og GetCompanyRecruitmentEventVersion3

Tovholder

Tovholderen laves af jobcenteret og kan sættes på alle jobordretype, der er oprettet af virksomheden selv, jobcenter, a-kasse eller fagforbund. Det er jobcentret, typisk det ansvarlige jobcenter, der sætter den fysiske tovholder på. Det er først når tovholderen fysisk er oprettet, at DFDG anvender logikken omkring tovholder skal godkende kandidater inden de bliver synlige for virksomheden. Virksomheden kan se en evt. tovholder på JobAG. Det er som standard (default) på JobAG at virksomheden ønsker en tovholder. 

Hvis en a-kasse opretter en jobordre, så skal denne enten gøre jobordren ikke-intern eller sætte sig selv om tovholder (tovholder) og/eller sætte sig selv som primær rekrutteringsmyndighed (primaereMyndigheder).
Hvis et fagforbund opretter en jobordre, skal det gøre jobordren ikke-intern for efterfølgende at kunne se og håndtere den.

Overblik over formidlingshændelsestyper og formidlingshistorik

Følgende er et overblik over hvilke formidlingshændelsestyper (formidlingshaendelsesType og internt i DFDG ActionType) og Descriptions der dannes i de forskellige scenarier. Disse benyttes bla. i WSRM'er til jobcenter:

Metode

Hændelse


Formidlingshændelsestype

(formidlingshaendelsesType)

Beskrivelse i formidlingshistorikCPR nummer på borger med

CreateJobordre (POST /v1/jobordre)

Jobordre oprettes

JobordreOprettet

Jobordre oprettet (Id 3)

"Jobordre oprettet."Nej

UpdateJobordre (PUT /v1/jobordre)





Hvis det jorordrens status sættes til lukket

JobordrenErLukket

Jobordren er lukket (Id 5)

"Jobordren er lukket. Virksomheden ønsker ikke flere formidlinger. {jobordre.opdateringsKommentarJobordre}

Nej
Hvis jobordren er gjort intern

JobordrenErIntern

Jobordren er gjort intern (Id 11)

"Jobordren er gjort intern og er opdateret. {jobordre.opdateringsKommentarJobordre}"

Nej
Hvis jobordren er gjort landsdækkende

JobordrenErLandsdækkende

Jobordren er frigivet til offentlig synlighed og håndtering (Id 10)

"Jobordren er gjort landsdækkende og er opdateret. {jobordre.opdateringsKommentarJobordre}"


Nej
Hvis ingen af ovenstående (Id 5, 10 eller 11)

JobordrenErOpdateret

Jobordren er opdateret (Id 4)

"Jobordren er blevet opdateret". {jobordre.opdateringsKommentarJobordre}

Nej
Hvis tovholderen fjernes i en af ovenstående (Id 4, 5, 10 eller 11) udløses en konsekvens behandling af formidlinger

For hver kandidat som ikke er godkendt sættes denne til godkendt og der indsættes event i formidlingsloggen:

KandidatGodkendtTilFormidling

Kandidat gjort tilgængelig for virksomhed (Id 8)

"{formidling.kandidatNavn.fornavne+mellemnavn+efternavn} er godkendt til kandidatlisten med følgende kommentar: {jobordre.opdateringsKommentarJobordre}"

Ja

UpdateJobordreStatus
(PUT /v1/jobordre/status)

Skift i status på jobordre

JobordrensStatusOpdateret

Jobordren er opdateret (4)

{jobordre.opdateringsKommentarJobordre} eller hvis tom "Jobordrens status er opdateret"Nej
CreateJobordreFormidling
(POST /v1/jobordre/formidling)
Formidling med kandidater

Formidling

Formidling (Id 1)

{request.beskrivelse}

Nej, Da der kan formidles flere borger på en gang

Orientering til virksomhed
(Formidling uden kandidater)

OrienteringTilArbejdsgiver

Orientering til arbejdsgiver (Id 2)

{request.beskrivelse}Nej

UpdateJobordreFormidling
(PUT /v1/jobordre/formidling)




Kandidat fjernet fra formidling og status sættes til:

  • Kandidat fjernet - ikke mere relevant
  • Kandidat fjernet - på vej til andet job, pension m.v.
  • Kandidat fjernet - ikke egnet match

Kandidat fjernet fra formidling

Kandidat fjernet fra formidling (Id 6)

{formidling.kandidatNavn.fornavne+mellemnavn+efternavn} er fjernet fra kandidatlisten med følgende kommentar: {formidling.opdateringsKommentarFormidling}"Ja
Kandidat gjort tilgængelig for virksomhed

Kandidat gjort tilgængelig for virksomhed

"Kandidat gjort tilgængelig for virksomhed (Id 9)

"{formidling.kandidatNavn.fornavne+mellemnavn+efternavn} er godkendt til kandidatlisten med følgende kommentar: {formidling.opdateringsKommentarFormidling}"Ja
Kandidat er formidling

Formidling

Formidling (Id 1)

{formidling.kandidatNavn.fornavne+mellemnavn+efternavn} er opdateret"Ja

Hvis kandidatens status sættes til

  • Ansat af virksomheden (Id 4)
  • Ikke ansat af virksomheden - ikke egnet match (Id 5)
  • Ikke ansat af virksomheden - har ansat en anden (Id 6)

"Resultat af formidling foreligger"

Resultat af formidling foreligger (Id 9)

"{formidling.kandidatNavn.fornavne+mellemnavn+efternavn} har afsluttet formidlingen med følgende resultat: {formidling.opdateringsKommentarFormidling}"Ja

Bemærk Kandidaternes CPR nummer på formidlingshistoriken vil ikke være tilgængelig på data før version 1 af denne service.

Skift i borgers tilstand

Skift i borgers CV søgbarhedstilstang påvirker ikke aktive formidlinger. dvs. hvor formidlingsstatus (FormidlingsstatusType) er "Formidling afventer godkendelse (Id 1)" eller "Formidling tilgængelig for virksomhed" (Id 2)

Hvis kontaktgruppen lukkes for en borger og borger har formidlingsstatus (FormidlingsstatusType) "Formidling afventer godkendelse (Id 1)" eller "Formidling tilgængelig for virksomhed" (Id 2) sættes formidlingsstatus til "Kandidat fjernet - ikke mere relevant" med formidlingskommentar (opdateringsKommentar) "Borger fjernet i forbindelse, da borger ikke længere er til rådighed for formidling"

Beskeder WSRM og e-mails

DFDG sender beskeder i relation til den enkelte jobordretype i form af WSRM til jobcentret og a-kasse og mail til virksomheden. Beskeder sendes:

  • WSRM til jobcenter og a-kasse når:

    • Et jobcenter er sat som ansvarlig jobcenter.

    • Et jobcenter eller en a-kasse er sat i kollektionen af primær formidlingsmyndighed.

    • Et jobcenter eller en a-kasse har oprettet et formidling.

    • Et jobcenter eller en a-kasse har en borger formidlet.

    • En jobordres tilgængelighed er ændret (gjort intern/landsdækkende)
  • Mail til virksomheden når:

    • En jobordre har status (jobordrestatusType) "Åben" og 
      • En formidling bliver gjort tilgængelig for virksomheden på JobAG - formidlingsstatus (FormidlingsstatusType) er "Formidling tilgængelig for virksomhed"

      • En formidling forsvinder for virksomheden på JobAG - formidlingsstatus (FormidlingsstatusType) er "Kandidat fjernet - ikke mere relevant"
      • Jobordretypen (jobordreType) er Ordinær job (Id 1)


Der sendes kun en WSRM pr. myndighed, dvs. optræder en myndighed i flere sammenhænge på en jobordre f.eks. er et jobcenter både ansvarlig jobcenter og har oprettet et eller flere formidling, vil dette jobcenter kun modtage en WSRM. 

Et jobcenter kan modtage besked om ikke-egne borgere (borger B), da et jobcenter modtager WSRM-besked om en jobordrer, som de er eller har været en del af via formidling på en anden borger, der tilhører jobcentret (Borger A).

Bemærk at a-kasser af GDPR hensyn kun får information om egne medlemmer. Der kan let være filtreret i den liste af borgere som fremstår henviste i GetCompanyRecruitmentEvent WSRM der modtages i a-kasser.

Der sendes ikke WSRM-beskeder til fagforbund.

Der afsendes følgende to forskellige WSRM-beskeder:

  • GetCompanyRecruitmentVersion (nyeste prod versionsnr)

    Denne sendes i forbindelse med oprettelse eller opdateringer til en jobordre.

    GetCompanyRecruitmentEventVersion (nyeste prod versionsnr) 

    Denne sendes i forbindelse med oprettelse eller opdateringer af formidling til en jobordre.

Se under metodegennemgangen nedenfor for nærmere beskrivelse om hvem der får WSRM i hvilke situationer

Historik i DFDG

  • DFDG laver revisionshistorik på alle ændringer. DFDG udstiller dette ikke eksternt.

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

Ud her, ses på serviceside under denne side (beholdes til service er tilgængelig)

Metode
Alle borgere
Egne borgere
Adgang ved "Intern rekruttering"
Beskrivelse

CreateJobordre (POST /v1/jobordre)

(CreateCompanyRecruitment)
JC, AA
N/A
GetCompanyRecruitmentJC, AA
Primary authorities, tovholder, ansvarligt JC og JC med formidlet borger
UpdateCompanyRecruitmentJC, AA
Primary authorities, tovholder og ansvarligt JC
CreateCompanyRecruitmentEventJC, AA
Primary authorities og ansvarligt JC
GetCompanyRecruitmentsOnCompanyJC, AA
Primary authorities, tovholder, ansvarligt JC og JC med formidlet borgerDer filtreres i output
GetCompanyRecruitmentsJC, AA
Primary authorities, tovholder, ansvarligt JC og JC med formidlet borgerDer filtreres i output
SetCompanyRecruitmentStatusJC, AA
Alle Man skal kende GUID
GetCompanyJobcenterAffiliationJC, AA
N/A
UpdateCandidateOnCompanyRecruitmentEventJC, AAAA(JC)Primary authorities og ansvarligt JC

Af hensyn til JobAGs håndtering af jobordrer har STAR adgang til alle metoder.

Overalt hvor der valideres på myndigheder bruges der hoved-myndighedskode, fx. hovedjobcenterkoden.

A-kasser og fagforbund

Har adgang til alle personer for alle metoder medmindre rekrutteringen er gjort lokal (intern). Ved interne rekrutteringer skal a-kassen eller fagforbundet være en del af de primære myndigheder for at kunne tilgå metoderne i samme omfang som jobcentrene - som illustreret ovenfor.

CreateJobordre (POST /v1/jobordre) - Tidligere CreateCompanyRecruitment

Metoden opretter et ønske om formidling til et ordinært job eller en af de andre jobordretyper fra en virksomhed. Virksomheder kan, via JobAG, selv benytte metoden.

Forretningsregler

  • Jobordre fra blokaderamt virksomheder må ikke oprettes af jobcenter/a-kassen, ligeledes må der ikke formidles på eksisterende jobordre. Jobcenter/a-kasse har selv ansvar for at sikre, at en virksomhed ikke er blokaderamt.
    Bemærk: Hvis virksomhederne går via JobAG kan de ikke logge ind, hvis de er blokaderamt.
  • Primære formidlingsmyndigheder (primaereMyndigheder)
    • Kun myndigheder af typen Jobcenter og a-kasse kan indgå blandt primære formidlingsmyndigheder.
    • Myndighedskoden der angives, skal være valid.
    • En myndighed kan kun være en gang iblandt primære formidlingsmyndigheder. 
  • Hvis jobordren sættes til landsdækkende (internJobordre=false) Det er lovligt, set fra DFDG, for alle myndigheder at formidle på en jobordre, uanset om myndigheden er med i PrimaryRecruitmentAuthorities eller ej.
  • Hvis jobordren sættes til lokal (intern) (internJobordre=true) er formidling og editering kun mulig for de primære rekrutteringsmyndigheder, ansvarligt jobcenter og eventuelt tovholder-jobcenter. Eventuelle andre jobcentre, der har en formidlet borgere på en sådan lokal jobordre kan se den, men ikke opdatere.
  • Hvis det ansvarlige jobcenter (ansvarligtJobcenterKode) ikke er angivet, vil DFDG benyttes virksomhedens lokation (kommune) til at bestemme det ansvarlige jobcenter. Løsningen til at bestemme virksomhedens tilhørsforhold til et jobcenter er baseres på at STAR BI data vedrørende CVR.
    • Hvis det ansvarlige jobcenter angives (ansvarligtJobcenterKode), skal det være validt.
  • Flag for om virksomheden har oprettet (oprettetAfVirksomhed) sættes af DFDG på baggrund af kalder. Er kalder fra JobAG sættes flaget (oprettetAfVirksomhed) til ”true” ellers sættes den til ”false”.
  • Tovholder (tovholder), interne kommentar (internKommentar) og primære formidlingsmyndigheder (primaereMyndigheder) er sagsbehandler attributter og beregnet primært til brug for jobcentre. JobAG skal ikke sende disse attributter via kald til denne service.
  • For en jobordre der oprettes kan tovholder ikke eksistere hvis flaget for tovholder (tovholderOensket) er false. Ellers fås fejl 9225.
  • Hvis koden for stillingsbetegnelse (ConceptUriDa) udfyldes, skal koden være i overensstemmelse med stillingsbetegnelsen i titel (jobordretitel). Der valideres på tekst i titel mod beskrivelsestekst fra ESCO STAR.
    • Hvis et alias er angivet skal der været angivet en stillingsbetegnelse og det angivet aliaset skal være knyttet til stillingsbetegnelsen
    • Kun stillingsbetengelser og alias der aktive må angives
  • Status på jobordren (jobordreStatusType) skal ved oprettelse normalt sættes til "Åben" (Id 1). DFDG validerer ikke for dette
  • Seneste dato for formidlingssvar (senesteSvarDato) skal være > dags dato.
  • Hvis virksomheder via JobAG har angivet at de vil modtage e-mails, vil DFDG sende e-mail til virksomheden hvis jobordertypen (jobordreType) er Ordinær job Id 1. (Intern STAR note Skal flyttes over på vores nye STAR.foundation udsendelse)

  • DFDG indsætte først element i formidlingsloggen om ordinær job er modtaget, men der sendes ikke WSRM på dette (GetCompanyRecruitmentEventVersion(nyeste prod versionsnr))
  • DFDG vil ved oprettelse danne et løbenummer. Løbenummeret er en fortløbende talrække pr. CVR-nr der starter med 1.
  • WSRM-beskederne GetCompanyRecruitmentVersion(nyeste prod versionsnr) og GetCompanyRecruitmentEventVersion(nyeste prod versionsnr) sendes til ansvarligt jobcenter, tovholders myndighed og listen af primære formidlingsmyndigheder.
  • Ugentligt arbejdstid i timer (timerPrUge) kan angives i forbindelse med angivelse af deltid (ugenligArbejdstidType). DFDG validere dog ikke på at dette alene angives i forbindelse med deltid. Tilbydes der i jobordren et inkaval f.eks. mellem 20 og 30 timer, angives max antal timer og det angives i beskrivetekst (jobordreBeskrivelse) nærmere oplysninger omkring timetalsinterval
  • Type af arbejdstidsforhold (arbejdstidsforholdType) bør default til "Normal arbejdstid" hvis intet andet er oplyst. DFDG validere dog ikke for dette, ej heller valideres for hvis der sættes forretningsmæssige ulogiske kombinationer af arbejdstidsforhold
  • Typerne (jobordreType) Lærlinge og elevjob Id 2, Fleksjob Id 3 og IGU-ansættelse Id 4 anvendes kun internt mellem myndigheder, virksomheden har ikke adgang til disse via JobAG
  • Virksomheder kan kun oprette Typerne (jobordreType) Ordinær job Id 1
  • Stående/langvarige jobordre, (hvor langvarigJobordre er TRUE) holdes åben, i princippet uendeligt, da virksomheden løbende vil kunne aftag arbejdskraft af den pågældende type. For stående/langvarige jobordre gælde:
    • senesteSvarDato skal ikke angives (skal være Null)
    • maxAntalKandidater skal ikke angives (skal være Null)
    • forventetAnsættelsesdato skal ikke angives (skal være Null)
    • jobordreAntalDage skal ikke angives (skal være Null)

    • De øvrige forretningsregler ændres ikke ved en stående/langvarige jobordre

DFDG vil dog ikke lave valideringer for dette. 
En sådan stående/langvarig jobordre betragtes forretnings- og opgørelsesmæssigt som rækkes af individuelle formidlinger, da de anses for små selvstændige jobordre inden i den stående/langvarige jobordre.

  • Hvis en virksomhed via JobAG (STAR) opretter en joborder skal CVR nummer på den kalden virksomhed være det samme som angives som udbydende virksomhed

UpdateJobordre (PUT /v1/jobordre) - Tidligere UpdateCompanyRecruitment

Metoden opdaterer en jobordre inkl. et evt. statusskift.

Forretningsregler

Kun forretningsregler der er specifikke for UpdateJobordre (PUT /v1/jobordre) er beskrevet her, derudover vil forretningsregler fra CreateJobordre (POST /v1/jobordre) også gælde.

  • Hvis der allerede er fortaget formidlinger, når en jobordre job tildeles/markeres med en tovholder, får det ikke betydning for disse formidlinger. Da de allerede kan være set af virksomheden betragtes disse som default godkendt af tovholder.
  • DFDG laver ikke validering på hvem der sætte en tovholder på og hvorfra tovholderen kommer udover at muligheden for tovholder ikke kan fjernes hvis den er givet.
  • Virksomheden (CVR nr og P nr) der har oprette eller som jobcentret ellers a-kasse har oprettet på vegne af formidlingsønsket  må ikke ændres.
  • Hvis virksomhed har oprette en joborder (oprettetAfVirksomhed) må dette ikke ændres og omvendt hvis en myndighed har oprette må det heller ikke ændres.
  • DFDG indsætter et element i formidlingsloggen om det ordinære job er opdateret, der sendes ikke WSRM besked på dette (GetCompanyRecruitmentEventVersion). 
  • WSRM-beskederne GetCompanyRecruitmentVersion(nyeste prod versionsnr) og GetCompanyRecruitmentEventVersion(nyeste prod versionsnr) sendes til ansvarligt jobcenter, tovholders myndighed, listen af primære formidlingsmyndigheder samt alle jobcentre/a-kasser, der har borgere formidlet på rekrutteringsanmodningen.
  • Hvis jobordren er sat til Intern (internJobordre=true) er den kun redigerbar for de primære rekrutteringsmyndigheder, ansvarligt jobcenter og eventuelt tovholder-jobcenter. Kalder som ikke har adgang får fejl 4575: You are not authorized.
  • Når JobAG (STAR) kalder har kaldt UpdateJobordre (PUT /v1/jobordre), så springes opdatering af de primære formidlingsmyndigheder (primaereMyndigheder) over.
  • Virksomheder kan kun opdaterer (jobordreType) Ordinær job Id 1
    • DFDG validerer ikke for at der skiftes type. men serviceaftager skal være opmærksom på at:
      • Skiftes typen væk fra (jobordreType) Ordinær job Id 1 kan virksomheden ikke mere se jobordren eller de tilhørende formidlinger
      • Skiftes typen til (jobordreType) Ordinær job Id 1 kan virksomheden se jobordren og de tilhørende formidlinger, men vil ikke for allerede formidlede borger få besked (e-mail)
  • Genoplivning af eksisterende jobordre, Step skal håndteres af serviceaftager

    • SenesteSvarDato skal fjerne eller justeres så der er en rimelig svarfrist
    • ForventetAnsættelsesdato fjernes eller justeres
    • Hvis der er formidlet kandidater på jobordren når jobordrestatus skiftes, så:
      • Hvis kandidat har status "Formidling afventer godkendelse (Id 1)" Se om kandidaten stadig har en åben kontaktgruppe
        Hvis borger har det gøres ingenting ved kandidaten, hvis ikke sættes formidlingsstatus til "Kandidat fjernet - ikke mere relevant" med formidlingskommentar (opdateringsKommentar) "Borger fjernet i forbindelse med genaktivering af jobordre da borger ikke længere er til rådighed for formidling"

      • "Formidling tilgængelig for virksomhed" (Id 2)
        Hvis borger har det og det er mindre en X (7) dage siden jobordren blev sat "Lukket" gøres ingenting, hvis det er mere x (7) dage sættes formidlingsstatus "Formidling afventer godkendelse (Id 1)" da tovholde lige igen skal se på kandidaten (denne regel er for at undgå problemer hvis jobordre ved en fejl lukkes), hvis ikke sættes formidlingsstatus til "Kandidat fjernet - ikke mere relevant" (Id 3) med formidlingskommentar (opdateringsKommentar) "Borger fjernet i forbindelse med genaktivering af jobordre, da borger ikke længere er til rådighed for formidling"

    • En sådan genoplivning af en jobordre betragtes som en ny jobordre hvis den er genoplivet efter mere end X (7) dage.

  • Hvis en virksomhed via JobAG (STAR) opdaterer en joborder skal CVR nummer på den kalden virksomhed være det samme som angives som udbydende virksomhed


UpdateJobordreStatus (PUT /v1/jobordre/status) -Tidligere SetCompanyRecruitmentStatus

Metoden giver mulighed for, på en jobordre, at opdatere status (åben, midlertidig inaktiv, lukket). Alle andre forretningsdata forbliver uændret.

Forretningsregler

  • DFDG indsætte et element i formidlingsloggen om ordinær job er opdateret, der sendes ikke GetCompanyRecruitmentEventVersion(nyeste prod versionsnr). DFDG danner ved oprette et entry i formidlingsloggen med CompanyRecruitmentEventActionTypeIdentifier = 7 (Jobordre status opdateret)
  • WSRM-beskederne GetCompanyRecruitmentVersion(nyeste prod versionsnr) og GetCompanyRecruitmentEventVersion(nyeste prod versionsnr) sendes til ansvarligt jobcenter, tovholders myndighed, listen af primære formidlingsmyndigheder samt alle jobcentre/a-kasser, der har borgere formidlet på rekrutteringsanmodningen.
  • Hvis en virksomhed via JobAG (STAR) opdaterer en joborder skal CVR nummer på den kalden virksomhed være det samme som angives som udbydende virksomhed


GetJobordre (GET /v1/jobordre/{jobordreId}) - Tidligere GetCompanyRecruitment

Denne metode henter et specifik jobordre job inkl. formidlingslog. Hvis jobordren er intern, og derfor ikke tilgængelig for en kalder, vil denne kalder få fejl 4575: You are not authorized


GetJobordreForVirksomhed (GET/v1/jobordre/{virksomhed}) - Tidligere GetCompanyRecruitmentsOnCompany

Denne metode henter alle ordinære job på en virksomhed inkl. antal formidlede kandidater og seneste ændringsdato.

Søgningen er målrettet JobAG og virksomheden, men kan f. eks. også bruges af en virksomhedskonsulent i et jobcenter, der ønsker at se alle ordinære jobs en virksomhed har.

Forretningsregler

  • I beregning af kandidater (antalKandidater) medtages ikke kandidater med status fjernede (Id 3) og ikke godkendt (ID 1) 
  • Der findes ordinære jobs på den angivende virksomhed ud fra CVR og P-nr. Er der kun angivet CVR-nr. findes på alle P-nr. under det CVR-nr.
  • Hvis rekrutteringen er intern filtreres output så kalder kun modtager de rekrutteringer som han har rettighed til at se.

GetJobordrePaaTypeOgStatus (GET/v1/jobordre/{jobordreType, jobordreStatusType}) - Tidligere GetCompanyRecruitments 

Metoden returnerer alle ordinære jobs med den ønskede type og status(ser).

Forretningsregler

  • Hvis Seneste opdaterings dato (opdateretEfter) er angivet, udsøges kun elementer, der blevet oprettet eller ændret siden det angivne datotid, dette inkl. ændringer, der er sket til formidlinger (events).
  • I beregning af kandidater (antalKandidater) medtages ikke kandidater med status fjernede (Id 3) og ikke godkendt (ID 1) 
  • Hvis rekrutteringen er intern filtreres output så kalder kun modtager de rekrutteringer som han har rettighed til at se.

CreateJobordreFormidling (POST /v1/jobordre/formidling) - Tidligere CreateCompanyRecruitmentEvent

Metoden giver mulighed for, på en jobordre, at oprette en formidling af en eller flere borgere (kandidater). Hvis der ikke angives nogen kandidater, oprettes forekomsten som et spørgsmål til virksomheden. 

Forretningsregler

  • En formidling resulterer i at DFDG opretter en event på formidlingsloggen med alle der formidlede borgere
    • Der kan ikke laves en formidling på en jobordre der har status (JobordreStatusType) Midlertidig inaktiv (Id 2) eller Lukket (Id3) fejl 9184
  • DFDG validerer ikke om formidlingen sker i forhold til det der er ønsket fra virksomheden i svartypen (jobordreSvarType), dette skal jobkonsulenten sikre sig i sit svar
  • Kun formidling på en eksisterende jobordre identifikation (jobordreId) kan ske.
  • Ved formidling (kandidater) må der ikke være dubletter af borger i en formidling (kandidater) ellers fås fejl 9187
  • Hvis jobordren er intern, og derfor ikke tilgængelig for en kalder, vil denne kalder få fejl 4575: You are not authorized
  • Hvis en borger tidligere er formidlet af samme eller anden myndighed og borgeren ikke er fjernet fra formidlingen, må borger ikke formidles igen fejl 9186. Dvs. en borger må kun have en aktiv formidling pr ordimært job.
    • En borger kan have formidlinger på flere forskellige jobordre. 
  • Når en jobordre har en tovholder, sætter DFDG status på de formidlinger der laves, til ”Afventer godkendelse” (Id 1). Har en jobordre ikke en tovholder sætter DFDG status på de formidlinger der laves, til ”Tilgængelig for virksomhed” (Id 2)
    • Status kan ikke sættes fra CreateJobordreFormidling (POST /v1/jobordre/formidling); det er DFDG der sætter status automatisk. Jobcentre og a-kasser kan kun sættes status vha. metoden UpdateJobordreFormidling (PUT /v1/jobordre/formidling)
  • Virksomheden modtager en e-mail, hvis de har bedt om det og kandidatens status er "Tilgængelig for virksomhed" (Id 2) hvis typerne (jobordreType) er Ordinær job Id 1.
  • WSRM-beskeden GetCompanyRecruitmentEventVersion(nyeste prod versionsnr) sendes til ansvarligt jobcenter, tovholders myndighed, listen af primære formidlingsmyndigheder samt alle jobcentre/a-kasser, der har borgere formidlet på rekrutteringsanmodningen.
  • Det er udelukkende jobcentre og a-kasser, der kan opdatere de primære formidlingsmyndigheder (primaereMyndigheder). 

UpdateJobordreFormidling (PUT /v1/jobordre/formidling) - Tidligere UpdateCandidateOnCompanyRecruitmentEvent

Metoden giver mulighed for, på en formidlet borger, at opdatere status og eller kommentar og alternativ CV URL. 

Hvis det ordinære job har tilknyttet en ”tovholder” (tovholder

) er det denne metode, der skal benyttes ifm. tovholders godkendelse af formidling på den enkelte borger.

Forretningsregler

  • Af hensyn til virksomheden oprettes der et event i formidlingsloggen når:
    • Borgeren er fjernet fra kandidatlisten. Event’et vil indeholde sin egen eventtype (formidlingshaendelsesType = 6) samt i beskrivelsen (beskrivelse) vil der være borgerens navn samt tekst fra korrektionskomentaren (opdateringsKommentarFormidling i requestet)
    • Borgeren gøres tilgængelig for virksomhed fra kandidatlisten. Event’et vil indeholde sin egen eventtype (formidlingshaendelsesType = 8) samt i beskrivelsen beskrivelse (beskrivelse) vil der være borgerens navn samt evt. tekst fra korrektionskomentaren (opdateringsKommentarFormidling i requestet).
      JobAG viser ikke denne event for virksomhed.
  • Hvis jobordren er intern, og derfor ikke tilgængelig for en kalder, vil denne kalder få fejl 4575: You are not authorized
  • Når en tovholder først har godkendt en kandidat, er den tilgængelig for virksomheden. Er en borger godkendt ved en fejl, skal den fjernes sker det med en ny status ”Fjernet” (Id 6)
    • Formidlingen bliver dog kun tilgængelig for virksomheden hvis Typerne (jobordreType) Ordinær job Id 1 
  • Det er ikke muligt at skifte til status ”Formidling afventer godkendelse” (Id 1) 
  • Det er ikke muligt at skifte status på en fjernet borger. Er en borger fjernet ved en fejl, kan borger formidles igen som en normal formidling.
  • En jobkonsulent i et jobcenter/a-kasse kan fjerne kandidater fra et andet jobcenter/a-kasse. Anden aktør kan udelukkende fjerne borgere som de selv har ansvar for.
  • Hvis en borger fjernes for en formidling, skal der være angivet en kommentar (opdateringsKommentarFormidling)
  • Kun personer der er formidlet kan opdateres.
  • Virksomheden modtage en e-mail, hvis de har bedt om det, og kandidatens status er "Tilgængelig for virksomhed" (Id 2).
  • WSRM-beskeden GetCompanyRecruitmentEventVersion(nyeste prod versionsnr) sendes til ansvarligt jobcenter, tovholders myndighed, listen af primære formidlingsmyndigheder samt alle jobcentre/a-kasser, der har borgere formidlet på rekrutteringsanmodningen.
  • Hvis jobordre har status (JobordreStatusType) Midlertidig inaktiv (Id 2) eller Lukket (Id3) må en formidlingsstatus (FormidlingsstatusType) ikke skiftes til Formidling tilgængelig for virksomhed (Id 2)
  • Der sendes ikke besked til virksomheden (e-mail) hvis formidlingsstatus ændres til "Kandidat fjernet - ikke mere relevant" (Id 3) og den forgående formidlingsstatus har været <> "Formidling tilgængelig for virksomhed" (Id 2)

Det klassiske DFDG mønster ved update med at alle data der skal være efter en update skal være med i kaldet.