Match.BorgersjobagentService (Version 1, 2025-1) [UDV]
Siden er en UDV udgave manuelt ændret.
Metoder
- 1 GetJobagent (GET /v1/Jobagent)
- 2 GetJobagenter (GET /v1/Jobagent)
- 3 GetJobagenterPaaEmail (GET /v1/Jobagent)
- 4 CreateJobagent (POST /v1/Jobagent){}
- 5 UpdateJobagent (PUT /v1/Jobagent){Jobagentindtifier}/VerificereEmail
- 6 UpdateJobagent (PUT /v1/UpdateJobagent{Jobagentindtifier})
- 7 DeleteJobagent (DELETE /v1/UpdateJobagent{})
GetJobagent (GET /v1/Jobagent)
Henter en jobagent / gemt søgning.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
match.jobagent.read
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
x-civilRegistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Beskrivelse af cpr |
- jobagentidentifier | GUID |
| 1 | Unik identifikation af jogagent / gemt søgning |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
- jobagentrequestBody | CreateJobagentRequestDto |
| 1 |
|
- - jobagentidentifier | GUID |
| 1 | Unik identifikation af jogagent / gemt søgning |
- - titel | string | max 100 UN i JN classic | 1 | Titel på jogagent / gemt søgning |
- - jobagent | JobagentDto |
| 0 - 1 | Oplysniger om jobagent og autioations notifikation. Er kun udfyldt ved automatisk jobagenter |
string |
| 1 | Hvilken email jobagentens søgningsresultat skal sendes til | |
- - - emailVerificeret | boolean |
| 1 | Om emailen er verfiseres og om der dermed må sendes til den |
- - - udesendelsesinterval | https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4564680705 |
| 1 | Hvilket interval der skal sendes i |
- - - smsNotifikation | boolean |
| 1 | Om borger ønske notifikation via NemSMS, True hvis der skal sendes via Nem SMS |
- - soegeparametre | SoegeparametreDto |
| 1 | De søgeparametre der anvendes i standard jogagent / gemt søgning |
- - - udMineFraKravTilJobsøgning | boolean |
|
| Anvend mine krav til jobsøgning som parametre |
- - - geografi | GeografiDto |
| 0 - 1 | De geografiske søgeparametre der anvendes i jogagent / gemt søgning |
- - - - region | eksterndata.region |
| 0 - * | Danske regioner |
- - - - andreomraader | https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4564582408 |
| 0 - * | Andre geografiske områder m.v. |
Hvad med udland??? | Kodeliste |
| 0 - * | Lande, kun EURES???? |
- - - - afstand | AfstandDto |
| 0 - 1 | Afstand |
- - - - - minafstand | int |
| 0 - 1 | Minimum afstand i km |
- - - - - maxafstand | int |
| 1 | Maxikmum afstand i km |
- - - - - fraPostnummer | int |
| 0 - 1 | Postnummer der måles fra |
- - - - - fraKommune | int |
| 0 - 1 | Kommunenkode der måles fra |
- - - - rejsetid |
|
| 0 - 1 |
|
- - - - - minafstand | int |
| 0 - 1 | Minimum afstand i km |
- - - - - maxafstand | int |
| 1 | Maxikmum afstand i km |
- - - arbejdsomraade | ArbejdsomraadeDto |
| 0 - 1 | De arbejdsområder og eller stillingsbetegnelser der anvendes i jogagent / gemt søgning |
- - - - beskaeftigelsesomraade | BeskaeftigelsesomraadeDto |
| 0 - * | Beskæftigelsesområder der indgår i søgning |
- - - - - hierarkielementId | GUID |
| 1 | Beskæftigelsesområdes identifier |
- - - - - hierarkitype | https://starwiki.atlassian.net/wiki/spaces/UDV/pages/3770220619 |
| 1 | Type af beskæftigelsesområde |
- - - - stillingsbetegnelser | StillingsbetegnelserDto |
| 0 - * | Stillingsbetegnelser og alias der indgår i søgning |
- - - - - ConceptUriDa | string |
| 1 | Unik ESCO STAR identifikation på stillingsbetegnelse. |
- - - - - AliasIdentifier | guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 | Unik ESCO STAR identifikation på alias. |
- - - ansaettelsesvilkaar | AnsaettelsesvilkaarDto |
| 0 - 1 | De ansættelsesvilkår der anvendes i jogagent / gemt søgning |
- - - - ansaettelsesvilkaartype |
| 0 - * | Ansættelsesvilkår | |
- - - ansaettelsesvarighed | AnsaettelsevarighedDto |
| 0 - 1 | Den ansættelsesvarighed der anvendes i jogagent / gemt søgning |
- - - - ansaettelsesvarighedstype |
| 0 - * | Ansættelsesvarighed | |
- - - arbejdstid | ArbejdstidDto |
| 0 - 1 | De arbejdsområder og eller stillingsbetegnelser der anvendes i jogagent / gemt søgning |
- - - - arbejdstidstype |
| 1 |
| |
- - - - deltidMinTimer | int |
| 0 - 1 | Hvis deltid minimum antal timer |
- - - - deltidMaxTimer | int |
| 1 | Hvis deltid maximum antal timer |
|
|
|
|
|
- - - - - |
|
|
|
|
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
1010 | Unknown cpr | The submitted cpr is unknown to the system |
4575 | You are not authorized | You are not authorized to execute the operation |
GetJobagenter (GET /v1/Jobagent)
Henter en borgeres jobagenter / gemt søgninger.
GetJobagenterPaaEmail (GET /v1/Jobagent)
Henter jobagenter / gemt søgninger ud fra email adresse.
CreateJobagent (POST /v1/Jobagent){}
Opretter en borgers jobagent eller gemt søgning. Hvis
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
match.jobagent.write
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
x-civilRegistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Beskrivelse af cpr |
x-requestId [Header] | string |
| 1 | Unikt id for requestet (typisk guid). Hvis api'et modtager samme requestId mere end én gang returneres http status kode 412. Max længde for id'et er 46 chars |
requestBody | CreateJobagentRequestDto |
| 1 |
|
Titel |
|
|
|
|
- - - |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- KlientKategori |
| 1 | Klientkategori som fremsøgte borgere skal matche. | |
- Tilmeldingsdato | dateTime |
| 1 | Tilmeldedatoen hvor det angivne tilmeldeforhold starter. Dette er datoen, hvor den ledige har henvendt sig enten gennem Jobnet eller Jobcentret. |
- Ledighedsgrad |
| 1 | Ledighedsgrad. | |
- Haendelsesdato | dateTime |
| 0 - 1 | Forretningsmæssig hændelsesdato for tilmeldingen hvis den ikke er registreret på hændelsesdatoen |
- Emailadresse | EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Emailadresse som tidligere skulle angives ved tilmelding fra Jobnet for at kunne bekræfte timeldingen digitalt til borger. Løses med dialogmodul hvis vi ikke har emailadresse på borger |
- Joboensker | JoboenskeDtoCollection |
| 0 - 1 | Samling af jobønsker |
- - JoboenskeDto | JoboenskeDto |
| 0 - * | Jobønske/stillingsbetegnelse |
- - - ConceptUriDa | string |
| 1 | Unik ESCO STAR identifikation på stillingsbetegnelse. |
- - - AliasIdentifier | guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 | Unik ESCO STAR identifikation på alias. |
- - - HarUddannelse | boolean |
| 1 | Angivelse af om personen har uddannelse for den angivne stillingsbetegnelse. |
- - - AarSidstBrugt | int |
| 0-1 | Angivelse hvornår personen senest var aktiv indenfor stillingen. |
- - - maanederMedErfaring | int |
| 0-1 | Angivelse hvor mange måneder personen har erfaring fra stillingen. |
- - - jobTargetIdentifier | uuid |
| 1 | Unik identifier på jobønsket |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
Tomt |
|
|
|
|
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
---|---|---|
1001 | Invalid cpr | The submitted cpr is either to long or short or contains data not interpretable as a date |
1010 | Unknown cpr | The submitted cpr is unknown to the system |
4405 | The person with specified cpr is dead | The person with specified cpr is dead |
4575 | You are not authorized | You are not authorized to execute the operation |
4589 | Unknown identifier | The submitted Identifier is unknown to the system |
UpdateJobagent (PUT /v1/Jobagent){Jobagentindtifier}/VerificereEmail
Opdaterer en given jobagent til at email er verificeret og der kan udsendes email til borger
UpdateJobagent (PUT /v1/UpdateJobagent{Jobagentindtifier})
Opdaterer en en jobagent / gemt søgning.
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | Anden Aktør - alle borgere | System - alle borgere |
---|---|---|---|---|---|---|---|---|
STAR | X |
|
|
|
|
|
|
|
Scope
Ikke defineret
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
x-civilRegistrationIdentifier [Header] | string | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | personnummer |
request | UnemploymentEnrollmentAndBookRequestType |
| 1 |
|
requestBody | UpdateJobagentRequestDto |
| 1 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
HasEducation | boolean |
| 1 | Angivelse af om personen har uddannelse for den angivne stillingsbetegnelse. |
YearLastUsed | int |
| 1 | Angivelse hvornår personen senest var aktiv indenfor stillingen. |
MonthsOfExperience | int |
| 1 | Angivelse hvor mange måneder personen har erfaring fra stillingen. |
BookingStartTime | dateTime |
| 1 |
|
- moedetilbudId | guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 1 |
|
- sagsbehandlerEksterntId | string | Length: 1-255 | 0 - 1 | Sagsbehandler-ID |
- SamtaleformType |
| 1 | Angiver om mødet skal være personligt fremmøde, telefonisk, digitalt eller andet. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
UnemploymentEnrollmentAndBookResponse | UnemploymentEnrollmentAndBookResponseType |
| 1 |
|
- ServiceReceipt | ServiceReceiptType |
| 1 | kvittering for transaktionen. |
- - EventDate | dateTime |
| 1 | Tidspunkt for transaktionen eller registrering. |
- - MessageIdentifier | guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 1 | Unik identifikation af transaktion eller registrering. |
- JobCenterReceipt | string | Length: 0-10000 | 1 | Kvittering fra jobcentret. |
- Phone | string |
| 0 - 1 | Telefonnummer. |
- Fax | string |
| 0 - 1 | Faxnummer. |
- NoSelfActivatingCodeNeeded | boolean |
| 1 |
|
- IndkaldelseId | guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 1 | Identifikation af booking. |
Fejlkoder
DeleteJobagent (DELETE /v1/UpdateJobagent{})
Sletter en jobagent / gemt søgning.