Integrationsvejledning til EURES NDCP

Owned by Bjarne Hansen (Edora)
Last updated: Nov 16, 2021 by Knud de Place (STAR)Version comment
9 min read


Introduktion

Denne integrationsvejledning beskriver hvordan danske aktører kan anvende EURES NDCP webservice til at levere jobannoncer og CV'er til EURES portalen. Målgruppen for integrationsvejledningen er softwareudviklere og projektledere hos danske aktører.

Aktører, som kun ønsker at levere jobannoncer  og som ønsker at jobannoncerne både skal leveres til Jobnet og til EURES, skal ikke anvende EURES NDCP. Her er det tilstrækkeligt at anvende JobAD servicen, som både kan levere jobannoncerne til Jobnet og til EURES på samme tid. Se Integrationsvejledning til JobAD webservice.

EURES er EU kommisionens Europæisk Portal For Jobmobilitet, som findes her. Arbejdsgivere kan indsende jobannoncer til EURES portalen, samt søge efter medarbejdere på EURES portalen. Arbejdssøgende kan lægge deres CV'er på EURES portalen, samt søge efter ledige stillinger på EURES portalen. Såvel jobannoncer som CV'er skal indsendes til EURES portalen via nationale knudepunkter ved anvendelse af en dansk aktør. Arbejdsgivere kan ikke indsende jobannoncer direkte til EURES, ligesom arbejdssøgende heller ikke kan indsende CV'er direkte til EURES portalen.. I Danmark skal EURES NDCP anvendes som knudepunkt. Nærværende integrationsvejledning beskriver hvordan en dansk aktør skal anvende EURES NDCP.

EURES NDCP (National Data Consolidation Point) er en service, som opsamler alle danske jobannoncer og CV'er og som videresender disse til EU's EURES portal. EURES NDCP udstiller snitfladen "EuresNDCPService", som aktøren skal anvende til at implementere integration til EURES NDCP.

Figuren herunder illustrerer hvordan danske aktører kan indsende jobannoncer og CV'er til EURES portalen ved anvendelse af EURES NDCP.


EURES NDCP snitfladebeskrivelse

Snitfladebeskrivelsen består af 3 sæt specifikationer:

  1. EuresNDCPService
  2. EU's XML specifikationer for hhv. jobannoncer og CV'er'
  3. Danske forretningsregler

Jobannoncer og CV'er skal forsendes til EURES NDCP som XML dokumenter, der skal overholde EU's specifikationer. EU's specifikationer tillader en række valgmuligheder og den enkelte danske aktør har frihed til at foretage de valg, som passer aktøren bedst så længe at EU's specifikationer overholdes. XML dokumenterne forsendes direkte fra EURES NDCP til EU uden modifikationer. Danmark kræver dog at nogle få supplerende forrretningsregler er overholdt for at de enkelte aktørers jobannoncer og CV'er kan identificeres og behandles korrekt.

EURES NDCP REST/JSON webservicen er således transportlaget til forsendelse af jobannoncer og CV'er, mens EU's XML specifikationer fastlægger indholdet i jobannoncer og CV'er, herunder XML Schema, klassifikationer og koder.

EuresNDCPService

EURES NDCP udstiller EuresNDCPService, som er en REST/JSON webservice, der skal anvendes til at forsende jobannoncer / CV'er til EURES portalen. Webservicen anvendes også hvis indholdet i en jobannonce / et CV skal opdateres eller en jobannoncen / et CV skal fjernes fra EURES portalen.

Webservicen er beskrevet på siden EuresNDCPService (2018-4).

XML Schema for EURES jobannoncer og CV'er

XML dokumenterne med jobannoncer og CV'er skal opbygges i overensstemmelse med EURES XML schemaerne. XML Schemaerne findes herunder.

XML Schema for jobannoncer er specificeret i \eures-xsd-1.3\eures-xsd\HR-XML-3_2-Recruiting\org_hr-xml\3_2\Developer\Nouns\PositionOpening.xsd.

XML Schema for CV'er er specificeret i \eures-xsd-1.3\eures-xsd\HR-XML-3_2-Recruiting\org_hr-xml\3_2\Developer\Nouns\Candidate.xsd.

EURES NDCP validerer jobannoncer og CV'er mod XML Schema inden de accepteres. Hvis dokumenterne ikke kan valideres, afvises de.


XML Schemaerne specificerer ikke alle krav til XML dokumenterne. Der er er række krav til klassifikationer mv., der ikke er specificerede i XML Schemaer, men som kun er specificerede i specifikationsdokumenterne herunder. Disse specifikationer skal overholdes for at jobannoncer og CV'er kan sendes til EURES portalen. EURES NDCP validerer ikke kravene i specifikationerne, hvilket betyder at disse krav først valideres, når de modtages af EURES portalen.

XML specifikationer for EURES jobannoncer

Jobannoncer skal opfylde en række krav til klassifikationer mv. Kravene er beskrevet i dokumentet "EURES formats and standards specification, Part 1: EURES job vacancy data standard description", version 1.01:

XML specifikationer for EURES CV'er

CV'er skal opfylde en række krav til klassifikationer mv. Kravene er beskrevet i dokumentet "EURES formats and standards specification, Part 2: EURES job seeker profile data standard description", version 1.01:

Danske forretningsregler

