Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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, herunder følgende jobordretype:

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

Servicen indeholder funktionalitet både om selve den enkelte jobordretype f.eks. ordinære job samt den formidling, der sker i forbindelse med denne. Derudover er der funktionalitet til at finde de enkelte jobordretype landsdækkende. I forbindelse med servicen er der etableret WSRM-beskeder, der vil blive sendt til berørte jobcentre og a-kasser.

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 ag jobordre. 

@Anne Koefoed Ravn (Unlicensed) og Knud de Place (STAR) hvad skal vi skrive omkring koblingen til Vitas?

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.

Servicen kan kaldes af STAR, jobcentre, a-kasser og fagforbund. (Ud her kan ses på snitfladen)

WSRM'er

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

  • GetCompanyRecruitmentVersion4 (Ny tynd kommer)
  • GetCompanyRecruitmentEventVersion2 og GetCompanyRecruitmentEventVersion3 (Ny tynd kommer)

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.

Som standard er det på JobAG forudfyldt (fra 2020-4), at virksomheden ønsker en tovholder. (Skal DFDG fremover gøre dette default, da det jo nu er et fravalg fra virksomheden, eller er det helt afskaffet så der altid skal være en tovholder, er det ikke smart at bevarer just i case)

Hvis en a-kasse opretter en jobordre, så skal denne enten gøre jobordren ikke-intern eller sætte sig selv om tovholder (RecruitmentCaseworker) og/eller sætte sig selv som primær rekrutteringsmyndighed (PrimaryRecruitmentAuthorities). 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 ActionTypes

Følgende er et overblik over hvilke ActionTypes og Descriptions der dannes i de forskellige scenarier. Disse benyttes bla. i WSRM'er til KSS:

  • CreateCompanyRecruitment

    • ActionType = 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"

    • Description = "{personStatus.PersonNameStructure.ToFullName()} er fjernet fra kandidatlisten med følgende kommentar: {candidateModel.CorrectionComment}"

    • ActionType = "Kandidat gjort tilgængelig for virksomhed"

    • Description = "{personStatus.PersonNameStructure.ToFullName()} er godkendt til kandidatlisten med følgende kommentar: {candidateModel.CorrectionComment}"

    • ActionType = "Formidling"

    • Description = "{personStatus.PersonNameStructure.ToFullName()} er opdateret"

    • Hvis kandidatens status sættes til "Kandidat fjernet - ikke mere relevant":

    • Hvis kandidatens status sættes til "Formidling tilgængelig for virksomhed":

    • Hvis kandidatens status sættes til "Ansat af virksomheden" eller "Ikke ansat af virksomheden"
      • ActionType = "Resultat af formidling foreligger "
      • Description = "{personStatus.PersonNameStructure.ToFullName()} har afsluttet formidlingen med følgende resultat: {Description fra status} "
    • 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.

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 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 virksomheden når:

    • En jobordre har status (jobordrestatusType) "Åben" eller "Permanent" 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"


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:

  • GetCompanyRecruitmentVersion(nyeste prod versionsnr)

    Denne sendes i forbindelse med oprettelse eller opdateringer til et ordinært job


  • GetCompanyRecruitmentEventVersion(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 ikke eksternt.

Link til snitfladebeskrivelser

Child pages (Children Display)
sorttitle


Link til forretningsbeskrivelser 

 

Search Results
spacekeyLOG
queryCompanyRecruitmentService
typepage

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

Ud her ses på serviceside under denne side

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 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) - 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 (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 er lovligt set fra DFDG for alle myndigheder at formidle på et ordinært job, uanset om myndigheden er med i PrimaryRecruitmentAuthorities eller ej.
  • 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 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

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.

CreateJobordreFormidling (POST /v1/jobordre/formidling) (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)

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

  • 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.

GetCompanyJobcenterAffiliation

Metoden returnerer en virksomheds tilknytning til et jobcenter/kommune ud fra dens CVR-nr og P-nr placering.

Metoden er målrettet JobAG og virksomheden og tager hensyn til om et givent jobcenter er tilmeldt på løsningen.

Forretningsregler

  • Hvis virksomheden er tilknyttet et Jobcenter der ikke er tilmeldt til løsningen returneres ingen jobcenter kode.
  • Hvis der er en virksomhedsafdeling oprettet under jobcenteret returneres denne. I modsat fald returneres hovedjobcentret.

UpdateJobordreFormidling (PUT /v1/jobordre/formidling) (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.