Endpoints

You can make requests to the following REST endpoints

You must use an installation access token to access endpoints using the REST API. For more information, see "Authentication".

Access

All API access is over HTTPS, and accessed from:

HTTPS https://api.carrierebus.nl/

All data is sent and received as JSON

Jobs

• get /jobs/{reference}
• post /jobs/create
• post /jobs/update
• post /jobs/expire

Retrieve a job-posting

Use this endpoint to retrieve a specific job posting data from your organisation.

Note: Only job openings from your organisation which has been posted via the JOB API can be retrieved.

GET /jobs/{reference}

Parameters

Default response

Status: 200 OK

{
    "reference": "VDL1607201",
    "employmentType": [
        "FULL_TIME"
    ],
    "salary": {
        "unitText": "YEAR",
        "currency": "EUR",
        "minimumSalary": 58709,
        "maximumSalary": 83870
    },
    "jobFunction": "Sales Engineer",
    "description": "<p>Samen met het salesteam ben je verantwoordelijk voor het gehele verkooptraject van engineering, advies, offerteopbouw en offerteopvolging. De functie biedt veel mogelijkheden voor eigen initiatief. Zo stel je onder andere gezamenlijk het verkoopplan en acties op. Kom jij ons team versterken?</p><h2>Sales Engineer</h2><h3>De functie</h3><p>Als engineer werk je bij VDL Klima in een team van tien enthousiaste en flexibele collega’s. Het productenpakket bestaat hoofdzakelijk uit lucht/lucht en lucht/water koelers, boxcoolers en buizenwarmtewisselaars en ventilatiesystemen voor diverse applicaties, zoals (elektrische) voorstuwingsystemen, energiegeneratoren en transformatoren. Een greep uit jouw werkzaamheden:</p><p>Je hebt het eerste aanspreekpunt voor de klanten als het gaat om projectaanvragen en vraagstukken omtrent diverse technische componenten uit ons productenpakket.&nbsp;</p><p>Het actief aanbieden van oplossingen, servicediensten en technische adviezen aan klanten, op zodanige wijze dat een goede relatie met de klanten blijft bestaan en wordt verdiept op technisch gebied.</p><p>Verder stel je in overleg met de accountmanager offertes samen, werk je deze vervolgens uit en bewaak je samen met collega’s van de binnendienst de lopende offertes.</p><h3>Jouw kwaliteiten</h3><ul><li>Je hebt een afgerond diploma hbo werktuigbouwkunde of vergelijkbaar.</li><li>Je hebt minimaal 3-5 jaar relevante werkervaring</li><li>Je signaleert ontwikkelingen in je vakgebied en bent initiatiefrijk.</li><li>Goede communicatieve en sociale vaardigheden.</li><li>De beheersing van de Engelse taal is een pré.</li></ul><h3>Wat bieden wij?</h3><ul><li>een marktconform salaris&nbsp;</li><li>winstdeling&nbsp;</li><li>27 vakantiedagen en 13 ADV dagen (bij fulltime dienstverband)</li><li>een goede pensioenregeling&nbsp;</li><li>PC privé plan + fietsplan&nbsp;</li><li>volop persoonlijke ontwikkeling door middel van trainingen en opleidingen&nbsp;</li><li>een jaarlijks VDL-feest met alle collega’s van VDL Groep&nbsp;</li><li>interne doorgroeimogelijkheden&nbsp;</li><li>diverse collectiviteitsregelingen&nbsp;</li><li>personeelsaanbiedingen&nbsp;</li><li>deelname aan sportactiviteiten</li></ul><h3>Solliciteren?</h3><p>Is je interesse gewekt en herken je jezelf in bovenstaand profiel? Solliciteer dan via de ‘Solliciteer’ knop. Gelieve een CV en beknopte motivatie toe te voegen waarom jij denkt dat deze rol op je lijf is geschreven.Acquisitie naar aanleiding van deze vacature wordt niet op prijs gesteld. Wij verzoeken kandidaten om rechtstreeks te solliciteren bij VDL Klima en wensen deze vacature niet in te vullen middels een tussenkomst van een uitzend-, detacherings- of werving &amp; selectiebureau.</p><h3>Het bedrijf</h3><p>Hou jij van technische uitdagingen?<br></p><p>Bij VDL Klima werk je mee aan de ontwikkeling en productie van warmtewisselaars en industriele ventilatiesystemen van onder andere cruiseschepen en windmolens. Daarnaast produceren wij voor toepassingen als generatoren, transformatoren, omvormers en voortstuwingssystemen. Dat doen we voor klanten in uiteenlopende industrieen van landbouw tot aan scheepsvaart en maritieme industrie, energieopwekking en de semiconductor industrie. Op onze eigen R-D-afdeling worden de systemen ontwikkeld en direct door onze vakmensen geproduceerd. En dat alles onder één dak in onze vestiging in Eindhoven. Beschik jij over een hoge mate van zelfstandigheid en werk jij graag in een technisch en internationaal georienteerd bedrijf met een informeel karakter? Wij bieden je uitdagingen op allerlei niveaus. </p><p>Word jij onze nieuwe collega?</p>",
    "datePosted": "2020-07-15T00:00:00+02:00",
    "validThrough": "2020-09-15T00:00:00+02:00",
    "urlToApply": "https://www.werkenbijvdl.nl/vacature-solliciteren/4346",
    "company": {},
    "salary": {},
    "siteListing": {
        "baitTitle": "Sales Engineer",
        "baitText": "<p>Samen met het salesteam ben je verantwoordelijk voor het gehele verkooptraject van engineering, advies, offerteopbouw en offerteopvolging.</p>",
        "image": "/content/images/carrierebus/job-bg.jpg"
    },
    "data": {
        "workExperience": {
            "min": 3,
            "max": 5
        },
        "workHours": {
            "min": 36
        }
        "responsibilities": "<h3>Jouw werkzaamheden</h3><ul><li>Eerste aanspreekpunt voor de klanten omtrent projectaanvragen en vraagstukken</li><li>Het actief aanbieden van oplossingen, servicediensten en technische adviezen aan klanten</li><li>Opbouwen van goede relatie met de klanten</li><li>Offertes samenstellen en uitwerken in overleg met de accountmanager</li><li>Bewaken van lopende offertes samen met collega’s van de binnendienst.</li></ul>",
        "qualitifications": "<h3>Jouw competenties</h3><ul><li>Goede communicatieve en sociale vaardigheden.</li><li>Je signaleert ontwikkelingen in je vakgebied en bent initiatiefrijk.</li><li>Je bent netwerkvaardig en weet hoe je klantrelaties kunt ontwikkelen en bestendigen</li></ul><div></div>",
        "requirements": "<h3>Jouw kwaliteiten</h3><ul><li>Je hebt een afgerond diploma hbo werktuigbouwkunde of vergelijkbaar.</li><li>Je hebt minimaal 3-5 jaar relevante werkervaring</li><li>De beheersing van de Engelse taal is een pré.</li></ul>",
        "fringeBenefits": "<h3>Wat bieden wij?</h3><ul><li>een marktconform salaris&nbsp;</li><li>winstdeling&nbsp;</li><li>27 vakantiedagen en 13 ADV dagen (bij fulltime dienstverband)</li><li>een goede pensioenregeling&nbsp;</li><li>PC privé plan + fietsplan&nbsp;</li><li>volop persoonlijke ontwikkeling door middel van trainingen en opleidingen&nbsp;</li><li>een jaarlijks VDL-feest met alle collega’s van VDL Groep&nbsp;</li><li>interne doorgroeimogelijkheden&nbsp;</li><li>diverse collectiviteitsregelingen&nbsp;</li><li>personeelsaanbiedingen&nbsp;</li><li>deelname aan sportactiviteiten</li></ul>"
    }
}