NDCP kræver at nogle få forretningsregler er opfyldt for at jobannoncer og CV'er kan udveksles korrekt til EURES portalen:

  1. "PartyID" elementerne i XML dokumenter skal have samme værdi, som aktørens kontonavn på EURES NDCP
  2. På jobannoncer skal jobannoncens udløbsdato være udfyldt
  3. Aktøren skal tildele et unikt ID til hver jobannonce hhv. CV, som maksimalt må være på 28 karakterer
  4. Krav til specifikke felter

EURES NDCP validerer jobannoncer og CV'er mod disse danske forretningsregler inden de accepteres. Hvis dokumenterne ikke kan valideres, afvises de.

Forretningsreglerne uddybes herunder.

"PartyID" elementerne i XML dokumenter skal have samme værdi, som aktørens kontonavn på EURES NDCP

Hver aktør får et entydigt kontonavn, som dels anvendes til autentificering på EURES NDCP webservicen, dels anvendes som PartyID i XML dokumenterne. Følgende felter (xpath) i XML dokumenterne skal udfyldes med aktørens kontonavn:

  • På jobannoncer: PositionOpening/PostingRequester/PartyID
  • På CV'er: Candidate/CandidateSupplier/PartyID

På jobannoncer skal jobannoncens udløbsdato være udfyldt

Jobannoncernes udløbsdato skal være udfyldt for at EURES NDCP automatisk kan fjerne dem fra EURES portalen, når jobannoncerne er udløbet. Følgende felt (xpath) skal være udfyldt:

  • PositionOpening/PositionProfile/ApplicationCloseDate

Aktøren skal tildele et unikt ID til hver jobannonce hhv. CV, som maksimalt må være på 28 karakterer

Aktøren skal tildele et unikt ID til hver jobannonce hhv. CV. ID'et skal anvendes , når jobannoncen / CV'et lægges ind med EuresNDCPService. ID'et kan også anvendes som "DokumentID" i XML dokumenterne, men det er ikke et krav.

Tilladt tegnsæt: 7-bit printbare ASCII tegn, dog ikke blanktegn og underscore: 

Dec

Char

Dec

Char

Dec

Char

Dec

Char

Dec

Char

Dec

Char

Dec

Char

Dec

Char

33

!

34

"

35

#

36

$

37

%

38

&

39

'

40

(

41

)

42

*

43

+

44

,

45

-

46

.

47

/

48

0

49

1

50

2

51

3

52

4

53

5

54

6

55

7

56

8

57

9

58

:

59

;

60

<

61

=

62

>

63

?

64

@

65

A

66

B

67

C

68

D

69

E

70

F

71

G

72

H

73

I

74

J

75

K

76

L

77

M

78

N

79

O

80

P

81

Q

82

R

83

S

84

T

85

U

86

V

87

W

88

X

89

Y

90

Z

91

[

92

\

93

]

94

^



96

