Vacature data feed
Vacature data feed
De vanuit RecruitNow Cockpit gepubliceerde vacatures worden ontsloten middels een data feed. Deze data feed bevat alle beschikbare informatie met betrekking tot het het adverteren van de vacatures op de website. De feed bevat gegevens over de volgende onderdelen:
- Vacature metadata;
- Omschrijvingen
- Kenmerken/facetten;
- Sollicitatie informatie;
- Standplaats;
- Salaris;
- Verantwoordelijke recruiter;
- Verantwoordelijke vestiging;
- De opdrachtgever;
Data formaat en url
De feed is beschikbaar als JSON data en XML data. Standaard wordt XML data beschikbaar gesteld. Indien JSON gewenst is, kan dit opgegeven worden middels een url parameter.
https://jobsite-<customer>.recruitnow.nl/api/vacancies/feed/website SBE klanten: https://<customer>.recruitnowcockpit.nl/jobsite/api/vacancies/feed/website
https://jobsite-<customer>.recruitnow.nl/api/vacancies/feed/website?type=json SBE klanten: https://<customer>.recruitnowcockpit.nl/jobsite/api/vacancies/feed/website?type=json
De daadwerkelijke url's voor de test/acceptatie en productie omgevingen worden door RecruitNow beschikbaar gesteld op het moment dat de eerste Cockpit testomgeving beschikbaar wordt gesteld.
Verversingssnelheid
Na het opvragen van de data feed wordt deze 5 minuten gecached door RecruitNow. Het advies is daarom om de feed niet vaker dan eens in de 5 minuten op te vragen, aangezien er anders geen gewijzigde gegevens zullen zijn.
Let op: Indien er 2 of minder publicaties op online staan zal de feed niet verversen. Je dient dus eerst 3 publicaties online te brengen voordat publicaties zichtbaar worden.
Inhoud van de feed
De feed bevat een volledige overzicht van alle vacatures die op het moment van opvragen gemarkeerd als 'gepubliceerd' zijn. Vacatures zijn gepubliceerd als ze aan de volgende uitgangspunten voldoen.
- De vacature is in Cockpit gemarkeerd als "Online" of "Open online" (deze waarde kan per klant afwijken);
- De publicatiedatum van de vacature is gepasseerd;
- De vervaldatum van de vacature is nog niet bereikt;
- Het maximum aantal toegestane sollicitaties op de vacature is nog niet bereikt;
Vacatures die niet (meer) gepubliceerd zijn worden uit de feed gehaald. Het is aan de website om vacatures die niet meer aanwezig zijn in de feed te depubliceren of te verwijderen.
Voorbeelden
| JSON | Een voorbeeld van de JSON feed is hier te vinden. |
| XML | Een voorbeeld van de XML feed is hier te vinden. |
Data omschrijving
| XML / JSON field | Type | Omschrijving |
|---|---|---|
| Id | String | Het technische (RecruitNow) ID van de vacature. |
| RemoteId | String | Het Cockpit ID van de vacature. |
| ReferenceNumber | String | Referentie nummer. |
| Title | String | De vacature titel. |
| CreatedAt | DateTime | De aanmaakdatum van de vacature. |
| LastEditedAt | DateTime | De laatste wijzigingsdatum van de vacature. |
| PublicationDate | Date | De publicatiedatum van de vacature. Wanneer de publicatiedatum bereikt is zal de vacature door Cockpit online geplaatst worden. Op dit moment komt de vacature in de feed beschikbaar. |
| ExpirationDate | Date | De vervaldatum van de vacature. Wanneer de vervaldatum is bereikt zal de vacature door Cockpit offline gehaald worden. De vacature is daarna niet meer beschikbaar in de feed. |
| Descriptions | Vacature omschrijvingen | |
| Summary | Html string | Inhoudelijke samenvatting van de vacature. Te gebruiken in overzichtslijsten. |
| FunctionDescription | Html string | Inhoudelijke omschrijving van de vacature en de functie. |
| ClientDescription | Html string | Omschrijving van de werkgever waar de kandidaat aan het werk gaat. |
| RequirementsDescription | Html string | "Vacature eisen" |
| OfferDescription | Html string | "Wat wij bieden" |
| AdditionalDescription | Html string | Vrij omschrijving veld |
| ApplicationProcedureDescription | Html string | "Over de sollicitatieprocedure" |
| Facets | Kenmerken | |
| Regions | Regio (provincie) | |
| FunctionTypes | Functie categorie | |
| ContractTypes | Dienstverband | |
| ExperienceLevels | Ervaringsniveau | |
| EducationLevels | Opleidingsniveau | |
| Categories | Vakgebied | |
| HoursPerWeek | Aantal uur per week | |
| Application | Sollicitatie info | |
| MaxAllowedApplications | Integer | Totaal aantal toegestane sollicitaties (over alle kanalen). |
| RemainingApplications | Integer | Resterend aantal toegestane sollicitaties. |
| CurriculumVitaeRequired | Boolean | Is een CV document verplicht bij het solliciteren op deze vacature. |
| Employment | Dienstverband info | |
| HoursPerWeekMin | Integer | Gewenst minimum aantal werkuren per week. |
| HoursPerWeekMax | Integer | Gewenst maximum aantal werkuren per week. |
| ShiftService | Boolean | Wordt er gewerkt in ploegendiensten. |
| TravelDistance | Integer | |
| WorkLocation | Standplaats | |
| Street | String | |
| Housenumber | Integer | |
| HousenumberSuffix | String | |
| Zipcode | String | |
| City | String | |
| Country | String | |
| Region | String | |
| Latitude | Double | |
| Longitude | Double | |
| Salary | Salaris | |
| Interval | Enum | De periode waarin de salaris bandbreedte is uitgedrukt |
| SalaryMin | Double | Minimaal salaris |
| SalaryMax | Double | Maximaal salaris |
| Description | Html string | Aanvullende omgschrijving over het salaris en de secundaire arbeidsvoorwaarden. |
| Recruiter | Recruiter/intercedent | |
| Id | String | Het technische (RecruitNow) ID van de recruiter/intercedent. |
| RemoteId | String | Het Cockpit ID van de recruiter/intercedent. |
| FirstName | String | |
| MiddleName | String | |
| LastName | String | |
| EmailAddress | String | |
| PhoneNumber | String | |
| MobilePhoneNumber | String | |
| Office | Vestiging | |
| Id | String | Het technische (RecruitNow) ID van de vestiging. |
| RemoteId | String | Het Cockpit ID van de vestiging. |
| Name | String | |
| Summary | String | |
| Description | String | |
| EmailAddress | String | |
| PhoneNumber | String | |
| MobilePhoneNumber | String | |
| Office.Address | ||
| Street | String | |
| Housenumber | Integer | |
| HousenumberSuffix | String | |
| Zipcode | String | |
| City | String | |
| Country | String | |
| Region | String | |
| Latitude | Double | |
| Longitude | Double | |
| Employer | Werkgever (deze gegevens komen enkel mee als PublishCompanyData op true staat in de transformtemplate) | |
| Id | String | Het technische (RecruitNow) ID van de werkgever. |
| RemoteId | String | Het Cockpit ID van de werkgever. |
| EmailAddress | String | |
| PhoneNumber | String | |
| MobilePhoneNumber | String | |
| Employer.Address | ||
| Street | String | |
| Housenumber | String | |
| HousenumberSuffix | String | |
| Zipcode | String | |
| City | String | |
| Country | String | |
| Region | String | |
| Latitude | Double | |
| Longitude | Double |