Inhalt
Mit Heyrecruit hast Du die Möglichkeit, Stellenanzeigen automatisiert über einen XML-Feed zu importieren. In diesem Artikel erklären wir Dir, wie der XML-Import funktioniert, welche Felder notwendig sind und worauf Du achten musst.
Voraussetzungen
- Eine XML-Datei, die den beschriebenen Aufbau erfüllt.
- Zugriff auf den XML-Feed über eine URL
- Ein aktives Heyrecruit-Konto mit der Option für XML-Importe (bei Fragen kontaktiere bitte unser Support-Team).
Aufbau der XML-Datei
Dein XML-Feed muss wie folgt aufgebaut sein:
<?xml version="1.0" encoding="UTF-8"?>
<Jobs>
<Job>
<id>1475221</id>
<order>1</order>
<industry_id>1</industry_id>
<job_level>3</job_level>
<job_function_id>21</job_function_id>
<job_offer_type>1</job_offer_type>
<university_needed>0</university_needed>
<social_insurance>1</social_insurance>
<internal_title><![CDATA[ABCDEFG]]></internal_title>
<last_modification>2021-05-13T12:20:01</last_modification>
<salary>25000</salary>
<salary_min>15000</salary_min>
<salary_max>150000</salary_max>
<salary_type>year</salary_type>
<salary_is_tariff_related>0</salary_is_tariff_related>
<salary_is_public>0</salary_is_public>
<remote>no</remote>
<job_education_level_id>1</job_education_level_id>
<form_id>12345</form_id>
<ba_supervision_desired>1</ba_supervision_desired>
<ba_handicap>1<ba_handicap>
<JobDescriptions>
<Description>
<language>de</language>
<employment> <![CDATA[ Vollzeit ]]> </employment>
<job_title><![CDATA[Softwareentwickler]]></job_title>
<job_sub_title><![CDATA[Wir suchen ab sofort:]]></job_sub_title>
<company_description><![CDATA[<p>Um unseren Mandanten im Gesundheits- und Sozialwesen mehr Zeit ...</p>]]></company_description>
<JobSections>
<Section>
<title><![CDATA[Ihre Aufgaben2]]></title>
<description>
<![CDATA[<ul><li>Führung der Seniorenresidenz</li><li>Sicherstellung einer sehr hohen Qualität der Bewohnerversorgung</li><li>Kommunikationsstarke und motivierende Führung des Personals</li><li>Repräsentation der Einrichtung in die Gemeinde / Region</li><li>Beschwerdemanagement</li><li>Einhaltung der betriebswirtschaftlich und fachlich vereinbarten Kennzahlen und Ziele</li><li>Mitarbeiterrekrutierung und -bindung</li><li>Kontaktpflege zu Multiplikatoren sowie Kostenträgern, Ämtern und Behörden</li></ul>]]></description>
</Section>
<Section>
<title><![CDATA[Ihr Profil2]]></title>
<description>
<![CDATA[<ul><li>Qualifikation zur Heimleitung nach HeimPersV und entsprechende Anerkennung<br></li><li>Berufserfahrung als Einrichtungs- und/oder Pflegedienstleiter in Einrichtungen der stationären Altenhilfe (mindestens 3 Jahre Leitungs-/Führungserfahrung)</li><li>Einsatzbereitschaft, Durchsetzungs- & Organisationsvermögen</li><li>Gute Kenntnisse in den gängigen EDV-Systemen</li><li>Vertriebs- und Dienstleistungsorientierung, Kommunikationsstärke sowie ein sicheres und gepflegtes Auftreten</li><li>Hohes betriebswirtschaftliches Verständnis</li><li>Hohe Affinität für moderne Personalinstrumente und -methoden</li></ul>]]>
</description>
</Section>
<Section>
<title><![CDATA[Ihr Vorteile2]]></title>
<description>
<![CDATA[<ul><li>Qualifikation zur Heimleitung nach HeimPersV und entsprechende Anerkennung<br></li><li>Berufserfahrung als Einrichtungs- und/oder Pflegedienstleiter in Einrichtungen der stationären Altenhilfe (mindestens 3 Jahre Leitungs-/Führungserfahrung)</li><li>Einsatzbereitschaft, Durchsetzungs- & Organisationsvermögen</li><li>Gute Kenntnisse in den gängigen EDV-Systemen</li><li>Vertriebs- und Dienstleistungsorientierung, Kommunikationsstärke sowie ein sicheres und gepflegtes Auftreten</li><li>Hohes betriebswirtschaftliches Verständnis</li><li>Hohe Affinität für moderne Personalinstrumente und -methoden</li></ul>]]>
</description>
</Section>
</JobSections>
</Description>
</JobDescriptions>
<JobLocations>
<Location>
<active>1</active>
<title><![CDATA[Standort Frankfurt]]></title>
<country><![CDATA[Deutschland]]></country>
<state><![CDATA[Hessen]]></state>
<city><![CDATA[Frankfurt am Main]]></city>
<street><![CDATA[Achenbachstr.]]></street>
<street_number><![CDATA[1]]></street_number>
<postal_code>60435</postal_code>
<lat>49.8666564</lat>
<lng>8.6469699</lng>
</Location>
</JobLocations>
</Job>
</Jobs>
Pflichtfelder
Damit eine Stellenanzeige erfolgreich importiert und veröffentlicht werden kann, müssen folgende Felder ausgefüllt sein:
Feld |
Beschreibung |
<id> |
Eindeutige Kennung der Stelle |
<industry_id> |
Branche (ID) |
<job_level> |
Karrierestufe (ID) |
<job_function_id> |
Berufsfeld (ID) |
<job_offer_type> |
Angebotsart (z. B. Vollzeit, Teilzeit) |
<last_modification> |
Letztes Änderungsdatum im ISO-Format |
<job_education_level_id> |
Ausbildungsniveau (ID) |
<language> |
Sprache (z. B. de) |
<employment> |
Beschäftigungsart(en) |
<job_title> |
Stellentitel |
<JobSections> |
Mindestens ein Abschnitt mit Titel und Beschreibung |
<JobLocations> |
Mindestens ein aktiver Standort mit Land und Stadt |
Für einige Pflichtfelder wie <industry_id>, <job_level>, <job_function_id> oder <job_education_level_id> müssen vordefinierte Werte genutzt werden.
Eine vollständige Übersicht aller möglichen Werte findest Du hier:
[Download: Übersicht der XML-Feldwerte (Excel)](LINK ZUR DATEI )
In dieser Excel-Datei findest Du:
- Alle verfügbaren Branchen-IDs (industry_id)
- Alle Karrierestufen (job_level)
- Alle Berufsfunktionen (job_function_id)
- Alle Ausbildungsniveaus (job_education_level_id)
- Hinweise zu Beschäftigungsarten (employment) und Remote-Optionen (remote)
Bitte orientiere Dich beim Erstellen Deines Feeds an diesen Vorgaben, damit der Import reibungslos funktioniert.
Optionale Felder
Du kannst zusätzlich folgende Informationen angeben:
- Sortierreihenfolge (<order>)
- Gehaltsspanne (<salary_min>, <salary_max>)
- Hinweis auf Remote-Arbeit (<remote>)
- Weiterleitungslink für Bewerbungen (<job_redirect_url>)
- Interner Titel (<internal_title>)
- Bewerbungsformular in Heyrecruit anhand der „Form-Id“ zuweisen (<form_id>)
Wo Du die Id des jeweiligen Bewerbungsformulars findest, erklären wir hier. - Vermittlungsauftrag an die Bundesagentur für Arbeit erzeugen (<ba_supervision_desired>)
- Vermittlungsauftrag für die Bundesagentur für Arbeit als „für Schwerbehinderte geeignet“ markieren (<ba_handicap>)
Hinweise
- HTML in Beschreibungen: Inhalte innerhalb der <description>-Tags können HTML-Tags wie <ul>, <li>, <b> etc. enthalten.
- Mehrere Standorte: Du kannst pro Job mehrere <Location>-Blöcke angeben.
- Mehrsprachigkeit: Es können mehrere <Description>-Elemente in verschiedenen Sprachen verwendet werden.
XML-Feed einrichten
Sobald Dein XML-Feed bereitsteht, kannst Du diesen bei Heyrecruit hinterlegen. Wende Dich dazu an Deinen Kundenbetreuer oder unser Support-Team.
Bitte stelle sicher, dass der Feed immer aktuell und erreichbar ist.
FAQ zum XML-Import in Heyrecruit
Sobald Dein XML-Feed bereitsteht, kannst Du diesen bei Heyrecruit hinterlegen. Wende Dich dazu an Deinen Kundenbetreuer oder unser Support-Team.
Bitte stelle sicher, dass der Feed immer aktuell und erreichbar ist.
Was ist ein XML-Feed?
Ein XML-Feed ist eine strukturierte Datei im XML-Format, die Daten – in diesem Fall Stellenanzeigen – enthält. Der Feed wird von Deinem System automatisch erstellt und regelmäßig aktualisiert. Heyrecruit kann diese Datei auslesen und daraus Stellenanzeigen erstellen oder aktualisieren.
Warum sollte ich Stellenanzeigen per XML importieren?
- Du möchtest Anzeigen aus einem bestehenden System oder Deiner Webseite importieren
- Du sparst Zeit, indem Du Anzeigen nicht manuell erstellen musst.
- Deine Stellenanzeigen bleiben automatisch aktuell.
- Änderungen aus 3. Systemen werden direkt in Heyrecruit übernommen.
Was passiert, wenn Pflichtfelder fehlen?
Wenn Pflichtfelder wie <job_title>, <JobSections> oder <JobLocations> fehlen oder falsch gefüllt sind, kann die Anzeige nicht vollständig importiert werden. In der Regel informieren wir Dich über Importfehler, damit Du diese beheben kannst.
Kann ich mehrere Standorte für eine Stelle angeben?
Ja, innerhalb eines <Job>-Blocks kannst Du mehrere <Location>-Elemente angeben. Damit wird die Stelle an verschiedenen Orten gleichzeitig veröffentlicht.
Wie oft wird der XML-Feed aktualisiert?
Standardmäßig wird der XML-Feed einmal täglich eingelesen. Bei Bedarf können auch kürzere Aktualisierungsintervalle eingerichtet werden – sprich uns dafür einfach an.
Wie stelle ich den XML-Feed bereit?
Du solltest eine öffentlich erreichbare URL bereitstellen, unter der wir die XML-Datei abrufen können.