XML Job Feed - Integrations Guide – Help Center - Deutsch

1. Übersicht

Jobiqo unterstützt den automatisierten Import von Stellenangeboten über XML-Feeds. Dies ermöglicht es Feed-Anbietern, eine Jobplattform mit minimalem manuellem Aufwand zu befüllen und zu verwalten. Vorausgesetzt, der Feed ist fehlerfrei aufgebaut und enthält die in dieser Anleitung beschriebenen Pflichtfelder, bietet das System Flexibilität beim Feld-Mapping und kommt mit den unterschiedlichsten XML-Strukturen zurecht.

Dieses Dokument beschreibt die technischen Anforderungen für die Einrichtung eines kompatiblen XML-Feeds, einschließlich der Pflicht- und empfohlenen Felder, den Anforderungen an die Feed-Bereitstellung sowie eines Referenzbeispiels.

2. Wie der Feed funktioniert

Der Importprozess des XML-Feeds läuft vollautomatisch ab. Sobald eine Feed-URL auf der Jobiqo-Plattform konfiguriert wurde, führt das System regelmäßig die folgenden Schritte aus:

Der Importprozess wird alle paar Stunden automatisch ausgeführt.
Bei jedem Durchlauf ruft das System den aktuellen XML-Inhalt von der hinterlegten Feed-URL ab.
Neue Stellenanzeigen, die im Feed enthalten, aber noch nicht auf der Plattform vorhanden sind, werden automatisch veröffentlicht.
Stellenanzeigen, die zuvor importiert wurden, aber nicht mehr im Feed enthalten sind, werden automatisch vom Stellenportal offline genommen.
Dies stellt sicher, dass das Stellenportal kontinuierlich mit den Inhalten des XML-Feeds synchronisiert bleibt.

Wichtig: Die Feed-URL muss jederzeit stabil und erreichbar bleiben. Die URL darf sich zwischen den Aktualisierungen nicht ändern – lediglich der Inhalt des Feeds unter dieser Adresse sollte sich anpassen, wenn Stellenanzeigen hinzugefügt oder entfernt werden.

Feed-Anbieter haben die direkte Kontrolle darüber, welche Jobs auf der Jobplattform erscheinen: Das Hinzufügen eines Jobs zum Feed veröffentlicht diesen automatisch, während das Entfernen eines Jobs dafür sorgt, dass er wieder offline genommen wird.

SEO-Hinweis: Es ist wichtig zu wissen, dass das Löschen bereits veröffentlichter Stellenanzeigen zu 404-Fehlerseiten führt und sich negativ auf Ihre SEO-Leistung auswirken kann.

3. Feed-Anforderungen

3.1 Allgemeine Vorgaben

Der Feed darf maximal 10.000 Jobs enthalten.
Der Job Titel darf maximal 255 Zeichen enthalten
Die Jobbeschreibung darf maximal 32.000 Zeichen enthalten
Zulässige Dateiformate für Logos sind: png, gif, jpg, jpeg. Die maximale Dateigröße beträgt 5 MB.
Der XML-Feed muss eine valide XML-Struktur aufweisen.
Der XML-Feed muss über eine feste URL erreichbar sein.
Der XML-Feed kann per Benutzername und Passwort geschützt werden – in diesem Fall müssen die Zugangsdaten für die Einrichtung bereitgestellt werden.

3.2 Struktur der Job-Tags

Das Jobiqo-Importsystem muss exakt auf den Namen des XML-Tags konfiguriert werden, der einen einzelnen Stellenübertrag repräsentiert. Die empfohlene Standardstruktur verwendet ein <jobs>-Wurzelelement , das einzelne untergeordnete <job>-Elemente enthält, wie hier dargestellt:

XML

<jobs>
  <job>
    <!-- job fields -->
  </job>
  <job>
    <!-- job fields -->
  </job>
</jobs>

Alternative Tag-Namen (z. B. <listings> / <listing>) werden unterstützt – vorausgesetzt, sie werden innerhalb desselben XML-Feeds durchgehend einheitlich verwendet. Ein Mix aus verschiedenen Tags für dasselbe Objekt (z. B. die gleichzeitige Nutzung von <jobs> und <listings> im selben Feed) wird nicht unterstützt.

4. Feld-Referenz

Die folgende Tabelle listet alle unterstützten Felder, ob sie Pflicht oder Empfehlung sind sowie eine Beschreibung des erwarteten Inhalts auf.

