talent.Flow Stammdaten

Anrede

GET /masterdata/salutations

Dieser Endpunkt gibt eine Liste aller Anreden zurück.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Arbeitsorte

GET /masterdata/workplaces

Neu in V 3.4.0: Liefert die Stammdatenliste der Arbeitsorte als Id-Wert-Paare. Die Ids sind als workPlaceId einzusetzen, etwa beim Anlegen einer Anfrage (POST /customers/{customerId}/requests/directtransmission und …/servicecontract). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Arten der Behinderung

GET /masterdata/disabilitytypes

Liefert die Stammdatenliste der Behinderungsarten als Id-Wert-Paare. Die zurückgegebenen Ids werden bei den Angaben zur Schwerbehinderung eines Bewerbers (disability) verwendet. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Arbeitszeitmodelle

GET /masterdata/employmenttypes

Liefert die Stammdatenliste der Arbeitszeitmodelle (Beschäftigungsarten) als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als employmentTypeId einzusetzen, etwa in den Arbeitspräferenzen eines Bewerbers (workingPreferences.employmentTypeId). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Berufe

GET /masterdata/professions

Liefert die Stammdatenliste der Berufe als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als professionId einzusetzen, etwa beim Anlegen eines Berufs zu einem Bewerber (POST /candidates/{id}/professions) oder zu einer Firma (POST /customers/{customerId}/professions). In den Bewerberdetails ist professionObjects[].id die Id der Zuordnung und nicht die professionId. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Bezugsquellen

GET /candidates/sourceofsupplies

Dieser Endpunkt gibt eine Liste aller Bezugsquellen zurück.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Bundesländer

GET /masterdata/federalstates

Dieser Endpunkt gibt eine Liste aller Bundesländer zurück.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Bonusarten

GET /masterdata/bonustypes

Liefert die Stammdatenliste der Bonusarten als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als bonusTypeId einzusetzen, etwa in der Gehaltsvorstellung eines Bewerbers (salaryExpectations.bonusTypeId). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Familienstände

GET /masterdata/maritalstatus

Liefert die Stammdatenliste der Familienstände als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als maritalStatusId einzusetzen, etwa im persönlichen Status eines Bewerbers (personalStatus.maritalStatusId). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Führerscheine

GET /masterdata/driverslicenses

Liefert die Stammdatenliste der Führerscheinklassen als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als driversLicenseId einzusetzen, etwa beim Anlegen eines Führerscheins zu einem Bewerber (POST /candidates/{id}/driverslicences) sowie als driversLicenseIds in den Anforderungen einer Anfrage. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Geschlechter

GET /masterdata/genders

Liefert die Stammdatenliste der Geschlechter als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als genderId einzusetzen, etwa beim Anlegen (POST /candidates) und Ändern der Bewerberstammdaten (PUT /candidates/{candidateId}). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Länder

GET /masterdata/countries

Dieser Endpunkt gibt eine Liste aller Länder zurück.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Mobilitätsarten

GET /masterdata/mobilitytypes

Liefert die Stammdatenliste der Mobilitätsarten als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als mobilityTypeId einzusetzen, etwa in den Mobilitätsangaben eines Bewerbers (mobility.mobilityTypeId). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Nationalitäten

GET /masterdata/nationalities

Liefert die Stammdatenliste der Staatsangehörigkeiten als Id-Wert-Paare. Die zurückgegebenen Ids sind im persönlichen Status eines Bewerbers einzusetzen — für bis zu drei Staatsangehörigkeiten über personalStatus.nationalityId, nationalitySecondId und nationalityThirdId. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Schichten

GET /masterdata/shifts

Neu in V 3.4.0: Liefert die Stammdatenliste der Schichten als Id-Wert-Paare. Die Ids sind als shiftIds einzusetzen, etwa beim Anlegen einer Anfrage. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

shiftIds wird beim Anlegen einer Anfrage gegen diesen Katalog geprüft; eine Id aus einer anderen Gruppe liefert 400 NotExisting auf ShiftIds.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Sprachen

GET /masterdata/languages

Dieser Endpunkt gibt eine Liste aller Sprachen zurück.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Sprachlevel

GET /masterdata/languagelevels

Liefert die Stammdatenliste der Sprachniveaus als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als levelId einzusetzen, etwa beim Anlegen (POST /candidates/{id}/languages) und Ändern (PUT /candidates/{candidateId}/languages/{languageId}) einer Sprachkenntnis; die Sprache selbst kommt aus GET /masterdata/languages. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

Vertragslaufzeiten

GET /masterdata/contractdurations

Neu in V 3.4.0: Liefert die Stammdatenliste der Vertragslaufzeiten als Id-Wert-Paare. Die Ids sind als contractDurationId einzusetzen, etwa beim Anlegen einer Anfrage (POST /customers/{customerId}/requests/directtransmission und …/servicecontract). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Währungen

GET /masterdata/currencies

Neu in V 3.4.0: Liefert die Stammdatenliste der Währungen mit Bezeichnung, ISO-Code und Symbol. Die Ids sind als serviceContractWageCurrencyId bzw. wageCurrencyId einzusetzen, etwa beim Anlegen einer Anfrage. Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Anders als die Enum-Gruppen stammen Währungen aus einer eigenen Stammdatentabelle. Die Antwort trägt deshalb wie Länder, Sprachen und Bundesländer einen eigenen Schlüssel (currencies) mit den fachlichen Feldern statt der generischen values-Liste.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler

Zeiteinheiten

GET /masterdata/periods

Liefert die Stammdatenliste der Zeiteinheiten (z. B. Bezugszeitraum eines Gehalts) als Id-Wert-Paare. Die zurückgegebenen Ids sind an anderer Stelle als periodId einzusetzen, etwa in der Gehaltsvorstellung eines Bewerbers (salaryExpectations.periodId). Der Endpunkt benötigt keine Parameter und liefert immer den vollständigen, mandantenspezifischen Bestand.

Responses

200 — Request successful

400 — Ungültige Anfrage oder Validierungsfehler