Komposit.TilmeldingService (Version 1, 2024-4)
- WikiUploader
Siden opdateres automatisk til at afspejle koden.
Metoder
CreateTilmelding (POST /v1/tilmelding/CreateTilmelding)
Tilmelding af ledige for Jobcenter og A-kasse hvis borger i forvejen har jobønsker.
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 |
|---|---|---|---|---|---|---|---|---|
A-kasse |
| X |
|
|
|
|
|
|
JobCenter | X |
|
|
| X |
|
|
|
Kommune | X |
|
|
|
|
|
|
|
STAR | X |
|
|
|
|
|
|
|
Scope
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 | CreateTilmeldingRequestDto |
| 1 |
|
- tilmeldingIdentifier | uuid |
| 0 - 1 | Id som medsendes i de tilfælde hvor ekstern aftager har et lokalt id ved oprettelsen |
- klientKategori |
| 1 |
| |
- tilmeldingsdato | date-time |
| 1 | Tilmeldedatoen hvor det angivne tilmeldeforhold starter.
|
- ledighedsgrad |
| 1 |
| |
- haendelsesdato | date-time |
| 0 - 1 | Forretningsmæssig hændelsesdato for tilmeldingen hvis den ikke er registreret på hændelsesdatoen |
- joboensker | JoboenskeDtoCollection |
| 0 - 1 | Samling af jobønsker |
- - JoboenskeDto | JoboenskeDto |
| 0 - * |
|
- - - conceptUriDa | string | MinLength: 1 | 1 | Unik ESCO STAR identifikation på stillingsbetegnelse. |
- - - aliasIdentifier | uuid |
| 0 - 1 | Unik ESCO STAR identifikation på alias. |
- - - harUddannelse | boolean |
| 1 | Angivelse af om personen har uddannelse for den angivne stillingsbetegnelse. |
- - - aarSidstBrugt | int32 |
| 0 - 1 | Angivelse hvornår personen senest var aktiv indenfor stillingen. |
- - - maanederMedErfaring | int32 |
| 0 - 1 | Angivelse hvor mange måneder personen har erfaring fra stillingen. |
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
response | CreateTilmeldingResponseDto |
| 1 | Response model der indeholder identifier og kvitteringstekst |
- createdItemIdentifier | uuid |
| 1 | Unik identifikation for den oprettede entitet |
- borgerkvitteringstekst | string | MaxLength: 3000 | 0 - 1 | Kvitteringstekst til borgeren |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
1001 | Ugyldigt cpr-nummer | Ugyldigt cpr-nummer |
1010 | Unknown cpr | Unknown cpr |
1014 | The submitted message is not valid | The submitted message is not valid |
1 | Person does not exist for given cpr number. | Person does not exist for given cpr number. |
4405 | Borgeren med det specificerede CPR nummer er død | Borgeren med det specificerede CPR nummer er død |
4575 | You are not authorized to execute the operation | You are not authorized to execute the operation |
4977 | Det angivne id findes allerede | Det angivne id findes allerede |
9299 | Klientkategorien kan ikke anvendes af a-kasser | Klientkategorien kan ikke anvendes af a-kasser |
9300 | Ledighedsgraden kan ikke anvendes af a-kasser | Ledighedsgraden kan ikke anvendes af a-kasser |
4749 | Tilmeldingsdato skal være dags dato | Tilmeldingsdato skal være dags dato |
4339 | Ledighedsgraden 'Ikke ledig' kan kun anvendes med klientkategorien 'Tilmeldt uden ydelse' | Ledighedsgraden 'Ikke ledig' kan kun anvendes med klientkategorien 'Tilmeldt uden ydelse' |
6014 | Tilmelding er ikke tilladt pga. ugyldig kombination af klientkategori og ledighedsgrad | Tilmelding er ikke tilladt pga. ugyldig kombination af klientkategori og ledighedsgrad |
4314 | Ugyldig ledighedsgrad | Ugyldig ledighedsgrad |
4417 | Borger skal være medlem af en a-kasse for at modtage dagpenge | Borger skal være medlem af en a-kasse for at modtage dagpenge |
4720 | En udrejst borger kan ikke tilmeldes | En udrejst borger kan ikke tilmeldes |
4641 | Borgers personkategori tillader ikke tilmelding | Borgers personkategori tillader ikke tilmelding |
4750 | Borger har fravær der ikke tillader tilmelding | Borger har fravær der ikke tillader tilmelding |
7062 | Jobønsker skal være sat for denne klientkategori | Jobønsker skal være sat for denne klientkategori |
4318 | Kaldet indeholder en eller flere ugyldige jobønsker | Kaldet indeholder en eller flere ugyldige jobønsker |
4405 | Borgeren med det specificerede CPR nummer er død | Borgeren med det specificerede CPR nummer er død |
4698 | En parameter er ulovligt negativ | En parameter er ulovligt negativ |
4710 | AarSidstBrugt er ikke et lovligt år | AarSidstBrugt er ikke et lovligt år |
8281 | ConceptUriDa findes ikke | ConceptUriDa findes ikke |
8282 | ConceptUriDa er udløbet | ConceptUriDa er udløbet |
9439 | En borger kan ikke registreres med samme ConceptUriDa mere end en gang | En borger kan ikke registreres med samme ConceptUriDa mere end en gang |
100046 | Hændelsesdato må for dagpengemodtagere kun registreres og opdateres af a-kassen og STAR | Hændelsesdato må for dagpengemodtagere kun registreres og opdateres af a-kassen og STAR |
TilmeldOgBook (POST /v1/tilmelding/action/TilmeldOgBook)
Denne komposit-metode sikrer at man i samme kald, og kun sammenhængende kan tilmelde borgeren og lave en booking af et møde. Metodens forretningsregler er de samme som for JobnetBookingService.
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
komposit.tilmelding.staronly.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 | TilmeldOgBookRequestDto |
| 1 | Tilmelding af borger og booking af møde. |
- tilmeldingIdentifier | uuid |
| 0 - 1 | Id som medsendes i de tilfælde hvor ekstern aftager har et lokalt id ved oprettelsen |
- klientKategori |
| 1 |
| |
- tilmeldingsdato | date-time |
| 1 | Tilmeldedatoen hvor det angivne tilmeldeforhold starter.
|
- ledighedsgrad |
| 1 |
| |
- haendelsesdato | date-time |
| 0 - 1 | Forretningsmæssig hændelsesdato for tilmeldingen hvis den ikke er registreret på hændelsesdatoen |
- joboensker | JoboenskeDtoCollection |
| 0 - 1 | Samling af jobønsker |
- - JoboenskeDto | JoboenskeDto |
| 0 - * |
|
- - - conceptUriDa | string | MinLength: 1 | 1 | Unik ESCO STAR identifikation på stillingsbetegnelse. |
- - - aliasIdentifier | uuid |
| 0 - 1 | Unik ESCO STAR identifikation på alias. |
- - - harUddannelse | boolean |
| 1 | Angivelse af om personen har uddannelse for den angivne stillingsbetegnelse. |
- - - aarSidstBrugt | int32 |
| 0 - 1 | Angivelse hvornår personen senest var aktiv indenfor stillingen. |
- - - maanederMedErfaring | int32 |
| 0 - 1 | Angivelse hvor mange måneder personen har erfaring fra stillingen. |
- moedeStarttidspunkt | date-time |
| 1 | Starttidspunkt for mødet. |
- moedetilbudId | uuid |
| 1 | ID på mødetilbud. |
- sagsbehandlerEksterntId | string |
| 0 - 1 | Sagsbehandler-id |
- samtaleformType |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
|---|---|---|---|---|
response | CreateTilmeldingResponseDto |
| 1 | Response model der indeholder identifier og kvitteringstekst |
- createdItemIdentifier | uuid |
| 1 | Unik identifikation for den oprettede entitet |
- borgerkvitteringstekst | string | MaxLength: 3000 | 0 - 1 | Kvitteringstekst til borgeren |
Fejlkoder
Fejlkode | Fejltekst | Beskrivelse |
|---|---|---|
1001 | Ugyldigt cpr-nummer | Ugyldigt cpr-nummer |
1010 | Unknown cpr | Unknown cpr |
1014 | The submitted message is not valid | The submitted message is not valid |
1 | Person does not exist for given cpr number. | Person does not exist for given cpr number. |
4405 | Borgeren med det specificerede CPR nummer er død | Borgeren med det specificerede CPR nummer er død |
4575 | You are not authorized to execute the operation | You are not authorized to execute the operation |
4977 | Det angivne id findes allerede | Det angivne id findes allerede |
9299 | Klientkategorien kan ikke anvendes af a-kasser | Klientkategorien kan ikke anvendes af a-kasser |
9300 | Ledighedsgraden kan ikke anvendes af a-kasser | Ledighedsgraden kan ikke anvendes af a-kasser |
4749 | Tilmeldingsdato skal være dags dato | Tilmeldingsdato skal være dags dato |
4339 | Ledighedsgraden 'Ikke ledig' kan kun anvendes med klientkategorien 'Tilmeldt uden ydelse' | Ledighedsgraden 'Ikke ledig' kan kun anvendes med klientkategorien 'Tilmeldt uden ydelse' |
6014 | Tilmelding er ikke tilladt pga. ugyldig kombination af klientkategori og ledighedsgrad | Tilmelding er ikke tilladt pga. ugyldig kombination af klientkategori og ledighedsgrad |
4314 | Ugyldig ledighedsgrad | Ugyldig ledighedsgrad |
4417 | Borger skal være medlem af en a-kasse for at modtage dagpenge | Borger skal være medlem af en a-kasse for at modtage dagpenge |
4720 | En udrejst borger kan ikke tilmeldes | En udrejst borger kan ikke tilmeldes |
4641 | Borgers personkategori tillader ikke tilmelding | Borgers personkategori tillader ikke tilmelding |
4750 | Borger har fravær der ikke tillader tilmelding | Borger har fravær der ikke tillader tilmelding |
7062 | Jobønsker skal være sat for denne klientkategori | Jobønsker skal være sat for denne klientkategori |
4318 | Kaldet indeholder en eller flere ugyldige jobønsker | Kaldet indeholder en eller flere ugyldige jobønsker |
4405 | Borgeren med det specificerede CPR nummer er død | Borgeren med det specificerede CPR nummer er død |
4698 | En parameter er ulovligt negativ | En parameter er ulovligt negativ |
4710 | AarSidstBrugt er ikke et lovligt år | AarSidstBrugt er ikke et lovligt år |
8281 | ConceptUriDa findes ikke | ConceptUriDa findes ikke |
8282 | ConceptUriDa er udløbet | ConceptUriDa er udløbet |
9439 | En borger kan ikke registreres med samme ConceptUriDa mere end en gang | En borger kan ikke registreres med samme ConceptUriDa mere end en gang |
90201 | Systemfejl i kontakten med jobcentrets bookingsystem | Systemfejl i kontakten med jobcentrets bookingsystem |
90204 | Der er sket en systemfejl imellem Jobnet og DFDG | Der er sket en systemfejl imellem Jobnet og DFDG |
90205 | Mødetidspunktet er ikke længere tilgængeligt | Mødetidspunktet er ikke længere tilgængeligt |