Create a job-posting

To create a new job posting, the reference of the job opening should not have been already created by the authenticated user.
All job postings needs to be approved by one of our employees, before they will appear online at one or more of our websites.

Note: If you have multiple jobs to post, please wait until the previous one has been accepted before you post a new one.

post /jobs/create

Parameters

Post sample

Body

{
    "reference": "2005020814",
    "employmentType": [
        "FULL_TIME",
        "PART_TIME"
    ],
    "jobFunction": "Network Manager Clearing",
    "description": "<p><strong>In short</strong></p>
<p>Responsible for creating and developing enterprise web-based software applications.<br/>
Applies expert knowledge on application development technologies and technical trends. 
Works on projects of high complexity within one or more development environments and on multiple programs/systems/applications as a senior project team member.
Additional responsibilities include leading development projects and delegating work to other team members..</p>",
    "datePosted": "2020-04-22T17:27:00+02:00",
    "validThrough": "2020-07-22T00:00:00+02:00",
    "urlToApply": "https://your-job-url.com/path-to-the-job-posting",
    "company": {
        "name": "My company name",
        "logoUrl": "https://your-job-url.com/path-to-your-logo"
    },
    "salary": {
        "unitText": "YEAR",
        "currency": "EUR",
        "minimumSalary": 58709,
        "maximumSalary": 83870
    },
    "siteListing": {
        "baitTitle": "Network Manager Clearing",
        "baitText": "<p>Can you manage the relationships with and the performance of our international service providers and counterparties?</p>",
        "image": "/content/images/carrierebus/job-bg.jpg"
    },
    "data": {
        "educationLevel": [],
        "workHours": {
            "min": 36
        }
    }
}

Default response

Status: 202 Accepted

Update an job-posting

To edit a job posting, the authenticated user must be the owner of the job-posting.
Only fields that are includes in your job-object will be updated. If you want to remove an value of a certain field, you need to include the field and pass the default value for that field.
Updates needs to be approved by one of our employees, before the changes will be visible online.

Note: the value for reference cannot be updates. 

post /jobs/update

Parameters

Post sample

Body

{
    "reference": "2005020814",
    "salary": {
        "unitText": "YEAR",
        "currency": "EUR",
        "minimumSalary": 58709,
        "maximumSalary": 83870
    },
    "siteListing": {
        "baitTitle": "Network Manager Clearing",
        "baitText": "<p>Can you manage the relationships with and the performance of our international service providers and counterparties?</p>",
        "image": "/content/images/carrierebus/job-bg.jpg"
    },
    "data": {
        "educationLevel": [],
        "workHours": {
            "min": 36
        }
    }
}

Default response

Status: 202 Accepted

Taking an online job-posting offline

Forces a specific job-posting from your organization to be set offline on a particular date and time. You can also use this endpoint to directly remove the job posting if the post has been fullfilled and does no longer exists.

You must authenticate using the Bearer token to use this endpoint.

post /jobs/expire

Parameters

Post sample

Body

{
  "reference": '2005020014',
  "validThrough": '2020-07-22T00:00:00+02:00'
}

Default response

Status: 202 Accepted