In dit artikel wordt uitgelegd hoe je functies vanuit Personio kunt integreren met je bedrijfswebsite via een XML-interface die we aanbieden. XML staat voor eXtensible Markup Language en beschikt over een gegevensstructuur die door computers kan worden gelezen.
Waarom een XML-interface gebruiken?
De carrièrepagina's van Personio bieden een breed scala aan designopties, maar soms loop je toch tegen beperkingen aan op het vlak van gepersonaliseerde designs en filters.
Je kunt gegevens integreren via een XML-interface om je individuele voorkeuren voor je bedrijfswebsite volledig te implementeren en tegelijkertijd de content en de publicatiestatus van je vacatures centraal te beheren in Personio.
Via onze XML-interface heb je toegang tot een XML-feed. Deze XML-feed levert de content en metagegevens voor alle functies die je in Personio hebt opgeslagen en gepubliceerd. Deze feed is altijd actueel. Als je in Personio wijzigingen aanbrengt aan een functie worden deze meteen overgedragen naar de XML-feed.
Opmerking:
De XML-interface maakt geen deel uit van het Essential-pakket.
Functies publiceren via XML
Als je functies via XML op je website wilt publiceren, moet je eerst de XML-interface in Personio activeren en vervolgens de XML-feed integreren in je website.
XML-feed activeren
Het systeem kan alleen een XML-feed aanmaken als je die optie geactiveerd hebt.
- Ga naar Instellingen > Werving & selectie > Werving & selectie.
- Ga op het tabblad Carrièrepagina naar Activeringen.
- Vink het selectievakje Activeer XML feed aan.
- Klik vervolgens in de rechterbenedenhoek op Wijzigingen toepassen.
Zodra je een functie publiceert, wordt deze in XML-indeling geëxporteerd op jouwaccount.jobs.personio.nl/xml en daarnaast automatisch beschikbaar gemaakt op de Personio-(hoofd)carrièrepagina (indien geactiveerd).
De XML-feed integreren
Het integreren van functies met je bedrijfswebsite via een XML-feed moet door een IT-expert worden gedaan.
Ga naar onze Developer Hub voor uitgebreide documentatie over alle formulieritems die worden geëxporteerd via de XML-interface. Je vindt er ook een praktijkvoorbeeld voor het instellen van een XML-integratie.
Tip:
Functies worden in de XML-feed standaard in het Duits weergegeven. Om ze in het Nederlands te openen, moet je de parameter 'language' en de waarde 'nl' toevoegen: youraccount.jobs.personio.de/xml?language=en.
Voorbeeld van een XML-feed
Het volgende voorbeeld laat zien wat de XML-feed bevat.
De XML-feed bevat de Functie-ID met alle bijbehorende content. Deze informatie is te vinden in Werving & selectie > Functies > Details weergeven > Omschrijving. |
![]() |
De XML-feed bevat de metagegevens van een functie, zoals afdeling, kantoor, type dienstverband enzovoort. Deze informatie is te vinden in Werving & selectie > Functies > Details weergeven > |
![]() |
Opmerking:
Content en metagegevens worden weergegeven als individuele items, bijvoorbeeld als de functie-ID <id>126910</id>. Exportgegevens van formulieritems bestaan uit alleen tekst zonder opmaak. Je kunt zelf bepalen hoe de tekst wordt weergegeven wanneer je de gegevens in je bedrijfswebsite integreert. Je kunt ook formulieren of filteropties voor je kandidaten maken om functies te filteren.
De volgende afbeelding laat de XML-feed zien die door Personio is gegenereerd voor de functie uit de screenshots hierboven.
Tip:
Als je ook gegevens van kandidaten vanuit je eigen systeem wilt overzetten naar Personio, dan kun je de wervings-API van Personio gebruiken. Meer informatie over deze mogelijkheid vind je in ons artikel Opties om je carrièrepagina aan Personio te koppelen.