Developer Hub » Vacatures plaatsen via XML » Documentatie » Uitleg XML-schema

Stap 1: Algemene informatie · Stap 2: Uitleg XML-schema · Stap 3: Validatie · Stap 4: Aanmelden

Uitleg XML-schema

Om te beginnen kun je een voorbeeld downloaden. Hopelijk wordt het snel duidelijk waar je welke gegevens moet invullen. Toch gaan we uitgebreid elk element bespreken en uitleggen hoe je het hoort te gebruiken. Je kunt ook altijd het XML-schema (XSD) downloaden.

Met PHP, Java of een andere programmeertaal is het mogelijk om een XML-document te genereren. Bekijk eens het PHP-voorbeeld.

Verplichte velden

Slechts enkele elementen zijn verplicht in te vullen. Als een element verplicht is, staat dit aangegeven bij het betreffende element.

Alle velden uitgelegd

Ieder XML-bestand begint als volgt. Zorg ervoor dat je de juiste encoding invult.

<?xml version="1.0" encoding="UTF-8" ?>

jobs verplicht

Dit hoofdelement bevat de lijst met alle vacatures. Het is erg belangrijk om de correcte versie in te vullen. Momenteel wordt alleen gebruik gemaakt van versie 1.0.

<jobs version="1.0">

job verplicht

Dit subelement van jobs definieert één enkele vacature. jobs bevat net zoveel job-elementen als dat er vacatures zijn.

<jobs version="1.0">
    <job>(...)</job>
    <job>(...)</job>
</jobs>

Hieronder staan de elementen die binnen job geplaatst dienen te worden.

jobId verplicht

Hier moet een uniek id voor iedere vacature worden ingevuld. Je kunt hier bijv. het id van de vacature in de database invullen of het vacaturenummer, zolang het maar uniek is. Voorkom dat id's in de toekomst worden hergebruikt.

<jobId>
  <![CDATA[
    6489
  ]]>
</jobId>

alternativeJobId

Soms zijn er voor een vacature meerdere id's (meestal voor verschillende systemen), of heb je een apart referentienummer. Dan kun je dat hier invullen.

<alternativeJobId>
  <![CDATA[
    TECH-076
  ]]>
</alternativeJobId>

jobAddedDate verplicht

De datum waarop de vacature is toegevoegd in jullie systeem. Gebruik het formaat YYYY-MM-DD.

<jobAddedDate>
  <![CDATA[
    2008-04-23
  ]]>
</jobAddedDate>

hotJob

Je kunt hotJob gebruiken als je een overeenkomst hebt met Uitzendbureau.nl voor topvacatures. Voor meer informatie over de mogelijkheden van topvacatures kun je contact opnemen met sales@uitzendbureau.nl, of bellen naar 085-4019579.

<hotJob>
  <![CDATA[
    false
  ]]>
</hotJob>

jobTitle verplicht

De titel van de vacature.

<jobTitle>
  <![CDATA[
    Automonteur
  ]]>
</jobTitle>

jobDescription verplicht xhtml

Een algemene beschrijving van de vacature. Informatie over bijv. de ervaring of het salaris kan bij andere velden worden ondergebracht.

<jobDescription>
  <![CDATA[
    1e automonteur met APK ervaring die zelfstandig kan werken.
  ]]>
</jobDescription>

jobLocation verplicht

<jobLocation>
  <locationPlace></locationPlace>
  <locationProvince></locationProvince>
  <locationZipCode></locationZipCode>
</jobLocation>

locationPlace verplicht

De standplaats van de vacature.

<jobLocation>
  <locationPlace>
    <![CDATA[
      Nijmegen
    ]]>
  </locationPlace>
</jobLocation>

locationProvince

De provincie van de vacature.

<jobLocation>
  <locationProvince>
    <![CDATA[
      Gelderland
    ]]>
  </locationProvince>
</jobLocation>

locationZipCode

(Optioneel, maar zeer aanbevolen)

De postcode van de vacature.

<jobLocation>
  <locationZipCode>
    <![CDATA[
      6538AB
    ]]>
  </locationZipCode>
</jobLocation>

jobCategory

