Table of Contents
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
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:
Hændelse
Formidlingshændelsestype
(formidlingshaendelsesType)
CreateJobordre (POST /v1/jobordre)
JobordreOprettet
Jobordre oprettet (Id 3)
UpdateJobordre (PUT /v1/jobordre)
JobordrenErLukket
Jobordren er lukket (Id 5)
"Jobordren er lukket. Virksomheden ønsker ikke flere formidlinger. {jobordre.opdateringsKommentarJobordre}
JobordrenErIntern
Jobordren er gjort intern (Id 11)
"Jobordren er gjort intern og er opdateret. {jobordre.opdateringsKommentarJobordre}"
JobordrenErLandsdækkende
Jobordren er frigivet til offentlig synlighed og håndtering (Id 10)
"Jobordren er gjort landsdækkende og er opdateret. {jobordre.opdateringsKommentarJobordre}"
JobordrenErOpdateret
Jobordren er opdateret (Id 4)
"Jobordren er blevet opdateret". {jobordre.opdateringsKommentarJobordre}
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)
"{kandidatNavn.fornavne+mellemnavn+efternavn} er godkendt til kandidatlisten med følgende kommentar: {jobordre.opdateringsKommentarJobordre}"
UpdateJobordreStatus
(PUT /v1/jobordre/status)
JobordrensStatusOpdateret
Jobordren er opdateret (4)
(POST /v1/jobordre/formidling)
Formidling
Formidling (Id 1)
{request.beskrivelse}
Orientering til virksomhed
(Formidling uden kandidater)
OrienteringTilArbejdsgiver
Orientering til arbejdsgiver (Id 2)
CreateJobordreFormidling
(POST /v1/jobordre/formidling)
Kandidat fjernet fra formidling
Kandidat fjernet fra formidling (Id 6)
Kandidat gjort tilgængelig for virksomhed
"Kandidat gjort tilgængelig for virksomhed (Id 9)
Formidling
Formidling (Id 1)
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)
CreateCompanyRecruitment
Formidlingshændelsestype = JobordreOprettet
Description = "Jobordre oprettet"
- UpdateCompanyRecruitment
Hvis det ordinære job's status sættes til lukket:
ActionType = JobordrenErLukket
Description = "Jobordren er lukket. Virksomheden ønsker ikke flere formidlinger" : companyRecruitment.CorrectionComment
Ellers:
Hvis jobordren er gjort intern:
- ActionType = JobordrenErIntern
- Description: Jobordren er gjort intern og er opdateret
- Hvis jobordren er gjort landsdækkende:
- ActionType = JobordrenErLandsdækkende
- Description: Jobordren er gjort landsdækkende og er opdateret
- Hvis ingen af ovenstående:
- ActionType = JobordrenErOpdateret
- Description = "Jobordren er blevet opdateret" : companyRecruitment.CorrectionComment
Hvis tovholderen fjernes i en af ovenstående (hvilket i praksis næppe vil forekomme fremadrettet):
For hver kandidat som ikke er godkendt sættes denne til godkendt og der indsættes event i formidlingsloggen:
ActionType = KandidatGodkendtTilFormidling
Description = "{personStatus.PersonNameStructure.ToFullName()} er godkendt til kandidatlisten med følgende kommentar: {candidateModel.CorrectionComment}" (CorrectionComment tages fra UpdateCompanyRecruitment)
UpdateCandidateOnCompanyRecruitmentEvent
ActionType = "Kandidat fjernet fra formidling"
Table of Contents
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
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 formidlingshistorik | CPR 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 | 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 | OrienteringTilArbejdsgiver Orientering til arbejdsgiver (Id 2) | {request.beskrivelse} | Nej | |
UpdateJobordreFormidling | Kandidat fjernet fra formidling og status sættes til:
| 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}" |
ActionType = "Formidling"
Ja | ||
Kandidat er formidling | Formidling Formidling (Id 1) | {formidling.kandidatNavn.fornavne+mellemnavn+efternavn} er opdateret" |
Ja |
Hvis kandidatens status sættes til |
|
| "Resultat af formidling |
foreligger" |
Resultat af formidling foreligger (Id 9) | "{ |
formidling. |
kandidatNavn.fornavne+mellemnavn+efternavn} har afsluttet formidlingen med følgende resultat |
Hvis kandidatens status IKKE ændres:
SetCompanyRecruitmentStatus
ActionType = JobordrensStatusOpdateret
Description = { CorrectionComment } eller hvis tom "Jobordrens status er opdateret"
CreateCompanyRecruitmentEvent
Hvis formidling indeholder kandidater:
ActionType = Formidling
Description = Description-element fra requestet.
Ellers hvis ingen kandidater
ActionType = OrienteringTilArbejdsgiver
Description = Description-element fra requestet.
Udenlandsk arbejdskraft
Det er muligt at angive på jobordren om arbejdsgiver ønsker udenlandsk arbejdskraft: {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:
Til 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)
Til Mail til virksomheden når:
- En jobordre har status (jobordrestatusType) "Åben" eller "Permanent" og 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",
- En jobordre har status (jobordrestatusType) "Åben" eller "Permanent" og og
Der sendes kun en WSRM pr. myndighed, dvs. optræder en myndighed i flere sammenhænge på et 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:
GetCompanyRecruitmentVersionGetCompanyRecruitmentVersion (nyeste prod versionsnr)
Denne sendes i forbindelse med oprettelse eller opdateringer til et ordinært job
GetCompanyRecruitmentEventVersionGetCompanyRecruitmentEventVersion (nyeste prod versionsnr)
Denne sendes i forbindelse med oprettelse eller opdateringer af formidling til et ordinært job.
Se under metodegennemgangen nedenfor for nærmere beskrivelse om hvem der får WSRM i hvilke situationer
Primær og sekundær jobordertype
Forretningsmæssigt anvende jobodertypen (joborderType) til at angive hvilken primær type joborderen er, her kan vælges mellem alle værdier Ordinær job Id 1, Lærlinge og elevjob Id 2, Fleksjob Id 3 eller IGU-ansættelse Id 4 og hvor det kun er Ordinær job Id 1 der er tilgængelig for virksomheder på JobAG.
Den sekundære jobordertype (sekundaerejobordreType) anvendes forretningsmæssigt i forbindelse at den primær type joborderen (joborderType) er et Ordinær job Id 1. i Den forbindelse kan man som sagsbehandler registrere at virksomheden er interesseret i at det ordinære job også kan udfyldes som Lærlinge og elevjob Id 2, Fleksjob Id 3 og / eller IGU-ansættelse Id 4.
Historik i DFDG
- DFDG laver revisionshistorik på alle ændringer. Disse udstilles 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 | ||
GetCompanyRecruitment | JC, AA | Primary authorities, tovholder, ansvarligt JC og JC med formidlet borger | ||
UpdateCompanyRecruitment | JC, AA | Primary authorities, tovholder og ansvarligt JC | ||
CreateCompanyRecruitmentEvent | JC, AA | Primary authorities og ansvarligt JC | ||
GetCompanyRecruitmentsOnCompany | JC, AA | Primary authorities, tovholder, ansvarligt JC og JC med formidlet borger | Der filtreres i output | |
GetCompanyRecruitments | JC, AA | Primary authorities, tovholder, ansvarligt JC og JC med formidlet borger | Der filtreres i output | |
SetCompanyRecruitmentStatus | JC, AA | Alle | Man skal kende GUID | |
GetCompanyJobcenterAffiliation | JC, AA | N/A | ||
UpdateCandidateOnCompanyRecruitmentEvent | JC, AA | AA(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) -
CreateCompanyRecruitmentTidligere 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 : Hvis virksomhederne går via JobAG kan de ikke logge ind, hvis de er blokaderamt. - Primære formidlingsmyndigheder (PrimaryRecruitmentAuthorities)
- 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.
- Det Hvis jobordren sættes til landsdækkende (RecruitmentIsInternal=false) Det er lovligt, set fra DFDG, for alle myndigheder at formidle på et ordinært joben jobordre, uanset om myndigheden er med i PrimaryRecruitmentAuthorities eller ej.
- Hvis jobordren sættes til lokal (intern) (RecruitmentIsInternal=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 (ResponsibleJobcenterCode) 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 (ResponsibleJobcenterCode), skal det være validt.
- Flag for om virksomheden har oprettet (IsCreatedByCompany) sættes af DFDG på baggrund af kalder. Er kalder fra JobAG sættes IsCreatedByCompany til ”true” ellers sættes den til ”false”.
- Tovholder (RecruitmentCaseworker), interne kommentar (InternalComment) og primære formidlingsmyndigheder (PrimaryRecruitmentAuthorities) er sagsbehandler attributter og beregnet primært til brug for jobcentre. JobAG skal ikke sende disse attributter via kald til denne service.
- For et ordinært job der en jobordre der oprettes kan tovholder ikke eksistere hvis flaget RecruitmentCaseWorkerAllowed er false. Ellers fås fejl 9225.
- Hvis koden for stillingsbetegnelse (ConceptUriDa) udfyldes, skal koden være i overensstemmelse med stillingsbetegnelsen i CompanyRecruitmentTitle. 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 (CompanyRecruitmentStatus) skal ved oprettelse normalt sættes til "Åben" (Id 1). DFDG validerer ikke for dette
- Seneste dato for formidlingssvar (CompanyRecruitmentValidToDate) skal være > dags dato.
Hvis virksomheder via JobAG har angivet at de vil modtage e-mails, vil DFDG sende e-mail til virksomheden. (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.
- Hvis jobordren sættes til Intern (RecruitmentIsInternal=true) er den kun redigerbar for de primære rekrutteringsmyndigheder, ansvarligt jobcenter og eventuelt tovholder-jobcenter. Eventuelle jobcentre med formidlede borgere kan se den, men ikke opdatere.
- 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
- Angives at udenlandsk arbejdskraft ønskes (udlandsArbejdskraft) vil jobordren blive annonceres via Work in Denmark. Bemærk at formidling af kandidater via denne snitflade kun kan ske på person med dansk CPR nr.
- Typerne (joborderType) 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 (joborderType) Ordinær job Id 1 og kan ikke selv sætte sekundære jobordertype (sekundaerejobordreType)
- På et ordinært job Id 1 (joborderType) er det muligt at tilknytte en eller flere sekundære jobordertype (sekundaerejobordreType) af typen Lærlinge og elevjob Id 2, Fleksjob Id 3 og IGU-ansættelse Id 4 (DFDG validere ikke for dette)
- en bestemt sekundære jobordertype (sekundaerejobordreType) må kun forkomme en gang i kollektionen
- Permanent/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 permanent/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 permanent/langvarige jobordre
DFDG vil dog ikke lave valideringer for dette.
En sådan Permanent jobordre betragtes forretnings- og opgørelsesmæssigt som rækkes af individuelle formidlinger, da de anses for små selvstændige jobordre inden i den permanente jobordre.
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
jobordre.
Tidligere UpdateCompanyRecruitment
Metoden opdaterer et ordinært job inkl. et evt. statusskift.
Forretningsregler
Kun forretningsregler der er specifikke for UpdateCompanyRecruitment er beskrevet her, derudover vil forretningsregler fra CreateCompanyRecruitment også gælde.
- Hvis der allerede er fortaget formidlinger, når et ordinært 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 der har oprette formidlingsønsket (JobOfferProvider) må 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 (RecruitmentIsInternal=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.
- DFDG oprydning hvis jobordre genoplives
- Hvis status skiftes fra "Lukket" (Id 3) eller "Midlertidig inaktiv" til "Åben" (Id 1) eller "Permanent" (Id 4) og seneste senesteSvarDato er i dag + X dage eller historisk fjerne denne
- Hvis status skiftes fra "Lukket" (Id 3) eller "Midlertidig inaktiv" til "Åben" (Id 1) eller "Permanent" (Id 4) og seneste forventetAnsættelsesdato er i dag + X dage eller historisk fjerne denne
Hvis der er formidlet kandidater på jobordren når jobordrestatus skiftes fra "Lukket" (Id 3) eller "Midlertidig inaktiv" til "Åben" (Id 1) eller "Permanent" (Id 4), vil DFDG hvis de har formidlingsstatus (FormidlingsstatusType):
- "Formidling afventer godkendelse (Id 1)", "Kandidat fjernet - ikke mere relevant" (Id 3), "Ansat af virksomheden" (Id 4), "Ikke ansat af virksomheden" (Id 5) eller "Formidlingsresultat ukendt" (Id 6) gøres ingenting ved kandidaten
- "Formidling tilgængelig for virksomhed" (Id 2) Hvis det er mindre en 7 dage siden jobordren blev sat "Lukket" gøres ingenting. Hvis det er mere 7 dage sættes formidlingsstatus "Formidling afventer godkendelse (Id 1)", da tovholde lige igen skal se på kandidaten. De 7 dages forsinkelse sikre at problemer undgåes hvis jobordre ved en fejl lukkes.
Tidligere SetCompanyRecruitmentStatus
Metoden giver mulighed for, på et ordinært job, 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
- Der kan ikke laves en formidling på et lukket ordinær job formidlingsønske (CompanyRecruitmentStatus = Id 3) fejl 9184
- Der må ikke være dubletter af borger i en formidling (CandidateCollection) ellers fås fejl 9187
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.
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
- Status kan ikke sættes fra CreateCompanyRecruitmentEvent; det er DFDG der sætter status automatisk. Jobcentre og a-kasser kan kun sættes status vha. metoden UpdateCandidateOnCompanyRecruitmentEvent.
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 (NumberOfCandidates) 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.
GetCompanyRecruitments
Metoden returnerer alle ordinære jobs med den ønskede type og status(ser).
Forretningsregler
- Hvis LastModifiedAfter 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 (NumberOfCandidates) 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.
SetCompanyRecruitmentStatus
Metoden giver mulighed for, på et ordinært job, at opdatere status (åben, midlertidig inaktiv, lukket). Alle andre forretningsdata forbliver uændret.
Forretningsregler
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 (NumberOfCandidates) 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.
Tidligere GetCompanyRecruitments
Metoden returnerer alle ordinære jobs med den ønskede type og status(ser).
Forretningsregler
- Hvis LastModifiedAfter 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 (NumberOfCandidates) 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å et ordinært job, 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å et lukket ordinær job formidlingsønske (CompanyRecruitmentStatus = Id 3) fejl 9184
- DFDG validerer ikke om formidlingen sker i forhold til det der er ønsket fra virksomheden i svartypen (CompanyRecruitmentRespondType), dette skal jobkonsulenten sikre sig i sit svar
- CompanyRecruitmentIdentifier skal eksistere.
- Ved formidling (CandidateCollection) skal enten CPR-nr. eller CV-nr. være udfyldt ellers fås fejl 9185
- Der må ikke være dubletter af borger i en formidling (CandidateCollection) 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 (men en borger må selvfølgelig være formidlet til flere forskellige ordinære jobs).
- Når et ordinært job har en tovholder, sætter DFDG status på de formidlinger der laves, til ”Afventer godkendelse” (Id 1) ellers sætter DFDG status på de formidlinger der laves, til ”Tilgængelig for virksomhed” (Id 2)
- Status kan ikke sættes fra CreateCompanyRecruitmentEvent; det er DFDG der sætter status automatisk. Jobcentre og a-kasser kan kun sættes status vha. metoden UpdateCandidateOnCompanyRecruitmentEvent.
- Virksomheden modtager 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.
- Det er udelukkende jobcentre og a-kasser, der kan opdatere PrimaryAuthorities, Når JobAG (STAR) kalder UpdateCompanyRecruitment, så springes opdatering af PrimaryAuthorities over.
- Der må ikke formidles på en joborder der har status (JobordreStatusType) Midlertidig inaktiv (Id 2) eller Lukket (Id3)
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” (RecruitmentCaseworker) 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 (CompanyRecruitmentEventActionTypeIdentifier=6) samt i beskrivelsen (Description) vil der være borgerens navn samt tekst fra korrektionskomentaren (CorrectionComment i requestet)
- Borgeren gøres tilgængelig for virksomhed fra kandidatlisten. Event’et vil indeholde sin egen eventtype (CompanyRecruitmentEventActionTypeIdentifier=8) samt i beskrivelsen beskrivelse (Description) vil der være borgerens navn samt evt. tekst fra korrektionskomentaren (CorrectionComment 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)
- 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 (CorrectionComment)
- 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 joborder har status (JobordreStatusType) Midlertidig inaktiv (Id 2) eller Lukket (Id3) må en formidlingsstatus (FormidlingsstatusType) ikke skiftes til Formidling tilgængelig for virksomhed (Id 2)
Hvis formidlingsstatus (FormidlingsstatusType) skiftes til Kandidat fjernet - ikke mere relevant (id 3) eller Ikke ansat af virksomheden (Id 5) kan der angives en årsag (formidlingsaarsagType)
Det klassiske DFDG mønster ved update med at alle data der skal være efter en update skal være med i kaldet.