Feld / Tag	Anforderung	Beschreibung
`<jobId>`	Erforderlich	Eine eindeutige Kennung für jede Stellenanzeige. Dieser Wert wird verwendet, um Jobs über Feed-Aktualisierungen hinweg zu verfolgen, und darf sich während der gesamten Lebenszeit der Stellenanzeige nicht ändern.
`<title>`	Erforderlich	Der Jobtitel als Klartext (z. B. „Senior Software Engineer“).
`<description>`	Erforderlich	Die vollständige Stellenbeschreibung. HTML-Inhalte werden unterstützt und sollten in einen CDATA-Bereich eingeschlossen werden.
`<company>`	Erforderlich	Der Name des einstellenden Unternehmens.
`<country>`	Erforderlich	ISO 3166-1 Alpha-2-Ländercode (z. B. US, GB, DE).
`<state>`	Erforderlich	Das Bundesland, die Provinz oder die Verwaltungsregion des Jobstandorts.
`<city>`	Erforderlich	Die Stadt oder der Ort des Jobstandorts.
`<postalCode>`	Erforderlich	Die Postleitzahl oder der ZIP-Code des Jobstandorts.
`<postedAt>`	Empfohlen	Das Datum, an dem der Job ursprünglich veröffentlicht wurde.
`<jobUrl>`	Empfohlen	Die URL, zu der Kandidaten weitergeleitet werden, wenn sie auf den Bewerben-Button klicken. Muss eine vollständige (vollqualifizierte) URL sein.
`<applicationEmail>`	Empfohlen	Eine E-Mail-Adresse, an die Bewerbungen weitergeleitet werden sollen. Nützlich für ATS-Systeme, die eingehende Bewerbungen per E-Mail akzeptieren. Kann ignoriert werden, wenn stattdessen die URL verwendet wird.
`<category>`	Empfohlen	Die Berufskategorie oder Jobfunktion (z. B. Engineering, Vertrieb, Gesundheitswesen).
`<companyLogo>`	Empfohlen	Eine öffentlich zugängliche URL zum Logobild des einstellenden Unternehmens.
`<address>`	Empfohlen	Eine vollständige, formatierte Straßenadresse, sofern verfügbar (z. B. „123 Main St, Richmond, VA 23890“).
`<salaryMin>`	Empfohlen	Der Mindestwert der ausgeschriebenen Gehaltsspanne (nur numerischer Wert).
`<salaryMax>`	Empfohlen	Der Höchstwert der ausgeschriebenen Gehaltsspanne (nur numerischer Wert).
`<salaryCurrency>`	Empfohlen	ISO 4217-Währungscode für die Gehaltswerte (z. B. USD, EUR, GBP).
`<salaryFrequency>`	Empfohlen	Die Zahlungshäufigkeit. Akzeptierte Werte: Hourly, Daily, Weekly, Monthly, Yearly.
`<requiredDegreeLevel>`	Optional	Ordnet die Begriffe für das erforderliche Bildungsniveau (Abschluss) den bestehenden Taxonomiebegriffen zu.
`<employmentType>`	Optional	Ordnet die Begriffe für die Anstellungsart den bestehenden Taxonomiebegriffen zu.
`<yearsOfExperience>`	Optional	Ordnet die Begriffe für die erforderlichen Jahre an Berufserfahrung den bestehenden Taxonomiebegriffen zu.
`<fieldsOfStudy>`	Optional	Ordnet die Begriffe für die erforderlichen Studienbereiche den bestehenden Taxonomiebegriffen zu.
`<requiredLanguage>`	Optional	Ordnet die Begriffe für erforderliche Sprachen den bestehenden Taxonomiebegriffen zu.
`<occupations>`	Optional	Ordnet die erforderlichen Berufsfelder den bestehenden Taxonomiebegriffen zu.
`<requiredSkills>`	Optional	Ordnet die Begriffe für erforderliche Fähigkeiten (Skills) den bestehenden Taxonomiebegriffen zu.
`<remoteOptions>`	Optional	Ordnet die Homeoffice-/Remote-Optionen den bestehenden Taxonomiebegriffen zu.
`<industry>`	Optional	Ordnet die Branche den bestehenden Taxonomiebegriffen zu.
`<applicationWorkflow>`	Optional	Definiert den Typ des Bewerbungs-Workflows („internal“, „external“ oder „none“).

5. XML-Feed-Beispiel

Das folgende Beispiel zeigt einen fehlerfrei aufgebauten XML-Feed, der eine einzelne Stellenanzeige mit allen ausgefüllten, empfohlenen Feldern enthält:

XML

<jobs>
  <job>
    <jobId><![CDATA[12345]]></jobId>
    <title><![CDATA[Senior Software Engineer]]></title>
    <description><![CDATA[Full job description here...]]></description>
    <company><![CDATA[Acme Corporation]]></company>
    <city><![CDATA[Richmond]]></city>
    <state><![CDATA[VA]]></state>
    <country><![CDATA[US]]></country>
    <postalCode><![CDATA[23890]]></postalCode>
    <postedAt><![CDATA[2024-03-01T10:00:00Z]]></postedAt>
    <jobUrl><![CDATA[https://example.com/apply/12345]]></jobUrl>
    <applicationEmail><![CDATA[jobs@example.com]]></applicationEmail>
    <category><![CDATA[Engineering]]></category>
    <companyLogo><![CDATA[https://example.com/logo.png]]></companyLogo>
    <salaryMin><![CDATA[80000]]></salaryMin>
    <salaryMax><![CDATA[120000]]></salaryMax>
    <salaryCurrency><![CDATA[USD]]></salaryCurrency>
    <salaryFrequency><![CDATA[Yearly]]></salaryFrequency>
  </job>
</jobs>

6. Onboarding & Konfiguration

Um den XML-Feed-Import für Ihre Jobplattform zu aktivieren, stellen Sie unserem Team bitte die folgenden Informationen zur Verfügung:

Die URL des Feeds
Die Zugangsdaten zur Authentifizierung (falls der Feed geschützt ist)

Wir übernehmen die Konfiguration des Feld-Mappings direkt auf der Plattformseite. Es sind daher keine Änderungen an Ihrer bestehenden Feed-Struktur erforderlich – vorausgesetzt, alle Pflichtdaten sind im Feed enthalten.

6.1 Fragebogen für die Integration

Wenn Sie möchten, dass Jobiqo den Importer einrichtet (es fallen Einrichtungskosten an), sammeln Sie bitte die folgenden detaillierten Parameter und übermitteln Sie diese:

Thema	Frage	Beispiele / Optionen
Website *	Wo soll der Importer eingerichtet werden (falls Sie ein Multi-Frontend nutzen)?	www.jobiqo.com
Feed-Link *	Link zum XML-Feed, der integriert werden soll.	www.jobiqo.com/feed.xml
Größe (Umfang)	Wie viele Jobs werden durchschnittlich im XML-Feed erwartet?	Jede Zahl unter 10.000
Unternehmensprofil	Sollen Jobs aus diesem Feed mit einem bestimmten Unternehmensprofil verknüpft werden oder gehören sie zu verschiedenen Unternehmen? Haben die Unternehmen aus dem Feed ein Profil? Wie sollen wir sie zuordnen?	Alle Jobs dem Unternehmensprofil „jobiqo“ basierend auf dem Unternehmensnamen zuordnen.
Job-Typ *	Möchten Sie die Jobs lieber über ein Template oder per Link einrichten?	über Template (regulärer Textinhalt) oder per Link (eingebettet).
Bewerbungs-Workflow *	Bevorzugen Sie die Einrichtung von Jobs über einen „internen“ oder einen „externen“ Bewerbungs-Workflow? (Oder „kein Bewerbungssystem“, um den Bewerben-Button auszublenden).	interner Bewerbungs-Workflow (E-Mail) oder externer Bewerbungs-Workflow (URL).
Veröffentlichungsoptionen	Sollen wir alle importierten Jobs automatisch veröffentlichen oder sollen importierte Jobs zunächst im Status „Muss überprüft werden“ (Needs Review) landen?	Jobs automatisch veröffentlichen oder Manuelle Überprüfung (Needs Review).
Mapping *	Welche XML-Tags sollen für welches Feld verwendet werden?	`position` - Berufsfeld `employment_type` - Anstellungsart
Backfill-Jobs	Sollen die importierten Jobs als Backfill markiert werden?	Ja/Nein (Hinweis: Backfill-Jobs werden in den Suchergebnissen weiter unten gerankt und erscheinen nach manuell erstellten Jobs. Sie können auch von Exporten ausgeschlossen werden).
E-Mails	Soll der Autor des importierten Jobs benachrichtigt werden, wenn eine Stellenanzeige veröffentlicht oder deaktiviert wird?	Ja/Nein.

7. Administratives & Backend-Setup (Für Seiten-Admins)

Bevor Sie einen neuen XML-Importer einrichten, machen Sie sich bitte mit der Jobiqo-Importer-Benutzeroberfläche vertraut.

Schritt 1: Zugriff auf die Benutzeroberfläche

Melden Sie sich mit einem (Seiten-)Admin-Konto an und navigieren Sie zu Jobs ➔ Job Importer oder rufen Sie direkt den Pfad /admin/content/feed auf.
Klicken Sie oben rechts auf der Seite auf „Feed hinzufügen“ oder gehen Sie direkt zu /feed/add.
- Wichtiger Hinweis: Sobald der Importer einmal erstellt wurde, kann der Importer-Typ (Template vs. Link) nachträglich nicht mehr geändert werden.

Job importer template (Vorlage): Für reguläre Stellenanzeigen mit reinem Textinhalt.
Job importer per link (Per Link): Für Jobs, die über ein Job-Widget eingebettet werden (nutzt ein iFrame).

Schritt 2: Administrative Einstellungen & Konfiguration

Title (Titel): Definieren Sie einen internen Namen, um mehrere Importer leicht voneinander zu unterscheiden (z. B. Deutsche Bank Prescreen XML Import).
Feed URL: Kopieren Sie den stabilen Feed-Link und fügen Sie ihn hier ein.
Context (Kontext): Definieren Sie den genauen XPath-Pfad zum ersten Job-Element, basierend auf der Struktur Ihrer XML-Datei. Dieser Pfad muss immer mit einem Schrägstrich (/) beginnen und bis zum eigentlichen Job-Knoten absteigen (z. B. /data/jobs/job oder /smartrecruitersfeed/jobs/job). Alle nachfolgenden Felder werden relativ zu diesem Kontextpfad konfiguriert.
Feeds item : guid: Dieses Feld muss zwingend konfiguriert und mit der eindeutigen Identifikations-ID der Stellenanzeige innerhalb der XML verknüpft werden. Diese ID muss im gesamten Feed absolut einmalig sein und über die gesamte Lebensdauer der Stellenanzeige unverändert bleiben, um Duplikate zu vermeiden und erfolgreiche Updates zu garantieren.

Example: /data/jobs/job

Example: /smartrecruitersfeed/jobs/job

Schritt 3: Speichern und Importieren

Setzen Sie die Import-Optionen auf „Aktiv“, um die automatische, wiederkehrende Synchronisierung freizuschalten.
Klicken Sie auf „Speichern und Importieren“, um die Jobs sofort einzulesen, oder auf „Speichern“, um die Konfigurationen zu sichern, ohne den initialen Import direkt zu starten.

8. Taxonomie-Management & Synonym-Mapping

In der Regel stimmen die Berufsbezeichnungen, Anstellungsarten oder andere Kategorien in einem externen XML-Feed (die von einem externen ATS exportiert werden) nicht exakt mit den nativen Jobiqo-Taxonomiebegriffen überein.

Sie können Importer-Synonyme direkt in Jobiqo's Taxonomy Manager hinterlegen, um die Begriffe aus dem Feed Ihren eigenen Plattform-Kategorien zuzuordnen – komplett ohne die ursprüngliche XML-Datei modifizieren zu müssen.

Hinweis zum Autotagging: Wenn Sie dasselbe Synonym zwei oder mehr Taxonomiebegriffen zuweisen, wird eine importierte Stelle beim Einlesen automatisch mit allen übereinstimmenden Begriffen gleichzeitig getaggt.

Beispiel für ein Synonym-Mapping:

Begriff im XML-Feed: Half time ➔ Ziel-Taxonomie in Jobiqo: Part time
Begriff im XML-Feed: Administration ➔ Ziel-Taxonomie in Jobiqo: Assistance / Administration

9. Wartung & Fehlerbehebung (Troubleshooting)

Für erweiterte Konfigurationen, die gezielte Fehlerbehebung und operative Workflows nutzen Sie bitte die folgenden internen Leitfäden:

„Importer Interface“ – Detaillierte Anleitung zu allen unterstützten Funktionen des Importsystems.
„What should I consider when testing a new XML importer“ – Best Practices für das Einrichten sicherer Testumgebungen (Staging) und die Überprüfung von Jobs, bevor sie live gehen.
„Importer: most common errors“ – Definitionen von Fehlerprotokollen, Verbindungsproblemen und Syntaxfehlern.
„How can I edit an imported job“ & „How can I update an imported job“ – Anweisungen für manuelle Anpassungen, Daten-Überschreibungen und das nachträgliche Ändern aktiver Importe.