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.

3. Feed-Anforderungen

3.1 Allgemeine Vorgaben

Der Feed darf maximal 10.000 Jobs enthalten.
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	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 Laufzeit 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-Abschnitt eingefügt werden.
`<company>`	Erforderlich	Der Name des Unternehmens bzw. der Organisation.
`<country>`	Erforderlich	Ländercode nach ISO 3166-1 Alpha-2 (z. B. DE, AT, CH, US).
`<state>`	Erforderlich	Das Bundesland, die Region, die Provinz oder der Verwaltungsbezirk des Arbeitsortes.
`<city>`	Erforderlich	Die Stadt oder Gemeinde des Arbeitsortes.
`<postalCode>`	Erforderlich	Die Postleitzahl des Arbeitsortes.
`<postedAt>`	Empfohlen	Das Datum, an dem die Stellenanzeige ursprünglich veröffentlicht wurde.
`<jobUrl>`	Empfohlen	Die URL, zu der Kandidaten weitergeleitet werden, wenn sie auf die Schaltfläche „Bewerben“ klicken. Muss eine vollständige, valide URL (vollqualifiziert) sein.
`<applicationEmail>`	Empfohlen	Eine E-Mail-Adresse, an die Bewerbungen weitergeleitet werden sollen. Hilfreich für ATS-Systeme, die eingehende Bewerbungen per E-Mail verarbeiten. Kann ignoriert werden, wenn stattdessen die URL genutzt 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 angegebenen Gehaltsspanne (nur numerischer Wert).
`<salaryMax>`	Empfohlen	Der Höchstwert der angegebenen Gehaltsspanne (nur numerischer Wert).
`<salaryCurrency>`	Empfohlen	Währungscode nach ISO 4217 für die Gehaltswerte (z. B. EUR, CHF, USD, GBP).
`<salaryFrequency>`	Empfohlen	Die Zahlungsfrequenz. Zulässige Systemwerte: Hourly, Daily, Weekly, Monthly, Yearly.

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.