De categorie waaronder deze vacature valt. Er kunnen meerdere categoriën worden ingevuld (gescheiden door willekeurige word boundaries), maar de vacature zal uiteindelijk maar aan één categorie worden toegewezen. Je kunt gewoon je eigen benamingen gebruiken voor de categoriën. Wij vertalen dit automatisch naar onze eigen categoriën.

Let op: dit veld is niet de branche. Een vacature voor een ICT'er bij een bank valt onder de categorie ICT, en niet onder financieel.

<jobCategory>
  <![CDATA[
    Techniek, productie
  ]]>
</jobCategory>

jobEducation

De gewenste vooropleiding(en) voor de functie.

<jobEducation>
  <![CDATA[
    LTS Motorvoertuigentechniek
  ]]>
</jobEducation>

jobUrl

De link naar de vacature op de website van het uitzendbureau.

<jobUrl>
  <![CDATA[
    https://www.mijnuitzendbureau.nl/vacature/6489-automonteur
  ]]>
</jobUrl>

jobOffer

Hieronder een voorbeeld van hoe het totaalplaatje eruit kan zien.

<jobOffer>
  <offerDescription>
    <![CDATA[
      Goede arbeidsvoorwaarden.
    ]]>
  </offerDescription>
  <offerContract>
    <contractType>
      <![CDATA[
        vrijwilligerswerk
      ]]>
    </contractType>
    <contractHours>
      <hoursType>
        <![CDATA[
          fulltime
        ]]>
      </hoursType>
      <hoursMin>
        <![CDATA[
          32
        ]]>
      </hoursMin>
      <hoursMax>
        <![CDATA[
          40
        ]]>
      </hoursMax>
      <hoursDescription>
        <![CDATA[
          32-40 uur
        ]]>
    </hoursDescription>
    </contractHours>
    <contractSalaryDescription>
      <![CDATA[
        Marktconform.
      ]]>
    </contractSalaryDescription>
    <contractDescription>
      <![CDATA[
        Wij bieden:
        <ul>
          <li>
            Een uitdagende baan;
          </li>
          <li>
            Een marktconform salaris.
          </li>
        </ul>
      ]]>
    </contractDescription>
  </offerContract>
</jobOffer>

offerDescription xhtml

Algemene informatie over wat de werkgever heeft te bieden.

offerContract

Feitelijk aanbod van de vacature.

contractType

Soort dienstverband. Kies hierbij uit de dienstverbanden op deze pagina. Je kunt er ook meerdere gebruiken, gescheiden door komma’s.

contractHours

Het aantal uren per week.

<contractHours>
  <hoursType>
    <![CDATA[
      fulltime
    ]]>
  </hoursType>
  <hoursMin>
    <![CDATA[
      32
    ]]>
  </hoursMin>
  <hoursMax>
    <![CDATA[
      40
    ]]>
  </hoursMax>
  <hoursDescription>
    <![CDATA[
      32-40 uur
    ]]>
  </hoursDescription>
</contractHours>
hoursType

Kies hierbij uit: parttime of fulltime.

hoursMin

Minimaal aantal uren per week.

hoursMax

Maximaal aantal uren per week.

hoursDescription

Als het niet mogelijk is om het aantal uren onder te brengen bij hoursMin en hoursMax, vul dan hier een algemene beschrijving in.

contractSalaryDescription xhtml

Omschrijving van het salarisaanbod.

contractDescription xhtml

Algemene omschrijving van het contract.

jobRequirements

Specifiekere informatie over de vereisten.

<jobRequirements>
    <requirementsDescription>
      <![CDATA[
        Je bent nauwkeurig, flexibel, en een echte
        teamplayer.
      ]]>
    </requirementsDescription>
  <requirementsExperience>
    <![CDATA[
      2 jaar ervaring in de auto- en elektrotechniek.
    ]]>
  </requirementsExperience>
  <requirementsCourses>
    <![CDATA[
      Je hebt de opleiding MTS werktuigbouwkunde,
      motorvoertuigentechniek of gelijkwaardig met
      succes afgerond.
    ]]>
  </requirementsCourses>
</jobRequirements>

requirementsDescription xhtml

Algemene omschrijving van de vereisten.

requirementsExperience xhtml

Omschrijving van de ervaringen die gewenst zijn.

requirementsCourses xhtml

Omschrijving van de opleidingen/cursussen die gewenst zijn.

jobEmployerInfo xhtml