`

97

a

98

b

99

c

100

d

101

e

102

f

103

g

104

h

105

i

106

j

107

k

108

l

109

m

110

n

111

o

112

p

113

q

114

r

115

s

116

t

117

u

118

v

119

w

120

x

121

y

122

z

123

{

124

|

125

}

126

~





Krav til specifikke felter på jobannoncer

  • /PositionOpening/PositionProfile/PositionOrganization/OrganizationIdentifiers/OrganizationLegalID er CVR-nummer på den virksomhed, der søger en ny medarbejder.

Krav til specifikke felter på CV'er

Der er ingen særlige krav.

EURES XML valideringsværktøj

XML dokumenterne med jobannoncer og CV'er kan valideres med EU's valideringsværktøj, som både validerer XML Schema og krav til klassifikationer mv.:

https://webgate.acceptance.ec.europa.eu/eures/eures-tools/debug-tool/page/main#/validator-tool

Username = IOC_Validator, Password = IOC_Validator 

Når man har udviklet sit programmel til at opbygge XML dokumenter jf. EURES specifikationerne, skal man validere eksempler på XML dokumenterne som del af kvalitetssikringen inden XML dokumenterne sendes til EURES NDCP.

Eksempler

Herunder findes eksempler på såvel XML dokumenter som på kald af EURES NDCP webservicen.

Husk at der skal benyttes basic authentication, med det tildelte brugernavn og kodeord.

Jobannonce

Eksempel på XML dokument med jobannonce indsendt af aktøren "Danmark123" med kontonavn "DK123" og dokument ID = "1234567":


Eksempler på:

  • Indsend jobannonce
  • Opdater jobannonce
  • Luk jobannonce
  • Hent oversigt over jobannoncer
  • Hent jobannonce

Indsend jobannonce

POST til https://euresservice.jobnet.dk/jvs

Request body
{
	"id":"1234",
	"document": "<?xml version='1.0' encoding='UTF-8'?><PositionOpening xmlns='http://www.hr-xml.org/3' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns2='http://www.openapplications.org/oagis/9' majorVersionID='3' minorVersionID='2' xsi:schemaLocation='http://www.hr-xml.org/3 file:///C:/eures-xsd/HR-XML-3_2-Recruiting/org_hr-xml/3_2/Developer/Nouns/PositionOpening.xsd'><DocumentID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI=''>1234567</DocumentID><PositionOpeningStatusCode>Active</PositionOpeningStatusCode><PostingRequester><PartyID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI='http://ec.europa.eu/eures/standards/2014/DOC/Data/ID' >DK123</PartyID><PartyName>Danmark123</PartyName></PostingRequester><PositionProfile languageCode='da'><PostingInstruction><ApplicationMethod><Instructions languageID='dk'>Send ansøgning på en af de angivne kommunikationskanaler</Instructions><PersonContact><PersonName xmlns:oa='http://www.openapplications.org/oagis/9' ><oa:GivenName>Jens</oa:GivenName><FamilyName>Jensen</FamilyName></PersonName><Communication><ChannelCode>Email</ChannelCode><ns2:URI>jens.jensen@virksomheden.dk</ns2:URI></Communication><Communication><Address><ns2:BuildingNumber>13</ns2:BuildingNumber><ns2:StreetName>Perssonsgade</ns2:StreetName><ns2:CityName>Frederiksværk</ns2:CityName><CountryCode listName='Countries' listVersionID='3166-1-alpha-2' listURI='http://ec.europa.eu/esco/ConceptScheme/country' >DK</CountryCode><ns2:PostalCode>3300</ns2:PostalCode></Address></Communication></PersonContact></ApplicationMethod></PostingInstruction><PositionTitle languageID='DK'>virksomheden.dk søger ny medarbejder</PositionTitle><PositionLocation><Address><CountryCode listName='EURES_MemberCountries' listURI='http://www.iso.org/iso/' listVersionID='3166-1-alpha-2'>DK</CountryCode></Address></PositionLocation><PositionOrganization><OrganizationIdentifiers><OrganizationName>virksomheden.dk</OrganizationName><OrganizationLegalID schemeID='DK-001' schemeAgencyID='https://erhvervsstyrelsen.dk' schemeAgencyName='Erhvervsstyrelsen' schemeVersionID='DK-001' schemeDataURI=''>12345678</OrganizationLegalID></OrganizationIdentifiers><IndustryCode listName='NACE_r2' listURI='http://ec.europa.eu/esco/ConceptScheme/NACErev2/cs' listVersionID=''>N81.2.1</IndustryCode></PositionOrganization><PositionOpenQuantity>1</PositionOpenQuantity><JobCategoryCode listName='ISCO2008' listURI='http://ec.europa.eu/esco/ConceptScheme/ISCO2008' listVersionID='2008'>9112</JobCategoryCode><PositionOfferingTypeCode>DirectHire</PositionOfferingTypeCode><PositionFormattedDescription><Content languageID='DK'><![CDATA[<p>Vi er et lille firma i stor udvikling og søger derfor em ny medarbejder på deltid - op til 30 timer pr. uge. Rebngøringen foregår primart i private hjem. Du skal bo i Nordsjælland og vi starter kl 8.00 hos den første kunde.</p><p> </p><p>Vi forventer at du:</p><ul><li>Er serviceminded og flexibel</li><li>Er mødestabil og kvalitetsbevist</li><li>Er præsentabel</li><li>Taler, skriver og læser dansk</li><li>Har kørekort og mulighed for at bruge egen bil i arbejdstiden</li><li>Kan arbejde selvstændigt og i teams</li><li>Bor i Nordsjælland</li><li>Sætter en ære i dit arbejde</li><li>Har mulighed for evt. nogle gange at kunne hjælpe til i weender og tidligt om morgen</li></ul><p>Vi tilbyder:</p><ul><li>En god løn</li><li>Et godt arbejdsmiljø</li><li>Et selvstændigt job</li><li>Deltid op til 30. timer pr. uge</li></ul><p>Det vil kun være et stort plus hvis du også kan pudse vinduer mv.</p>]]></Content></PositionFormattedDescription><WorkingLanguageCode listName='ISO-639-1/2-Languages' listVersionID='639-1:2002 Alpha 2' listURI='http://www.loc.gov' >da</WorkingLanguageCode><PositionPeriod><StartDate><FormattedDateTime>2018-08-29</FormattedDateTime></StartDate></PositionPeriod><ImmediateStartIndicator>false</ImmediateStartIndicator><PositionScheduleTypeCode listName='PositionScheduleCodeContentType' listSchemeURI='http://www.hr-xml.org/3 ../Developer/Common/CodeLists.xsd' listURI='http://www.hr-xml.org/' listVersionID='1.0' name='Full time name value'>PartTime</PositionScheduleTypeCode><ApplicationCloseDate>2018-08-28</ApplicationCloseDate><Attachment><ns2:EmbeddedData mimeCode='image/jpeg' encodingCode='base64Binary'>iVBORw0KGgoAAAANSUhEUgAAAEgAAAAwCAYAAACynDzrAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAJfSURBVGhD7ZfBTcQwEEW3C5rhSgkcaQBBIVw4bgGUgkQvVMB10Tt8NBpNYpTMOGbx4WkTx+zaz9/jcLq5O18my0xBDaagBsMJenq5D9uPYihBD4/Pl/ePU/jsKIYQhBjJ+fo8/dxD1Ne3VdJV0OvbbbiFaEeMBVmRDJ75tkq6CmJyyIieIc4KivogjGc9U1QuSJPy+FrjU7T2TCzJzqRbglRfICrEdksxcZ8SL7pXig4RtGXl/4UgPplYlKAWSJVYey2qhJUIouD2fuEjVVH7XkoEkZAtKdmKtl9FitIEaZARVfFnm0W/57ffHtITZItxjxT5hcne2n9eEFhB2WlNF6RBamWjPpmQmLXTbS8lRfqamIIapAoi3lUn1m/JHkOqIGpO7xdED2PIrEO7BbFanFb+9Op1gkHlGFISpBPLDi7qV0nVGNK2mF29o7aZHUPWNksTxKBYRQZ2RIJAY2CBhkoQg1q7P4KsMaQl6FopEcTq9U5RVd0rEUQdynwX+Q3Un6h9L2mCSIzE2JMEqtKkf1T1mxRm3Uf9t5CaIA3UkjlYD+Lt0S4yFyR9i1lJlXIsVXIgXRAraon6ZIIQLQaf2cW6JEHRNTCZvSvsBXBvv3N4QWsgbO+2IyVRexXlglhdiVGd0H2UpigBtNnv0DX4vtl0SZAmZokmh7Cobqndf0ckOJtuW8xK8nKYKKiP7r0A/T3Y9kq6CWJSS6cbW8hOXlhBXNMmidnFeImuCYquhQQI/xwhEsbn1QlqoRSp1kR9jmAYQaRKCUFWr4S0GEbQqExBDaagBlNQgylolfPlG5oh+gX0qmTLAAAAAElFTkSuQmCC</ns2:EmbeddedData><ns2:FileType listName='EURES_FileTypeCode' listVersionID='1.0' name='photo' listURI='https://ec.europa.eu/eures' >photo</ns2:FileType><Instructions>CompanyLogo</Instructions></Attachment></PositionProfile></PositionOpening>"
}

Opdater jobannonce

POST til https://euresservice.jobnet.dk/jvs/1234

Request body
{
	"status":"ACTIVE",
	"document": "<?xml version='1.0' encoding='UTF-8'?><PositionOpening xmlns='http://www.hr-xml.org/3' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns2='http://www.openapplications.org/oagis/9' majorVersionID='3' minorVersionID='2' xsi:schemaLocation='http://www.hr-xml.org/3 file:///C:/eures-xsd/HR-XML-3_2-Recruiting/org_hr-xml/3_2/Developer/Nouns/PositionOpening.xsd'><DocumentID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI=''>1234567</DocumentID><PositionOpeningStatusCode>Active</PositionOpeningStatusCode><PostingRequester><PartyID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI='http://ec.europa.eu/eures/standards/2014/DOC/Data/ID' >DK123</PartyID><PartyName>Danmark123</PartyName></PostingRequester><PositionProfile languageCode='da'><PostingInstruction><ApplicationMethod><Instructions languageID='dk'>Send ansøgning på en af de angivne kommunikationskanaler</Instructions><PersonContact><PersonName xmlns:oa='http://www.openapplications.org/oagis/9' ><oa:GivenName>Jens</oa:GivenName><FamilyName>Jensen</FamilyName></PersonName><Communication><ChannelCode>Email</ChannelCode><ns2:URI>jens.jensen@virksomheden.dk</ns2:URI></Communication><Communication><Address><ns2:BuildingNumber>13</ns2:BuildingNumber><ns2:StreetName>Perssonsgade</ns2:StreetName><ns2:CityName>Frederiksværk</ns2:CityName><CountryCode listName='Countries' listVersionID='3166-1-alpha-2' listURI='http://ec.europa.eu/esco/ConceptScheme/country' >DK</CountryCode><ns2:PostalCode>3300</ns2:PostalCode></Address></Communication></PersonContact></ApplicationMethod></PostingInstruction><PositionTitle languageID='DK'>virksomheden.dk søger ny medarbejder</PositionTitle><PositionLocation><Address><CountryCode listName='EURES_MemberCountries' listURI='http://www.iso.org/iso/' listVersionID='3166-1-alpha-2'>DK</CountryCode></Address></PositionLocation><PositionOrganization><OrganizationIdentifiers><OrganizationName>virksomheden.dk</OrganizationName><OrganizationLegalID schemeID='DK-001' schemeAgencyID='https://erhvervsstyrelsen.dk' schemeAgencyName='Erhvervsstyrelsen' schemeVersionID='DK-001' schemeDataURI=''>12345678</OrganizationLegalID></OrganizationIdentifiers><IndustryCode listName='NACE_r2' listURI='http://ec.europa.eu/esco/ConceptScheme/NACErev2/cs' listVersionID=''>N81.2.1</IndustryCode></PositionOrganization><PositionOpenQuantity>1</PositionOpenQuantity><JobCategoryCode listName='ISCO2008' listURI='http://ec.europa.eu/esco/ConceptScheme/ISCO2008' listVersionID='2008'>9112</JobCategoryCode><PositionOfferingTypeCode>DirectHire</PositionOfferingTypeCode><PositionFormattedDescription><Content languageID='DK'><![CDATA[<p>Vi er et lille firma i stor udvikling og søger derfor em ny medarbejder på deltid - op til 30 timer pr. uge. Rebngøringen foregår primart i private hjem. Du skal bo i Nordsjælland og vi starter kl 8.00 hos den første kunde.</p><p> </p><p>Vi forventer at du:</p><ul><li>Er serviceminded og flexibel</li><li>Er mødestabil og kvalitetsbevist</li><li>Er præsentabel</li><li>Taler, skriver og læser dansk</li><li>Har kørekort og mulighed for at bruge egen bil i arbejdstiden</li><li>Kan arbejde selvstændigt og i teams</li><li>Bor i Nordsjælland</li><li>Sætter en ære i dit arbejde</li><li>Har mulighed for evt. nogle gange at kunne hjælpe til i weender og tidligt om morgen</li></ul><p>Vi tilbyder:</p><ul><li>En god løn</li><li>Et godt arbejdsmiljø</li><li>Et selvstændigt job</li><li>Deltid op til 30. timer pr. uge</li></ul><p>Det vil kun være et stort plus hvis du også kan pudse vinduer mv.</p>]]></Content></PositionFormattedDescription><WorkingLanguageCode listName='ISO-639-1/2-Languages' listVersionID='639-1:2002 Alpha 2' listURI='http://www.loc.gov' >da</WorkingLanguageCode><PositionPeriod><StartDate><FormattedDateTime>2018-08-29</FormattedDateTime></StartDate></PositionPeriod><ImmediateStartIndicator>false</ImmediateStartIndicator><PositionScheduleTypeCode listName='PositionScheduleCodeContentType' listSchemeURI='http://www.hr-xml.org/3 ../Developer/Common/CodeLists.xsd' listURI='http://www.hr-xml.org/' listVersionID='1.0' name='Full time name value'>PartTime</PositionScheduleTypeCode><ApplicationCloseDate>2018-08-28</ApplicationCloseDate><Attachment><ns2:EmbeddedData mimeCode='image/jpeg' encodingCode='base64Binary'>iVBORw0KGgoAAAANSUhEUgAAAEgAAAAwCAYAAACynDzrAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAJfSURBVGhD7ZfBTcQwEEW3C5rhSgkcaQBBIVw4bgGUgkQvVMB10Tt8NBpNYpTMOGbx4WkTx+zaz9/jcLq5O18my0xBDaagBsMJenq5D9uPYihBD4/Pl/ePU/jsKIYQhBjJ+fo8/dxD1Ne3VdJV0OvbbbiFaEeMBVmRDJ75tkq6CmJyyIieIc4KivogjGc9U1QuSJPy+FrjU7T2TCzJzqRbglRfICrEdksxcZ8SL7pXig4RtGXl/4UgPplYlKAWSJVYey2qhJUIouD2fuEjVVH7XkoEkZAtKdmKtl9FitIEaZARVfFnm0W/57ffHtITZItxjxT5hcne2n9eEFhB2WlNF6RBamWjPpmQmLXTbS8lRfqamIIapAoi3lUn1m/JHkOqIGpO7xdED2PIrEO7BbFanFb+9Op1gkHlGFISpBPLDi7qV0nVGNK2mF29o7aZHUPWNksTxKBYRQZ2RIJAY2CBhkoQg1q7P4KsMaQl6FopEcTq9U5RVd0rEUQdynwX+Q3Un6h9L2mCSIzE2JMEqtKkf1T1mxRm3Uf9t5CaIA3UkjlYD+Lt0S4yFyR9i1lJlXIsVXIgXRAraon6ZIIQLQaf2cW6JEHRNTCZvSvsBXBvv3N4QWsgbO+2IyVRexXlglhdiVGd0H2UpigBtNnv0DX4vtl0SZAmZokmh7Cobqndf0ckOJtuW8xK8nKYKKiP7r0A/T3Y9kq6CWJSS6cbW8hOXlhBXNMmidnFeImuCYquhQQI/xwhEsbn1QlqoRSp1kR9jmAYQaRKCUFWr4S0GEbQqExBDaagBlNQgylolfPlG5oh+gX0qmTLAAAAAElFTkSuQmCC</ns2:EmbeddedData><ns2:FileType listName='EURES_FileTypeCode' listVersionID='1.0' name='photo' listURI='https://ec.europa.eu/eures' >photo</ns2:FileType><Instructions>CompanyLogo</Instructions></Attachment></PositionProfile></PositionOpening>"
}

Luk jobannonce

POST til https://euresservice.jobnet.dk/jvs/1234

Request body
{
	"status":"CLOSED"
}

Hent oversigt over jobannoncer

GET til https://euresservice.jobnet.dk/jvs

Hent jobannonce

GET til https://euresservice.jobnet.dk/jvs/1234


CV

Eksempel på XML dokument med CV indsendt af aktøren "Danmark123" med kontonavn "DK123" og dokument ID = "1234567":


SOAP UI eksempel på 

  • Indsend CV
  • Opdater CV
  • Luk CV
  • Hent oversigt over CV'er
  • Hent CV

Indsend CV

POST til https://euresservice.jobnet.dk/jsps

Request body
{
	"id":"1234",
	"document": "<?xml version='1.0' encoding='UTF-8'?><Candidate xmlns='http://www.hr-xml.org/3' xmlns:oa='http://www.openapplications.org/oagis/9' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns2='http://www.openapplications.org/oagis/9' majorVersionID='3' minorVersionID='2' xsi:schemaLocation='http://www.hr-xml.org/3 file:///C:/eures-xsd/HR-XML-3_2-Recruiting/org_hr-xml/3_2/Developer/Nouns/Candidate.xsd'><DocumentID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI=''>1234567</DocumentID><ProcessingInformation><ProcessingInstructionCode>Candidate/CandidatePerson/PersonName</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/EmploymentHistory</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/CandidatePositionPreferences</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/EmploymentHistory/EmployerHistory/OrganizationName</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/PersonQualifications/PersonCompetency/CompetencyID[@schemeID='ISO-639-1/2-Languages']</ProcessingInstructionCode></ProcessingInformation><CandidateSupplier><PartyID schemeID='DK123' schemeAgencyID='EURES' schemeAgencyName='EURES' schemeVersionID='1.0' validFrom='2015-12-10'>DK123</PartyID><PartyName>Danmark123</PartyName><PersonContact><PersonName><ns2:GivenName>Jens</ns2:GivenName><FamilyName>Jensen</FamilyName></PersonName><Communication><ChannelCode listName='ChannelCodeContentType' listVersionID='1.0' listURI='http://www.hr-xml.org/' >Email</ChannelCode><UseCode listName='ContactUseCodeContentType' listURI='http://www.hr-xml.org/' listVersionID='1.0'>Business</UseCode><oa:URI>eures@danmark123.dk</oa:URI></Communication></PersonContact><CandidateSourceCode listName='CandidateSourceCodeType' listURI='http://www.hr-xml.org/' listVersionID='1.0'>StaffingAgency</CandidateSourceCode><PrecedenceCode>1</PrecedenceCode></CandidateSupplier><CandidatePerson><PersonName><oa:GivenName>Frits</oa:GivenName><FamilyName>Anna-Camille</FamilyName></PersonName><Communication><ChannelCode>Telephone</ChannelCode><ns2:DialNumber>12345678</ns2:DialNumber></Communication><Communication><ChannelCode>Email</ChannelCode><ns2:URI>Anna-Camille@frits.dk</ns2:URI></Communication><Communication><Address><ns2:AddressLine>Askelunden 4</ns2:AddressLine><ns2:CityName>Søndersø</ns2:CityName><CountryCode listName='Countries' listVersionID='3166-1-alpha-2' listURI='http://ec.europa.eu/esco/ConceptScheme/country' >DK</CountryCode><ns2:PostalCode>5471</ns2:PostalCode></Address></Communication><ResidencyCountryCode>DK</ResidencyCountryCode><NationalityCode>DK</NationalityCode><BirthDate>1993-03-23</BirthDate><GenderCode>NotKnown</GenderCode><PrimaryLanguageCode>da</PrimaryLanguageCode></CandidatePerson><CandidateProfile languageCode='da'><PersonAvailability><ImmediateStartIndicator>true</ImmediateStartIndicator></PersonAvailability><ExecutiveSummary>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ExecutiveSummary><CandidatePositionPreferences><JobCategory><JobCategoryCode listName='ISCO2008' listURI='http://ec.europa.eu/esco/ConceptScheme/ISCO2008' listVersionID='2008' name='Business and administration professionals'>2141</JobCategoryCode><ns2:Description>maskiningeniør</ns2:Description></JobCategory></CandidatePositionPreferences><EmploymentHistory><EmployerHistory><OrganizationName>Arbejdsgiver</OrganizationName><EmploymentPeriod><StartDate><FormattedDateTime>2014-09</FormattedDateTime></StartDate><EndDate><FormattedDateTime>2015-03</FormattedDateTime></EndDate></EmploymentPeriod><PositionHistory><PositionTitle>Internship</PositionTitle><ns2:Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ns2:Description></PositionHistory></EmployerHistory></EmploymentHistory><EducationHistory><EducationOrganizationAttendance><OrganizationName>Skole</OrganizationName><ProgramName>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ProgramName><EducationLevelCode listName='EURES_ISCEDEducationLevel' listURI='https://ec.europa.eu/eures' listVersionID='2011'>6</EducationLevelCode><AttendancePeriod><StartDate><FormattedDateTime>2012-09</FormattedDateTime></StartDate><EndDate><FormattedDateTime>2016-01</FormattedDateTime></EndDate></AttendancePeriod></EducationOrganizationAttendance></EducationHistory><PersonQualifications><PersonCompetency><CompetencyID schemeID='ISO-639-1/2-Languages'>en</CompetencyID><TaxonomyID>language</TaxonomyID><ProficiencyLevel><ScoreText>C1</ScoreText></ProficiencyLevel></PersonCompetency><PersonCompetency><CompetencyID schemeID='ISO-639-1/2-Languages'>ar</CompetencyID><TaxonomyID>language</TaxonomyID><ProficiencyLevel><ScoreText>C2</ScoreText></ProficiencyLevel></PersonCompetency></PersonQualifications></CandidateProfile></Candidate>"
}

Opdater CV

POST til https://euresservice.jobnet.dk/jsps/1234

Request body
{
	"status":"ACTIVE",
	"document": "<?xml version='1.0' encoding='UTF-8'?><Candidate xmlns='http://www.hr-xml.org/3' xmlns:oa='http://www.openapplications.org/oagis/9' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns2='http://www.openapplications.org/oagis/9' majorVersionID='3' minorVersionID='2' xsi:schemaLocation='http://www.hr-xml.org/3 file:///C:/eures-xsd/HR-XML-3_2-Recruiting/org_hr-xml/3_2/Developer/Nouns/Candidate.xsd'><DocumentID schemeID='DK-001' schemeAgencyID='STAR.DK' schemeAgencyName='star.dk' schemeVersionID='1.0' schemeDataURI=''>1234567</DocumentID><ProcessingInformation><ProcessingInstructionCode>Candidate/CandidatePerson/PersonName</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/EmploymentHistory</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/CandidatePositionPreferences</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/EmploymentHistory/EmployerHistory/OrganizationName</ProcessingInstructionCode><ProcessingInstructionCode>Candidate/CandidateProfile/PersonQualifications/PersonCompetency/CompetencyID[@schemeID='ISO-639-1/2-Languages']</ProcessingInstructionCode></ProcessingInformation><CandidateSupplier><PartyID schemeID='DK123' schemeAgencyID='EURES' schemeAgencyName='EURES' schemeVersionID='1.0' validFrom='2015-12-10'>DK123</PartyID><PartyName>Danmark123</PartyName><PersonContact><PersonName><ns2:GivenName>Jens</ns2:GivenName><FamilyName>Jensen</FamilyName></PersonName><Communication><ChannelCode listName='ChannelCodeContentType' listVersionID='1.0' listURI='http://www.hr-xml.org/' >Email</ChannelCode><UseCode listName='ContactUseCodeContentType' listURI='http://www.hr-xml.org/' listVersionID='1.0'>Business</UseCode><oa:URI>eures@danmark123.dk</oa:URI></Communication></PersonContact><CandidateSourceCode listName='CandidateSourceCodeType' listURI='http://www.hr-xml.org/' listVersionID='1.0'>StaffingAgency</CandidateSourceCode><PrecedenceCode>1</PrecedenceCode></CandidateSupplier><CandidatePerson><PersonName><oa:GivenName>Frits</oa:GivenName><FamilyName>Anna-Camille</FamilyName></PersonName><Communication><ChannelCode>Telephone</ChannelCode><ns2:DialNumber>12345678</ns2:DialNumber></Communication><Communication><ChannelCode>Email</ChannelCode><ns2:URI>Anna-Camille@frits.dk</ns2:URI></Communication><Communication><Address><ns2:AddressLine>Askelunden 4</ns2:AddressLine><ns2:CityName>Søndersø</ns2:CityName><CountryCode listName='Countries' listVersionID='3166-1-alpha-2' listURI='http://ec.europa.eu/esco/ConceptScheme/country' >DK</CountryCode><ns2:PostalCode>5471</ns2:PostalCode></Address></Communication><ResidencyCountryCode>DK</ResidencyCountryCode><NationalityCode>DK</NationalityCode><BirthDate>1993-03-23</BirthDate><GenderCode>NotKnown</GenderCode><PrimaryLanguageCode>da</PrimaryLanguageCode></CandidatePerson><CandidateProfile languageCode='da'><PersonAvailability><ImmediateStartIndicator>true</ImmediateStartIndicator></PersonAvailability><ExecutiveSummary>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ExecutiveSummary><CandidatePositionPreferences><JobCategory><JobCategoryCode listName='ISCO2008' listURI='http://ec.europa.eu/esco/ConceptScheme/ISCO2008' listVersionID='2008' name='Business and administration professionals'>2141</JobCategoryCode><ns2:Description>maskiningeniør</ns2:Description></JobCategory></CandidatePositionPreferences><EmploymentHistory><EmployerHistory><OrganizationName>Arbejdsgiver</OrganizationName><EmploymentPeriod><StartDate><FormattedDateTime>2014-09</FormattedDateTime></StartDate><EndDate><FormattedDateTime>2015-03</FormattedDateTime></EndDate></EmploymentPeriod><PositionHistory><PositionTitle>Internship</PositionTitle><ns2:Description>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ns2:Description></PositionHistory></EmployerHistory></EmploymentHistory><EducationHistory><EducationOrganizationAttendance><OrganizationName>Skole</OrganizationName><ProgramName>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</ProgramName><EducationLevelCode listName='EURES_ISCEDEducationLevel' listURI='https://ec.europa.eu/eures' listVersionID='2011'>6</EducationLevelCode><AttendancePeriod><StartDate><FormattedDateTime>2012-09</FormattedDateTime></StartDate><EndDate><FormattedDateTime>2016-01</FormattedDateTime></EndDate></AttendancePeriod></EducationOrganizationAttendance></EducationHistory><PersonQualifications><PersonCompetency><CompetencyID schemeID='ISO-639-1/2-Languages'>en</CompetencyID><TaxonomyID>language</TaxonomyID><ProficiencyLevel><ScoreText>C1</ScoreText></ProficiencyLevel></PersonCompetency><PersonCompetency><CompetencyID schemeID='ISO-639-1/2-Languages'>ar</CompetencyID><TaxonomyID>language</TaxonomyID><ProficiencyLevel><ScoreText>C2</ScoreText></ProficiencyLevel></PersonCompetency></PersonQualifications></CandidateProfile></Candidate>"
}

Luk CV

POST til https://euresservice.jobnet.dk/jsps/1234

Request body
{
	"status":"CLOSED"
}

Hent oversigt over CV'er

GET til https://euresservice.jobnet.dk/jsps

Hent CV

GET til https://euresservice.jobnet.dk/jsps/1234

Proceskrav for CV'er

Der er en række krav, som skal opfyldes før at aktøren må sende borgeres CV'er til EURES:

  1. Borgerne skal give samtykke til at deres CV sendes til EURES portalen før at deres CV'er må sendes til EURES.
  2. Borgerne skal have en fyldestgørende vejledning i forbindelse med at de afgiver samtykke
  3. Borgerne skal kunne angive om, og i givet fald hvilke, dele af deres CV skal skjules for arbejdsgivere på EURES

<TO DO: Reference til uddybende vejledning fra STAR>

Aktøren skal beskrive hvordan disse krav opfyldes i forbindelse med godkendelsesprocessen og STAR skal godkende de implementerede løsninger inden STAR vil tillade, at aktøren sender CV'er til EURES portalen via NDCP.

Aktøren skal specificere skjulte felter jf. "XML specifikationer for EURES CV'er". 

Procedure for tilslutning til EURES NDCP

Tilslutning til EURES NDCP består af følgende trin:

  1. Anmodning om tilslutning til EURES NDCP
  2. Underskrift af tilslutningsaftale
  3. Udvikling af XML dokumenter for jobannoncer og/eller CV'er
  4. Godkendelse af XML dokumenter med jobannoncer og/eller CV'er 
  5. Udvikling af integration til EURES NDCP webservice 
  6. Godkendelse af integration til EURES NDCP webservice
  7. Godkendelse af proceskrav for CV'er
  8. Tilslutning til produktionsmiljø
  9. Drift, herunder løbende vedligeholdelse

Hvert af disse trin beskrives i det følgende.

Anmodning om tilslutning til EURES NDCP

Første trin er at anmode om tilslutning til EURES NDCP. Det gøres ved at kontakte:

Styrelsen for Arbejdsmarked og Rekruttering - STAR

Vermundsgadee 38 · 2100 København Ø

Telefon: 70 25 87 25

E-mail: virksomhedssupport@star.dk

Følgende oplysninger skal leveres til STAR:

  • Virksomhedens navn
  • Virksomhedens CVR-nummer
  • Virksomhedens P-Nummer som annoncer/CV'er skal indsendes fra
  • Kontaktperson: Navn, e-mail og telefonnummer
  • Ønsker virksomheden at sende jobannoncer til EURES (ja/nej)?
  • Ønsker virksomheden at sende CV'er til EURES (ja/nej)?

STAR vil herefter fremsende en tilslutningsaftale, som skal accepteres af aktøren.

Underskrift af tilslutningsaftale

Når STAR har modtaget den underskrevne tilslutningsaftale, fremsender STAR  kontonavn og password til EURES NDCP testmiljøet, som aktøren kan anvende til at udvikle og teste integrationen.

Udvikling af XML dokumenter for jobannoncer og/eller CV'er

Aktøren udvikler herefter konstruktion af XML dokumenterne for jobannoncer og/eller CV'er.

Aktøren kan anvende dokumentationen i denne vejledning til at udvikle konstruktion af XML dokumenterne.

Godkendelse af XML dokumenter med jobannoncer og/eller CV'er 

Aktøren skal sikre, at XML dokumenterne kan valideres med EURES XML valideringsværktøjet, som er beskrevet på denne side. STAR kontaktes når alle varianter af XML dokumenterne kan valideres uden fejl. STAR modtager eksempler på XML dokumenterne fra aktøren og efter verifikation åbner STAR for adgangen til EURES NDC i testmiljøet.

Udvikling af integration til EURES NDCP webservice 

Aktøren udvikler herefter integrationen til EURES NDCP webservice med anvendelse af dokumentationen i denne vejledning.

Følgende scenarier skal udvikles og testes for hhv. jobannoncer og CV'er, afhængig af hvilket dokumenttyper, som aktøren ønsker at sende til EURES NCDP:

  • Indsend dokument
  • Opdater dokument
  • Luk dokument

Aktøren kan valgfrit vælge at udvikle og teste:

  • Hent oversigt
  • Hent dokument

Godkendelse af integration til EURES NDCP webservice

Når scenarierne er testet af aktøren, fremsender aktøren dokumentation for den gennemførte test til STAR, hvorefter STAR vil validere, at dokumenterne fremsendes korrekt til EURES portalen. Når STAR har valideret at dokumenterne modtages og præsenteres korrekt på EURES portalen, vil STAR godkende integrationstesten.

Godkendelse af proceskrav for CV'er

Aktøren skal fremsende dokumentation for at proceskrav for CV'er er implementeret korrekt til STAR. STAR vil herefter validere og godkende opfyldelse af proceskravene.

Tilslutning til produktionsmiljø

Aktøren kan nu begynde at sende jobannoncer og CV'er til EURES portalen via EURES NDCP. Aktøren bør følge op på forsendelserne og på korrekt præsentation på EURES portalen i en periode.

Drift, herunder løbende vedligeholdelse

Aktøren behandler løbende henvendelser fra STAR jf. tilslutningsaftalen. Aktøren kan tilsvarende sende observationer til STAR jf. tilslutningsaftalen. Aktøren tilpasser systemerne til varslede ændringer jf. varslingsfrister.





Tilgængelighed: https://starwiki.atlassian.net/was