EuresNDCPService (2018-4)

Formål med service

Snitflade til danske aktører, som ønsker at levere jobannoncer og CV’er til EURES og som ikke leverer eller vil levere jobannoncer og CV’er til STAR’s forretningssystemer (Jobnet, DFDG mv.). Snitfladen giver alene danske aktører mulighed for at levere jobannoncer og CV’er til EURES. Dvs. snitfladen vil ikke levere jobannoncer og CV’er til Jobnet.
En række danske aktører leverer i dag jobannoncer via STAR’s eksisterende JobAD (tidligere JobIn) snitflade. Disse skal ikke anvende denne nye snitflade, men skal fortsat anvende JobAD, hvorved de fortsat er omfattet af STAR’s forretningsprocesser, herunder validering af indhold samt offentliggørelse på Jobnet. Aktører, som anvender JobAD, skal blot sætte en EURES attribut (2018-2 funktionalitet) for at deres jobannoncer distribueres til EURES.

NDCP er en forkortelse af National Data Consolidation Point jf. EURES, New Regulation (EU) 2016/589, Functional Message Exchange Specifications, Version 1.3.2.

Servicen tilgås vi følgende url (erstat X med miljønummer): https://euresservicetX.jobnettest.dk/jvs

Sikkerhed

I NDCP-servicen benyttes basic authentication.

Service-brugere er begrænset til at se og ændre i egne ressourcer.

Endpoints

/jvs

Dette endpoint representerer annoncer i Eures NDCP.

[
    {
        "id": <string>,
        "status": <"ACTIVE" / "CLOSED">,
        "creationTimestamp": <ISO-8086 tidsstempel>,
        "lastModificationTimestamp": <ISO-8086 tidsstempel>,
        "closingTimestamp": <ISO-8086 tidsstempel>
    }, <...>
]

{
    "id":<string>,
    "document":<Eures XML>
}

{
    "creationTimestamp": <ISO-8086 tidsstempel>
}

/jvs/{id}

Dette endpoint representerer en annonce i Eures NDCP med det angivne id

{
    "id": <string>,
    "document: <Eures XML>,
    "status": <"ACTIVE" / "CLOSED">,
    "creationTimestamp": <ISO-8086 tidsstempel>,
    "lastModificationTimestamp": <ISO-8086 tidsstempel>,
    "closingTimestamp": <ISO-8086 tidsstempel>
}

{
    "status": <"ACTIVE" / "CLOSED">,
    "document": <Eures XML>
}

{
    "lastModificationTimestamp": <ISO-8086 tidsstempel>,
    "closingTimestamp": <ISO-8086 tidsstempel>
}

/jsps

Dette endpoint representerer CV'er i Eures NDCP

[
    {
        "id": <string>,
        "status": <"ACTIVE" / "CLOSED">,
        "creationTimestamp": <ISO-8086 tidsstempel>,
        "lastModificationTimestamp": <ISO-8086 tidsstempel>,
        "closingTimestamp": <ISO-8086 tidsstempel>
    }, <...>
]

{
    "id":<string>,
    "document":<Eures XML>
}

{
    "creationTimestamp": <ISO-8086 tidsstempel>
}

/jsps/{id}

Metode som sætter status 'Close' på en jobannonce.

{
    "id": <string>,
    "document: <Eures XML>,
    "status": <"ACTIVE" / "CLOSED">,
    "creationTimestamp": <ISO-8086 tidsstempel>,
    "lastModificationTimestamp": <ISO-8086 tidsstempel>,
    "closingTimestamp": <ISO-8086 tidsstempel>
}

{
    "status": <"ACTIVE" / "CLOSED">,
    "document": <Eures XML>
}

{
    "lastModificationTimestamp": <ISO-8086 tidsstempel>,
    "closingTimestamp": <ISO-8086 tidsstempel>
}

Fejlhåndtering

Fejl i forbindelse med operationer i NDCP-servicen, vil resultere i en http-statuskode og så vidt muligt en besked, der forklarer, hvad der gik galt.

Følgende afsnit beskriver de statuskoder, der benyttes af NDCP-servicen og i hvilke scenarier de sendes.

Strukturen for svarbeskeder ifm. en handling, der er fejlet i NDCP-servicen ser således ud:

{
  "message": <string>
  "modelState":{
    "request.<feltnavn>": [<fejlbeskrivelse>,<...>],
    <...>
  } 
}

400 - Bad Request

Denne svarkode bruges om forespørgsler, der ikke opfylder de forretningsmæssige kriterier for den pågældende handling. Dette vil typisk være resultatet af en mislykket validering.

401 - Unauthorized

En svarkode af denne type betyder, at noget er gået galt i forbindelse med autentifikationsproceduren. Eksempler på dette kunne være en forkert konfiguration af Authorization headeren eller forkert angivet brugernavn/kodeord.

404 - Not Found

Forudsat at den korrekte adresse på servicen er angivet, vil denne svarkode være resultatet af, at den annonce eller det cv, man har forsøgt at operere på ikke findes i NDCP-servicen. Dette kan skyldes at den enten ikke er blevet oprettet, eller hvis den har ligget med status "CLOSED" i længere end 7 dage, hvorefter den vil være blevet slettet.

409 - Conflict

Statuskoden 409 gives i de tilfælde, hvor forespørgslen strider imod de forretningsmæssige logiske sammenhænge i databasen. Eksempler på dette kunne være at en allerede lukket ressource forsøges lukket, eller hvis det forsøges at indsende en ressource under et id, der allerede er i brug af en åben ressource af samme karakter (dvs. der tillades id-sammenfald mellem annoncer og cv'er, men ikke inden for samme kategori).

500 - Internal Server Error

Denne type fejl skyldes at der er opstået en fejl i NDCP-servicen, der ikke på anden vis er håndteret. Dette kan skyldes en manglende validering eller et uventet flow, der skaber problemer i databasen. I dette tilfælde bør starsupporten kontaktes.

Logning

Alle forespørgsler og svar logges, samt resulterende statuskoder. En logning opbevares i et halvt år, hvorefter den bliver fjernet.