Algemene informatie over de werkgever.

<jobEmployerInfo>
  <![CDATA[
    Onze klant is heeft zich ontwikkeld tot een
    gieterij met wereldwijd 1.000 projecten.
  ]]>
</jobEmployerInfo>

jobContact

Contactgegevens betreffende de vacature.

<jobContact>
  <contactName>
    <![CDATA[
      Jan Janssen
    ]]>
  </contactName>
  <contactAddress>
    <addressStreet>
      <![CDATA[
        Dorpsstraat 14
      ]]>
    </addressStreet>
    <addressZipcode>
      <![CDATA[
        1234 AB
      ]]>
    </addressZipcode>
    <addressPlace>
      <![CDATA[
        Arnhem
      ]]>
    </addressPlace>
  </contactAddress>
  <contactPhone>
    <![CDATA[
      0123-456789
    ]]>
  </contactPhone>
  <contactEmail>
    <![CDATA[
      jan.janssen@arnhemmail.nl
    ]]>
  </contactEmail>
  <contactUrl>
    <![CDATA[
      https://www.mijnuitzendbureau.nl/werknemers/jan.janssen
    ]]>
  </contactUrl>
  <applicationUrl>
    <![CDATA[
      https://www.mijnuitzendbureau.nl/vacature/123-automonteur/solliciteren
    ]]>
  </applicationUrl>
  <applicationUrlHotJob>
    <![CDATA[
      https://www.mijnuitzendbureau.nl/vacature/123-automonteur/solliciteren?topvacature=1
    ]]>
  </applicationUrlHotJob>
  <mandatoryMotivation>
    <![CDATA[
      true
    ]]>
  </mandatoryMotivation>
</jobContact>

De velden applicationUrl en applicationUrlHotJob worden alleen gebruikt bij overeenstemming met de accountmanager van Uitzendbureau.nl. Standaard worden sollicitaties verzonden naar het e-mailadres in contactEmail. applicationUrlHotJob (indien beschikbaar) wordt alleen gebruikt bij sollicitaties op topvacatures.

Het veld mandatoryMotivation geeft aan of gebruikers verplicht een motivatietekst moeten invullen bij een sollicitatie.

jobBranch

Beschrijving van de vestiging waar de vacature open staat.

<jobBranch>
  <branchName>
    <![CDATA[
      Mijn Uitzendbureau Amsterdam
    ]]>
  </branchName>
  <branchPlace>
    <![CDATA[
      Amsterdam
    ]]>
  </branchPlace>
</jobBranch>

branchName

Naam van de vestiging.

branchPlace

Plaats van de vestiging.

video

Op dit moment worden alleen video's van YouTube ondersteund. Mogelijk worden er later nog andere formaten toegevoegd.

<video>
  <jobDescription>
    <youtube>
      <![CDATA[
        9bZkp7q19f0
      ]]>
    </youtube>
  </jobDescription>
</video>

jobDescription

Binnen jobDescription plaats je een lijst met video's. Deze video's worden geplaatst bij de beschrijving van de vacature. Mogelijk worden er later nog andere locaties toegevoegd.

youtube

Je video moet al zijn toegevoegd aan YouTube, om deze toe te voegen aan de XML-feed. Vul het id in van de YouTube-video. Het id kun je uit de url van de video halen. https://www.youtube.com/watch?v=9bZkp7q19f0 heeft bijvoorbeeld id 9bZkp7q19f0.

applicationMethods

Momenteel is alleen WhatsApp beschikbaar. Andere formaten kunnen later worden toegevoegd. Let op: dit werkt als een extra sollicitatiemethode - de onsite en offsite sollicitatiemethodes blijven aanwezig, ongeacht mobiele sollicitaties.

<applicationMethods>
  <whatsapp>
    <phone>
      <![CDATA[
        +31613223245
      ]]>
    </phone>
  </whatsapp>
</applicationMethods>

whatsapp

Hier kunt u informatie verstrekken voor whatsapply.

number

Whatsapp-contactnummer. Het telefoonnummer mag alleen in internationaal formaat worden opgegeven (wat betekent dat u ook de landcode +31 moet opgeven). We accepteren alleen waarden in dit patroon \s*\+[0-9\-()\s]+.

Heb je de XML-feed af?

Controleer hem dan op fouten.