{"openapi":"3.1.2","info":{"title":"talent Flow Api | V3","version":"3.0.0"},"servers":[{"url":"/v3"}],"paths":{"/candidates":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Alle Bewerber auflisten","description":"Dieser Endpunkt gibt eine Liste von Bewerbern zur\u00FCck.\n\n\u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden. Ohne Angabe werden alle Bewerber zur\u00FCckgegeben.","parameters":[{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidatesResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"},"post":{"tags":["Bewerberdetails"],"summary":"Stammdaten anlegen","description":"Mit diesem Endpunkt kann man die Stammdaten eines Kandidaten anlegen.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Ein Kandidat wird in talent.Flow nur angezeigt wenn zu dem Kandidaten auch mindestens eine Bewerbung angelegt wurde!\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n**Neu in V 3.4.0:**\n\n* \u0060contact.phoneNumber\u0060 und \u0060contact.mobileNumber\u0060 werden beide gespeichert. Bisher ging \u0060phoneNumber\u0060 verloren, wenn beide Felder bef\u00FCllt waren. Wer nur eines der beiden Felder sendet, ist nicht betroffen.\n\n**Angek\u00FCndigt:** Telefonnummern werden k\u00FCnftig gegen den internationalen Rufnummernkatalog gepr\u00FCft. Derzeit wird nichts abgelehnt: Ein Wert, der keine existierende Rufnummer ist, wird gespeichert und nur protokolliert. Eine Ablehnung mit \u0060400\u0060 und \u0060validationErrors\u0060 wird vorher angek\u00FCndigt. Festnetznummern sind zul\u00E4ssig; nicht bestehen w\u00FCrden Werte wie \u0060abc\u0060, \u00601\u0060 oder eine zu kurze Nummer wie \u00600171 123\u0060.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}":{"put":{"summary":"Bewerberstammdaten \u00E4ndern","description":"\u00C4ndert die Stammdaten eines Bewerbers. Es werden ausschlie\u00DFlich die im Request-Body \u00FCbermittelten Felder ge\u00E4ndert \u2014 nicht \u00FCbermittelte Felder bleiben unver\u00E4ndert. Das gilt auch innerhalb der Sub-Objekte (\u0060contact\u0060, \u0060location\u0060, \u0060birth\u0060 \u2026): Ein \u00FCbermitteltes Sub-Objekt ersetzt nicht den ganzen Block, sondern nur dessen enthaltene Felder. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt. Listenartige Angaben wie Berufe, Sprachen, Qualifikationen oder F\u00FChrerscheine werden hier\u00FCber nicht gepflegt, daf\u00FCr gibt es eigene Endpunkte unter \u0060/candidates/{id}/\u2026\u0060. Der Bewerberstatus wird \u00FCber \u0060PUT /candidates/{id}/status\u0060 gesetzt. Die zul\u00E4ssigen Werte der Katalog-Ids (\u0060genderId\u0060, \u0060levelId\u0060, \u0060driversLicenseId\u0060, \u0060professionId\u0060, \u0060countryId\u0060 \u2026) liefern die Stammdaten-Endpunkte unter \u0060/masterdata/\u2026\u0060.\n\n**Neu in V 3.4.0:**\n\n* \u0060contact.phoneNumber\u0060 wird beim \u00C4ndern ausgewertet; bisher wurde das Feld ohne Fehlermeldung ignoriert. Beide Telefonnummern werden gespeichert. Ein nicht \u00FCbermitteltes Telefonfeld beh\u00E4lt seine gespeicherte Nummer, ein Teil-Update verwirft die andere Nummer also nicht.\n\n**Angek\u00FCndigt:** Telefonnummern werden k\u00FCnftig gegen den internationalen Rufnummernkatalog gepr\u00FCft. Derzeit wird nichts abgelehnt: Ein Wert, der keine existierende Rufnummer ist, wird gespeichert und nur protokolliert. Eine Ablehnung mit \u0060400\u0060 und \u0060validationErrors\u0060 wird vorher angek\u00FCndigt. Gepr\u00FCft werden nur die im Request \u00FCbermittelten Telefonfelder; eine bereits gespeicherte Nummer f\u00FChrt nie zu einem Fehler. Festnetznummern sind zul\u00E4ssig.","operationId":"updateCandidates","parameters":[{"name":"candidateId","in":"path","description":"Kennung des Bewerbers (Id)","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Zu \u00E4ndernde Bewerberstammdaten. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateChangeDto"}}},"required":true},"responses":{"204":{"description":"Request successful, no content returned"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}/communications":{"post":{"tags":["Bewerberkommunikation"],"summary":"Kommunikation anlegen","description":"Mit diesem Endpunkt kann eine Kommunikation f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommunicationCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberkommunikation"}},"/candidates/{candidateId}/communications/{id}/attachments":{"post":{"tags":["Bewerberkommunikation"],"summary":"Anhang zur Kommunikation hinzuf\u00FCgen","description":"Mit diesem Endpunkt kann ein Anhang f\u00FCr eine Kommunikation f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n Es wird die KommunikationsId ben\u00F6tigt, welche beim Anlegen der Kommunikation zur\u00FCck gegeben wird.\n\n Die Datei muss als Base64 String \u00FCbergeben werden.\n\n Der \u0027Base64EncodedString\u0027 muss das Format \u0027\u0027data:mimetype;base64,base64String\u0027 haben.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}},{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachmentCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseSuccessResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber oder Kommunikation nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberkommunikation"}},"/candidates/{candidateId}/documents/{documentCategory}":{"post":{"tags":["Bewerberdokumente"],"summary":"Dokument als F\u00FChrerschein hinzuf\u00FCgen","description":"### Dokument als F\u00FChrerschein hinzuf\u00FCgen\n\nMit diesem Endpunkt kann ein Dokument an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als F\u00FChrerschein angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n### Dokument als Bewerbung hinzuf\u00FCgen\n\nMit diesem Endpunkt kann ein Dokument an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als Bewerbung angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n### Dokument als Arbeitserlaubnis hinzuf\u00FCgen\n\nMit diesem Endpunkt kann ein Dokument an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als Arbeitserlaubnis angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n### Dokument als F\u00FChrungszeugnis hinzuf\u00FCgen\n\nMit diesem Endpunkt kann ein Dokument an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als F\u00FChrungszeugnis angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}},{"name":"documentCategory","in":"path","description":"Kategorie des Dokuments","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateOtherDocumentCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden oder unbekannte Dokumentkategorie","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/{candidateId}/documents/cv":{"post":{"tags":["Bewerberdokumente"],"summary":"Lebenslauf hochladen","description":"### Lebenslauf hochladen\n\nMit diesem Endpunkt kann ein Lebenslauf f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n Das File muss als Base64 codierter String \u00FCbergeben werden.\n\n Das Feld \u0027shouldParseCV\u0027 gibt an, ob der CV Parser gestartet werden soll. Bitte false angeben, wenn die Lebenslaufdaten \u00FCber die anderen Endpunkte \u00FCbergeben werden, da die Daten ansonsten ggf. doppelt erzeugt werden.\n\n### Dokument als Lebenslauf hinzuf\u00FCgen\n\nMit diesem Endpunkt kann ein Lebenslauf an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als Lebenslauf angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateCvDocumentCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/{candidateId}/documents/other":{"post":{"tags":["Bewerberdokumente"],"summary":"Dokument als sonstiges Dokument hinzuf\u00FCgen","description":"Mit diesem Endpunkt kann ein Dokument an einen Bewerber angeh\u00E4ngt werden..\n\n Dieses Dokument wird dann bei einem Bewerber unter Dokumente als sonstiges angezeigt.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateOtherDocumentCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/{candidateId}/driverslicences/{driversLicenseId}":{"delete":{"summary":"F\u00FChrerschein l\u00F6schen","description":"L\u00F6scht einen F\u00FChrerschein-Eintrag eines Bewerbers. \u0060candidateId\u0060 adressiert den Bewerber, \u0060driversLicenseId\u0060 die zu entfernende F\u00FChrerscheinklasse \u2014 also dieselbe Katalog-Id aus \u0060GET /masterdata/driverslicenses\u0060, die beim Anlegen \u00FCbermittelt wurde, und nicht die Id des Zuordnungsdatensatzes. Angelegt werden F\u00FChrerscheine \u00FCber \u0060POST /candidates/{id}/driverslicences\u0060. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt.","operationId":"deleteCandidatesDriverslicenceById","parameters":[{"name":"candidateId","in":"path","description":"Numerische Kennung des Bewerbers (Id), wie sie POST /candidates zur\u00FCckgibt.","required":true,"schema":{"type":"integer"}},{"name":"driversLicenseId","in":"path","description":"Kennung der F\u00FChrerscheinklasse aus \u0060GET /masterdata/driverslicenses\u0060 \u2014 dieselbe Id, die beim Anlegen \u00FCbermittelt wurde. Es ist nicht die Id des Zuordnungsdatensatzes.","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Request successful, no content returned"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber oder F\u00FChrerschein nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}/endofoperation":{"put":{"tags":["Bewerberdetails"],"summary":"Bewerber Ende der Einsatzzeit","description":"Setzt das Ende der Einsatzzeit eines Bewerbers. \u00DCbergeben wird ausschlie\u00DFlich \u0060endOfOperationAtUtc\u0060, der Zeitpunkt des Einsatzendes in UTC. Der Bewerberstatus wird dadurch nicht ver\u00E4ndert \u2014 daf\u00FCr dient \u0060PUT /candidates/{id}/status\u0060. Die Meldung eines unterzeichneten Vertrags l\u00E4uft \u00FCber \u0060PUT /candidates/{candidateId}/workcontract\u0060.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateEndOfOperationChangeDto"}}}},"responses":{"204":{"description":"Ende der Einsatzzeit gespeichert, die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}/keywords/{keywordId}":{"delete":{"tags":["Bewerberdetails"],"summary":"Schlagwort l\u00F6schen","description":"**Neu in V 3.4.0:** Entfernt ein Schlagwort von einem Bewerber. Bisher war das nur f\u00FCr Qualifikationen und Berufe m\u00F6glich.\n\n\u0060keywordId\u0060 ist die **Schlagwort-Id** (der Stammsatz), nicht die Id der Zuordnung, genauso wie bei den L\u00F6schendpunkten f\u00FCr Qualifikationen und Berufe.\n\nGel\u00F6scht wird als Soft-Delete: Die Zuordnung wird deaktiviert, der Schlagwort-Stammsatz bleibt bestehen. Ein erneutes \u0060POST /candidates/{id}/keywords\u0060 mit demselben Schlagwort reaktiviert die Zuordnung. Der Bewerber wird aus der Volltextsuche des gel\u00F6schten Schlagworts entfernt.\n\nEin nicht zugeordnetes oder bereits inaktives Schlagwort ergibt 404.","operationId":"deleteCandidatesKeywordById","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}},{"name":"keywordId","in":"path","description":"Identifikation des Schlagworts (Stammsatz), wie von POST /candidates/{id}/keywords zur\u00FCckgegeben","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Schlagwort entfernt \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber oder Schlagwort nicht gefunden \u2014 auch dann, wenn das Schlagwort dem Bewerber nicht zugeordnet oder die Zuordnung bereits inaktiv ist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}/languages/{languageId}":{"put":{"summary":"Sprache \u00E4ndern","description":"\u00C4ndert das Sprachniveau einer bereits erfassten Sprachkenntnis eines Bewerbers. \u00DCbergeben wird ausschlie\u00DFlich \u0060levelId\u0060; die Sprache selbst l\u00E4sst sich nicht tauschen \u2014 daf\u00FCr den Eintrag \u00FCber \u0060DELETE /candidates/{candidateId}/languages/{languageId}\u0060 l\u00F6schen und per \u0060POST /candidates/{id}/languages\u0060 neu anlegen. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt.","operationId":"updateCandidatesLanguageById","parameters":[{"name":"candidateId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"languageId","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Neues Sprachniveau der zu \u00E4ndernden Sprachkenntnis.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateLanguageChangeDto"}}},"required":true},"responses":{"204":{"description":"Request successful, no content returned"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber oder Sprachkenntnis nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"},"delete":{"summary":"Sprache l\u00F6schen","description":"L\u00F6scht eine Sprachkenntnis eines Bewerbers. \u0060candidateId\u0060 adressiert den Bewerber, \u0060languageId\u0060 die Sprache \u2014 also dieselbe Id, die beim Anlegen \u00FCber \u0060POST /candidates/{id}/languages\u0060 \u00FCbergeben wurde (aus \u0060/masterdata/languages\u0060), **nicht** die interne Kennung aus \u0060languages[].id\u0060 der Bewerberdetails. Soll nur das Niveau ge\u00E4ndert werden, dient \u0060PUT /candidates/{candidateId}/languages/{languageId}\u0060. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt.","operationId":"deleteCandidatesLanguageById","parameters":[{"name":"candidateId","in":"path","description":"Kennung des Bewerbers (Id)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"languageId","in":"path","description":"Kennung der Sprache (Id) \u2014 dieselbe Id wie beim Anlegen \u00FCber POST /candidates/{id}/languages. Nicht die Id der Sprachkenntnis aus \u0060languages[].id\u0060 der Bewerberdetails.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"204":{"description":"Request successful, no content returned"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber oder Sprachkenntnis nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{candidateId}/workcontract":{"put":{"tags":["Bewerberdetails"],"summary":"Bewerber Arbeitsvertrag","description":"Pflegt die Arbeitsvertragsdaten eines Bewerbers: ob der Vertrag unterzeichnet ist (\u0060isWorkContractSigned\u0060), wann er unterzeichnet wurde (\u0060workContractSignedAtUtc\u0060) und ob der Bewerber die Stelle nicht angetreten hat (\u0060didNotShowUpForWork\u0060). Das Ende der Einsatzzeit wird \u00FCber \u0060PUT /candidates/{candidateId}/endofoperation\u0060 gesetzt, der Bewerberstatus \u00FCber \u0060PUT /candidates/{id}/status\u0060.","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Zu \u00E4ndernde Arbeitsvertragsdaten des Bewerbers.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateWorkContractChangeDto"},"example":{"isWorkContractSigned":true,"workContractSignedAtUtc":"2024-01-15T09:30:00Z","didNotShowUpForWork":true}}},"required":true},"responses":{"204":{"description":"Arbeitsvertrag gespeichert, die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/apply":{"post":{"tags":["Bewerberdetails"],"summary":"Bewerbung zu einem Bewerber anlegen","description":"Mit diesem Endpunkt kann eine Bewerbung f\u00FCr einen Kandidaten angelegt werden.\n\nEs wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\nDie RecruiterId kann \u00FCber die Benutzer ermittelt werden.\n\nOptional kann noch eine \u0060jobAdId\u0060 mitgeliefert werden, die auf einen existierenden JobAd verweisen muss.\n\nOptional kann noch eine \u0060channelId\u0060 mitgeliefert werden, die auf einen existierenden Kanal verweisen muss. Im Standard wird der Kanal \u0022Import\u0022 (51) verwendet.\nSowohl die \u0060jobAdId\u0060 als auch die \u0060channelId\u0060 sind als Ganzzahl anzugeben.\n\nWird eine \u0060jobAdId\u0060 mitgeliefert, \u00FCbernimmt die API den Berufstitel der Stellenanzeige als Schlagwort am Bewerber.\n\n**Neu in V 3.4.0:**\n\n* Das Schlagwort aus dem Berufstitel wird bei Bedarf angelegt. Bisher schlug der Aufruf mit \u0060INVALIDDATA\u0060 fehl, wenn der Titel noch nicht als Schlagwort existierte, obwohl die Bewerbung bereits angelegt war, und ein zweiter Versuch lief in die Dublettenpr\u00FCfung.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyImportDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/driverslicences":{"post":{"tags":["Bewerberdetails"],"summary":"F\u00FChrerschein anlegen","description":"Mit diesem Endpunkt kann ein F\u00FChrerschein f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n Folgende driverLicenceIds sind g\u00FCltig:\n\n| Id | Beschreibung |\n|---|---|\n| 313 | Fahrerlaubnisklasse L (land-, forstw. Zugmaschinen, alt: 5) |\n| 314 | Fahrerlaubnisklasse C1 (Leichte LKW, alt: 3) |\n| 315 | Lokomotiv-/Triebfahrzeugf\u00FChrerschein Klasse 1 |\n| 316 | Seminarerlaubnis ASP (Fahrlehrerausbildung) |\n| 317 | Fahrerlaubnisklasse T (Gro\u00DFe Traktoren) |\n| 318 | Fahrerkarte |\n| 319 | Fahrerlaubnisklasse D1 (Kleine Omnibusse, alt: 2B) |\n| 320 | Fahrerlaubnisklasse Mofa und Krankenfahrst\u00FChle |\n| 321 | Fahrlehrerschein/Fahrlehrerlaubnis Klasse BE (alt: Kl. 3) |\n| 322 | Fahrerlaubnisklasse CE (Schwere LKW mit Anh\u00E4nger, alt: 2) |\n| 323 | Fahrerlaubnisklasse S (3-r\u00E4d.Kleinkraft.,4-r\u00E4d.Leichtkraft.) |\n| 324 | Fahrerlaubnisklasse DE (Omnibusse mit Anh\u00E4nger, alt: 2B) |\n| 325 | Fahrerlaubnisklasse M (Moped, Mokick, alt: 4) |\n| 326 | F\u00FChrerschein Gabelstapler, Flurf\u00F6rderzeuge |\n| 327 | Fahrabzeichen (Gespanne) |\n| 328 | Fahrerlaubnisklasse D1E (Kl. Omnibusse m. Anh\u00E4nger, alt: 2B) |\n| 329 | Fahrerlaubnisklasse D (Omnibusse, alt: 2B) |\n| 330 | Seminarerlaubnis ASF (Fahrlehrerausbildung) |\n| 331 | Fahrerlaubnisklasse C1E (Leichte LKW mit Anh\u00E4nger, alt: 3) |\n| 332 | Fahrlehrerschein/Fahrlehrerlaubnis Klasse CE (alt: Kl. 2) |\n| 333 | Fahrerlaubnisklasse C (Schwere LKW, alt: 2) |\n| 334 | Fahrerlaubnisklasse A (Motorr\u00E4der, alt: 1, 1a) |\n| 335 | Fahrlehrerschein/Fahrlehrerlaubnis Klasse A (alt: Kl. 1) |\n| 336 | F\u00FChrerschein Baumaschinen |\n| 337 | Fahrerlaubnisklasse A1 (Leichtkraftr\u00E4der, alt: 1b) |\n| 338 | Fahrlehrerschein/Fahrlehrerlaubnis Klasse DE |\n| 339 | Fahrerlaubnisklasse B (PKW/Kleinbusse, alt: 3) |\n| 340 | Fahrerlaubnisklasse Fahrgastbef\u00F6rd. (Taxen, Krankenkraftw.) |\n| 341 | Fahrerlaubnisklasse BE (PKW/Kleinbusse mit Anh\u00E4nger, alt: 3) |\n| 342 | Lokomotiv-/Triebfahrzeugf\u00FChrerschein Klasse 2 |\n| 343 | Lokomotiv-/Triebfahrzeugf\u00FChrerschein Klasse 3 |","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DriversLicenseCreateDto"}}}},"responses":{"200":{"description":"OK \u2014 \u0060id\u0060 enth\u00E4lt die \u00FCbergebene driversLicenseId, nicht die Id der erzeugten Zuordnung.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/email":{"post":{"tags":["Bewerberdetails"],"summary":"Email hinzuf\u00FCgen","description":"Mit diesem Endpunkt kann eine Email f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailImportDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/keywords":{"post":{"tags":["Bewerberdetails"],"summary":"Keywords anlegen","description":"Mit diesem Endpunkt kann ein Keyword f\u00FCr einen Kandidaten angelegt werden.\n\nEs wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n**Neu in V 3.4.0:**\n\n* Ein bereits zugeordnetes Schlagwort wird nicht doppelt angelegt, eine zuvor gel\u00F6schte Zuordnung wird reaktiviert. In beiden F\u00E4llen antwortet der Endpunkt mit 200 und derselben \u0060id\u0060 wie beim ersten Anlegen: der Id des Schlagwort-Stammsatzes, die auch \u0060DELETE /candidates/{candidateId}/keywords/{keywordId}\u0060 erwartet.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordCreateDto"}}}},"responses":{"200":{"description":"OK \u2014 \u0060id\u0060 ist die Id des Schlagworts (Stammsatz), nicht die Id der Zuordnung zum Bewerber. Sie ist bei jedem Aufruf mit demselben Schlagwort identisch \u2014 auch wenn die Zuordnung bereits bestand oder reaktiviert wurde \u2014 und wird unver\u00E4ndert in \u0060DELETE /candidates/{candidateId}/keywords/{keywordId}\u0060 verwendet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/languages":{"post":{"tags":["Bewerberdetails"],"summary":"Sprache anlegen","description":"Mit diesem Endpunkt kann eine Sprache f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n Folgende languageIds sind g\u00FCltig:\n\n| Id | Bezeichnung |\n|---|---|\n| 1 | Deutsch |\n| 2 | G\u00E4lisch/Irisch |\n| 3 | F\u00E4r\u00F6isch |\n| 4 | Tschechisch |\n| 5 | Kroatisch |\n| 6 | Lettisch |\n| 7 | Telugu |\n| 8 | Letzeburgisch (Luxemburg) |\n| 9 | Spanisch |\n| 10 | Tschetschenisch |\n| 11 | Esperanto |\n| 12 | Katalan |\n| 13 | Englisch (Amerikanisches Englisch) |\n| 14 | Pakistanisch/Urdu |\n| 15 | Ukrainisch |\n| 16 | Englisch (Wirtschafts-, Businessenglisch) |\n| 17 | Paschtu/Paschto/Pashto (Afghanistan) |\n| 18 | Geb\u00E4rdensprache/unterst\u00FCtzte Kommunikation (UK) |\n| 19 | Taiwanisch |\n| 20 | Serbisch |\n| 21 | Filipino (Tagalog) |\n| 22 | Litauisch |\n| 23 | Tigrinja (Eritrea) |\n| 24 | Jiddisch |\n| 25 | Englisch |\n| 26 | Hausa (Westafrika) |\n| 27 | Vietnamesisch |\n| 28 | Japanisch |\n| 29 | Wei\u00DFrussisch |\n| 30 | Tibetisch |\n| 32 | T\u00FCrkisch |\n| 33 | Thai |\n| 34 | Albanisch |\n| 35 | Russisch |\n| 36 | Mazedonisch |\n| 37 | Griechisch |\n| 38 | Englisch (Technisches Englisch) |\n| 39 | Finnisch |\n| 40 | Schwedisch |\n| 42 | Malayalam |\n| 43 | Rum\u00E4nisch |\n| 44 | Gujarati |\n| 45 | Tamil |\n| 46 | Italienisch |\n| 47 | Singhalesisch |\n| 48 | Koreanisch |\n| 49 | Arabisch |\n| 50 | Chinesisch |\n| 51 | Akan/Twi (Westafrika) |\n| 52 | Aserbaidschanisch |\n| 54 | Niederl\u00E4ndisch/Fl\u00E4misch |\n| 55 | Hebr\u00E4isch |\n| 56 | Usbekisch |\n| 57 | Yoruba (Westafrika) |\n| 58 | Amharisch (\u00C4thiopien) |\n| 59 | Indonesisch |\n| 60 | Suaheli (Ostafrika) |\n| 61 | Punjabi |\n| 62 | Bambara (Westafrika, Mali) |\n| 63 | Bulgarisch |\n| 64 | Afrikaans |\n| 65 | Mongolisch |\n| 66 | Estnisch |\n| 67 | Norwegisch |\n| 68 | Armenisch |\n| 69 | Portugiesisch |\n| 70 | Bengali |\n| 71 | Ungarisch |\n| 72 | Aram\u00E4isch/Syrisch |\n| 73 | Sorbisch/Wendisch |\n| 74 | Uigurisch |\n| 75 | Kasachisch |\n| 76 | Kurdisch |\n| 77 | Kirgisisch |\n| 78 | Hindi |\n| 79 | Marathi |\n| 80 | Kambodschanisch (Khmer) |\n| 81 | D\u00E4nisch |\n| 82 | Georgisch |\n| 83 | Somali |\n| 84 | Slowakisch |\n| 85 | Franz\u00F6sisch |\n| 86 | Polnisch |\n| 87 | Nepalesisch |\n| 88 | Romani |\n| 89 | Jamaika-Kreolisch (Patois) |\n| 90 | Persisch/Dari/Farsi |\n| 91 | Friesisch |\n| 92 | Latein |\n| 93 | Slowenisch |\n| 94 | Birmanisch |\n| 95 | Laotisch |\n| 96 | Isl\u00E4ndisch |\n| 97 | Bosnisch |\n\n Folgende languageLevelIds sind g\u00FCltig:\n\n| Id | Bezeichnung |\n|---|---|\n| 629 | A1 - Elementarstufe 1 |\n| 630 | A2 - Elementarstufe II |\n| 631 | B1 - Mittelstufe I |\n| 632 | B2 - Mittelstufe 2 |\n| 633 | C1 - Fortgeschrittene I |\n| 634 | C2 - Fortgeschrittene 2 |\n| 635 | Muttersprache |","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateLanguageDto"}}}},"responses":{"200":{"description":"OK \u2014 \u0060id\u0060 enth\u00E4lt die \u00FCbergebene languageId, nicht die Id der erzeugten Sprachkenntnis (die liefert \u0060languages[].id\u0060 der Bewerberdetails).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/pictures":{"post":{"tags":["Bewerberdetails"],"summary":"Profilbild hochladen","description":"Mit diesem Endpunkt kann ein Profilbild f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\n Das Bild muss als Base64 codierter String \u00FCbergeben werden.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidatePictureCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseSuccessResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/professions":{"post":{"tags":["Bewerberdetails"],"summary":"Berufe anlegen","description":"Mit diesem Endpunkt kann ein Beruf f\u00FCr einen Kandidaten angelegt werden.\n\nEs wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\nF\u00FCr die professionId ist die DKZID des BA Kataloges zu verwenden.\n\n**Neu in V 3.4.0:**\n\n* Ein bereits zugeordneter Beruf wird nicht doppelt angelegt, eine zuvor gel\u00F6schte Zuordnung wird reaktiviert. In beiden F\u00E4llen antwortet der Endpunkt mit 200 und derselben \u0060id\u0060 wie beim ersten Anlegen: der DKZID, die auch \u0060DELETE /candidates/{id}/professions/{professionId}\u0060 erwartet.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfessionCreateDto"}}}},"responses":{"200":{"description":"OK \u2014 \u0060id\u0060 enth\u00E4lt die \u00FCbergebene professionId (DKZID), nicht die Id der erzeugten Zuordnung (die liefert \u0060professionObjects[].id\u0060 der Bewerberdetails). Das gilt bei jedem Aufruf \u2014 auch wenn die Zuordnung bereits bestand oder reaktiviert wurde. Die Id wird unver\u00E4ndert in \u0060DELETE /candidates/{id}/professions/{professionId}\u0060 verwendet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/professions/{professionId}":{"delete":{"summary":"Berufe l\u00F6schen","description":"Entfernt die Zuordnung eines Berufs bzw. Einsatzgebiets von einem Bewerber. Der Beruf selbst bleibt als Stammdatum erhalten und kann weiterhin anderen Bewerbern zugeordnet sein. Zugeordnet werden Berufe \u00FCber \u0060POST /candidates/{id}/professions\u0060. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt.","operationId":"deleteCandidatesProfessionById","parameters":[{"name":"id","in":"path","description":"Id des Bewerbers","required":true,"schema":{"type":"integer"}},{"name":"professionId","in":"path","description":"DKZID des Berufs aus dem Katalog der Bundesagentur f\u00FCr Arbeit \u2014 dieselbe Id wie beim Anlegen. Nicht die Id aus \u0060professionObjects[].id\u0060 der Bewerberdetails.","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Request successful, no content returned"},"404":{"description":"Bewerber oder Beruf nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/qualifications":{"post":{"tags":["Bewerberdetails"],"summary":"Qualifikation anlegen","description":"Mit diesem Endpunkt kann eine Qualifikation f\u00FCr einen Kandidaten angelegt werden.\n\nEs wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.\n\nZus\u00E4tzlich kann ein Score im Bereich von 1 bis 5 oder alternativ der Wert null angegeben werden.\n\n**Neu in V 3.4.0:**\n\n* Eine bereits zugeordnete Qualifikation wird nicht doppelt angelegt, eine zuvor gel\u00F6schte Zuordnung wird reaktiviert. In beiden F\u00E4llen antwortet der Endpunkt mit 200 und derselben \u0060id\u0060 wie beim ersten Anlegen: der Id des Qualifikations-Stammsatzes, die auch \u0060DELETE /candidates/{id}/qualifications/{qualificationId}\u0060 erwartet.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualificationCreateDto"}}}},"responses":{"200":{"description":"OK \u2014 \u0060id\u0060 ist die Id der Qualifikation (Stammsatz, dieselbe Id wie in \u0060qualificationsWithScore[].id\u0060 der Bewerberdetails), nicht die Id der Zuordnung zum Bewerber. Sie ist bei jedem Aufruf mit derselben Qualifikation identisch \u2014 auch wenn die Zuordnung bereits bestand oder reaktiviert wurde \u2014 und wird unver\u00E4ndert in \u0060DELETE /candidates/{id}/qualifications/{qualificationId}\u0060 verwendet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/qualifications/{qualificationId}":{"delete":{"summary":"Qualifikationen l\u00F6schen","description":"Entfernt die Zuordnung einer Qualifikation von einem Bewerber. Die Qualifikation selbst bleibt als Stammdatum erhalten. Zugeordnet werden Qualifikationen \u00FCber \u0060POST /candidates/{id}/qualifications\u0060. Ein erfolgreicher Aufruf liefert 204 ohne Inhalt.","operationId":"deleteCandidatesQualificationById","parameters":[{"name":"id","in":"path","description":"Id des Bewerbers","required":true,"schema":{"type":"integer"}},{"name":"qualificationId","in":"path","description":"Id der Qualifikation","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Request successful, no content returned"},"404":{"description":"Bewerber oder Qualifikation nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/resume/educations":{"post":{"tags":["Bewerberdetails"],"summary":"Weiterbildung anlegen","description":"Mit diesem Endpunkt kann eine Weiterbildung f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateFurtherTrainingDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/resume/jobs":{"post":{"tags":["Bewerberdetails"],"summary":"Beruflichen Werdegang anlegen","description":"Mit diesem Endpunkt kann einen beruflichen Werdegang f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmployerCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/resume/professioneducations":{"post":{"tags":["Bewerberdetails"],"summary":"Berufsausbildung anlegen","description":"Mit diesem Endpunkt kann eine Berufsausbildung f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateProfessionalTrainingDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/resume/schooleducations":{"post":{"tags":["Bewerberdetails"],"summary":"Schulbildung anlegen","description":"Mit diesem Endpunkt kann eine Schule f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateEducationDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/sms":{"post":{"tags":["Bewerberdetails"],"summary":"Sms hinzuf\u00FCgen","description":"Mit diesem Endpunkt kann eine SMS f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsImportDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/status":{"put":{"tags":["Bewerberdetails"],"summary":"Bewerber archivieren/ablehnen/qualifizieren/einstellen","description":"Mit diesem Endpunkt kann man einzelne Bewerber archivieren, ablehnen oder qualifizieren.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003EACHTUNG! Bei Archivierung kann dieser Vorgang nicht r\u00FCckg\u00E4ngig gemacht werden.\u003C/p\u003E\u003C/div\u003E\n\nErlaubte Status Ids sind\n\n-   23 (archiviert)\n    \n-   2003 (einstellen)\n    \n-   2004 (abgelehnt)\n    \n-   2005 (qualifiziert)","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusUpdateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/{id}/whatsapp":{"post":{"tags":["Bewerberdetails"],"summary":"Whats App hinzuf\u00FCgen","description":"Mit diesem Endpunkt kann eine WhatsApp Nachricht f\u00FCr einen Kandidaten angelegt werden.\n\n Es wird die KandidatenId ben\u00F6tigt, welche beim Anlegen der Stammdaten zur\u00FCck gegeben wird.","parameters":[{"name":"id","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhatsAppImportDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/applies/external":{"post":{"tags":["Bewerbungen"],"summary":"Bewerbung auf eine Stellenanzeige \u00FCbertragen","description":"### Bewerbung auf eine Stellenanzeige \u00FCbertragen\n\nMit diesem Endpunkt legt man eine Bewerbung f\u00FCr eine Stellenanzeige an.\n\n Folgende Werte k\u00F6nnen \u00FCbergeben werden:\n\n| Wert | Beschreibung |\n|---|---|\n| officeId | Optional; Id der Niederlassung |\n| channelId | Optional; Gibt die Herkunft der Bewerbung an. Der Standardwert ist 28 (Homepage). |\n| jobAdId | Optional; Id der Stellenanzeige |\n| salutationId | Anrede des Bewerbers 1 = Herr, 2 = Frau, 3 = Keine Angabe |\n| firstName | Vorname des Bewerbers |\n| lastName | Nachname des Bewerbers |\n| city | Ort / Stadt des Bewerbers |\n| zipCode | Postleitzahl des Bewerbers |\n| email | E-Mail Adresse des Bewerbers |\n| phoneNumber | Optional; Telefonnummer des Bewerbers |\n| sourceOfSupplyId | Id der Bezugsquelle |\n| whatsAppConsentChecked | Bewerber hat eingewilligt \u00FCber WhatsApp kontaktiert zu werden |\n| hasWhatsApp | Bewerber hat WhatsApp |\n| privacyChecked | Bewerber hat den Datenschutzbestimmungen zugestimmt |\n| termsOfUseChecked | Bewerber hat den AGB\u0027s zugestimmt |\n| keywords | Schlagworte |\n| documents | Dokumente Die Gr\u00F6\u00DFe des Request-Bodies darf 100MB nicht \u00FCberschreiten. |\n| data | Dokument als Base64 codierter String |\n| fileName | Dateiname |\n| contentType | Dateityp; Erlaubte Typen - image/png - image/jpg - image/jpeg - image/gif - image/tiff - application/pdf - application/msword - application/vnd.openxmlformats-officedocument.wordprocessingml.document - text/plain - application/vnd.oasis.opendocument.text |\n| fileKindId | Dateiart 65 = Zeugnisse 66 = Unbekannt 67 = Lebensl\u00E4ufe 69 = Bewerbungen 722 = F\u00FChrerscheine 1240 = Arbeitserlaubnis |\n\n### Initiativbewerbung \u00FCbertragen\n\nMit diesem Endpunkt legt man eine Initiativ-Bewerbung an.\n\n Folgende Werte k\u00F6nnen \u00FCbergeben werden:\n\n| Wert | Beschreibung |\n|---|---|\n| officeId | Id der Niederlassung |\n| salutationId | Anrede des Bewerbers 1 = Herr, 2 = Frau, 3 = Keine Angabe |\n| firstName | Vorname des Bewerbers |\n| lastName | Nachname des Bewerbers |\n| city | Ort / Stadt des Bewerbers |\n| zipCode | Postleitzahl des Bewerbers |\n| email | EMail Adresse des Bewerbers |\n| phoneNumber | Telefonnummer des Bewerbers |\n| sourceOfSupplyId | Id der Bezugsquelle |\n| whatsAppConsentChecked | Bewerber hat eingewilligt \u00FCber WhatsApp kontaktiert zu werden |\n| hasWhatsApp | Bewerber hat WhatsApp |\n| privacyChecked | Bewerber hat den Datenschutzbestimmungen zugestimmt |\n| termsOfUseChecked | Bewerber hat den AGB\u0027s zugestimmt |\n| documents | Dokumente Die Gr\u00F6\u00DFe des Request-Bodies darf 100MB nicht \u00FCberschreiten. |\n| data | Dokument als Base64 codierter String |\n| fileName | Dateiname |\n| contentType | Dateityp; Erlaubte Typen - image/png - image/jpg - image/jpeg - image/gif - image/tiff - application/pdf - application/msword - application/vnd.openxmlformats-officedocument.wordprocessingml.document - text/plain - application/vnd.oasis.opendocument.text |\n| fileKindId | Dateiart 65 = Zeugnisse 66 = Unbekannt 67 = Lebensl\u00E4ufe 69 = Bewerbungen 722 = F\u00FChrerscheine 1240 = Arbeitserlaubnis |","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyCreateExternalRequest"}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerbungen"}},"/candidates/exists":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Existiert Bewerber mit Email","description":"Dieser Endpunkt pr\u00FCft ob ein Bewerber mit der Email existiert.","parameters":[{"name":"email","in":"query","description":"E-Mail-Adresse des Bewerbers","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateExistsResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"}},"/candidates/export/candidates":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Alle aktiven Bewerber","description":"Dieser Endpunkt gibt alle aktiven Bewerber zur\u00FCck.\n\nOhne officeId werden alle Bewerber \u00FCber alle Niederlassungen zur\u00FCck gegeben.\n\nMit officeId werden nur die Bewerber der jeweiligen Niederlassung zur\u00FCck gegeben.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E","parameters":[{"name":"officeId","in":"query","description":"Identifikation der Niederlassung","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateChangesDto"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"}},"/candidates/export/candidates/{candidateId}":{"get":{"tags":["Bewerberdetails"],"summary":"Bewerberdetails","description":"Dieser Endpunkt gibt ein spezifischer Bewerber zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E","parameters":[{"name":"candidateId","in":"path","description":"Numerische Kennung des Bewerbers (Id), wie sie POST /candidates zur\u00FCckgibt. Die Guid aus GET /candidates wird nicht akzeptiert (400).","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateDetailsDto"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdetails"}},"/candidates/export/candidates/{candidateId}/documents":{"get":{"tags":["Bewerberdokumente"],"summary":"Dokumentenliste pro Bewerber","description":"Dieser Endpunkt gibt eine Liste aller Dokumente pro Bewerber zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E","parameters":[{"name":"candidateId","in":"path","description":"Identifikation des Bewerbers","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateDocumentListDto"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/export/candidates/changes":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Bewerber\u00E4nderungen nach Zeitraum und Niederlassung","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerber in einem Zeitraum von Tagen zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Bewerber (new)\n    \n-   ge\u00E4nderte Bewerber (modified)\n    \n-   gel\u00F6schte Bewerber (deleted)","parameters":[{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"officeId","in":"query","description":"Identifikation der Niederlassung","schema":{"type":"integer"}},{"name":"processStatusId","in":"query","schema":{"$ref":"#/components/schemas/CandidateProcessStatus"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateChangesDto"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"}},"/candidates/export/candidates/changes/{date}":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Bewerber\u00E4nderungen pro Tag","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerber pro Tag zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Bewerber (new)\n    \n-   ge\u00E4nderte Bewerber (modified)\n    \n-   gel\u00F6schte Bewerber (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateChangesDto"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"}},"/candidates/export/candidates/changes/{date}/{hour}":{"get":{"tags":["Bewerber\u00FCbersichten"],"summary":"Bewerber\u00E4nderungen pro Tag und Stunde","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerber pro Tag und Stunde zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Bewerber (new)\n    \n-   ge\u00E4nderte Bewerber (modified)\n    \n-   gel\u00F6schte Bewerber (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}},{"name":"hour","in":"path","description":"Stunde des Tages (0\u201323)","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateChangesDto"}}}},"404":{"description":"Bewerber nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerber\u00FCbersichten"}},"/candidates/export/documents/{documentId}":{"get":{"tags":["Bewerberdokumente"],"summary":"Bewerberdokument","description":"Dieser Endpunkt gibt ein spezifisches Dokument eines Bewerbers zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E","parameters":[{"name":"documentId","in":"path","description":"Identifikation des Dokuments","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateDocumentDto"}}}},"404":{"description":"Dokument nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/export/documents/changes":{"get":{"tags":["Bewerberdokumente"],"summary":"Bewerberdokumenten\u00E4nderungen nach Zeitraum und Niederlassung","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerberdokumente in einem Zeitraum zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Dokumente (new)\n    \n-   ge\u00E4nderte Dokumente (modified)\n    \n-   gel\u00F6schte Dokumente (deleted)","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"officeId","in":"query","description":"Identifikation der Niederlassung","schema":{"type":"integer"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentChangesDto"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/export/documents/changes/{date}":{"get":{"tags":["Bewerberdokumente"],"summary":"Bewerberdokumenten\u00E4nderungen pro Tag","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerberdokumente pro Tag zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Dokumente (new)\n    \n-   ge\u00E4nderte Dokumente (modified)\n    \n-   gel\u00F6schte Dokumente (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentChangesDto"}}}},"404":{"description":"Bewerberdokumente nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/export/documents/changes/{date}/{hour}":{"get":{"tags":["Bewerberdokumente"],"summary":"Bewerberdokumenten\u00E4nderungen pro Tag und Stunde","description":"Dieser Endpunkt gibt die \u00C4nderungen der Bewerberdokumente pro Tag und Stunde zur\u00FCck.\n\n\u003Cdiv data-callout=\u0022warning\u0022\u003E\u003Cp\u003E\u003Cstrong\u003EACHTUNG! Dies sind sensible Daten welche gem\u00E4\u00DF der DSGVO besonders vertraulich behandelt werden m\u00FCssen.\u003C/strong\u003E\u003C/p\u003E\u003C/div\u003E\n\n\u00C4nderungen sind:\n\n-   neue Dokumente (new)\n    \n-   ge\u00E4nderte Dokumente (modified)\n    \n-   gel\u00F6schte Dokumente (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}},{"name":"hour","in":"path","description":"Stunde des Tages (0\u201323)","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentChangesDto"}}}},"404":{"description":"Bewerberdokumente nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Bewerber/Bewerberdokumente"}},"/candidates/sourceofsupplies":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Bezugsquellen","description":"Dieser Endpunkt gibt eine Liste aller Bezugsquellen zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/customers":{"post":{"tags":["Firmendetails"],"summary":"Firma anlegen","description":"Legt eine Firma an und liefert deren Id zur\u00FCck.\n\nPflichtfelder sind \u0060name\u0060, \u0060companyTypeId\u0060 und \u0060responsibility\u0060 (mit \u0060userId\u0060 und \u0060officeId\u0060). Fehlt eines davon, antwortet die API mit 400 und einem Validierungsfehler auf dem jeweiligen Feld.\n\n\u0060companyTypeId\u0060 ist die Rechtsform und wird oft \u00FCbersehen, weil sie in Quellsystemen h\u00E4ufig Teil des Firmennamens ist. G\u00FCltige Werte liefert \u0060GET /masterdata/CompanyTypes\u0060; f\u00FCr \u201Ekeine Angabe\u0022 ist \u0060130\u0060 (Unknown) vorgesehen. Beim \u0060PUT /customers/{customerId}\u0060 und an der Betriebsst\u00E4tte ist das Feld optional.\n\nAdresszeilen (\u0060addressLine1\u0060/\u0060addressLine2\u0060) f\u00FChrt die Firma nicht; die gibt es nur an der Betriebsst\u00E4tte. \u0060geoLat\u0060/\u0060geoLon\u0060 sind nicht schreibbar, die Koordinaten werden aus der Adresse berechnet.\n\n**Neu in V 3.4.0:**\n\n* Endet \u0060name\u0060 auf die Anzeigebezeichnung einer Rechtsform aus \u0060GET /masterdata/CompanyTypes\u0060 (z. B. \u201EMusterfirma GmbH\u0022), wird sie serverseitig abgetrennt: Gespeichert wird \u201EMusterfirma\u0022, \u0060companyTypeId\u0060 wird aus dem Suffix gesetzt und gewinnt \u00FCber einen mitgeschickten Wert. Der l\u00E4ngste Treffer gilt (\u201EGmbH \u0026 Co. KG\u0022 vor \u201EGmbH\u0022), Gro\u00DF-/Kleinschreibung spielt keine Rolle, nur ein ganzes Wort am Ende z\u00E4hlt (\u201EMusterfirma Agrar\u0022 bleibt unangetastet), und ein Name, der nur aus der Rechtsform besteht, bleibt unver\u00E4ndert. Wer den Namen bewusst mit Rechtsform f\u00FChrt, muss damit rechnen, dass er gek\u00FCrzt wird.\n* \u0060corporationId\u0060 ordnet der Firma einen bestehenden Konzern zu. G\u00FCltige Werte liefert \u0060GET /customers/corporations\u0060; eine unbekannte Id liefert 400.\n* Enth\u00E4lt \u0060location.street\u0060 Stra\u00DFe und Hausnummer und fehlt \u0060streetNumber\u0060, zerlegt die API den Wert selbst: Das letzte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt.\n* Der Aufruf ohne Token liefert 401. Bisher endete er in einem 500.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/{customerId}":{"put":{"tags":["Firmendetails"],"summary":"Firma \u00E4ndern","description":"\u00C4ndert die Stammdaten einer Firma. Es werden ausschlie\u00DFlich die im Request-Body \u00FCbermittelten Felder ge\u00E4ndert; nicht \u00FCbermittelte Felder bleiben unver\u00E4ndert (einzige Ausnahme: das Bundesland beim L\u00E4nderwechsel, siehe unten). F\u00FCr den Firmenstatus und den Vertragsstatus gibt es eigene Endpunkte (\u0060PUT /customers/{customerId}/customerstatus\u0060 bzw. \u0060PUT /customers/{customerId}/contractstatus\u0060).\n\n\u0060companyTypeId\u0060 ist beim \u00C4ndern optional; wer nur den Namen \u00E4ndert, muss die Rechtsform nicht mitschicken. Eine Adress\u00E4nderung berechnet die Koordinaten neu; \u0060geoLat\u0060/\u0060geoLon\u0060 sind nicht schreibbar.\n\n**Neu in V 3.4.0:**\n\n* \u0060responsibility\u0060 (\u0060userId\u0060, \u0060officeId\u0060) wird ausgewertet und ge\u00E4ndert; eine unbekannte Id ergibt 400. Bisher wurde das Objekt stillschweigend verworfen.\n* \u0060corporationId\u0060 ordnet der Firma einen bestehenden Konzern zu. G\u00FCltige Werte liefert \u0060GET /customers/corporations\u0060; eine unbekannte Id liefert 400.\n* \u0060createdAtUtc\u0060 wird auch beim \u00C4ndern \u00FCbernommen, gedacht f\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Der \u00C4nderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.\n* Endet ein mitgeschickter \u0060name\u0060 auf die Anzeigebezeichnung einer Rechtsform aus \u0060GET /masterdata/CompanyTypes\u0060 (z. B. \u201EMusterfirma GmbH\u0022), wird sie serverseitig abgetrennt: Gespeichert wird \u201EMusterfirma\u0022, \u0060companyTypeId\u0060 wird aus dem Suffix gesetzt, auch ohne mitgeschicktes Feld, und \u00FCberschreibt einen mitgeschickten Wert. Der l\u00E4ngste Treffer gilt, Gro\u00DF-/Kleinschreibung spielt keine Rolle, nur ein ganzes Wort am Ende z\u00E4hlt, und ein Name, der nur aus der Rechtsform besteht, bleibt unver\u00E4ndert. Wird \u0060name\u0060 nicht mitgeschickt, passiert nichts.\n* L\u00E4nderwechsel: Wird \u0060location.countryId\u0060 auf ein anderes Land ge\u00E4ndert und \u0060location.federalStateId\u0060 nicht mitgeschickt, leert die API das gespeicherte Bundesland, so wie talent.Flow beim L\u00E4nderwechsel. Bisher wurde der Aufruf mit 400 abgelehnt. Ein mitgeschicktes \u0060federalStateId\u0060 muss zum neuen Land geh\u00F6ren, sonst 400 \u0060NotMatchCountry\u0060 auf \u0060FederalStateId\u0060. Bleibt \u0060countryId\u0060 unver\u00E4ndert, bleibt auch das Bundesland stehen.\n* Schl\u00E4gt die Geokodierung fehl, bleiben vorhandene Koordinaten erhalten, statt auf \u0060null\u0060 zur\u00FCckzufallen.\n* Enth\u00E4lt \u0060location.street\u0060 Stra\u00DFe und Hausnummer und fehlt \u0060streetNumber\u0060, zerlegt die API den Wert selbst: Das letzte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Zu \u00E4ndernde Firmendaten. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerChangeDto"}}},"required":true},"responses":{"204":{"description":"Firma ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/{customerId}/contacts":{"post":{"tags":["Firmenkontakte"],"summary":"Kontakt anlegen","description":"Mit diesem Endpunkt kann man einen Kontakt anlegen.\n\nUm diesen neuen Kontakt direkt mit Betriebsst\u00E4tten des Kunden zu verkn\u00FCpfen k\u00F6nnen entsprechende Id\u0027s per \u0060assignedOfficeIds\u0060 \u00FCbergeben werden.\n\n**Neu in V 3.4.0:**\n\n* \u0060linkedInUrl\u0060 und \u0060xingUrl\u0060 werden normalisiert. Akzeptiert wird die vollst\u00E4ndige URL, ein Host ohne Schema (\u0060www.linkedin.com/in/\u2026\u0060) oder nur der Profilpfad (\u0060in/\u2026\u0060, \u0060profile/\u2026\u0060). Gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL. Ein Host, der nicht auf \u0060linkedin.com\u0060 bzw. \u0060xing.com\u0060 endet, liefert 400 mit errorType \u0060InvalidUrl\u0060.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmenkontakte"}},"/customers/{customerId}/contacts/{contactId}":{"put":{"tags":["Firmenkontakte"],"summary":"Kontakt \u00E4ndern","description":"\u00C4ndert die Daten eines Ansprechpartners. Es werden ausschlie\u00DFlich die im Request-Body \u00FCbermittelten Felder ge\u00E4ndert; nicht \u00FCbermittelte Felder bleiben unver\u00E4ndert.\n\n**Betriebsst\u00E4tten-Zuordnung \u00FCber \u0060assignedOfficeIds\u0060.** Das Feld ersetzt die Zuordnung vollst\u00E4ndig: Um einen Kontakt einer weiteren Betriebsst\u00E4tte zuzuordnen, m\u00FCssen alle gew\u00FCnschten Betriebsst\u00E4tten-Ids gemeinsam \u00FCbergeben werden. Ein weggelassenes Feld l\u00E4sst die Zuordnungen unver\u00E4ndert, eine leere Liste (\u0060[]\u0060) entfernt alle Zuordnungen.\n\n**Neu in V 3.4.0:**\n\n* \u0060assignedOfficeIds: null\u0060 wird ignoriert und wirkt wie ein weggelassenes Feld: Die Zuordnungen bleiben, die Antwort ist 204. Bisher f\u00FChrte \u0060null\u0060 zu einem 500. Wer alle Zuordnungen entfernen will, schickt ausdr\u00FCcklich \u0060[]\u0060.\n* \u0060responsibility\u0060 (\u0060userId\u0060, \u0060officeId\u0060) wird ausgewertet und ge\u00E4ndert. Bisher wurde das Objekt stillschweigend verworfen.\n* \u0060createdAtUtc\u0060 wird auch beim \u00C4ndern \u00FCbernommen, gedacht f\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Der \u00C4nderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.\n* \u0060linkedInUrl\u0060 und \u0060xingUrl\u0060 akzeptieren die vollst\u00E4ndige URL, einen Host ohne Schema (\u0060www.xing.com/profile/\u2026\u0060) oder nur den Profilpfad (\u0060in/\u2026\u0060, \u0060profile/\u2026\u0060). Gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL. Ein Host, der nicht auf \u0060linkedin.com\u0060 bzw. \u0060xing.com\u0060 endet, liefert 400 mit errorType \u0060InvalidUrl\u0060. Bisher wurde ein blo\u00DFer Pfad mit 400 abgelehnt.","parameters":[{"name":"contactId","in":"path","description":"Identifikation des Ansprechpartners","required":true,"schema":{"type":"integer"}},{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Zu \u00E4ndernde Kontaktdaten. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert. F\u00FCr die Zuordnung zu Betriebsst\u00E4tten m\u00FCssen alle gew\u00FCnschten Ids per assignedOfficeIds \u00FCbergeben werden.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactChangeDto"}}},"required":true},"responses":{"204":{"description":"Ansprechpartner ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Ansprechpartner nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmenkontakte"},"delete":{"tags":["Firmenkontakte"],"summary":"Kontakt l\u00F6schen","description":"**Neu in V 3.4.0:** L\u00F6scht einen Ansprechpartner der Firma. Bisher lie\u00DF sich ein Kontakt nur \u00FCber \u0060PUT \u2026 assignedOfficeIds: []\u0060 von seinen Betriebsst\u00E4tten l\u00F6sen, aber nicht entfernen.\n\nGel\u00F6scht wird als Soft-Delete, genau wie in talent.Flow: Der Ansprechpartner wird deaktiviert und erscheint nicht mehr in \u0060GET /customers/{id}\u0060, \u0060GET /customers/offices/{officeId}\u0060 und \u0060GET /customers/contacts/{contactId}\u0060. Bei den Berufen der Einsatzorte, die diesen Ansprechpartner tragen, wird die Zuordnung gel\u00F6st; ein hinterlegtes Bild wird entfernt. Anfragen, die auf den Ansprechpartner verweisen, bleiben unver\u00E4ndert. In der Firmenhistorie entsteht eine Aktivit\u00E4t \u201EKontakt \u2026 gel\u00F6scht\u0022.\n\nEin Ansprechpartner, der nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist, ergibt 404.","operationId":"deleteCustomerContact","parameters":[{"name":"contactId","in":"path","description":"Identifikation des Ansprechpartners","required":true,"schema":{"type":"integer"}},{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Ansprechpartner gel\u00F6scht \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Ansprechpartner nicht gefunden \u2014 auch dann, wenn der Ansprechpartner nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmenkontakte"}},"/customers/{customerId}/contractstatus":{"put":{"tags":["Firmendetails"],"summary":"Vertragsabschluss melden","description":"Meldet einen unterzeichneten Vertrag zu einer Anfrage der Firma. \u00DCbergeben werden die Anfrage (\u0060requestId\u0060), optional der vermittelte Bewerber (\u0060candidateId\u0060) und der Zeitpunkt der Unterzeichnung (\u0060contractSignedAtUtc\u0060). Trotz des Pfadnamens \u0060contractstatus\u0060 wird hier kein Statuswert gesetzt; der allgemeine Firmenstatus wird \u00FCber \u0060PUT /customers/{customerId}/customerstatus\u0060 ge\u00E4ndert, der Status einer Anfrage \u00FCber \u0060PUT /customers/{customerId}/requests/{requestId}/status\u0060.\n\nBei Arbeitnehmer\u00FCberlassung ist \u0060candidateId\u0060 Pflicht; fehlt sie, kommt 400 mit ErrorType \u0060Required\u0060 auf \u0060CandidateId\u0060. Einen Endpunkt, um einen Bewerber einer Anfrage zuzuordnen, bietet die Public API nicht; ein Vertragsabschluss l\u00E4sst sich nur f\u00FCr Bewerber melden, die auf einem anderen Weg zugeordnet wurden.\n\n**Neu in V 3.4.0:**\n\n* Der Endpunkt bedient Arbeitnehmer\u00FCberlassung (\u0060EmployeeLeasing\u0060) und Personalvermittlung (\u0060PersonnelPlacement\u0060). F\u00FCr jede andere Vermittlungsart der Anfrage (\u0060None\u0060, \u0060InternalStaffing\u0060, \u0060ServiceContract\u0060) antwortet er mit 400 und einem Validierungsfehler auf \u0060RequestId\u0060 mit dem ErrorType \u0060PlacementTypeNotSupported\u0060, der die tats\u00E4chliche Vermittlungsart als Wert tr\u00E4gt. Bisher kam in diesen F\u00E4llen ein 400 ohne Begr\u00FCndung.\n* Ist der Bewerber der Anfrage nicht zugeordnet, antwortet der Endpunkt mit 404 und einem Validierungsfehler auf \u0060CandidateId\u0060 mit dem ErrorType \u0060NotAssignedToRequest\u0060; existiert der Bewerber nicht, mit 404 und \u0060NotExisting\u0060. Bisher lief der nicht zugeordnete Bewerber in ein 500 \u0060READDATAERROR\u0060.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerContractStatusChangeDto"}}}},"responses":{"204":{"description":"Vertragsabschluss gespeichert, die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/{customerId}/customerstatus":{"put":{"tags":["Firmendetails"],"summary":"Firmen Status \u00E4ndern","description":"Erlaubte Werte:\n\n Kunde: Active oder 5000\n\n Interessent: Prospect oder 5001\n\n Ehemaliger Kunde: Former oder 5002\n\n Abgelehnt: Rejected oder 5003\n\n**Erlaubte \u00DCberg\u00E4nge**, jede andere Kombination wird mit 400 abgelehnt:\n\n| Ist-Status | Erlaubte Zielstatus |\n| --- | --- |\n| Prospect (5001) | Active (5000), Rejected (5003) |\n| Rejected (5003) | Prospect (5001) |\n| Active (5000) | Former (5002), Prospect (5001) |\n| Former (5002) | Active (5000) |\n\nRejected ist nur aus Prospect erreichbar.\n\nBei einem unzul\u00E4ssigen \u00DCbergang enth\u00E4lt \u0060validationErrors\u0060 neben dem allgemeinen Eintrag mit \u0060errorType\u0060 \u0060InvalidData\u0060 einen zweiten Eintrag mit \u0060errorType\u0060 \u0060InvalidStatusTransition\u0060 auf \u0060customerStatusId\u0060. Dessen \u0060value\u0060 ist ein Objekt mit \u0060currentStatus\u0060, \u0060requestedStatus\u0060 und \u0060allowedTargetStatus\u0060 (Statusnamen, z. B. \u0060\u0022Active\u0022\u0060), damit der Client sieht, welche Ziele vom aktuellen Status aus m\u00F6glich sind.\n\nDas Senden des bereits gesetzten Status ist ein No-op und antwortet mit 204.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerProcessStatusChangeDto"}}}},"responses":{"204":{"description":"Status ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler. Fachliche Pr\u00FCfungen antworten als ErrorResponse; scheitert dagegen schon das Binden des Requests (z.B. nicht konvertierbare customerId), liefert das Framework ValidationProblemDetails mit Content-Type application/problem\u002Bjson.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"$ref":"#/components/schemas/ValidationProblemDetails"}]}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/{customerId}/offices":{"post":{"tags":["Beriebsst\u00E4tten"],"summary":"Betriebsst\u00E4tte anlegen","description":"Mit diesem Endpunkt kann man eine Betriebsst\u00E4tte anlegen.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficeCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Betriebsst\u00E4tten"}},"/customers/{customerId}/offices/{officeId}":{"put":{"tags":["Beriebsst\u00E4tten"],"summary":"Betriebsst\u00E4tte \u00E4ndern","description":"\u00C4ndert die Daten einer Betriebsst\u00E4tte einer Firma: Adresse, Kontaktdaten, Firmentyp, Kostenstelle, USt-IdNr. und Zust\u00E4ndigkeit. Es werden ausschlie\u00DFlich die im Request-Body \u00FCbermittelten Felder ge\u00E4ndert; nicht \u00FCbermittelte Felder bleiben unver\u00E4ndert (einzige Ausnahme: das Bundesland beim L\u00E4nderwechsel, siehe unten). Angelegt wird eine Betriebsst\u00E4tte \u00FCber \u0060POST /customers/{customerId}/offices\u0060, gelesen \u00FCber \u0060GET /customers/offices/{officeId}\u0060.\n\nEine Adress\u00E4nderung berechnet die Koordinaten neu; \u0060geoLat\u0060/\u0060geoLon\u0060 sind nicht schreibbar.\n\n**Neu in V 3.4.0:**\n\n* \u0060responsibility\u0060 (\u0060userId\u0060, \u0060officeId\u0060) wird ausgewertet und ge\u00E4ndert; eine unbekannte Id ergibt 400. Bisher wurde das Objekt stillschweigend verworfen.\n* Schl\u00E4gt die Geokodierung fehl, bleiben vorhandene Koordinaten erhalten, statt auf \u0060null\u0060 zur\u00FCckzufallen.\n* L\u00E4nderwechsel: Wird \u0060location.countryId\u0060 auf ein anderes Land ge\u00E4ndert und \u0060location.federalStateId\u0060 nicht mitgeschickt, leert die API das gespeicherte Bundesland, so wie talent.Flow beim L\u00E4nderwechsel. Bisher wurde der Aufruf mit 400 abgelehnt. Ein mitgeschicktes \u0060federalStateId\u0060 muss zum neuen Land geh\u00F6ren, sonst 400 \u0060NotMatchCountry\u0060 auf \u0060FederalStateId\u0060. Bleibt \u0060countryId\u0060 unver\u00E4ndert, bleibt auch das Bundesland stehen.\n* \u0060addressLine1\u0060 und \u0060addressLine2\u0060 werden sowohl auf oberster Ebene als auch in \u0060location\u0060 akzeptiert. Kommt der Wert in beiden, gewinnt der aus \u0060location\u0060. Bisher gingen die Adresszeilen auf oberster Ebene beim \u00C4ndern verloren.\n* Enth\u00E4lt \u0060location.street\u0060 Stra\u00DFe und Hausnummer und fehlt \u0060streetNumber\u0060, zerlegt die API den Wert selbst: Das letzte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt.\n* \u0060createdAtUtc\u0060 wird auch beim \u00C4ndern \u00FCbernommen, gedacht f\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Der \u00C4nderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"officeId","in":"path","description":"Identifikation der Niederlassung","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Zu \u00E4ndernde Daten der Betriebsst\u00E4tte. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficeChangeDto"}}},"required":true},"responses":{"204":{"description":"Betriebsst\u00E4tte ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Betriebsst\u00E4tte nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Betriebsst\u00E4tten"},"delete":{"tags":["Beriebsst\u00E4tten"],"summary":"Betriebsst\u00E4tte l\u00F6schen","description":"**Neu in V 3.4.0:** L\u00F6scht eine Betriebsst\u00E4tte der Firma, etwa um L\u00F6schungen aus einem Fremdsystem zu spiegeln oder Testdaten zu entfernen.\n\nGel\u00F6scht wird als Soft-Delete, genau wie in talent.Flow: Die Betriebsst\u00E4tte wird deaktiviert und erscheint nicht mehr in \u0060GET /customers/{id}\u0060; \u0060GET /customers/offices/{officeId}\u0060 liefert anschlie\u00DFend 404. Einsatzorte, Ansprechpartner-Zuordnungen und Anfragen dieser Betriebsst\u00E4tte bleiben unver\u00E4ndert bestehen. Wer sie ebenfalls entfernen will, l\u00F6scht sie vorher \u00FCber die jeweiligen Endpunkte. In der Firmenhistorie entsteht eine Aktivit\u00E4t \u201EBetriebsst\u00E4tte \u2026 gel\u00F6scht\u0022.\n\nEine Betriebsst\u00E4tte, die nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist, ergibt 404.","operationId":"deleteCustomerOffice","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"officeId","in":"path","description":"Identifikation der Betriebsst\u00E4tte","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Betriebsst\u00E4tte gel\u00F6scht \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Betriebsst\u00E4tte nicht gefunden \u2014 auch dann, wenn die Betriebsst\u00E4tte nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Betriebsst\u00E4tten"}},"/customers/{customerId}/offices/{officeId}/locations":{"post":{"tags":["Einsatzorte"],"summary":"Einsatzort anlegen","description":"Mit diesem Endpunkt kann man einen Einsatzort anlegen.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"officeId","in":"path","description":"Identifikation der Niederlassung","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Einsatzorte"}},"/customers/{customerId}/offices/{officeId}/locations/{locationId}":{"put":{"tags":["Einsatzorte"],"summary":"Einsatzort \u00E4ndern","description":"**Neu in V 3.4.0:** \u00C4ndert die Daten eines Einsatzortes: Bezeichnung, Anfahrtshinweise, Ansprechpartner, externe Id und Adresse. Es werden ausschlie\u00DFlich die im Request-Body \u00FCbermittelten Felder ge\u00E4ndert; nicht \u00FCbermittelte Felder bleiben unver\u00E4ndert (einzige Ausnahme: das Bundesland beim L\u00E4nderwechsel, siehe unten).\n\nDas **Umh\u00E4ngen auf eine andere Betriebsst\u00E4tte ist nicht m\u00F6glich**: Die Betriebsst\u00E4tte kommt aus der Route, ein \u0060officeId\u0060 im Body wird nicht ausgewertet. Diese Einschr\u00E4nkung gilt systemweit, auch talent.Flow kann einen Einsatzort nicht umh\u00E4ngen.\n\nGeh\u00F6rt der Einsatzort zu einer anderen Betriebsst\u00E4tte oder die Betriebsst\u00E4tte zu einer anderen Firma, antwortet der Endpunkt mit 404.\n\nEine Adress\u00E4nderung berechnet die Koordinaten neu; \u0060geoLat\u0060/\u0060geoLon\u0060 sind nicht schreibbar. Schl\u00E4gt die Geokodierung fehl, bleiben vorhandene Koordinaten erhalten.\n\nL\u00E4nderwechsel: Wird \u0060location.countryId\u0060 auf ein anderes Land ge\u00E4ndert und \u0060location.federalStateId\u0060 nicht mitgeschickt, leert die API das gespeicherte Bundesland, so wie talent.Flow beim L\u00E4nderwechsel. Ein mitgeschicktes \u0060federalStateId\u0060 gilt unver\u00E4ndert. Bleibt \u0060countryId\u0060 unver\u00E4ndert, bleibt auch das Bundesland stehen.\n\nEnth\u00E4lt \u0060location.street\u0060 Stra\u00DFe und Hausnummer und fehlt \u0060streetNumber\u0060, zerlegt die API den Wert selbst: Das letzte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt.\n\n\u0060createdAtUtc\u0060 wird beim \u00C4ndern \u00FCbernommen, gedacht f\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Der \u00C4nderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.\n\nAngelegt wird ein Einsatzort \u00FCber \u0060POST /customers/{customerId}/offices/{officeId}/locations\u0060, gelesen \u00FCber \u0060GET /customers/locations/{locationId}\u0060.","operationId":"updateCustomerOfficeLocation","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"locationId","in":"path","description":"Identifikation des Einsatzortes","required":true,"schema":{"type":"integer"}},{"name":"officeId","in":"path","description":"Identifikation der Betriebsst\u00E4tte, zu der der Einsatzort geh\u00F6rt","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Zu \u00E4ndernde Daten des Einsatzortes. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationChangeDto"}}},"required":true},"responses":{"204":{"description":"Einsatzort ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma, Betriebsst\u00E4tte oder Einsatzort nicht gefunden \u2014 auch dann, wenn der Einsatzort zu einer anderen Betriebsst\u00E4tte geh\u00F6rt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Einsatzorte"},"delete":{"tags":["Einsatzorte"],"summary":"Einsatzort l\u00F6schen","description":"**Neu in V 3.4.0:** L\u00F6scht einen Einsatzort der Betriebsst\u00E4tte, etwa um L\u00F6schungen aus einem Fremdsystem zu spiegeln oder Testdaten zu entfernen.\n\nGel\u00F6scht wird als Soft-Delete, genau wie in talent.Flow: Der Einsatzort wird deaktiviert; \u0060GET /customers/locations/{locationId}\u0060 liefert anschlie\u00DFend 404. Berufe des Einsatzorts und Anfragen, die auf ihn verweisen, bleiben unver\u00E4ndert bestehen. In der Firmenhistorie entsteht eine Aktivit\u00E4t \u201EEinsatzort \u2026 gel\u00F6scht\u0022.\n\nDie ganze Kette muss stimmen: Die Betriebsst\u00E4tte geh\u00F6rt zur Firma und der Einsatzort zur Betriebsst\u00E4tte, sonst 404. Ein bereits gel\u00F6schter Einsatzort ergibt ebenfalls 404.","operationId":"deleteCustomerOfficeLocation","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"locationId","in":"path","description":"Identifikation des Einsatzorts","required":true,"schema":{"type":"integer"}},{"name":"officeId","in":"path","description":"Identifikation der Betriebsst\u00E4tte","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Einsatzort gel\u00F6scht \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma, Betriebsst\u00E4tte oder Einsatzort nicht gefunden \u2014 auch dann, wenn die Kette Firma \u2192 Betriebsst\u00E4tte \u2192 Einsatzort nicht stimmt oder der Einsatzort bereits gel\u00F6scht ist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Einsatzorte"}},"/customers/{customerId}/professions":{"post":{"tags":["Firmendetails"],"summary":"Beruf anlegen","description":"Mit diesem Endpunkt kann man einen Beruf anlegen.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationProfessionCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/{customerId}/requests/{requestId}":{"put":{"tags":["Anfragendetails"],"summary":"Anfrage umh\u00E4ngen (Betriebsst\u00E4tte, Einsatzort, Ansprechpartner)","description":"**Neu in V 3.4.0:** \u00C4ndert die drei Beziehungsfelder einer Anfrage: Betriebsst\u00E4tte, Einsatzort und Ansprechpartner. Der fachliche Inhalt der Anfrage (T\u00E4tigkeit, Menge, Verg\u00FCtung, Listen) und ihr Status sind \u00FCber diesen Endpunkt nicht \u00E4nderbar; der Status l\u00E4uft weiterhin \u00FCber \u0060PUT /customers/{customerId}/requests/{requestId}/status\u0060.\n\n**Teilweise Angaben werden gegen den Bestand validiert.** Nicht mitgeschickte Werte werden aus der Anfrage \u00FCbernommen, und gepr\u00FCft wird immer die resultierende Kombination mit derselben Konsistenzkette wie beim Anlegen:\n\n* der Ansprechpartner geh\u00F6rt zum Kunden,\n* die Betriebsst\u00E4tte geh\u00F6rt zum Kunden,\n* der Einsatzort geh\u00F6rt zur Betriebsst\u00E4tte,\n* der Ansprechpartner ist der Betriebsst\u00E4tte zugeordnet.\n\nWer nur \u0060officeId\u0060 schickt, bekommt 400, wenn der bestehende Einsatzort nicht zur neuen Betriebsst\u00E4tte geh\u00F6rt. Beim Umh\u00E4ngen deshalb alle drei Ids gemeinsam schicken.\n\nGeh\u00F6rt die Anfrage zu einer anderen Firma oder existiert sie nicht, antwortet der Endpunkt mit 404.","operationId":"updateCustomerRequest","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"requestId","in":"path","description":"Identifikation der Anfrage","required":true,"schema":{"type":"integer"}}],"requestBody":{"description":"Die neuen Beziehungsfelder der Anfrage. Nicht mitgeschickte Werte werden aus der Anfrage \u00FCbernommen.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestChangeDto"}}},"required":true},"responses":{"204":{"description":"Anfrage ge\u00E4ndert \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler \u2014 insbesondere eine inkonsistente Kombination aus Betriebsst\u00E4tte, Einsatzort und Ansprechpartner. Die Validierungsfehler sind dieselben wie beim Anlegen der Anfrage.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Anfrage nicht gefunden \u2014 auch dann, wenn die Anfrage zu einer anderen Firma geh\u00F6rt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"},"delete":{"tags":["Anfragendetails"],"summary":"Anfrage l\u00F6schen","description":"**Neu in V 3.4.0:** L\u00F6scht eine Anfrage der Firma, etwa um L\u00F6schungen aus einem Fremdsystem zu spiegeln oder Testdaten zu entfernen.\n\nGel\u00F6scht wird als Soft-Delete, genau wie in talent.Flow: Die Anfrage wird deaktiviert und liefert unter \u0060GET /requests/{id}\u0060 anschlie\u00DFend 404. Bewerbervorstellungen, Schlagw\u00F6rter, Schichten und F\u00FChrerscheine der Anfrage bleiben als Historie erhalten. Wer eine Anfrage fachlich beenden statt l\u00F6schen will, nutzt weiterhin \u0060PUT /customers/{customerId}/requests/{requestId}/status\u0060.\n\nEine Anfrage, die nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist, ergibt 404.","operationId":"deleteCustomerRequest","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"requestId","in":"path","description":"Identifikation der Anfrage","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"Anfrage gel\u00F6scht \u2014 die API antwortet ohne Inhalt."},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma oder Anfrage nicht gefunden \u2014 auch dann, wenn die Anfrage nicht zu dieser Firma geh\u00F6rt oder bereits gel\u00F6scht ist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/customers/{customerId}/requests/{requestId}/status":{"put":{"tags":["Anfragendetails"],"summary":"Anfragestatus \u00E4ndern","description":"\u00DCber diesen Endpunkt kann man den Anfragestatus \u00E4ndern.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}},{"name":"requestId","in":"path","description":"Identifikation der Anfrage","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestProcessStatusChangeDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseSuccessResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler. Fachliche Pr\u00FCfungen antworten als ErrorResponse; scheitert dagegen schon das Binden des Requests (z.B. unbekannter Wert f\u00FCr processStatusId), liefert das Framework ValidationProblemDetails mit Content-Type application/problem\u002Bjson.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"$ref":"#/components/schemas/ValidationProblemDetails"}]}}}},"404":{"description":"Firma oder Anfrage nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/customers/{customerId}/requests/directtransmission":{"post":{"tags":["Anfragendetails"],"summary":"Anfrage f\u00FCr Direktvermittlung anlegen","description":"Mit diesem Endpunkt kann man eine Anfrage f\u00FCr eine Direktvermittlung anlegen.\n\n**Neu in V 3.4.0:**\n\n* Die Zuordnungen \u0060shiftIds\u0060, \u0060driversLicenseIds\u0060, \u0060qualifications\u0060 und \u0060keywords\u0060 werden zusammen mit der Anfrage angelegt. Schl\u00E4gt einer dieser Schritte fehl, wird die Anfrage nicht angelegt und der Aufruf antwortet mit dem Fehler. Bisher wurden solche Fehler verworfen und die Anfrage ohne die betroffenen Zuordnungen mit \u0060200\u0060 gespeichert.\n* Jede Schicht-Id muss ein Wert aus \u0060/masterdata/shifts\u0060 sein, jede F\u00FChrerschein-Id ein Wert aus \u0060/masterdata/driverslicenses\u0060. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert \u0060400\u0060 mit dem Validierungsfehler \u0060NotExisting\u0060 auf \u0060ShiftIds\u0060 bzw. \u0060DriversLicenseIds\u0060. Bisher lief eine unbekannte Id in \u0060500 CREATEDATAERROR\u0060 und hinterlie\u00DF eine Anfrage ohne Zuordnungen.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestDirectTransmissionCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/customers/{customerId}/requests/employeeleasing":{"post":{"tags":["Anfragendetails"],"summary":"Anfrage f\u00FCr A\u00DCV anlegen","description":"Mit diesem Endpunkt kann man eine Anfrage f\u00FCr die Arbeitnehmer\u00FCberlassung anlegen.\n\n**Neu in V 3.4.0:**\n\n* Die Zuordnungen \u0060shiftIds\u0060, \u0060driversLicenseIds\u0060, \u0060qualifications\u0060 und \u0060keywords\u0060 werden zusammen mit der Anfrage angelegt. Schl\u00E4gt einer dieser Schritte fehl, wird die Anfrage nicht angelegt und der Aufruf antwortet mit dem Fehler. Bisher wurden solche Fehler verworfen und die Anfrage ohne die betroffenen Zuordnungen mit \u0060200\u0060 gespeichert.\n* Jede Schicht-Id muss ein Wert aus \u0060/masterdata/shifts\u0060 sein, jede F\u00FChrerschein-Id ein Wert aus \u0060/masterdata/driverslicenses\u0060. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert \u0060400\u0060 mit dem Validierungsfehler \u0060NotExisting\u0060 auf \u0060ShiftIds\u0060 bzw. \u0060DriversLicenseIds\u0060. Bisher lief eine unbekannte Id in \u0060500 CREATEDATAERROR\u0060 und hinterlie\u00DF eine Anfrage ohne Zuordnungen.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestEmployeeLeasingCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/customers/{customerId}/requests/servicecontract":{"post":{"tags":["Anfragendetails"],"summary":"Anfrage f\u00FCr Dienstleistungsvertrag anlegen","description":"Mit diesem Endpunkt kann man eine Anfrage f\u00FCr einen Dienstleistungsvertrag anlegen.\n\n**Neu in V 3.4.0:**\n\n* Die Zuordnungen \u0060shiftIds\u0060, \u0060driversLicenseIds\u0060, \u0060qualifications\u0060 und \u0060keywords\u0060 werden zusammen mit der Anfrage angelegt. Schl\u00E4gt einer dieser Schritte fehl, wird die Anfrage nicht angelegt und der Aufruf antwortet mit dem Fehler. Bisher wurden solche Fehler verworfen und die Anfrage ohne die betroffenen Zuordnungen mit \u0060200\u0060 gespeichert.\n* Jede Schicht-Id muss ein Wert aus \u0060/masterdata/shifts\u0060 sein, jede F\u00FChrerschein-Id ein Wert aus \u0060/masterdata/driverslicenses\u0060. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert \u0060400\u0060 mit dem Validierungsfehler \u0060NotExisting\u0060 auf \u0060ShiftIds\u0060 bzw. \u0060DriversLicenseIds\u0060. Bisher lief eine unbekannte Id in \u0060500 CREATEDATAERROR\u0060 und hinterlie\u00DF eine Anfrage ohne Zuordnungen.\n* Die Vertrags- und Konditionsfelder in \u0060request\u0060 werden gespeichert und validiert: \u0060contractDurationId\u0060 (\u0060/masterdata/contractdurations\u0060), \u0060contractLimitedUntilUtc\u0060, \u0060contractLimitedFor\u0060, \u0060contractLimitedForPeriodId\u0060, \u0060workingTimeModelId\u0060, \u0060workPlaceId\u0060 (\u0060/masterdata/workplaces\u0060), \u0060primaryLanguageId\u0060, \u0060primaryLanguageLevelId\u0060, \u0060secondaryLanguageId\u0060, \u0060secondaryLanguageLevelId\u0060, \u0060companyCarBudget\u0060 und \u0060additionalBenefits\u0060. Eine unbekannte Stammdaten-Id liefert \u0060400\u0060 mit einem Validierungsfehler auf dem jeweiligen Feld. Bisher wurden diese zw\u00F6lf Felder still verworfen und blieben in \u0060GET /requests/{id}\u0060 leer.","parameters":[{"name":"customerId","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestServiceContractCreateDto"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCreateResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/customers/{id}":{"get":{"tags":["Firmendetails"],"summary":"Firmendetails lesen","description":"Dieser Endpunkt gibt eine spezifische Firma zur\u00FCck.\n\n**Neu in V 3.4.0:**\n\n* \u0060notes\u0060 und \u0060ranking\u0060 werden gelesen. Bisher lie\u00DFen sich beide Felder nur \u00FCber \u0060POST /customers\u0060 schreiben, aber nicht auslesen.\n* \u0060corporationId\u0060 und \u0060corporation\u0060 liefern den zugeordneten Konzern (Id und Name). G\u00FCltige Werte f\u00FCr \u0060corporationId\u0060 liefert \u0060GET /customers/corporations\u0060.\n* \u0060contacts[].linkedInUrl\u0060 und \u0060contacts[].xingUrl\u0060 werden vollst\u00E4ndig mit Host geliefert (\u0060https://www.linkedin.com/\u2026\u0060, \u0060https://www.xing.com/\u2026\u0060), ohne Wert \u0060null\u0060, dasselbe Format wie an \u0060GET /customers/contacts/{contactId}\u0060. Bisher stand hier nur der gespeicherte Profilpfad.\n* Der Aufruf ohne Token liefert 401. Bisher endete er in einem 500.","parameters":[{"name":"id","in":"path","description":"Identifikation des Kunden","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerReadDto"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/changes":{"get":{"tags":["Firmen\u00FCbersichten"],"summary":"Firmen\u00E4nderungen nach Zeitraum und Niederlassung","description":"Dieser Endpunkt gibt die \u00C4nderungen der Firmen in einem Datumsbereich zur\u00FCck.\n\n\u00C4nderungen sind:\n\n-   neue Firmen (new)\n    \n-   ge\u00E4nderte Firmen (modified)\n    \n-   gel\u00F6schte Firmen (deleted)","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"officeId","in":"query","description":"Identifikation der Niederlassung","schema":{"type":"integer"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmen\u00FCbersichten"}},"/customers/changes/{date}":{"get":{"tags":["Firmen\u00FCbersichten"],"summary":"Firmen\u00E4nderungen pro Tag","description":"Dieser Endpunkt gibt die \u00C4nderungen der Firmen pro Tag zur\u00FCck.\n\n\u00C4nderungen sind:\n\n-   neue Firmen (new)\n    \n-   ge\u00E4nderte Firmen (modified)\n    \n-   gel\u00F6schte Firmen (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmen\u00FCbersichten"}},"/customers/changes/{date}/{hour}":{"get":{"tags":["Firmen\u00FCbersichten"],"summary":"Firmen\u00E4nderungen pro Tag und Stunde","description":"Dieser Endpunkt gibt die \u00C4nderungen der Firmen pro Tag und Stunde zur\u00FCck.\n\n\u00C4nderungen sind:\n\n-   neue Firmen (new)\n    \n-   ge\u00E4nderte Firmen (modified)\n    \n-   gel\u00F6schte Firmen (deleted)","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}},{"name":"hour","in":"path","description":"Stunde des Tages (0\u201323)","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"}}}},"404":{"description":"Firma nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmen\u00FCbersichten"}},"/customers/contacts/{contactId}":{"get":{"tags":["Firmenkontakte"],"summary":"Kontakt lesen","description":"Liest einen Ansprechpartner anhand seiner Id. Die Firma muss nicht mit angegeben werden.\n\nDie Antwort enth\u00E4lt alle Stamm- und Kontaktdaten des Ansprechpartners, seine Zust\u00E4ndigkeit und die Ids der zugeordneten Betriebsst\u00E4tten, dazu Id und Name der Firma.\n\nZum \u00C4ndern eines Ansprechpartners dient \u0060PUT /customers/{customerId}/contacts/{contactId}\u0060, zum Anlegen \u0060POST /customers/{customerId}/contacts\u0060.\n\n**Neu in V 3.4.0:**\n\n* \u0060linkedInUrl\u0060 und \u0060xingUrl\u0060 werden vollst\u00E4ndig mit Host geliefert (\u0060https://www.linkedin.com/\u2026\u0060, \u0060https://www.xing.com/\u2026\u0060), ohne Wert \u0060null\u0060. Dasselbe Format gilt jetzt auch in \u0060contacts[]\u0060 der Firmen- und Betriebsst\u00E4ttendetails.\n* Eine unbekannte oder gel\u00F6schte Id liefert 404 mit \u0060ErrorResponse\u0060. Bisher antwortete der Endpunkt in diesem Fall mit 204 ohne Inhalt.","parameters":[{"name":"contactId","in":"path","description":"Identifikation des Ansprechpartners","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK \u2014 der Ansprechpartner mit allen Stamm- und Kontaktdaten sowie der zugeh\u00F6rigen Firma.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactDetailsReadDto"}}}},"404":{"description":"Ansprechpartner nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmenkontakte"}},"/customers/corporations":{"get":{"tags":["Firmendetails"],"summary":"Konzerne lesen","description":"**Neu in V 3.4.0:** Liefert die aktiven Konzerne (Unternehmensgruppen) des Accounts mit Id, Name und externer Id. Die hier gelieferten Ids sind die zul\u00E4ssigen Werte f\u00FCr \u0060corporationId\u0060 an \u0060POST /customers\u0060 und \u0060PUT /customers/{customerId}\u0060.\n\nDer Katalog liegt bewusst nicht unter \u0060/masterdata\u0060: Konzerne sind Kundenstammdaten des Accounts, keine systemweit geteilten Stammdaten. Die Antwort tr\u00E4gt zus\u00E4tzlich die einheitliche Form \u0060values\u0060, die alle Katalog-Endpunkte verwenden.\n\nNeue Konzerne legt die Public API nicht an; das bleibt Stammdatenpflege in der Oberfl\u00E4che.","operationId":"getCustomerCorporations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorporationsResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Firmendetails"}},"/customers/locations/{locationId}":{"get":{"tags":["Einsatzorte"],"summary":"Einsatzort lesen","description":"Liest die Detaildaten eines Einsatzorts anhand seiner Id, einschlie\u00DFlich Adresse, Anfahrtshinweisen sowie der zugeh\u00F6rigen Firma und Betriebsst\u00E4tte. Der Einsatzort wird direkt adressiert, Firma und Betriebsst\u00E4tte m\u00FCssen nicht mit angegeben werden. Angelegt wird ein Einsatzort \u00FCber \u0060POST /customers/{customerId}/offices/{officeId}/locations\u0060, ge\u00E4ndert \u00FCber \u0060PUT /customers/{customerId}/offices/{officeId}/locations/{locationId}\u0060; die Einsatzorte einer Betriebsst\u00E4tte stehen au\u00DFerdem in der Liste \u0060locations\u0060 an \u0060GET /customers/offices/{officeId}\u0060.\n\n**Neu in V 3.4.0:**\n\n* \u0060importExternalId\u0060 und \u0060importedAtUtc\u0060 werden ausgegeben. Bisher waren beide Felder an Einsatzorten immer \u0060null\u0060, obwohl der Wert beim Anlegen gespeichert wurde.\n* Eine unbekannte oder gel\u00F6schte Id liefert 404 mit \u0060ErrorResponse\u0060. Bisher antwortete der Endpunkt in diesem Fall mit 204 ohne Inhalt.","parameters":[{"name":"locationId","in":"path","description":"Identifikation des Standorts","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationDetailsReadDto"}}}},"404":{"description":"Einsatzort nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Einsatzorte"}},"/customers/offices/{officeId}":{"get":{"tags":["Beriebsst\u00E4tten"],"summary":"Betriebsst\u00E4tte lesen","description":"Liest die Detaildaten einer Betriebsst\u00E4tte anhand ihrer Id, einschlie\u00DFlich Adresse, Zust\u00E4ndigkeit, zugeordneter Ansprechpartner und Einsatzorte. Die Betriebsst\u00E4tte wird direkt adressiert, die Firma muss nicht mit angegeben werden. Zum \u00C4ndern dient \u0060PUT /customers/{customerId}/offices/{officeId}\u0060, zum Anlegen \u0060POST /customers/{customerId}/offices\u0060.\n\n**Neu in V 3.4.0:**\n\n* \u0060contacts[].assignedOfficeIds\u0060 ist nie mehr \u0060null\u0060 und enth\u00E4lt alle Betriebsst\u00E4tten-Zuordnungen des Ansprechpartners, nicht nur die der abgefragten Betriebsst\u00E4tte. Damit liefert das Feld dasselbe wie an \u0060GET /customers/{id}\u0060 und \u0060GET /customers/contacts/{contactId}\u0060. Bisher war die Liste an diesem Endpunkt immer \u0060null\u0060.\n* \u0060contacts[].linkedInUrl\u0060 und \u0060contacts[].xingUrl\u0060 werden vollst\u00E4ndig mit Host geliefert (\u0060https://www.linkedin.com/\u2026\u0060, \u0060https://www.xing.com/\u2026\u0060), ohne Wert \u0060null\u0060. Bisher stand hier nur der gespeicherte Profilpfad.\n* Die Einsatzorte in \u0060locations[]\u0060 f\u00FChren \u0060importExternalId\u0060 und \u0060importedAtUtc\u0060.\n* Eine unbekannte oder gel\u00F6schte Id liefert 404 mit \u0060ErrorResponse\u0060. Bisher antwortete der Endpunkt in diesem Fall mit 204 ohne Inhalt.","parameters":[{"name":"officeId","in":"path","description":"Identifikation der Niederlassung","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfficeDetailsReadDto"}}}},"404":{"description":"Betriebsst\u00E4tte nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Firmen/Betriebsst\u00E4tten"}},"/jobads":{"get":{"tags":["Stellenanzeigen\u00FCbersichten"],"summary":"Stellenanzeigen auflisten","description":"Dieser Endpunkt gibt eine Liste von Stellenanzeigen zur\u00FCck.\n\n\u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden. Ohne Angabe werden alle Stellenanzeigen zur\u00FCckgegeben.","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ReadAllJobAdsResponse"}}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigen\u00FCbersichten"}},"/jobads/{id}/statistics/organic":{"get":{"tags":["Stellenanzeigenauswertungen"],"summary":"Organische Statistik einer Anzeige","description":"Dieser Endpunkt gibt die organischen Statistikkennzahlen einer einzelnen Stellenanzeige zur\u00FCck. Die Kennzahlen sind je Kanal aufgeschl\u00FCsselt.\n\n\u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden.","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"id","in":"path","description":"Identifikation der Stellenanzeige","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicStatisticsResponse"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigenauswertungen"}},"/jobads/{id}/statistics/performance":{"get":{"tags":["Stellenanzeigenauswertungen"],"summary":"Performance-Statistik einer Anzeige","description":"Dieser Endpunkt gibt die Performance-Statistikkennzahlen einer einzelnen Stellenanzeige zur\u00FCck. Die Kennzahlen sind je Kanal aufgeschl\u00FCsselt.\n\n\u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format: YYYY-MM-DD) kann die Ausgabe auf einen Zeitraum eingegrenzt werden.","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"id","in":"path","description":"Identifikation der Stellenanzeige","required":true,"schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceStatisticsResponse"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigenauswertungen"}},"/jobads/{jobAdId}":{"get":{"tags":["Stellenanzeigendetails"],"summary":"Stellenanzeigendetails","description":"Dieser Endpunkt gibt ein spezifischer Stellenanzeige zur\u00FCck.","parameters":[{"name":"jobAdId","in":"path","description":"Identifikation der Stellenanzeige","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadJobAdByIdResponse"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigendetails"}},"/jobads/changes":{"get":{"tags":["Stellenanzeigen\u00FCbersichten"],"summary":"Stellenanzeigen\u00E4nderungen nach Zeitraum und Niederlassung","description":"Dieser Endpunkt gibt die \u00C4nderungen der Stellenanzeigen in einem Zeitraum von Tagen zur\u00FCck.\n\n Die Eigenschaft \u0022ProcessStatus\u0022 gibt den aktuellen Zustand der Stellenanzeige an.\n\n Die Stellenanzeige kann folgende Zust\u00E4nde einnehmen\n\n- **Editing**: Die Stellenanzeige ist noch im Entwurf und nicht ver\u00F6ffentlicht.\n\n- **Active**: Die Stellenanzeige ist auf bewerbungs.jobs ver\u00F6ffentlicht und kann auf anderen Plattformen ausgespielt werden\n\n- **Completed**: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"officeId","in":"query","description":"Identifikation der Niederlassung","schema":{"type":"integer"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAdChangesDto"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigen\u00FCbersichten"}},"/jobads/changes/{date}":{"get":{"tags":["Stellenanzeigen\u00FCbersichten"],"summary":"Stellenanzeigen\u00E4nderungen pro Tag","description":"Dieser Endpunkt gibt die \u00C4nderungen der Stellenanzeigen pro Tag zur\u00FCck.\n\n Die Eigenschaft \u0022ProcessStatus\u0022 gibt den aktuellen Zustand der Stellenanzeige an.\n\n Die Stellenanzeige kann folgende Zust\u00E4nde einnehmen\n\n- **Editing**: Die Stellenanzeige ist noch im Entwurf und nicht ver\u00F6ffentlicht.\n\n- **Active**: Die Stellenanzeige ist auf bewerbungs.jobs ver\u00F6ffentlicht und kann auf anderen Plattformen ausgespielt werden\n\n- **Completed**: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAdChangesDto"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigen\u00FCbersichten"}},"/jobads/changes/{date}/{hour}":{"get":{"tags":["Stellenanzeigen\u00FCbersichten"],"summary":"Stellenanzeigen\u00E4nderungen pro Tag und Stunde","description":"Dieser Endpunkt gibt die \u00C4nderungen der Stellenanzeigen pro Tag und Stunde zur\u00FCck.\n\n Die Eigenschaft \u0022ProcessStatus\u0022 gibt den aktuellen Zustand der Stellenanzeige an.\n\n Die Stellenanzeige kann folgende Zust\u00E4nde einnehmen\n\n- **Editing**: Die Stellenanzeige ist noch im Entwurf und nicht ver\u00F6ffentlicht.\n\n- **Active**: Die Stellenanzeige ist auf bewerbungs.jobs ver\u00F6ffentlicht und kann auf anderen Plattformen ausgespielt werden\n\n- **Completed**: Die Stellenanzeige wurde aus bewerbung.jobs entfernt und kann nicht mehr auf anderen Plattformen ausgespielt werden","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}},{"name":"hour","in":"path","description":"Stunde des Tages (0\u201323)","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobAdChangesDto"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigen\u00FCbersichten"}},"/jobads/statistics/organic/{date}":{"get":{"tags":["Stellenanzeigenauswertungen"],"summary":"Organische Statistik (Stichtag)","description":"Dieser Endpunkt gibt die organischen Statistikkennzahlen aller Stellenanzeigen f\u00FCr den im Pfad angegebenen Tag (\u0060date\u0060, Format: YYYY-MM-DD) zur\u00FCck. Die Kennzahlen sind je Kanal aufgeschl\u00FCsselt.","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicStatisticsResponse"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigenauswertungen"}},"/jobads/statistics/performance/{date}":{"get":{"tags":["Stellenanzeigenauswertungen"],"summary":"Performance-Statistik (Stichtag)","description":"Dieser Endpunkt gibt die Performance-Statistikkennzahlen aller Stellenanzeigen f\u00FCr den im Pfad angegebenen Tag (\u0060date\u0060, Format: YYYY-MM-DD) zur\u00FCck. Die Kennzahlen sind je Kanal aufgeschl\u00FCsselt.","parameters":[{"name":"date","in":"path","description":"Stichtag im Format YYYY-MM-DD","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceStatisticsResponse"}}}},"404":{"description":"Stellenanzeige nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigenauswertungen"}},"/masterdata/bonustypes":{"get":{"summary":"Bonusarten","description":"Liefert die Stammdatenliste der Bonusarten als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060bonusTypeId\u0060 einzusetzen, etwa in der Gehaltsvorstellung eines Bewerbers (\u0060salaryExpectations.bonusTypeId\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataBonustypes","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/contractdurations":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Vertragslaufzeiten","description":"**Neu in V 3.4.0:** Liefert die Stammdatenliste der Vertragslaufzeiten als Id-Wert-Paare. Die Ids sind als \u0060contractDurationId\u0060 einzusetzen, etwa beim Anlegen einer Anfrage (\u0060POST /customers/{customerId}/requests/directtransmission\u0060 und \u0060\u2026/servicecontract\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataContractdurations","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/countries":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"L\u00E4nder","description":"Dieser Endpunkt gibt eine Liste aller L\u00E4nder zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CountriesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/currencies":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"W\u00E4hrungen","description":"**Neu in V 3.4.0:** Liefert die Stammdatenliste der W\u00E4hrungen mit Bezeichnung, ISO-Code und Symbol. Die Ids sind als \u0060serviceContractWageCurrencyId\u0060 bzw. \u0060wageCurrencyId\u0060 einzusetzen, etwa beim Anlegen einer Anfrage. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.\n\nAnders als die Enum-Gruppen stammen W\u00E4hrungen aus einer eigenen Stammdatentabelle. Die Antwort tr\u00E4gt deshalb wie L\u00E4nder, Sprachen und Bundesl\u00E4nder einen eigenen Schl\u00FCssel (\u0060currencies\u0060) mit den fachlichen Feldern statt der generischen \u0060values\u0060-Liste.","operationId":"getMasterdataCurrencies","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrenciesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/disabilitytypes":{"get":{"summary":"Arten der Behinderung","description":"Liefert die Stammdatenliste der Behinderungsarten als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids werden bei den Angaben zur Schwerbehinderung eines Bewerbers (\u0060disability\u0060) verwendet. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataDisabilitytypes","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/driverslicenses":{"get":{"summary":"F\u00FChrerscheine","description":"Liefert die Stammdatenliste der F\u00FChrerscheinklassen als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060driversLicenseId\u0060 einzusetzen, etwa beim Anlegen eines F\u00FChrerscheins zu einem Bewerber (\u0060POST /candidates/{id}/driverslicences\u0060) sowie als \u0060driversLicenseIds\u0060 in den Anforderungen einer Anfrage. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataDriverslicenses","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/employmenttypes":{"get":{"summary":"Arbeitszeitmodelle","description":"Liefert die Stammdatenliste der Arbeitszeitmodelle (Besch\u00E4ftigungsarten) als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060employmentTypeId\u0060 einzusetzen, etwa in den Arbeitspr\u00E4ferenzen eines Bewerbers (\u0060workingPreferences.employmentTypeId\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataEmploymenttypes","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/federalstates":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Bundesl\u00E4nder","description":"Dieser Endpunkt gibt eine Liste aller Bundesl\u00E4nder zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FederalStatesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/genders":{"get":{"summary":"Geschlechter","description":"Liefert die Stammdatenliste der Geschlechter als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060genderId\u0060 einzusetzen, etwa beim Anlegen (\u0060POST /candidates\u0060) und \u00C4ndern der Bewerberstammdaten (\u0060PUT /candidates/{candidateId}\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataGenders","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/languagelevels":{"get":{"summary":"Sprachlevel","description":"Liefert die Stammdatenliste der Sprachniveaus als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060levelId\u0060 einzusetzen, etwa beim Anlegen (\u0060POST /candidates/{id}/languages\u0060) und \u00C4ndern (\u0060PUT /candidates/{candidateId}/languages/{languageId}\u0060) einer Sprachkenntnis; die Sprache selbst kommt aus \u0060GET /masterdata/languages\u0060. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataLanguagelevels","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/languages":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Sprachen","description":"Dieser Endpunkt gibt eine Liste aller Sprachen zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguagesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/maritalstatus":{"get":{"summary":"Familienst\u00E4nde","description":"Liefert die Stammdatenliste der Familienst\u00E4nde als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060maritalStatusId\u0060 einzusetzen, etwa im pers\u00F6nlichen Status eines Bewerbers (\u0060personalStatus.maritalStatusId\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataMaritalstatus","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/mobilitytypes":{"get":{"summary":"Mobilit\u00E4tsarten","description":"Liefert die Stammdatenliste der Mobilit\u00E4tsarten als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060mobilityTypeId\u0060 einzusetzen, etwa in den Mobilit\u00E4tsangaben eines Bewerbers (\u0060mobility.mobilityTypeId\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataMobilitytypes","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/nationalities":{"get":{"summary":"Nationalit\u00E4ten","description":"Liefert die Stammdatenliste der Staatsangeh\u00F6rigkeiten als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind im pers\u00F6nlichen Status eines Bewerbers einzusetzen \u2014 f\u00FCr bis zu drei Staatsangeh\u00F6rigkeiten \u00FCber \u0060personalStatus.nationalityId\u0060, \u0060nationalitySecondId\u0060 und \u0060nationalityThirdId\u0060. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataNationalities","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/periods":{"get":{"summary":"Zeiteinheiten","description":"Liefert die Stammdatenliste der Zeiteinheiten (z. B. Bezugszeitraum eines Gehalts) als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060periodId\u0060 einzusetzen, etwa in der Gehaltsvorstellung eines Bewerbers (\u0060salaryExpectations.periodId\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataPeriods","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/professions":{"get":{"summary":"Berufe","description":"Liefert die Stammdatenliste der Berufe als Id-Wert-Paare. Die zur\u00FCckgegebenen Ids sind an anderer Stelle als \u0060professionId\u0060 einzusetzen, etwa beim Anlegen eines Berufs zu einem Bewerber (\u0060POST /candidates/{id}/professions\u0060) oder zu einer Firma (\u0060POST /customers/{customerId}/professions\u0060). In den Bewerberdetails ist \u0060professionObjects[].id\u0060 die Id der Zuordnung und **nicht** die \u0060professionId\u0060. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataProfessions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/salutations":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Anrede","description":"Dieser Endpunkt gibt eine Liste aller Anreden zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/shifts":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Schichten","description":"**Neu in V 3.4.0:** Liefert die Stammdatenliste der Schichten als Id-Wert-Paare. Die Ids sind als \u0060shiftIds\u0060 einzusetzen, etwa beim Anlegen einer Anfrage. Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.\n\n\u0060shiftIds\u0060 wird beim Anlegen einer Anfrage gegen diesen Katalog gepr\u00FCft; eine Id aus einer anderen Gruppe liefert 400 \u0060NotExisting\u0060 auf \u0060ShiftIds\u0060.","operationId":"getMasterdataShifts","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/masterdata/workplaces":{"get":{"tags":["talent.Flow Stammdaten"],"summary":"Arbeitsorte","description":"**Neu in V 3.4.0:** Liefert die Stammdatenliste der Arbeitsorte als Id-Wert-Paare. Die Ids sind als \u0060workPlaceId\u0060 einzusetzen, etwa beim Anlegen einer Anfrage (\u0060POST /customers/{customerId}/requests/directtransmission\u0060 und \u0060\u2026/servicecontract\u0060). Der Endpunkt ben\u00F6tigt keine Parameter und liefert immer den vollst\u00E4ndigen, mandantenspezifischen Bestand.","operationId":"getMasterdataWorkplaces","responses":{"200":{"description":"Request successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnumValuesResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"talent.Flow Stammdaten"}},"/offices":{"get":{"tags":["Niederlassungen"],"summary":"Alle Niederlassungen","description":"Dieser Endpunkt gibt alle aktiven Niederlassungen zur\u00FCck.\n\n R\u00FCckgabewerte sind:\n\n| Wert | Beschreibung |\n|---|---|\n| officeId | Id der Niederlassung |\n| officeGuid | Guid der Niederlassung |\n| zvooveId | Id der Niederlassung bei Zvoove |\n| name | Name der Niederlassung |\n| description | Beschreibung der Niederlassung |\n| addressLine1 | Adresszeile 1 |\n| addressLine2 | Adresszeile 2 |\n| street | Stra\u00DFe |\n| streetNumber | Hausnummer |\n| zipCode | Postleitzahl |\n| city | Stadt |\n| region | Region |\n| federalState | Bundesland |\n| country | Land |\n| phoneNumber | Telefonnummer |\n| faxNumber | Telefaxnummer |\n| email | E-Mail |\n| costCenter | CostCenter (Buchhaltung) |\n| latitude | Geocoordinaten Lat |\n| longitude | Geocoordinaten Lon |","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ReadAllOfficesResponse"}}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Niederlassungen"}},"/reports/customerrequests/performance":{"get":{"tags":["Anfragenauswertungen"],"summary":"Anfragen Report","description":"Dieser Endpunkt gibt die Statisken der Anfrage zur\u00FCck.","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerReportPerfomanceReadResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragenauswertungen"}},"/reports/performance/jobs":{"get":{"tags":["Stellenanzeigenauswertungen"],"summary":"Stellenanzeigen Statistiken pro Monat","description":"Dieser Endpunkt gibt die Statistiken der Stellenanzeigen pro Monat in einem Jahr zur\u00FCck.\n\nOptional l\u00E4sst sich das Ergebnis mit page und pageSize seitenweise abrufen. Ohne pageSize wird der ganze Monat zur\u00FCckgegeben. Beim seitenweisen Abruf ist die Reihenfolge stabil: nach Tag, Stellenanzeige, ReferenceId und Kanal. Die Antwort enth\u00E4lt keine Gesamtanzahl; die letzte Seite ist erreicht, wenn weniger als pageSize Eintr\u00E4ge zur\u00FCckkommen.","parameters":[{"name":"month","in":"query","description":"Monat (1\u201312)","schema":{"type":"integer"}},{"name":"year","in":"query","description":"Jahr (vierstellig)","schema":{"type":"integer"}},{"name":"page","in":"query","description":"Seite, beginnt bei 1. Wirkt nur zusammen mit pageSize; ohne pageSize wird der ganze Monat zur\u00FCckgegeben. Werte kleiner 1 werden mit 400 abgelehnt.","schema":{"examples":[1],"type":"integer","format":"int32"}},{"name":"pageSize","in":"query","description":"Anzahl der Eintr\u00E4ge pro Seite, keine Obergrenze. Ohne Angabe wird der ganze Monat zur\u00FCckgegeben. Werte kleiner 1 werden mit 400 abgelehnt.","schema":{"examples":[100],"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/JobAdStatisticsReadResponse"}}}}},"400":{"description":"Ung\u00FCltige Pagination. Fachliche Pr\u00FCfungen antworten als ErrorResponse mit dem Validierungsfehler Invalid auf Page bzw. PageSize: bei einem Wert kleiner 1 oder wenn (page - 1) * pageSize den int32-Bereich \u00FCberschreitet. Scheitert dagegen schon das Binden des Requests (z.B. page=abc), liefert das Framework ValidationProblemDetails mit Content-Type application/problem\u002Bjson.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"$ref":"#/components/schemas/ValidationProblemDetails"}]}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stellenanzeigen/Stellenanzeigenauswertungen"}},"/requests/{id}":{"get":{"tags":["Anfragendetails"],"summary":"Anfragen per Id","description":"Liest die Detaildaten einer Anfrage anhand ihrer Id, unabh\u00E4ngig von der Vermittlungsart. Die Anfrage wird direkt adressiert, die Firma muss nicht mit angegeben werden. Angelegt wird eine Anfrage \u00FCber die drei Endpunkte unter \u0060POST /customers/{customerId}/requests/\u2026\u0060, umgeh\u00E4ngt \u00FCber \u0060PUT /customers/{customerId}/requests/{requestId}\u0060, der Status ge\u00E4ndert \u00FCber \u0060PUT /customers/{customerId}/requests/{requestId}/status\u0060. Eine unbekannte oder gel\u00F6schte Id liefert 404.\n\n**Neu in V 3.4.0:**\n\n* \u0060labourLeasingDurationUnit\u0060 liefert den Anzeigetext zu \u0060labourLeasingDurationUnitId\u0060 (z. B. \u201EMonat\u0022), analog zu \u0060workingHoursUnit\u0060 und \u0060serviceContractDurationUnit\u0060. Bisher war das Feld immer \u0060null\u0060.\n* \u0060keywords\u0060 und \u0060qualifications\u0060 sind unmittelbar nach dem Anlegen der Anfrage gef\u00FCllt, auch f\u00FCr Begriffe, die im System noch nicht als Schlagwort existierten. Bisher blieben beide Listen in diesem Fall dauerhaft leer.","parameters":[{"name":"id","in":"path","description":"Identifikation der Anfrage","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK \u2014 die Anfrage wird direkt als Objekt zur\u00FCckgegeben, nicht in einer Antworth\u00FClle.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestReadDto"}}}},"404":{"description":"Anfrage nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Anfragen/Anfragendetails"}},"/users":{"get":{"tags":["Benutzer"],"summary":"Alle Benutzer","description":"Listet die Benutzer des Mandanten. \u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format \u0060YYYY-MM-DD\u0060) l\u00E4sst sich die Ergebnismenge auf einen Zeitraum eingrenzen; ohne Angabe wird der vollst\u00E4ndige Bestand geliefert. F\u00FCr neue Integrationen ist \u0060GET /users/all\u0060 als neuere Variante vorgesehen.","parameters":[{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsersResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Benutzer"}},"/users/{userGuid}":{"get":{"tags":["Benutzer"],"summary":"Benutzerdetails lesen (Guid)","description":"Liest die Detaildaten eines Benutzers anhand seiner GUID (\u0060rowGuid\u0060), einschlie\u00DFlich der zugeordneten Lizenzen und Niederlassungen. F\u00FCr den Zugriff \u00FCber die numerische Id steht \u0060GET /users/{userId}\u0060 zur Verf\u00FCgung.","parameters":[{"name":"userGuid","in":"path","description":"GUID des Benutzers","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadUserByIdResponse"}}}},"404":{"description":"Benutzer nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Benutzer"}},"/users/{userId}":{"get":{"tags":["Benutzer"],"summary":"Benutzer abrufen","description":"Dieser Endpunkt gibt einen einzelnen Benutzer anhand der numerischen \u0060userId\u0060 zur\u00FCck.","parameters":[{"name":"userId","in":"path","description":"Numerische Identifikation des Benutzers","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadUserByIdResponse"}}}},"404":{"description":"Benutzer nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Benutzer"}},"/users/all":{"get":{"tags":["Benutzer"],"summary":"Alle Benutzer (Neue Version)","description":"Listet die Benutzer des Mandanten \u2014 die neuere Variante von \u0060GET /users\u0060. Die Antwort ist flacher aufgebaut: die Benutzer stehen direkt unter \u0060users\u0060, statt in den generischen Antwortumschlag mit \u0060isFaulty\u0060, \u0060statusCode\u0060 und \u0060serviceAlerts\u0060 eingebettet zu sein. \u00DCber die optionalen Query-Parameter \u0060startDate\u0060 und \u0060endDate\u0060 (Format \u0060YYYY-MM-DD\u0060) l\u00E4sst sich die Ergebnismenge auf einen Zeitraum eingrenzen.","parameters":[{"name":"endDate","in":"query","description":"Ende des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}},{"name":"startDate","in":"query","description":"Beginn des Zeitraums im Format YYYY-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadAllUsers2Response"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Benutzer"}},"/users/responsibilities":{"get":{"tags":["Benutzer"],"summary":"Alle verantwortliche Benutzer","description":"Liefert die Benutzer samt ihrer Zust\u00E4ndigkeiten. Die hier gelieferten Benutzer sind die zul\u00E4ssigen Werte f\u00FCr die \u0060responsibility\u0060-Angaben an Bewerbern, Firmen, Betriebsst\u00E4tten und Ansprechpartnern. Der Endpunkt ben\u00F6tigt keine Parameter.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponsibilitiesResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Stammdaten/Benutzer"}},"/webhooks/event/types":{"get":{"tags":["Webhooks"],"summary":"Webhook Ereignistypen lesen","description":"Dieser GET-Endpunkt liefert alle in talent.Flow ausl\u00F6sbaren Ereignisse zur\u00FCck. Die Ids dieser Ereignisse werden f\u00FCr die Registrierung von Webhook Endpunkten ben\u00F6tigt.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReadEventTypesResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/protocol":{"post":{"tags":["Webhooks"],"summary":"Protocol lesen","description":"Dieser POST-Endpunkt liefert alle in talent.Flow ausgel\u00F6sten Ereignisse zur\u00FCck, f\u00FCr die Webhook Endpunkte registriert sind. Beim Aufrufen dieses Endpunktes kann ein Zeitraum angegeben werden. Dieser schr\u00E4nkt die zur\u00FCckgelieferten Ereignisse auf Basis ihres Ausl\u00F6sedatums ein.\n\n Response:\n\n| Eigenschaft | Beschreibung |\n|---|---|\n| eventId | Id des ausgel\u00F6sten Ereignisses. Eine vollst\u00E4ndige Liste aller m\u00F6glichen Ereignisse kann \u00FCber einen separaten Endpunkt abgerufen werden. |\n| event | Textuelle Beschreibung des Ereignisses. |\n| endpoint | Referenzendpunkt \u00FCber den der Datensatz abgerufen werden kann, der das Ereignis ausgel\u00F6st hat. |\n| endpointMethod | HTTP Methode des Referenzendpunktes. |\n| entityId | Id auf den Datensatz f\u00FCr den das Ereignis ausgel\u00F6st wurde. |\n| eventDateUtc | Zeitpunkt zu dem dieses Ereignis ausgel\u00F6st wurde. |\n| id | Eindeutige Id, die diese Ereignis identifiziert; UniqueIdentifier |\n| sendStatusId | Gibt den Status der \u00DCbermittlung des Ereignisses an den registrierten Webhook an - 130 (Transfered): Der Webhook konnte erfolgreich aufgerufen werden - 131 (Failed): Der Webhook hat kein OK zur\u00FCckgeliefert - 132 (Skipped): Der Webhook ist aufgrund zu vieler Fehler pausiert |\n| sendStatus | Textuelle Beschreibung der SendStatusId. Entspricht der Beschreibung der SendStatusId Eigenschaft. |\n| sendStatusReason | Antwort des Webhook Aufrufes bei einer fehlerhaften Antwort (kein OK). |\n| webhookUrl | Url, die f\u00FCr die \u00DCbermittlung des Ereignisses aufgerufen wurde. |\n| additionalData | Ereignisabh\u00E4ngige Daten. Diese unterscheiden sich je nach Ereignistyp. |","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReadProtocolRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReadProtocolResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/settings":{"get":{"tags":["Webhooks"],"summary":"Webhook Einstellungen lesen","description":"Dieser GET-Endpunkt liefert die Einstellung f\u00FCr die Webhooks zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReadSettingsResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/settings/eventdatatype/{webhookEventDataType}":{"put":{"tags":["Webhooks"],"summary":"Webhook Ereignisdatentyp setzen","description":"Diese PUT-Endpunkt erm\u00F6glicht die \u00C4nderung des Webhook Datenformates\n\n Es stehen zwei verschiedene Datenformate zur Verf\u00FCgung\n\n- Standard (talent360)\n\n  - Id: 1482\n\n- Azure Cloud Event\n\n  - Id: 1483\n\n Response:\n\n 200 (OK) mit einem leeren Response","parameters":[{"name":"webhookEventDataType","in":"path","required":true,"schema":{"$ref":"#/components/schemas/WebhookEventDataType"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSetEventDataTypeResponse"}}}},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Webhook-Einstellung nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/subscribe":{"post":{"tags":["Webhooks"],"summary":"Subscribe","description":"Dieser POST-Endpunkt erm\u00F6glicht die Registirerung von Webhook Endpunkten, die beim Ausl\u00F6sen eines Ereignisses aufgerufen werden soll.\n\n F\u00FCr die Registrierung von Webhook Endpunkten gelten die folgenden Regeln:\n\n- Webhook Endpunkte werden immer pro Ereignis registriert\n\n- Ein Webhook Endpunkt kann f\u00FCr verschiedene Ereignisse verwendet werden\n\n- Auf ein Ereignis k\u00F6nnen verschiedene Webhook Endpunkte registriert werden\n\n- Die Kombination aus Webhook Endpunkt und Ereignis muss einzigartig sein.\n\n- Wurde ein Webhook Endpunkt durch das Erreichen der Fehlerschwelle pausiert, kann dieser durch eine erneute Registrierung wieder aktiviert werden.\n\n- Ein Webhook Endpunkt muss \u00FCber einen POST-Aufruf \u00F6ffentlich erreichbar sein\n\n Hinweis:\n\n Jeder registrierte Webhook Endpunkt hat einen eigenen Z\u00E4hler f\u00FCr aufgetretene Fehler. Dieser Z\u00E4hler wird jedes Mal um eins erh\u00F6ht, wenn beim Aufruf des Webhook Endpunktes der Server kein 200er (OK) zur\u00FCckgeliefert hat. Erreicht der Z\u00E4hler den Wert 10, wird die Registrierung pausiert. Das bedeutet, dass f\u00FCr diese Registrierung der Webhook Endpunkt nicht mehr aufgerufen wird. Es wird aber weiterhin das Protokoll f\u00FCr das Ausl\u00F6sen des Ereignisses in Kombination mit diesem Webhook Endpunkt erfasst. Dadurch k\u00F6nnen die ausgel\u00F6sten Ereignisse nachtr\u00E4glich abgerufen werden. Vor dem Erreichen des Schwellwertes, wird der Z\u00E4hler bei einem erfolgreichen Aufrufen des Webhook Endpunktes wieder auf Null zur\u00FCckgesetzt.\n\n Response:\n\n 200 (OK) mit einem leeren Response","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscribeRequest"}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/subscriptions":{"get":{"tags":["Webhooks"],"summary":"Subscriptions lesen","description":"Dieser GET-Endpunkt liefert alle registrierten Webhook Endpunkte zur\u00FCck.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReadSubscriptionsResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}},"/webhooks/unsubscribe":{"post":{"tags":["Webhooks"],"summary":"Unsubscribe","description":"Dieser POST-Endpunkt erm\u00F6glicht das Entfernen der Registirerung von Webhook Endpunkten\n\n Response:\n\n 200 (OK) mit einem leeren Response","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookUnsubscribeRequest"}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Ung\u00FCltige Anfrage oder Validierungsfehler","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"BearerAuth":[]}],"x-routebase-folder-path":"Webhooks"}}},"components":{"schemas":{"AddressCreateDto":{"type":"object","properties":{"street":{"type":["null","string"],"description":"Stra\u00DFe, ohne Hausnummer; die geh\u00F6rt nach streetNumber. Neu in V 3.4.0: Bleibt streetNumber leer und street enth\u00E4lt beides (z. B. Musterstra\u00DFe 5a oder Am Markt 3-5), zerlegt die API selbst: Das letzte durch Leerzeichen getrennte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt; sonst bleibt der Wert unver\u00E4ndert Stra\u00DFe (Am Markt 3-5 Hinterhaus wird nicht zerlegt). Wird streetNumber mitgeschickt, bleibt street unangetastet."},"streetNumber":{"type":["null","string"],"description":"Hausnummer, getrennt von der Stra\u00DFe. Wer sie mitschickt, schaltet die serverseitige Zerlegung von street ab."},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"federalStateId":{"type":["null","integer"],"description":"Kennung des Bundeslandes (Id). Ein Bundesland geh\u00F6rt zu genau einem Land. Neu in V 3.4.0: Beim \u00C4ndern per PUT gilt: Wird countryId auf ein anderes Land ge\u00E4ndert und federalStateId nicht mitgeschickt, leert die API das gespeicherte Bundesland selbst, so wie talent.Flow beim L\u00E4nderwechsel. Wird federalStateId mitgeschickt, gilt der \u00FCbermittelte Wert und muss zum Land geh\u00F6ren, sonst 400 NotMatchCountry. Bleibt countryId unver\u00E4ndert, bleibt auch das Bundesland stehen.","format":"int32"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id). Neu in V 3.4.0: Beim \u00C4ndern per PUT leert ein Wechsel auf ein anderes Land ein gespeichertes Bundesland, wenn federalStateId nicht mitgeschickt wird.","format":"int32"},"geoLat":{"type":["null","number"],"description":"Geografische Breite. Wird bei jeder Adress\u00E4nderung serverseitig neu berechnet und ist nicht schreibbar; \u00FCbermittelte Werte werden ignoriert. Mindestangaben f\u00FCr die Geokodierung sind Land, Ort und Postleitzahl.","format":"double"},"geoLon":{"type":["null","number"],"description":"Geografische L\u00E4nge. Wird bei jeder Adress\u00E4nderung serverseitig neu berechnet und ist nicht schreibbar; \u00FCbermittelte Werte werden ignoriert.","format":"double"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen bzw. \u00C4ndern einer Adresse mit Stra\u00DFe, Hausnummer, PLZ, Ort, Bundesland und Land. Die Geokoordinaten geoLat und geoLon werden serverseitig berechnet und sind nicht schreibbar. Stra\u00DFe und Hausnummer werden getrennt erwartet. Neu in V 3.4.0: Wird keine Hausnummer mitgeschickt, zerlegt die API eine kombinierte Angabe in street selbst."},"AddressReadDto":{"type":"object","properties":{"addressLine1":{"type":["null","string"],"description":"Adresszeile 1"},"addressLine2":{"type":["null","string"],"description":"Adresszeile 2"},"street":{"type":["null","string"],"description":"Stra\u00DFe"},"streetNumber":{"type":["null","string"],"description":"Hausnummer"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"federalStateId":{"type":["null","integer"],"description":"Kennung des Bundeslandes (Id)","format":"int32"},"federalState":{"type":["null","string"],"description":"Bundesland"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"country":{"type":["null","string"],"description":"Land"},"countryCode":{"type":["null","string"],"description":"L\u00E4ndercode"},"geoLat":{"type":["null","number"],"description":"Geografische Breite","format":"double"},"geoLon":{"type":["null","number"],"description":"Geografische L\u00E4nge","format":"double"}},"additionalProperties":false,"description":"Datenobjekt einer Adresse mit Adresszeilen, Stra\u00DFe, PLZ, Ort, Bundesland, Land, L\u00E4ndercode und Geokoordinaten."},"ApplicationDto":{"type":"object","properties":{"jobId":{"type":"integer","description":"Id der Stellenanzeige in talent.Flow","format":"int32"},"externalJobId":{"type":["null","string"],"description":"Id der Stellenanzeige des Kunden (nur talent.Reach)"},"externalOfferUrl":{"type":["null","string"],"description":"Link der Stellenanzeige des Kunden (nur talent.Reach)"},"externalApplicationUrl":{"type":["null","string"],"description":"Link der Bewerbungsseite des Kunden (nur talent.Reach)"},"jobTitle":{"type":["null","string"],"description":"Stellentitel"},"jobLocation":{"type":["null","string"],"description":"Ort/Stadt des Einsatzortes"},"officeId":{"type":"integer","description":"Id der Niederlassung in talent.Flow","format":"int32"},"officeDescription":{"type":["null","string"],"description":"Beschreibung der Niederlassung"},"costCenter":{"type":["null","string"],"description":"Kostenstelle der Niederlassung"},"recruiterFullName":{"type":["null","string"],"description":"Vor- und Nachname des Recruiters"},"recruiterEmail":{"type":["null","string"],"description":"Email des Recruiters"},"channelId":{"type":"integer","description":"Id des Kanals \u00FCber welchen sich der Bewerber beworben hat.","format":"int32"},"channelName":{"type":["null","string"],"description":"Name des Kanals \u00FCber welchen sich der Bewerber beworben hat."},"createdAtUtc":{"type":"string","description":"Erstelldatum der Bewerbung","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt einer Bewerbung mit Angaben zu Stelle, Einsatzort, Niederlassung, Kostenstelle, Recruiter und Bewerbungskanal."},"ApplyCreateExternalRequest":{"type":"object","properties":{"officeId":{"type":["null","integer"],"description":"Optional; Id der Niederlassung","format":"int32"},"channelId":{"type":["null","integer"],"description":"Optional; Gibt die Herkunft der Bewerbung an. Der Standardwert ist 28 (Homepage).","format":"int32"},"jobAdId":{"type":["null","integer"],"description":"Optional; Id der Stellenanzeige","format":"int32"},"salutationId":{"description":"Anrede des Bewerbers (Enum Salutation)","$ref":"#/components/schemas/Salutation"},"firstName":{"type":["null","string"],"description":"Vorname des Bewerbers"},"lastName":{"type":["null","string"],"description":"Nachname des Bewerbers"},"city":{"type":["null","string"],"description":"Ort / Stadt des Bewerbers"},"zipCode":{"type":["null","string"],"description":"Postleitzahl des Bewerbers"},"email":{"type":["null","string"],"description":"E-Mail Adresse des Bewerbers","format":"email"},"phoneNumber":{"type":["null","string"],"description":"Optional; Telefonnummer des Bewerbers"},"whatsAppConsentChecked":{"type":["null","boolean"],"description":"Bewerber hat eingewilligt \u00FCber WhatsApp kontaktiert zu werden"},"hasWhatsApp":{"type":["null","boolean"],"description":"Bewerber hat WhatsApp"},"privacyChecked":{"type":["null","boolean"],"description":"Bewerber hat den Datenschutzbestimmungen zugestimmt"},"termsOfUseChecked":{"type":["null","boolean"],"description":"Bewerber hat den AGB\u0027s zugestimmt"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schlagworte"},"documents":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ApplyCreateExternalRequestDocument"},"description":"Dokumente Die Gr\u00F6\u00DFe des Request-Bodies darf 100MB nicht \u00FCberschreiten."},"additionalInfo":{"type":["null","string"],"description":"Zus\u00E4tzliche Informationen"},"sourceOfSupplyId":{"type":["null","integer"],"description":"Id der Bezugsquelle","format":"int32"},"additionalEmailAddresses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ContactInfoDto"},"description":"Weitere Kontakt-/E-Mail-Adressen des Bewerbers"}},"additionalProperties":false,"description":"Anfrageobjekt zum Anlegen einer externen Bewerbung mit Kontaktdaten, Einwilligungen, Dokumenten sowie Bezug zu Niederlassung, Kanal und Stellenanzeige."},"ApplyCreateExternalRequestDocument":{"type":"object","properties":{"data":{"type":["null","string"],"description":"Dokument als Base64 codierter String"},"fileName":{"type":["null","string"],"description":"Dateiname"},"contentType":{"type":["null","string"],"description":"Dateityp; Erlaubte Typen - image/png - image/jpg - image/jpeg - image/gif - image/tiff - application/pdf - application/msword - application/vnd.openxmlformats-officedocument.wordprocessingml.document - text/plain - application/vnd.oasis.opendocument.text"},"fileKindId":{"description":"Art des Dokuments","$ref":"#/components/schemas/FileKind"}},"additionalProperties":false,"description":"Datenobjekt eines Bewerbungsdokuments mit Base64-Inhalt, Dateiname, Dateityp und Dokumentart."},"ApplyImportDto":{"type":"object","properties":{"jobAdTitle":{"type":["null","string"],"description":"Titel der Stellenanzeige"},"recruiterId":{"type":["null","integer"],"description":"Identifikation des Recruiters","format":"int32"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"jobAdId":{"type":["null","integer"],"description":"Identifikation der Stellenanzeige","format":"int32"},"channelId":{"type":["null","integer"],"description":"Kennung des Kanals","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Import einer Bewerbung mit Stellenanzeigentitel, Stellenanzeigen-Id, Recruiter, Kanal und Erstellzeitpunkt."},"AttachmentCreateDto":{"type":"object","properties":{"fileName":{"type":["null","string"],"description":"Dateiname"},"data":{"type":["null","string"],"description":"Dateiinhalt"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Dateianhangs mit Dateiname, Inhalt und Erstellzeitpunkt."},"BaseCreateResponse":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des erzeugten Datensatzes","format":"int32"}},"additionalProperties":false,"description":"Antwortobjekt eines Anlege-Endpunkts mit der Id des erzeugten Datensatzes."},"BaseSuccessResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Gibt an, ob die Operation erfolgreich war"}},"additionalProperties":false,"description":"Antwortobjekt mit einem Erfolgskennzeichen einer Operation."},"CandidateChangesDetailsDto":{"type":"object","properties":{"candidateId":{"type":"integer","description":"Identifikation des Bewerbers","format":"int32"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"createdAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher der Bewerber angelegt wurde","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher der Bewerber das letzte Mal ge\u00E4ndert wurde","format":"date-time"},"questionnaireStarted":{"type":["null","string"],"description":"Datum und Uhrzeit wann der Bewerber die Bewerberqualifikation gestartet hat","format":"date-time"},"isQuestionnaireCompleted":{"type":"boolean","description":"Gibt an ob der Bewerber die Bewerberqualifikationsfragen abgeschlossen hat"}},"additionalProperties":false,"description":"Einzelner \u00C4nderungseintrag eines Bewerbers mit Id, Name, Erstell- und \u00C4nderungszeitpunkt sowie Status der Bewerberqualifikation."},"CandidateChangesDto":{"type":"object","properties":{"new":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CandidateChangesDetailsDto"},"description":"Neue Bewerber"},"modified":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CandidateChangesDetailsDto"},"description":"Bearbeitete Bewerber"},"deleted":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CandidateChangesDetailsDto"},"description":"Gel\u00F6schte Bewerber"}},"additionalProperties":false,"description":"\u00C4nderungscontainer f\u00FCr Bewerber mit Listen neuer, ge\u00E4nderter und gel\u00F6schter Eintr\u00E4ge."},"CandidateCreateDto":{"type":"object","properties":{"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"salutationId":{"type":["null","integer"],"description":"Kennung der Anrede (Id)","format":"int32"},"genderId":{"type":["null","integer"],"description":"Kennung des Geschlechts (Id)","format":"int32"},"title":{"type":["null","string"],"description":"Titel"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"fullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"description":{"type":["null","string"],"description":"Freitextbeschreibung zum Bewerber"},"contact":{"description":"Kontaktdaten des Bewerbers","$ref":"#/components/schemas/ContactDto"},"location":{"description":"Standort des Bewerbers","$ref":"#/components/schemas/LocationDto"},"birth":{"description":"Geburtsangaben des Bewerbers","$ref":"#/components/schemas/BirthDto"},"availability":{"description":"Verf\u00FCgbarkeit des Bewerbers","$ref":"#/components/schemas/AvailabilityDto"},"disability":{"description":"Angaben zur Schwerbehinderung des Bewerbers","$ref":"#/components/schemas/DisabilityDto"},"mobility":{"description":"Mobilit\u00E4t des Bewerbers","$ref":"#/components/schemas/MobilityDto"},"workingPreferences":{"description":"Arbeitspr\u00E4ferenzen des Bewerbers","$ref":"#/components/schemas/WorkingPreferencesDto"},"salaryExpectations":{"description":"Gehaltsvorstellung des Bewerbers","$ref":"#/components/schemas/SalaryExpectationsDto"},"personalStatus":{"description":"Pers\u00F6nlicher Status des Bewerbers","$ref":"#/components/schemas/PersonalStatusDto"},"professionalProfile":{"description":"Berufliches Profil des Bewerbers","$ref":"#/components/schemas/ProfessionalProfileDto"},"desiredWorkLocation":{"description":"Gew\u00FCnschter Arbeitsort des Bewerbers","$ref":"#/components/schemas/DesiredWorkLocationDto"},"placementTypes":{"description":"Gew\u00FCnschte Vermittlungsarten des Bewerbers","$ref":"#/components/schemas/PlacementTypesDto"},"privacyPolicy":{"description":"Datenschutzeinwilligung des Bewerbers","$ref":"#/components/schemas/PrivacyPolicyDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Bewerber","$ref":"#/components/schemas/ResponsibilityDto"},"candidateStatus":{"description":"Status des Bewerbers","$ref":"#/components/schemas/CandidateStatusDto"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Bewerbers mit Stammdaten, Kontakt, Standort, Verf\u00FCgbarkeit, Mobilit\u00E4t, Arbeitspr\u00E4ferenzen, Gehaltsvorstellung, pers\u00F6nlichem Status, beruflichem Profil, gew\u00FCnschtem Arbeitsort, Vermittlungsarten und Status."},"CandidateCvDocumentCreateDto":{"type":"object","properties":{"filename":{"type":["null","string"],"description":"Dateiname"},"base64File":{"type":["null","string"],"description":"Dateiinhalt als Base64-kodierte Zeichenfolge"},"shouldParseCV":{"type":"boolean","description":"Gibt an, ob der Lebenslauf analysiert werden soll"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Lebenslauf-Dokuments eines Bewerbers mit Dateiname, Base64-Inhalt und optionaler CV-Analyse."},"CandidateDetailsDto":{"type":"object","properties":{"id":{"type":"integer","description":"Identifikation des Dokumentes","format":"int32"},"createdAtUtc":{"type":"string","description":"Erstelldatum des Bewerbers","format":"date-time"},"status":{"description":"Status des Bewerbers","$ref":"#/components/schemas/Status"},"salutation":{"type":["null","string"],"description":"Anrede"},"title":{"type":["null","string"],"description":"Titel (z.B. Dr.)"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"fullName":{"type":["null","string"],"description":"Vor- und Nachname"},"age":{"type":["null","string"],"description":"Alter in Jahren"},"description":{"type":["null","string"],"description":"Beschreibung"},"contact":{"description":"Kontaktdaten des Bewerbers","$ref":"#/components/schemas/ContactExportDto"},"location":{"description":"Standort des Bewerbers","$ref":"#/components/schemas/LocationExportDto"},"birth":{"description":"Geburtsangaben des Bewerbers","$ref":"#/components/schemas/BirthExportDto"},"gender":{"description":"Geschlecht des Bewerbers","$ref":"#/components/schemas/GenderDto"},"personalStatus":{"description":"Pers\u00F6nlicher Status des Bewerbers","$ref":"#/components/schemas/PersonalStatusExportDto"},"availability":{"description":"Verf\u00FCgbarkeit des Bewerbers","$ref":"#/components/schemas/AvailabilityExportDto"},"disability":{"description":"Angaben zur Behinderung des Bewerbers","$ref":"#/components/schemas/DisabilityExportDto"},"mobility":{"description":"Angaben zur Mobilit\u00E4t des Bewerbers","$ref":"#/components/schemas/MobilityExportDto"},"desiredWorkLocation":{"description":"Gew\u00FCnschter Arbeitsort des Bewerbers","$ref":"#/components/schemas/DesiredWorkLocationExportDto"},"shifts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ShiftsDto"},"description":"Bevorzugte Schichten"},"workingPreferences":{"description":"Arbeitspr\u00E4ferenzen des Bewerbers","$ref":"#/components/schemas/WorkingPreferencesExportDto"},"salaryExpectations":{"description":"Gehaltsvorstellungen des Bewerbers","$ref":"#/components/schemas/SalaryExpectationsExportDto"},"placementTypes":{"description":"Gew\u00FCnschte Vermittlungsarten des Bewerbers","$ref":"#/components/schemas/PlacementTypesDto"},"professionalProfile":{"description":"Berufliches Profil des Bewerbers","$ref":"#/components/schemas/ProfessionalProfileDto"},"languages":{"type":["null","array"],"items":{"$ref":"#/components/schemas/LanguagesDto"},"description":"Sprachkenntnisse des Bewerbers"},"driversLicenses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/DriverslicensesDto"},"description":"F\u00FChrerscheine des Bewerbers"},"education":{"type":["null","array"],"items":{"$ref":"#/components/schemas/EducationDto"},"description":"Schulbildung"},"resume":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ResumeDto"},"description":"Lebenslauf"},"schoolEducations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/SchoolEducationDto"},"description":"Schulische Ausbildung des Bewerbers"},"professionEducations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ProfessionEducationDto"},"description":"Berufsausbildung des Bewerbers"},"industryKnowledge":{"type":["null","array"],"items":{"type":"string"},"description":"Branchenkenntnisse"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schlagworte"},"professions":{"type":["null","array"],"items":{"type":"string"},"description":"Berufe / Einsatzgebiete"},"professionObjects":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ProfessionDto"},"description":"Berufe / Einsatzgebiete als Objekte mit Kennung und Bezeichnung"},"qualifications":{"type":["null","array"],"items":{"type":"string"},"description":"Qualifikationen"},"qualificationsWithScore":{"type":["null","array"],"items":{"$ref":"#/components/schemas/QualificationsDto"},"description":"Qualifikationen mit Bewertung"},"profileImage":{"type":["null","string"],"description":"Profilbild als Base64 codiert"},"privacyPolicy":{"description":"Angaben zur Datenschutzerkl\u00E4rung","$ref":"#/components/schemas/PrivacyPolicyExportDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Bewerber","$ref":"#/components/schemas/ResponsibilityExportDto"},"candidateStatus":{"description":"Status des Bewerbers","$ref":"#/components/schemas/CandidateStatusExportDto"},"applications":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ApplicationDto"},"description":"Bewerbungen des Bewerbers"}},"additionalProperties":false,"description":"Datenobjekt mit Detailangaben eines Bewerbers inkl. Status, Stammdaten, Kontakt, Standort, pers\u00F6nlichem Status, beruflichem Profil, gew\u00FCnschtem Arbeitsort, Vermittlungsarten, Qualifikationen, Ausbildung, Sprachen und Bewerbungen."},"CandidateDocumentDto":{"type":"object","properties":{"id":{"type":"integer","description":"Identifikation des Dokumentes","format":"int32"},"candidateId":{"type":"integer","description":"Identifikation des Bewerbers","format":"int32"},"originalFileName":{"type":["null","string"],"description":"Original Dateiname"},"createdAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument angelegt wurde","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument das letzte Mal ge\u00E4ndert wurde","format":"date-time"},"documentCategory":{"description":"Kategorie des Dokuments","$ref":"#/components/schemas/DocumentCategoryDto"},"documentBlob":{"type":["null","string"],"description":"Das Dokument als Base64 encodierte Zeichenkette"}},"additionalProperties":false,"description":"Datenobjekt eines Bewerberdokuments mit Id, Bewerberbezug, Dateiname, Kategorie, Zeitstempeln und Base64-Dateiinhalt."},"CandidateDocumentListDetailsDto":{"type":"object","properties":{"candidateId":{"type":"integer","description":"Identifikation des Bewerbers","format":"int32"},"documentId":{"type":"integer","description":"Identifikation des Dokuments","format":"int32"},"documentCategory":{"type":["null","string"],"description":"Kategorie des Dokumentes"},"createdAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument angelegt wurde","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument das letzte Mal ge\u00E4ndert wurde","format":"date-time"}},"additionalProperties":false,"description":"Einzeleintrag einer Bewerberdokument-Liste mit Bewerber-Id, Dokument-Id, Kategorie und Zeitstempeln."},"CandidateDocumentListDto":{"type":"object","properties":{"candidateDocuments":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CandidateDocumentListDetailsDto"},"description":"Liste der Dokumente des Bewerbers"}},"additionalProperties":false,"description":"Datenobjekt mit der Liste der Dokumente eines Bewerbers."},"CandidateEducationDto":{"type":"object","properties":{"degreeId":{"type":["null","integer"],"description":"Identifikation des Abschlusses","format":"int32"},"unmappedDegree":{"type":["null","string"],"description":"Nicht zugeordneter Abschluss (Freitext)"},"field":{"type":["null","string"],"description":"Fachrichtung"},"school":{"type":["null","string"],"description":"Schule / Bildungseinrichtung"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","integer"],"description":"Monat des Beginns","format":"int32"},"startDateYear":{"type":["null","integer"],"description":"Jahr des Beginns","format":"int32"},"endDateMonth":{"type":["null","integer"],"description":"Monat des Endes","format":"int32"},"endDateYear":{"type":["null","integer"],"description":"Jahr des Endes","format":"int32"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"}},"additionalProperties":false,"description":"Datenobjekt einer Ausbildung eines Bewerbers mit Abschluss, Fachrichtung, Schule, Ort, Land und Zeitraum."},"CandidateEndOfOperationChangeDto":{"type":"object","properties":{"endOfOperationAtUtc":{"type":"string","description":"Zeitpunkt des Einsatzendes (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt zur \u00C4nderung des Einsatzendes eines Bewerbers."},"CandidateExistsResponse":{"type":"object","properties":{"exists":{"type":"boolean","description":"Bewerber vorhanden"},"candidateId":{"type":["null","integer"],"description":"Identifikation des Bewerbers","format":"int32"},"status":{"type":["null","string"],"description":"Status des Bewerbers (Aktiv/Archiviert)"}},"additionalProperties":false,"description":"Antwortobjekt, das angibt, ob ein Bewerber existiert, inkl. Bewerber-Id und Status."},"CandidateFurtherTrainingDto":{"type":"object","properties":{"title":{"type":["null","string"],"description":"Titel"},"organization":{"type":["null","string"],"description":"Organisation / Bildungsanbieter"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","integer"],"description":"Monat des Beginns","format":"int32"},"startDateYear":{"type":["null","integer"],"description":"Jahr des Beginns","format":"int32"},"endDateMonth":{"type":["null","integer"],"description":"Monat des Endes","format":"int32"},"endDateYear":{"type":["null","integer"],"description":"Jahr des Endes","format":"int32"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"}},"additionalProperties":false,"description":"Datenobjekt einer Weiterbildung eines Bewerbers mit Titel, Organisation, Ort, Land und Zeitraum."},"CandidateLanguageDto":{"type":"object","properties":{"languageId":{"type":"integer","description":"Kennung der Sprache","format":"int32"},"levelId":{"type":"integer","description":"Kennung des Sprachniveaus","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt einer Sprachkenntnis eines Bewerbers mit Sprache und Niveau."},"CandidateOtherDocumentCreateDto":{"type":"object","properties":{"filename":{"type":["null","string"],"description":"Dateiname"},"base64File":{"type":["null","string"],"description":"Dateiinhalt als Base64-kodierte Zeichenkette"},"shouldParseCV":{"type":"boolean","description":"Gibt an, ob der Lebenslauf analysiert werden soll"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines sonstigen Dokuments eines Bewerbers mit Dateiname, Base64-Inhalt und optionaler CV-Analyse."},"CandidatePictureCreateDto":{"type":"object","properties":{"base64Image":{"type":["null","string"],"description":"Base64-kodiertes Bild des Bewerberfotos"}},"additionalProperties":false,"description":"Datenobjekt zum Hochladen eines Bewerberfotos als Base64-kodiertes Bild."},"CandidateProcessStatus":{"enum":[0,2000,2001,2002,2003,2004,2005],"type":"integer","description":"Verarbeitungsstatus (Stage) eines Bewerbers im Bewerbungsprozess. \u00600\u0060 steht f\u00FCr \u201Ekeine Angabe\u0022; die Codes 2000\u20132005 bezeichnen die einzelnen Prozessstufen (u. a. Neu, In Kontakt, Interview, Qualifiziert, Eingestellt, Abgelehnt).","format":"int32"},"CandidateProfessionalTrainingDto":{"type":"object","properties":{"title":{"type":["null","string"],"description":"Titel der Ausbildung"},"company":{"type":["null","string"],"description":"Name des Unternehmens"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","integer"],"description":"Monat des Beginns","format":"int32"},"startDateYear":{"type":["null","integer"],"description":"Jahr des Beginns","format":"int32"},"endDateMonth":{"type":["null","integer"],"description":"Monat des Endes","format":"int32"},"endDateYear":{"type":["null","integer"],"description":"Jahr des Endes","format":"int32"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"}},"additionalProperties":false,"description":"Datenobjekt einer beruflichen Ausbildung eines Bewerbers mit Titel, Unternehmen, Ort, Land, Zeitraum und Beschreibung."},"CandidateResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"description":"Nutzdaten der Antwort","$ref":"#/components/schemas/ReadCandidateByIdResponse"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt eines Endpunkts mit den Daten eines einzelnen Bewerbers sowie Status-, Validierungs- und Fehlerinformationen."},"CandidatesResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadAllCandidatesResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt eines Endpunkts mit einer Liste von Bewerbern sowie Status-, Validierungs- und Fehlerinformationen."},"CommunicationCreateDto":{"type":"object","properties":{"userId":{"type":["null","integer"],"description":"Identifikation des Benutzers","format":"int32"},"eventDateTimeUtc":{"type":["null","string"],"description":"Zeitpunkt des Ereignisses (UTC)","format":"date-time"},"headline":{"type":["null","string"],"description":"Betreff"},"communicationKindId":{"description":"Art der Kommunikation","$ref":"#/components/schemas/CommunicationKind"},"communicationStatus":{"description":"Status der Kommunikation","$ref":"#/components/schemas/CommunicationStatus"},"note":{"type":["null","string"],"description":"Notiz"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Kommunikationseintrags mit Benutzer, Zeitpunkt, Betreff, Art, Status und Notiz."},"CommunicationKind":{"enum":["InternalNote","PhoneCall"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Arten eines Kommunikationseintrags (interne Notiz, Telefonanruf)."},"CommunicationStatus":{"enum":["Reached","FirstContact","InterviewArrange","InterviewCancelled","InterviewChanged","NoStatus","NotReached","PhoneInterviewArranged"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Status eines Kommunikationseintrags (z.B. erreicht, nicht erreicht, Interview vereinbart)."},"CompanyType":{"enum":[114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,1315,1316,1317,1318,1319,1321,1322,1371,1372,1413],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Unternehmensarten (Firmentypen) als numerische Schl\u00FCssel.","format":"int32"},"ContactCreateDto":{"type":"object","properties":{"salutationId":{"type":"integer","description":"Identifikation der Anrede","format":"int32"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"position":{"type":["null","string"],"description":"Position im Unternehmen"},"department":{"type":["null","string"],"description":"Abteilung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer (Festnetz). Daraus wird die normalisierte Festnetznummer f\u00FCr die Kommunikation abgeleitet."},"mobilePhoneNumber":{"type":["null","string"],"description":"Mobiltelefonnummer. Daraus wird die normalisierte Mobilnummer f\u00FCr die Kommunikation (SMS, WhatsApp) abgeleitet; eine Nummer, die sich nicht in das Format \u002B49\u2026 normalisieren l\u00E4sst, wird mit 400 und errorType InvalidPhoneNumber abgelehnt."},"isDecider":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Entscheider ist"},"isPhoneAdvertisingAllowed":{"type":["null","boolean"],"description":"Gibt an, ob telefonische Werbung erlaubt ist"},"isEmailAdvertisingAllowed":{"type":["null","boolean"],"description":"Gibt an, ob Werbung per E-Mail erlaubt ist"},"isContactBanned":{"type":["null","boolean"],"description":"Gibt an, ob eine Kontaktsperre f\u00FCr den Ansprechpartner besteht"},"remark":{"type":["null","string"],"description":"Bemerkung"},"isSafetyOfficer":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Sicherheitsbeauftragter ist"},"isPrivacyOfficer":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Datenschutzbeauftragter ist"},"linkedInUrl":{"type":["null","string"],"description":"URL des LinkedIn-Profils. Neu in V 3.4.0: Akzeptiert wird die vollst\u00E4ndige URL (Host muss auf linkedin.com enden, sonst 400 mit errorType InvalidUrl), ein Host ohne Schema oder nur der Profilpfad (z. B. in/max-mustermann); gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL."},"xingUrl":{"type":["null","string"],"description":"URL des Xing-Profils. Neu in V 3.4.0: Akzeptiert wird die vollst\u00E4ndige URL (Host muss auf xing.com enden, sonst 400 mit errorType InvalidUrl), ein Host ohne Schema oder nur der Profilpfad (z. B. profile/Max_Mustermann); gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL."},"assignedOfficeIds":{"type":["null","array"],"items":{"type":"integer"},"description":"Ids der zugeordneten Betriebsst\u00E4tten"},"phoneNumberForCommunication":{"type":["null","string"],"description":"Festnetznummer f\u00FCr die Kommunikation. Abgeleitetes Feld: Wird phoneNumber mitgeschickt, wird der Wert daraus normalisiert abgeleitet und ein hier \u00FCbergebener Wert verworfen. Nur ohne phoneNumber wird der \u00FCbergebene Wert unver\u00E4ndert gespeichert. Die Mobilnummer f\u00FCr die Kommunikation wird ausschlie\u00DFlich aus mobilePhoneNumber abgeleitet und ist nicht setzbar."},"hasWhatsApp":{"type":["null","boolean"],"description":"Gibt an, ob WhatsApp verf\u00FCgbar ist"},"isWhatsAppConsentGranted":{"type":["null","boolean"],"description":"Gibt an, ob eine Einwilligung zur Nutzung von WhatsApp erteilt wurde"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit des Ansprechpartners","$ref":"#/components/schemas/ResponsibilityCreateDto"},"image":{"type":["null","string"],"description":"Bild des Ansprechpartners"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Ansprechpartners bei einem Kunden mit Kontaktdaten, Rollen, Einwilligungen und Betriebsst\u00E4ttenzuordnung."},"ContactHistoryResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadContactHistoryResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt eines Endpunkts mit der Kontakthistorie eines Ansprechpartners sowie Status-, Validierungs- und Fehlerinformationen."},"ContactInfoType":{"enum":[1667,1668,1669,1670],"type":"integer","description":"1667 = prim\u00E4re E-Mail-Adresse, 1668 = weitere E-Mail-Adresse, 1669 = prim\u00E4re Telefonnummer, 1670 = zweite Telefonnummer.","format":"int32","x-enum-varnames":["EmailPrimary","EmailSecondary","TelephonePrimary","TelephoneSecondary"]},"ContactReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Ansprechpartners","format":"int32"},"salutationId":{"description":"Kennung der Anrede","$ref":"#/components/schemas/Salutation"},"salutation":{"type":["null","string"],"description":"Anrede"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"fullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"position":{"type":["null","string"],"description":"Position im Unternehmen"},"department":{"type":["null","string"],"description":"Abteilung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer"},"mobilePhoneNumber":{"type":["null","string"],"description":"Mobiltelefonnummer"},"isDecider":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Entscheider ist"},"isPhoneAdvertisingAllowed":{"type":"boolean","description":"Gibt an, ob telefonische Werbung erlaubt ist"},"isEmailAdvertisingAllowed":{"type":"boolean","description":"Gibt an, ob Werbung per E-Mail erlaubt ist"},"isContactBanned":{"type":"boolean","description":"Gibt an, ob eine Kontaktsperre besteht"},"remark":{"type":["null","string"],"description":"Bemerkung"},"isSafetyOfficer":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Sicherheitsbeauftragter ist"},"isPrivacyOfficer":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Datenschutzbeauftragter ist"},"linkedInUrl":{"type":["null","string"],"description":"URL des LinkedIn-Profils, vollst\u00E4ndig mit Host (https://www.linkedin.com/\u2026); ohne Wert null. Neu in V 3.4.0: An allen Leseendpunkten gleich (Einzelabruf, Firmendetails, Betriebsst\u00E4ttendetails); bisher lieferten Firmen- und Betriebsst\u00E4ttendetails nur den Pfad."},"xingUrl":{"type":["null","string"],"description":"URL des Xing-Profils, vollst\u00E4ndig mit Host (https://www.xing.com/\u2026); ohne Wert null. Neu in V 3.4.0: An allen Leseendpunkten gleich (Einzelabruf, Firmendetails, Betriebsst\u00E4ttendetails); bisher lieferten Firmen- und Betriebsst\u00E4ttendetails nur den Pfad."},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"phoneNumberForCommunication":{"type":["null","string"],"description":"Telefonnummer f\u00FCr die Kommunikation"},"hasWhatsApp":{"type":"boolean","description":"Gibt an, ob WhatsApp verf\u00FCgbar ist"},"isWhatsAppConsentGranted":{"type":"boolean","description":"Gibt an, ob eine Einwilligung zur Nutzung von WhatsApp vorliegt"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit des Ansprechpartners","$ref":"#/components/schemas/ResponsibilityReadDto"},"assignedOfficeIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Ids der zugeordneten Betriebsst\u00E4tten. Neu in V 3.4.0: An den Betriebsst\u00E4ttendetails nie mehr null; enth\u00E4lt alle Zuordnungen des Ansprechpartners."}},"additionalProperties":false,"description":"Datenobjekt (Lesemodell) eines Ansprechpartners bei einem Kunden mit Kontaktdaten, Rollen, Einwilligungen und Betriebsst\u00E4ttenzuordnung."},"CountriesResponse":{"type":"object","properties":{"countries":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdCodeDto"},"description":"Liste der L\u00E4nder"}},"additionalProperties":false,"description":"Antwortobjekt eines Endpunkts mit einer Liste von L\u00E4ndern (jeweils ID, Name und Code)."},"CustomerChangesDetailsDto":{"type":"object","properties":{"customerId":{"type":"integer","description":"Identifikation der Firma","format":"int32"},"name":{"type":["null","string"],"description":"Name der Firma"},"createdAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher die Firma angelegt wurde","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher die Firma das letzte Mal ge\u00E4ndert wurde","format":"date-time"}},"additionalProperties":false,"description":"Einzelner \u00C4nderungseintrag eines Kunden mit Firmen-ID, Name sowie Erstellungs- und \u00C4nderungszeitpunkt."},"CustomerChangesDto":{"type":"object","properties":{"new":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"},"description":"Liste neu angelegter Kunden"},"modified":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"},"description":"Liste ge\u00E4nderter Kunden"},"deleted":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CustomerChangesDetailsDto"},"description":"Liste gel\u00F6schter Kunden"}},"additionalProperties":false,"description":"\u00C4nderungscontainer f\u00FCr Kunden mit Listen neu angelegter, ge\u00E4nderter und gel\u00F6schter Firmen."},"CustomerContractStatusChangeDto":{"type":"object","properties":{"requestId":{"type":"integer","description":"Identifikation der Anfrage","format":"int32"},"candidateId":{"type":["null","integer"],"description":"Identifikation des Bewerbers","format":"int32"},"contractSignedAtUtc":{"type":"string","description":"Zeitpunkt der Vertragsunterzeichnung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt zur Meldung eines unterschriebenen Vertrags mit Anfrage, Bewerber und Unterzeichnungszeitpunkt."},"CustomerCreateDto":{"required":["name","companyTypeId","responsibility"],"type":"object","properties":{"name":{"type":["null","string"],"description":"Name des Kunden. Pflichtfeld. Ohne Rechtsform; die geh\u00F6rt nach companyTypeId und wird von uns nicht an den Namen angeh\u00E4ngt. Neu in V 3.4.0: Endet der Name trotzdem auf eine Rechtsform aus GET /masterdata/CompanyTypes (z. B. Musterfirma GmbH), wird sie serverseitig abgetrennt und companyTypeId aus dem Suffix gesetzt; der Suffix gewinnt \u00FCber einen mitgeschickten companyTypeId."},"companyTypeId":{"type":"integer","description":"Kennung des Firmentyps (Rechtsform). Pflichtfeld beim Anlegen; fehlt der Wert, wird der Aufruf mit 400 und einem Validierungsfehler auf CompanyTypeId abgelehnt. G\u00FCltige Werte liefert GET /masterdata/CompanyTypes; f\u00FCr keine Angabe ist 130 (Unknown) vorgesehen. Beim PUT und an der Betriebsst\u00E4tte ist das Feld optional. Neu in V 3.4.0: Tr\u00E4gt name eine Rechtsform am Ende, wird der Wert daraus abgeleitet und \u00FCberschreibt den mitgeschickten."},"corporationId":{"type":["null","integer"],"description":"Neu in V 3.4.0: Kennung des Konzerns (Unternehmensgruppe). Es l\u00E4sst sich ausschlie\u00DFlich ein bereits vorhandener Konzern zuordnen; neue Konzerne legt die Public API nicht an, das bleibt Stammdatenpflege in der Oberfl\u00E4che. G\u00FCltige Werte liefert GET /customers/corporations; eine unbekannte Id wird mit 400 und einem Validierungsfehler auf CorporationId abgelehnt.","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung (max. 255 Zeichen). Der Wert wird gespeichert und \u00FCber GET /customers/{id} wieder ausgegeben, in talent.Flow am Kunden aber nicht angezeigt und fachlich nicht ausgewertet. F\u00FCr eine sichtbare Bezeichnung ist das gleichnamige Feld an Betriebsst\u00E4tte und Einsatzort gedacht."},"notes":{"type":["null","string"],"description":"Notizen (max. 1000 Zeichen)"},"location":{"description":"Adresse des Kunden. Der Kunde f\u00FChrt keine Adresszeilen; addressLine1 und addressLine2 gibt es nur an der Betriebsst\u00E4tte, Zus\u00E4tze zur Anschrift geh\u00F6ren hier in street.","$ref":"#/components/schemas/AddressCreateDto"},"customerStatus":{"description":"Status des Kunden","$ref":"#/components/schemas/CustomerStatus"},"ranking":{"description":"Ranking des Kunden","$ref":"#/components/schemas/CustomerRanking"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Ohne Angabe wird der Zeitpunkt des Aufrufs gesetzt.","format":"date-time"},"candidateProfileTemplateConfigurationForEmployeeLeasingId":{"type":["null","integer"],"description":"Kennung der Vorlagenkonfiguration f\u00FCr Bewerberprofile bei Arbeitnehmer\u00FCberlassung","format":"int32"},"candidateProfileTemplateConfigurationForPersonnelPlacementId":{"type":["null","integer"],"description":"Kennung der Vorlagenkonfiguration f\u00FCr Bewerberprofile bei Personalvermittlung","format":"int32"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Kunden. Pflichtfeld; fehlt der Block oder ist eine der beiden Ids 0, wird der Aufruf mit 400 und Validierungsfehlern auf Responsibility.UserId bzw. Responsibility.OfficeId abgelehnt.","$ref":"#/components/schemas/ResponsibilityCreateDto"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Kunden mit Name, Firmentyp, Konzern, Beschreibung, Adresse, Status, Ranking und Zust\u00E4ndigkeit. Pflichtfelder sind name, companyTypeId und responsibility (mit userId und officeId). Adresszeilen (addressLine1/2) f\u00FChrt der Kunde nicht; die gibt es nur an der Betriebsst\u00E4tte."},"CustomerProcessStatusChangeDto":{"type":"object","properties":{"customerStatusId":{"description":"Status des Kunden","$ref":"#/components/schemas/CustomerStatusCode"}},"additionalProperties":false,"description":"Datenobjekt zum \u00C4ndern des Status eines Kunden."},"CustomerRanking":{"enum":["A","B","C","D"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Ranking-Stufen eines Kunden (A bis D)."},"CustomerReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Kunden","format":"int32"},"name":{"type":["null","string"],"description":"Name des Kunden"},"description":{"type":["null","string"],"description":"Beschreibung"},"notes":{"type":["null","string"],"description":"Neu in V 3.4.0: Notizen, internes Freitextfeld \u00FCber den Kunden, schreibbar \u00FCber POST /customers und jetzt auch lesbar."},"corporationId":{"type":["null","integer"],"description":"Neu in V 3.4.0: Identifikation der Unternehmensgruppe (Id)","format":"int32"},"corporation":{"type":["null","string"],"description":"Neu in V 3.4.0: Name der Unternehmensgruppe"},"companyTypeId":{"description":"Firmentyp (Id)","$ref":"#/components/schemas/CompanyType"},"companyType":{"type":["null","string"],"description":"Firmentyp"},"ranking":{"anyOf":[{"$ref":"#/components/schemas/CustomerRanking"},{"type":"null"}],"description":"Neu in V 3.4.0: Ranking des Kunden (A\u2013D), gespiegelt aus dem Wert, den POST /customers im Feld ranking annimmt. null, wenn kein Ranking gesetzt ist oder der gespeicherte Wert au\u00DFerhalb von A\u2013D liegt."},"customerStatus":{"type":["null","string"],"description":"Status des Kunden"},"customerStatusChangedAtUtc":{"type":["null","string"],"description":"Zeitpunkt der letzten Status\u00E4nderung des Kunden (UTC)","format":"date-time"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"createdAtUtc":{"type":"string","description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung (UTC)","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Kunden","$ref":"#/components/schemas/ResponsibilityReadDto"},"address":{"description":"Adresse des Kunden","$ref":"#/components/schemas/AddressReadDto"},"offices":{"type":["null","array"],"items":{"$ref":"#/components/schemas/OfficeReadDto"},"description":"Niederlassungen des Kunden"},"contacts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ContactReadDto"},"description":"Ansprechpartner des Kunden"}},"additionalProperties":false,"description":"Datenobjekt (Lesemodell) eines Kunden mit Stammdaten, Firmentyp, Konzern, Status, Ranking, Notizen, Adresse, Niederlassungen und Ansprechpartnern."},"CustomerReportPerfomanceReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Id der Anfrage","format":"int32"},"status":{"type":["null","string"],"description":"Status der Anfrage"},"userName":{"type":["null","string"],"description":"Name des Beraters"},"title":{"type":["null","string"],"description":"Titel der Stellenanzeige"},"customerName":{"type":["null","string"],"description":"Name des Kunden"},"customerReference":{"type":["null","string"],"description":"Referenz des Kunden"},"corporationName":{"type":["null","string"],"description":"Name des Konzern"},"office":{"type":["null","string"],"description":"Name der Niederlassung"},"jobAds":{"type":"integer","description":"Aktive und inaktive Anzahl der Stellenanzeigen","format":"int32"},"requestedPositions":{"type":"integer","description":"Anzahl der ben\u00F6tigten Positionen","format":"int32"},"profiles":{"type":"integer","description":"Anzahl der Kandidatenvorschl\u00E4ge","format":"int32"},"projectStart":{"type":["null","string"],"description":"Erstelldatum der Anfrage im Format (dd.MM.yyyy, deutsche Zeitzone)"},"requestedFrom":{"type":["null","string"],"description":"Ben\u00F6tigt ab Datum im Format (dd.MM.yyyy, deutsche Zeitzone)"},"plannedTo":{"type":["null","string"],"description":"Voraussichtliche Einsatzdauer im Format (dd.MM.yyyy deutsche Zeitzone oder z.B.: 1 Tag/Woche/Monat bzw. 3 Tage/Wochen/Monate)"},"locationZipcode":{"type":["null","string"],"description":"Postleitzahl des EInsatzortes"},"location":{"type":["null","string"],"description":"Stadt des Einsatzortes"},"contactName":{"type":["null","string"],"description":"Ansprechpartner beim Kunden"}},"additionalProperties":false,"description":"Datenobjekt einer Zeile des Kunden-Performance-Reports mit Anfrage-, Stellenanzeigen-, Standort- und Kennzahldaten."},"CustomerReportPerfomanceReadResponse":{"type":"object","properties":{"projectData":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CustomerReportPerfomanceReadDto"},"description":"Liste der Projektdaten des Kunden-Performance-Reports"}},"additionalProperties":false,"description":"Antwortobjekt eines Endpunkts mit den Projektdaten des Kunden-Performance-Reports."},"DocumentCategoryDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Id der Kategorie in talent.Flow","format":"int32"},"name":{"type":["null","string"],"description":"Name der Dokumentenkategorie"}},"additionalProperties":false,"description":"Datenobjekt einer Dokumentenkategorie mit ID und Name."},"DocumentChangesDetailsDto":{"type":"object","properties":{"documentId":{"type":"integer","description":"Identifikation des Dokumentes","format":"int32"},"candidateId":{"type":"integer","description":"Identifikation des Bewerbers","format":"int32"},"originalFileName":{"type":["null","string"],"description":"Original Dateiname"},"fileName":{"type":["null","string"],"description":"Eindeutiger Dateiname von talent.Flow"},"createdAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument angelegt wurde","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Datum und Uhrzeit zu welcher das Dokument das letzte Mal ge\u00E4ndert wurde","format":"date-time"}},"additionalProperties":false,"description":"Einzelner \u00C4nderungseintrag eines Bewerber-Dokuments mit Datei-Metadaten sowie Erstellungs- und \u00C4nderungszeitpunkt."},"DocumentChangesDto":{"type":"object","properties":{"new":{"type":["null","array"],"items":{"$ref":"#/components/schemas/DocumentChangesDetailsDto"},"description":"Liste neu hinzugef\u00FCgter Dokumente"},"modified":{"type":["null","array"],"items":{"$ref":"#/components/schemas/DocumentChangesDetailsDto"},"description":"Liste ge\u00E4nderter Dokumente"},"deleted":{"type":["null","array"],"items":{"$ref":"#/components/schemas/DocumentChangesDetailsDto"},"description":"Liste gel\u00F6schter Dokumente"}},"additionalProperties":false,"description":"\u00C4nderungscontainer f\u00FCr Bewerber-Dokumente mit Listen neuer, ge\u00E4nderter und gel\u00F6schter Eintr\u00E4ge."},"DriversLicenseCreateDto":{"type":"object","properties":{"driversLicenseId":{"type":"integer","description":"Kennung des F\u00FChrerscheins (Id)","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer F\u00FChrerschein-Zuordnung anhand ihrer ID."},"DriverslicensesDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des F\u00FChrerscheins","format":"int32"},"name":{"type":["null","string"],"description":"Name des F\u00FChrerscheins"}},"additionalProperties":false,"description":"Datenobjekt eines F\u00FChrerscheins mit ID und Bezeichnung."},"EducationDto":{"type":"object","properties":{"startDateMonth":{"type":["null","string"],"description":"Monat des Beginns"},"startDateYear":{"type":["null","string"],"description":"Jahr des Beginns"},"endDateMonth":{"type":["null","string"],"description":"Monat des Endes"},"endDateYear":{"type":["null","string"],"description":"Jahr des Endes"},"endCurrent":{"type":"boolean","description":"Gibt an, ob der Zeitraum bis heute andauert"},"degree":{"type":["null","string"],"description":"Abschluss"},"unmappedDegree":{"type":["null","string"],"description":"Nicht zugeordneter Abschluss (Freitext)"},"field":{"type":["null","string"],"description":"Fachrichtung"},"school":{"type":["null","string"],"description":"Bildungseinrichtung / Schule"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"country":{"type":["null","string"],"description":"Land"},"description":{"type":["null","string"],"description":"Beschreibung"}},"additionalProperties":false,"description":"Datenobjekt eines Ausbildungsabschnitts eines Bewerbers mit Zeitraum, Abschluss, Fachrichtung und Bildungseinrichtung."},"EmailImportDto":{"type":"object","properties":{"userId":{"type":["null","integer"],"description":"Identifikation des Benutzers","format":"int32"},"messageStatus":{"description":"Status der Nachricht","$ref":"#/components/schemas/MessageStatus"},"eventDateTimeUtc":{"type":["null","string"],"description":"Zeitpunkt des Ereignisses (UTC)","format":"date-time"},"receiver":{"type":["null","string"],"description":"Empf\u00E4nger der E-Mail"},"subject":{"type":["null","string"],"description":"Betreff der E-Mail"},"sender":{"type":["null","string"],"description":"Absender der E-Mail"},"messageHtml":{"type":["null","string"],"description":"Nachrichteninhalt als HTML"},"messageText":{"type":["null","string"],"description":"Nachrichteninhalt als Text"}},"additionalProperties":false,"description":"Datenobjekt zum Import einer E-Mail-Nachricht mit Absender, Empf\u00E4nger, Betreff, Inhalt (HTML/Text), Status und Zeitpunkt."},"EmployerCreateDto":{"type":"object","properties":{"title":{"type":["null","string"],"description":"Titel der Position"},"company":{"type":["null","string"],"description":"Name des Arbeitgebers"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","integer"],"description":"Monat des Beginns","format":"int32"},"startDateYear":{"type":["null","integer"],"description":"Jahr des Beginns","format":"int32"},"endDateMonth":{"type":["null","integer"],"description":"Monat des Endes","format":"int32"},"endDateYear":{"type":["null","integer"],"description":"Jahr des Endes","format":"int32"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"},"hasManagementExperience":{"type":"boolean","description":"Gibt an, ob F\u00FChrungserfahrung vorliegt"},"hasProjectExperience":{"type":"boolean","description":"Gibt an, ob Projekterfahrung vorliegt"},"testimonyId":{"type":["null","integer"],"description":"Kennung des Zeugnisses","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer beruflichen Station eines Bewerbers mit Position, Arbeitgeber, Ort, Zeitraum sowie Management- und Projekterfahrung."},"EnumGroup":{"enum":["Salutations","Periods","CompanyTypes","EmploymentTypes","MaritalStatus","Nationalities","DisabilityTypes","SourceOfSupplies","BonusTypes","MobilityTypes"],"type":"string","description":"Gruppe der abzurufenden Stammdaten (Parameter \u0060groupId\u0060 in GET /MasterData/{groupId}). M\u00F6gliche Werte: \u0060Salutations\u0060 (Anreden), \u0060Periods\u0060 (Zeitr\u00E4ume), \u0060CompanyTypes\u0060 (Firmierungen), \u0060EmploymentTypes\u0060 (Besch\u00E4ftigungsarten), \u0060MaritalStatus\u0060 (Familienst\u00E4nde), \u0060Nationalities\u0060 (Staatsangeh\u00F6rigkeiten), \u0060DisabilityTypes\u0060 (Behinderungsarten), \u0060SourceOfSupplies\u0060 (Bezugsquellen), \u0060BonusTypes\u0060 (Bonusarten), \u0060MobilityTypes\u0060 (Mobilit\u00E4tsarten)."},"EnumValuesResponse":{"type":"object","properties":{"values":{"type":["null","array"],"items":{"$ref":"#/components/schemas/MasterDataEnumValueDto"},"description":"Liste der Enum-Werte"}},"additionalProperties":false,"description":"Antwortobjekt mit einer Liste von Enum-Werten aus den Stammdaten."},"ErrorResponse":{"type":"object","properties":{"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"}},"additionalProperties":false,"description":"Antwortobjekt f\u00FCr Fehler mit Fehlermeldung, Referenz-GUID und Liste von Validierungsfehlern."},"FederalStatesResponse":{"type":"object","properties":{"federalStates":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdNameDto"},"description":"Liste der Bundesl\u00E4nder"}},"additionalProperties":false,"description":"Antwortobjekt mit einer Liste von Bundesl\u00E4ndern (jeweils ID und Name)."},"FileKind":{"enum":[65,66,67,68,69,722,786,1240,1293,1422],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Dateiarten.","format":"int32"},"GenderDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation des Geschlechts","format":"int32"},"name":{"type":["null","string"],"description":"Geschlecht"}},"additionalProperties":false,"description":"Datenobjekt eines Geschlechts mit ID und Bezeichnung."},"IdCodeDto":{"type":"object","properties":{"code":{"type":["null","string"],"description":"ISO-2 L\u00E4ndercode"},"id":{"type":"integer","description":"Identifikation des Landes","format":"int32"},"name":{"type":["null","string"],"description":"Name des Landes"}},"additionalProperties":false,"description":"Datenobjekt eines Landes mit ID, ISO-2-L\u00E4ndercode und Name."},"IdNameDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation","format":"int32"},"name":{"type":["null","string"],"description":"Name"}},"additionalProperties":false,"description":"Datenobjekt mit ID und Bezeichnung."},"JobAdChangesDetailsDto":{"type":"object","properties":{"jobAdId":{"type":"integer","description":"Identifikation der Stellenanzeige","format":"int32"},"title":{"type":["null","string"],"description":"Titel der Stellenanzeige"},"processStatus":{"type":["null","string"],"description":"Prozessstatus der Stellenanzeige"},"createdAtUtc":{"type":"string","description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Einzelner \u00C4nderungseintrag einer Stellenanzeige mit Titel, Prozessstatus sowie Erstellungs- und \u00C4nderungszeitpunkt."},"JobAdChangesDto":{"type":"object","properties":{"new":{"type":["null","array"],"items":{"$ref":"#/components/schemas/JobAdChangesDetailsDto"},"description":"Neue Stellenanzeigen"},"modified":{"type":["null","array"],"items":{"$ref":"#/components/schemas/JobAdChangesDetailsDto"},"description":"Bearbeitete Stellenanzeigen"},"deleted":{"type":["null","array"],"items":{"$ref":"#/components/schemas/JobAdChangesDetailsDto"},"description":"Gel\u00F6schte Stellenanzeigen"}},"additionalProperties":false,"description":"\u00C4nderungscontainer f\u00FCr Stellenanzeigen mit Listen neuer, ge\u00E4nderter und gel\u00F6schter Eintr\u00E4ge."},"JobAdStatisticsReadResponse":{"type":"object","properties":{"day":{"type":"string","description":"Tag","format":"date"},"jobAdId":{"type":"integer","description":"Id der Stellenanzeige","format":"int32"},"referenceId":{"type":["null","string"],"description":"Referenz Id des Kunden"},"workingTitle":{"type":["null","string"],"description":"Berufsbezeichnung der Bundesagentur f\u00FCr Arbeit"},"dkzId":{"type":["null","string"],"description":"Id der Bundesagentur f\u00FCr Arbeit"},"channel":{"type":["null","string"],"description":"Kanal"},"campaignNames":{"type":["null","array"],"items":{"type":"string"},"description":"Name der Kampagne"},"campaignKeywords":{"type":["null","array"],"items":{"type":"string"},"description":"Kampagnenschlagworte"},"costs":{"type":"number","description":"Kosten","format":"double"},"clicks":{"type":"integer","description":"Klicks","format":"int32"},"applies":{"type":"integer","description":"Bewerbungen","format":"int32"},"applyStarts":{"type":"integer","description":"Gestartete Bewerbungen (nur bei Kanal Indeed)","format":"int32"}},"additionalProperties":false,"description":"Antwortobjekt mit tagesbezogenen Statistikkennzahlen einer Stellenanzeige je Kanal (Kosten, Klicks, Bewerbungen)."},"JobDescription":{"type":"object","properties":{"title":{"type":["null","string"],"description":"\u00DCberschrift des Textblocks"},"description":{"type":["null","string"],"description":"HTML formatierter Text des Textblocks"},"descriptionRendered":{"type":["null","string"],"description":"Gerenderter Text des Textblocks"}},"additionalProperties":false,"description":"Textblock einer Stellenbeschreibung mit \u00DCberschrift sowie Text in HTML-formatierter und gerenderter Form."},"KeywordCreateDto":{"type":"object","properties":{"keyword":{"type":["null","string"],"description":"Schlagwort"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Schlagworts."},"LanguagesDto":{"type":"object","properties":{"id":{"type":"integer","description":"Interne Kennung dieser Sprachkenntnis. ACHTUNG: nicht die languageId \u2014 zum \u00C4ndern und L\u00F6schen ist die Sprach-Id aus /masterdata/languages zu verwenden.","format":"int32"},"languageName":{"type":["null","string"],"description":"Name der Sprache"},"levelId":{"type":"integer","description":"Kennung der Niveaustufe","format":"int32"},"levelName":{"type":["null","string"],"description":"Name der Niveaustufe"}},"additionalProperties":false,"description":"Datenobjekt einer Sprachkenntnis mit Sprache und zugeh\u00F6riger Niveaustufe."},"LanguagesResponse":{"type":"object","properties":{"languages":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdCodeDto"},"description":"Liste der Sprachen"}},"additionalProperties":false,"description":"Antwortobjekt mit einer Liste von Sprachen (jeweils ID, Name und Code)."},"LocationCreateDto":{"type":"object","properties":{"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"description":{"type":["null","string"],"description":"Beschreibung"},"directions":{"type":["null","string"],"description":"Anfahrtshinweise"},"contactId":{"type":["null","integer"],"description":"Kennung des Ansprechpartners (Id)","format":"int32"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"location":{"description":"Adresse des Standorts","$ref":"#/components/schemas/AddressCreateDto"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen eines Standorts mit Beschreibung, Anfahrtshinweisen, Ansprechpartner und Adresse."},"LocationDetailsReadDto":{"type":"object","properties":{"customerId":{"type":"integer","description":"Identifikation des Kunden","format":"int32"},"customerName":{"type":["null","string"],"description":"Name des Kunden"},"officeId":{"type":"integer","description":"Identifikation der Niederlassung","format":"int32"},"officeDescription":{"type":["null","string"],"description":"Beschreibung der Niederlassung"},"id":{"type":"integer","description":"Eindeutige Identifikation des Standorts","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"contactId":{"type":["null","integer"],"description":"Identifikation des Ansprechpartners","format":"int32"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"address":{"description":"Adresse des Standorts","$ref":"#/components/schemas/AddressReadDto"},"directions":{"type":["null","string"],"description":"Anfahrtshinweise"}},"additionalProperties":false,"description":"Lesemodell mit Detaildaten eines Standorts inklusive zugeh\u00F6rigem Kunden, Niederlassung, Adresse, Ansprechpartner und Anfahrtshinweisen."},"LocationProfessionCreateDto":{"type":"object","properties":{"workingTitleId":{"type":"integer","description":"Kennung des Berufstitels (Id)","format":"int32"},"locationId":{"type":"integer","description":"Kennung des Standorts (Id)","format":"int32"},"contactId":{"type":["null","integer"],"description":"Kennung des Ansprechpartners (Id)","format":"int32"},"placementTypeId":{"description":"Art der Vermittlung","$ref":"#/components/schemas/PlacementType"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Berufszuordnung an einem Standort mit Berufstitel, Standort, Ansprechpartner und Vermittlungsart."},"LocationReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Standorts","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"contactId":{"type":["null","integer"],"description":"Identifikation des Ansprechpartners","format":"int32"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"address":{"description":"Adresse des Standorts","$ref":"#/components/schemas/AddressReadDto"},"directions":{"type":["null","string"],"description":"Anfahrtsbeschreibung"}},"additionalProperties":false,"description":"Lesemodell eines Standorts mit Adresse, Beschreibung, Ansprechpartner, Anfahrtsbeschreibung und Importdaten."},"MessageStatus":{"enum":["Received","Sent"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Nachrichtenstatus (empfangen, gesendet)."},"OfficeCreateDto":{"type":"object","properties":{"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Ohne Angabe wird der Zeitpunkt des Aufrufs gesetzt.","format":"date-time"},"addressLine1":{"type":["null","string"],"description":"Adresszeile 1. Beim Anlegen ausschlie\u00DFlich auf oberster Ebene, nicht in location. Beim \u00C4ndern werden beide Wege akzeptiert."},"addressLine2":{"type":["null","string"],"description":"Adresszeile 2. Beim Anlegen ausschlie\u00DFlich auf oberster Ebene, nicht in location. Beim \u00C4ndern werden beide Wege akzeptiert."},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"telephone":{"type":["null","string"],"description":"Telefonnummer"},"phoneNumberForCommunication":{"type":["null","string"],"description":"Telefonnummer f\u00FCr die Kommunikation. Wird beim Anlegen \u00FCbernommen, beim \u00C4ndern derzeit nicht."},"telefax":{"type":["null","string"],"description":"Faxnummer"},"vatId":{"type":["null","string"],"description":"Umsatzsteuer-Identifikationsnummer (USt-IdNr.)"},"costCenter":{"type":["null","string"],"description":"Kostenstelle"},"description":{"type":["null","string"],"description":"Beschreibung. An der Betriebsst\u00E4tte ist das die in talent.Flow sichtbare Bezeichnung."},"companyTypeId":{"type":["null","integer"],"description":"Kennung des Firmentyps (Rechtsform). An der Betriebsst\u00E4tte optional, anders als beim Kunden, wo das Feld beim Anlegen Pflicht ist. G\u00FCltige Werte liefert GET /masterdata/CompanyTypes; f\u00FCr keine Angabe ist 130 (Unknown) vorgesehen.","format":"int32"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"location":{"description":"Adresse der Betriebsst\u00E4tte. Die Adresszeilen geh\u00F6ren beim Anlegen auf die oberste Ebene.","$ref":"#/components/schemas/AddressCreateDto"},"responsibility":{"description":"Zust\u00E4ndigkeit der Betriebsst\u00E4tte","$ref":"#/components/schemas/ResponsibilityCreateDto"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Betriebsst\u00E4tte mit Adresse, Kontaktdaten, USt-IdNr., Kostenstelle, Firmentyp und Zust\u00E4ndigkeit. Die Adresszeilen stehen auf oberster Ebene, nicht in location."},"OfficeDetailsReadDto":{"type":"object","properties":{"customerId":{"type":"integer","description":"Identifikation des Kunden","format":"int32"},"customerName":{"type":["null","string"],"description":"Name des Kunden"},"contacts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ContactReadDto"},"description":"Liste der Ansprechpartner"},"id":{"type":"integer","description":"Eindeutige Identifikation der Niederlassung","format":"int32"},"companyTypeId":{"description":"Kennung des Firmentyps","$ref":"#/components/schemas/CompanyType"},"companyType":{"type":["null","string"],"description":"Firmentyp (Bezeichnung)"},"description":{"type":["null","string"],"description":"Beschreibung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"telephone":{"type":["null","string"],"description":"Telefonnummer"},"telefax":{"type":["null","string"],"description":"Faxnummer"},"costCenter":{"type":["null","string"],"description":"Kostenstelle"},"vatId":{"type":["null","string"],"description":"Umsatzsteuer-Identifikationsnummer (USt-IdNr.)"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"locations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/LocationReadDto"},"description":"Liste der Standorte"},"address":{"description":"Adresse der Niederlassung","$ref":"#/components/schemas/AddressReadDto"},"responsibility":{"description":"Zust\u00E4ndigkeit der Niederlassung","$ref":"#/components/schemas/ResponsibilityReadDto"}},"additionalProperties":false,"description":"Detailliertes Lesemodell einer Niederlassung inklusive Kunde, Ansprechpartnern, Standorten, Firmentyp, Kontaktdaten, Adresse und Zust\u00E4ndigkeit."},"OfficeDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation der Niederlassung","format":"int32"},"name":{"type":["null","string"],"description":"Zust\u00E4ndige Niederlassung"}},"additionalProperties":false,"description":"Kompaktes Datenobjekt einer Niederlassung mit Id und Name."},"OfficeReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation der Niederlassung","format":"int32"},"companyTypeId":{"description":"Kennung des Firmentyps","$ref":"#/components/schemas/CompanyType"},"companyType":{"type":["null","string"],"description":"Firmentyp"},"description":{"type":["null","string"],"description":"Beschreibung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"telephone":{"type":["null","string"],"description":"Telefonnummer"},"telefax":{"type":["null","string"],"description":"Telefaxnummer"},"costCenter":{"type":["null","string"],"description":"Kostenstelle"},"vatId":{"type":["null","string"],"description":"Umsatzsteuer-Identifikationsnummer (USt-IdNr.)"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"locations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/LocationReadDto"},"description":"Liste der zugeordneten Standorte"},"address":{"description":"Adresse der Niederlassung","$ref":"#/components/schemas/AddressReadDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr die Niederlassung","$ref":"#/components/schemas/ResponsibilityReadDto"}},"additionalProperties":false,"description":"Lesemodell einer Niederlassung mit Firmentyp, Kontaktdaten, USt-IdNr., Kostenstelle, Standorten, Adresse und Zust\u00E4ndigkeit."},"OperationType":{"enum":[0,1,2],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Operationsarten einer \u00C4nderungsoperation.","format":"int32"},"OrganicStatisticsResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadOrganicStatisticsResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt mit organischen Statistikdaten inklusive Statuscode, Meldungen, Validierungsfehlern und Service-Hinweisen."},"PerformanceStatisticsResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadPerformanceStatisticsResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt mit Performance-Statistikdaten inklusive Statuscode, Meldungen, Validierungsfehlern und Service-Hinweisen."},"ProfessionCreateDto":{"type":"object","properties":{"professionId":{"examples":["15312"],"type":"integer","description":"Identifikation des Berufs: DKZID aus dem Katalog der Bundesagentur f\u00FCr Arbeit. Nicht die Id aus \u0060professionObjects[].id\u0060 der Bewerberdetails \u2014 diese ist eine interne Zuordnungs-Id und wird mit 400 (NotExisting) abgelehnt.","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Berufszuordnung \u00FCber die Berufs-Id."},"ProfessionEducationDto":{"type":"object","properties":{"title":{"type":["null","string"],"description":"Titel der Ausbildung"},"company":{"type":["null","string"],"description":"Name der Bildungseinrichtung"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"country":{"type":["null","string"],"description":"Land"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","string"],"description":"Monat des Beginns"},"startDateYear":{"type":["null","string"],"description":"Jahr des Beginns"},"endDateMonth":{"type":["null","string"],"description":"Monat des Endes"},"endDateYear":{"type":["null","string"],"description":"Jahr des Endes"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"}},"additionalProperties":false,"description":"Datenobjekt einer Ausbildung im Werdegang mit Titel, Firma, Ort, Land, Zeitraum und Beschreibung."},"PutPatchDocument":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation","format":"int32"},"propertyName":{"type":["null","string"],"description":"Name des zu \u00E4ndernden Feldes"},"operations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PutPatchOperation"},"description":"Liste der auszuf\u00FChrenden \u00C4nderungsoperationen"},"layers":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PutPatchDocumentLayer"},"description":"Geschachtelte Objektebenen mit weiteren \u00C4nderungen"}},"additionalProperties":false,"description":"Generischer Patch-Umschlag f\u00FCr partielle Aktualisierungen (PUT). Beschreibt gezielte \u00C4nderungen an einzelnen Feldern (\u0060propertyName\u0060 mit \u0060operations\u0060) sowie an geschachtelten Objekten (\u0060layers\u0060). Wird von allen PUT-Endpunkten mit teilweiser Aktualisierung gemeinsam verwendet."},"PutPatchDocumentLayer":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation der Dokumentebene","format":"int32"},"propertyName":{"type":["null","string"],"description":"Name der Eigenschaft"},"operations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PutPatchOperation"},"description":"Liste der \u00C4nderungsoperationen"},"layers":{"type":["null","array"],"items":{"$ref":"#/components/schemas/PutPatchDocumentLayer"},"description":"Liste der verschachtelten Unterebenen"}},"additionalProperties":false,"description":"\u00C4nderungscontainer f\u00FCr eine Dokumentebene mit Eigenschaftsname, \u00C4nderungsoperationen und verschachtelten Unterebenen."},"PutPatchOperation":{"type":"object","properties":{"propertyName":{"type":["null","string"],"description":"Name der Eigenschaft"},"type":{"description":"Art der Operation","$ref":"#/components/schemas/OperationType"},"value":{"type":"string","description":"Wert"}},"additionalProperties":false,"description":"Einzelne \u00C4nderungsoperation auf einer Eigenschaft mit Operationsart und Wert."},"QualificationCreateDto":{"type":"object","properties":{"qualification":{"type":["null","string"],"description":"Bezeichnung der Qualifikation"},"score":{"type":["null","integer"],"description":"Bewertung der Qualifikation","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Qualifikation mit Bezeichnung und Bewertung."},"QualificationsDto":{"type":"object","properties":{"qualification":{"type":["null","string"],"description":"Qualifikation"},"score":{"type":["null","integer"],"description":"Bewertung","format":"int32"},"id":{"type":"integer","description":"Eindeutige Identifikation","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt einer Qualifikation mit Bezeichnung und Bewertung."},"ReadAllCandidatesResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation des Bewerbers","format":"uuid"},"status":{"type":["null","string"],"description":"Status des Bewerbers"},"createdAtUtc":{"type":"string","description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Antwortobjekt eines Bewerbers in der Auflistung mit Id, Status sowie Erstellungs- und \u00C4nderungszeitstempel."},"ReadAllJobAdsResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation der Stellenanzeige","format":"uuid"},"status":{"type":["null","string"],"description":"Status der Stellenanzeige"},"createdAtUtc":{"type":"string","description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Antwortobjekt einer Stellenanzeige in der Auflistung mit Id, Status sowie Erstellungs- und \u00C4nderungszeitstempel."},"ReadAllOfficesResponse":{"type":"object","properties":{"officeId":{"type":"integer","description":"Id der Niederlassung","format":"int32"},"officeGuid":{"type":"string","description":"Guid der Niederlassung","format":"uuid"},"zvooveId":{"type":["null","string"],"description":"Id der Niederlassung bei Zvoove"},"name":{"type":["null","string"],"description":"Name der Niederlassung"},"description":{"type":["null","string"],"description":"Beschreibung der Niederlassung"},"addressLine1":{"type":["null","string"],"description":"Adresszeile 1"},"addressLine2":{"type":["null","string"],"description":"Adresszeile 2"},"street":{"type":["null","string"],"description":"Stra\u00DFe"},"streetNumber":{"type":["null","string"],"description":"Hausnummer"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Stadt"},"region":{"type":["null","string"],"description":"Region"},"federalState":{"type":["null","string"],"description":"Bundesland"},"country":{"type":["null","string"],"description":"Land"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer"},"faxNumber":{"type":["null","string"],"description":"Telefaxnummer"},"email":{"type":["null","string"],"description":"E-Mail"},"costCenter":{"type":["null","string"],"description":"CostCenter (Buchhaltung)"},"latitude":{"type":["null","number"],"description":"Geocoordinaten Lat","format":"double"},"longitude":{"type":["null","number"],"description":"Geocoordinaten Lon","format":"double"}},"additionalProperties":false,"description":"Antwortobjekt einer Niederlassung in der Auflistung mit Id, Name, Beschreibung, Adresse, Kontaktdaten, Kostenstelle und Geokoordinaten."},"ReadAllUsers2Dto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Benutzers","format":"int32"},"rowGuid":{"type":"string","description":"Eindeutige Kennung (GUID) des Benutzers","format":"uuid"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"userFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"userSince":{"type":["null","string"],"description":"Datum, seit dem der Benutzer besteht"},"licenceStatus":{"type":["null","string"],"description":"Lizenzstatus des Benutzers"}},"additionalProperties":false,"description":"Datenobjekt eines Benutzers mit Id, Vor- und Nachname, vollst\u00E4ndigem Namen, Beitrittsdatum und Lizenzstatus."},"ReadAllUsers2Response":{"type":"object","properties":{"users":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadAllUsers2Dto"},"description":"Liste der Benutzer"}},"additionalProperties":false,"description":"Antwortobjekt mit der Liste aller Benutzer."},"ReadAllUsersResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation des Benutzers","format":"uuid"},"identifier":{"type":"integer","description":"Kennung des Benutzers","format":"int32"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"userFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name des Benutzers"},"userSince":{"type":["null","string"],"description":"Benutzer seit (Beitrittsdatum)"},"licenceStatus":{"type":["null","string"],"description":"Lizenzstatus des Benutzers"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"}},"additionalProperties":false,"description":"Antwortobjekt eines Benutzers in der Auflistung mit Id, Kennung, Name, Beitrittsdatum, Lizenzstatus und E-Mail."},"ReadCandidateByIdResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation des Bewerbers","format":"uuid"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"applicationCount":{"type":"integer","description":"Anzahl der Bewerbungen","format":"int32"},"firstApplicationDateUtc":{"type":["null","string"],"description":"Zeitpunkt der ersten Bewerbung (UTC)","format":"date-time"},"firstApplicationChannel":{"type":["null","string"],"description":"Kanal der ersten Bewerbung"},"officeZvooveId":{"type":["null","string"],"description":"Zvoove-Id der Niederlassung"},"officeName":{"type":["null","string"],"description":"Name der Niederlassung"},"recruiterFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name des Recruiters"},"createdAtUtc":{"type":"string","description":"Zeitpunkt der Erstellung (UTC)","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung (UTC)","format":"date-time"},"status":{"type":["null","string"],"description":"Status des Bewerbers"}},"additionalProperties":false,"description":"Antwortobjekt eines einzelnen Bewerbers mit Adresse, Bewerbungsanzahl, Erstbewerbung, Niederlassung, Recruiter, Status und Zeitstempeln."},"ReadContactHistoryResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation des Kontakthistorien-Eintrags","format":"uuid"},"candidateId":{"type":"string","description":"Eindeutige Identifikation des Bewerbers","format":"uuid"},"contactType":{"type":["null","string"],"description":"Art des Kontakts"},"contactedAtUtc":{"type":"string","description":"Zeitpunkt der Kontaktaufnahme (UTC)","format":"date-time"},"contactedBy":{"type":["null","string"],"description":"Kontaktierende Person"}},"additionalProperties":false,"description":"Antwortobjekt eines Kontakthistorien-Eintrags eines Bewerbers mit Kontaktart, Kontaktzeitpunkt (UTC) und der kontaktierenden Person."},"ReadJobAdByIdResponse":{"type":"object","properties":{"id":{"type":"string","description":"Identifikation der Stellenanzeige","format":"uuid"},"jobAdType":{"type":["null","string"],"description":"Art der Stellenanzeige"},"jobTitle":{"type":["null","string"],"description":"Titel der Stellenanzeige"},"workingTitle":{"type":["null","string"],"description":"Titel der Bundesagentur f\u00FCr Arbeit"},"contractType":{"type":["null","string"],"description":"Vertragstyp"},"jobAdEmploymentType":{"type":["null","string"],"description":"Besch\u00E4ftigungsart der Stellenanzeige"},"hoursPerWeek":{"type":["null","integer"],"description":"Arbeitstunden pro Woche","format":"int32"},"contractDuration":{"type":["null","string"],"description":"Vertragsbefristung"},"internalReference":{"type":["null","string"],"description":"Interne Referenz"},"language":{"type":["null","string"],"description":"Sprache der Stellenanzeige"},"numberOfVacancies":{"type":["null","integer"],"description":"Anzahl der offenen Stellen","format":"int32"},"fieldOfActivity":{"type":["null","string"],"description":"T\u00E4tigkeitsbereich"},"industry":{"type":["null","string"],"description":"Industrie"},"applicationPeriodFrom":{"type":["null","string"],"description":"Beginn des Bewerbungszeitraums","format":"date-time"},"applicationPeriodTo":{"type":["null","string"],"description":"Ende des Bewerbungszeitraums","format":"date-time"},"jobLocationStreet":{"type":["null","string"],"description":"Stra\u00DFe des Arbeitsorts"},"jobLocationZipCode":{"type":["null","string"],"description":"Postleitzahl des Arbeitsorts"},"jobLocationCity":{"type":["null","string"],"description":"Ort / Stadt des Arbeitsorts"},"jobLocationRegion":{"type":["null","string"],"description":"Region des Arbeitsorts"},"jobLocationCountry":{"type":["null","string"],"description":"Land des Arbeitsorts"},"jobLocationGeoLon":{"type":["null","number"],"description":"Geografische L\u00E4nge des Arbeitsorts","format":"double"},"jobLocationGeoLat":{"type":["null","number"],"description":"Geografische Breite des Arbeitsorts","format":"double"},"salaryType":{"type":["null","string"],"description":"Lohn und Gehaltstyp Id"},"salaryRangeStart":{"type":["null","number"],"description":"Untergrenze der Gehaltsspanne","format":"double"},"salaryRangeEnd":{"type":["null","number"],"description":"Obergrenze der Gehaltsspanne","format":"double"},"salaryPeriod":{"type":["null","string"],"description":"Zeitraum der Gehaltsangabe"},"salaryCurrency":{"type":["null","string"],"description":"W\u00E4hrung der Gehaltsangabe"},"homepageCategories":{"type":["null","array"],"items":{"type":"string"},"description":"Homepage Kategorien"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schl\u00FCsselworte / Schlagworte"},"isInHomepageChannel":{"type":"boolean","description":"Gibt an, ob die Stellenanzeige im Homepage-Kanal ver\u00F6ffentlicht ist"},"isInBAChannel":{"type":"boolean","description":"Gibt an, ob die Stellenanzeige im Kanal der Bundesagentur f\u00FCr Arbeit ver\u00F6ffentlicht ist"},"isInOrganicChannel":{"type":"boolean","description":"Gibt an, ob die Stellenanzeige im organischen Kanal ver\u00F6ffentlicht ist"},"isInPerformanceChannel":{"type":"boolean","description":"Gibt an, ob die Stellenanzeige im Performance-Kanal ver\u00F6ffentlicht ist"},"isInPremiumChannel":{"type":"boolean","description":"Gibt an, ob die Stellenanzeige im Premium-Kanal ver\u00F6ffentlicht ist"},"responsibleOffice":{"type":["null","string"],"description":"Zust\u00E4ndige Niederlassung"},"responsibleRecruiter":{"type":["null","string"],"description":"Zust\u00E4ndiger Recruiter"},"jobDescriptions":{"type":["null","array"],"items":{"$ref":"#/components/schemas/JobDescription"},"description":"Stellenanzeigentexte"},"publishedAtUtc":{"type":["null","string"],"description":"Ver\u00F6ffentlicht am","format":"date-time"},"createdAtUtc":{"type":"string","description":"Erstellt","format":"date-time"},"modifiedAtUtc":{"type":"string","description":"Letzte \u00C4nderung","format":"date-time"},"status":{"type":["null","string"],"description":"Status der Stellenanzeige"},"createdByFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name des Erstellers"}},"additionalProperties":false,"description":"Antwortobjekt einer einzelnen Stellenanzeige mit Titel, Vertrags- und Besch\u00E4ftigungsdaten, Arbeitsort, Gehalt, Kan\u00E4len, Zust\u00E4ndigkeiten und Anzeigentexten."},"ReadOrganicStatisticsResponse":{"type":"object","properties":{"jobAdId":{"type":"string","description":"Identifikation der Stellenanzeige","format":"uuid"},"date":{"type":["null","string"],"description":"Datum"},"dateUtc":{"type":"string","description":"Datum (UTC)","format":"date-time"},"channel":{"type":["null","string"],"description":"Kanal"},"clicks":{"type":"integer","description":"Anzahl der Klicks","format":"int32"},"applies":{"type":"integer","description":"Anzahl der Bewerbungen","format":"int32"}},"additionalProperties":false,"description":"Antwortobjekt mit organischen Statistikwerten einer Stellenanzeige je Tag und Kanal (Klicks und Bewerbungen)."},"ReadPerformanceStatisticsResponse":{"type":"object","properties":{"jobAdId":{"type":"string","description":"Identifikation der Stellenanzeige","format":"uuid"},"date":{"type":["null","string"],"description":"Datum"},"dateUtc":{"type":"string","description":"Datum (UTC)","format":"date-time"},"channel":{"type":["null","string"],"description":"Kanal"},"clicks":{"type":"integer","description":"Anzahl der Klicks","format":"int32"},"cost":{"type":"number","description":"Kosten","format":"double"},"applies":{"type":"integer","description":"Anzahl der Bewerbungen","format":"int32"}},"additionalProperties":false,"description":"Antwortobjekt mit Performance-Statistikwerten einer Stellenanzeige je Tag und Kanal (Klicks, Kosten und Bewerbungen)."},"ReadStatusHistoryResponse":{"type":"object","properties":{"id":{"type":"string","description":"Eindeutige Identifikation des Statushistorien-Eintrags","format":"uuid"},"candidateId":{"type":"string","description":"Identifikation des Bewerbers","format":"uuid"},"status":{"type":["null","string"],"description":"Status des Bewerbers"},"changedAtUtc":{"type":"string","description":"Zeitpunkt der \u00C4nderung (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Antwortobjekt eines Statushistorien-Eintrags eines Bewerbers mit Status und \u00C4nderungszeitpunkt (UTC)."},"ReadUserByIdAssignedOfficeDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation der Niederlassung","format":"int32"},"name":{"type":["null","string"],"description":"Name der Niederlassung"}},"additionalProperties":false,"description":"Datenobjekt einer dem Benutzer zugeordneten Niederlassung mit Kennung und Name."},"ReadUserByIdLicenceDto":{"type":"object","properties":{"licenceId":{"type":"integer","description":"Eindeutige Identifikation der Lizenz","format":"int32"},"licence":{"type":["null","string"],"description":"Bezeichnung der Lizenz"},"status":{"type":["null","string"],"description":"Status der Lizenz"},"sinceDate":{"type":["null","string"],"description":"Datum des Beginns"},"cancelationDate":{"type":["null","string"],"description":"Datum der K\u00FCndigung"}},"additionalProperties":false,"description":"Datenobjekt einer Lizenz eines Benutzers mit Kennung, Bezeichnung, Status sowie Beginn- und K\u00FCndigungsdatum."},"ReadUserByIdResponse":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Benutzers","format":"int32"},"rowGuid":{"type":"string","description":"Eindeutige Kennung des Datensatzes (GUID)","format":"uuid"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"userFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"userZvooveId":{"type":["null","string"],"description":"Zvoove-Kennung des Benutzers"},"userSince":{"type":["null","string"],"description":"Datum, seit dem der Benutzer besteht"},"licences":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadUserByIdLicenceDto"},"description":"Liste der zugeordneten Lizenzen"},"assignedOffices":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadUserByIdAssignedOfficeDto"},"description":"Liste der zugeordneten Niederlassungen"}},"additionalProperties":false,"description":"Antwortobjekt eines Benutzers mit Stammdaten, Kennungen, Eintrittsdatum sowie zugeordneten Lizenzen und Niederlassungen."},"RecruiterDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation des Recruiters","format":"int32"},"fullName":{"type":["null","string"],"description":"Zust\u00E4ndiger Recruiter"}},"additionalProperties":false,"description":"Datenobjekt eines Recruiters mit Kennung und vollst\u00E4ndigem Namen."},"RequestCandidateStatus":{"enum":[5040,5041,5042,5043,5044,5045,5046,5047,5048,5049,5050,5051,5150,5151,5152,5153,5154,5155,5156,5157,5158,5159,5160,5161,5162,5163,5164,5165,5166,5167,5168,5169,5170,5171,5172,5173,5174,5175,5176,5177,5178,5180,5181,5182,5183,5184,5185,5186,5187,5188,5189,5190,5191,5192],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Bewerberstatus innerhalb einer Anfrage.","format":"int32"},"RequestCreateCustomerDto":{"type":"object","properties":{"officeId":{"type":"integer","description":"Kennung der Niederlassung (Id)","format":"int32"},"locationId":{"type":"integer","description":"Kennung des Standorts (Id)","format":"int32"},"contactId":{"type":"integer","description":"Kennung des Ansprechpartners (Id)","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zur Angabe des Kunden bei einer Anfrage \u00FCber Niederlassung, Standort und Ansprechpartner."},"RequestCreateDirectTransmissionRequestDto":{"type":"object","properties":{"contractDurationId":{"type":["null","integer"],"description":"Kennung der Vertragsdauer (Id)","format":"int32"},"contractLimitedUntilUtc":{"type":["null","string"],"description":"Befristung bis (UTC)","format":"date-time"},"contractLimitedFor":{"type":["null","integer"],"description":"Dauer der Befristung","format":"int32"},"contractLimitedForPeriodId":{"type":["null","integer"],"description":"Kennung der Zeiteinheit der Befristung (Id)","format":"int32"},"workingTimeModelId":{"type":["null","integer"],"description":"Kennung des Arbeitszeitmodells (Id)","format":"int32"},"workPlaceId":{"type":["null","integer"],"description":"Kennung des Arbeitsorts (Id)","format":"int32"},"hasWillingnessToStandby":{"type":"boolean","description":"Gibt an, ob Bereitschaft zur Rufbereitschaft besteht"},"hasWillingnessToTravel":{"type":"boolean","description":"Gibt an, ob Reisebereitschaft besteht"},"hasEmployeeLeasingExperience":{"type":"boolean","description":"Gibt an, ob Erfahrung mit Arbeitnehmer\u00FCberlassung besteht"},"primaryLanguageId":{"type":["null","integer"],"description":"Kennung der prim\u00E4ren Sprache (Id)","format":"int32"},"primaryLanguageLevelId":{"type":["null","integer"],"description":"Kennung des Niveaus der prim\u00E4ren Sprache (Id)","format":"int32"},"secondaryLanguageId":{"type":["null","integer"],"description":"Kennung der sekund\u00E4ren Sprache (Id)","format":"int32"},"secondaryLanguageLevelId":{"type":["null","integer"],"description":"Kennung des Niveaus der sekund\u00E4ren Sprache (Id)","format":"int32"},"wageRangeEnd":{"type":["null","number"],"description":"Obergrenze der Verg\u00FCtungsspanne","format":"double"},"wagePeriodId":{"type":["null","integer"],"description":"Kennung des Verg\u00FCtungszeitraums (Id)","format":"int32"},"bonus":{"type":["null","number"],"description":"Bonus","format":"double"},"bonusTypeId":{"type":["null","integer"],"description":"Kennung der Bonusart (Id)","format":"int32"},"isCompanyCarProvided":{"type":"boolean","description":"Gibt an, ob ein Firmenwagen gestellt wird"},"companyCarBudget":{"type":["null","number"],"description":"Budget f\u00FCr den Firmenwagen","format":"double"},"additionalBenefits":{"type":["null","string"],"description":"Zus\u00E4tzliche Zusatzleistungen"},"amount":{"type":["null","integer"],"description":"Anzahl","format":"int32"},"workingTitleId":{"type":"integer","description":"Kennung der Berufsbezeichnung (Id)","format":"int32"},"earliestStartOfActivityUtc":{"type":["null","string"],"description":"Fr\u00FChester T\u00E4tigkeitsbeginn (UTC)","format":"date-time"},"workingHours":{"type":["null","number"],"description":"Arbeitsstunden","format":"double"},"workingHoursUnitId":{"type":["null","integer"],"description":"Kennung der Einheit der Arbeitsstunden (Id)","format":"int32"},"workingHoursFrom":{"type":["null","integer"],"description":"Arbeitsstunden von","format":"int32"},"workingHoursTo":{"type":["null","integer"],"description":"Arbeitsstunden bis","format":"int32"},"shiftIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Kennungen der Schichten (Ids)"},"jobDescription":{"type":["null","string"],"description":"Stellenbeschreibung"},"qualifications":{"type":["null","array"],"items":{"type":"string"},"description":"Qualifikationen"},"driversLicenseIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Kennungen der F\u00FChrerscheine (Ids)"},"notes":{"type":["null","string"],"description":"Anmerkungen"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schl\u00FCsselw\u00F6rter"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Direktvermittlungs-Anfrage mit Vertrags-, Arbeitszeit-, Sprach-, Verg\u00FCtungs- und Anforderungsangaben."},"RequestCreateEmployeeLeasingRequestDto":{"type":"object","properties":{"labourLeasingDuration":{"type":["null","integer"],"description":"Dauer der Arbeitnehmer\u00FCberlassung","format":"int32"},"labourLeasingDurationUnitId":{"type":["null","integer"],"description":"Einheit der \u00DCberlassungsdauer (Id)","format":"int32"},"hasEmployeeLeasingExperience":{"type":"boolean","description":"Gibt an, ob Erfahrung mit Arbeitnehmer\u00FCberlassung vorhanden ist"},"amount":{"type":["null","integer"],"description":"Anzahl der ben\u00F6tigten Arbeitskr\u00E4fte","format":"int32"},"workingTitleId":{"type":"integer","description":"Identifikation der T\u00E4tigkeit / Berufsbezeichnung (Id)","format":"int32"},"earliestStartOfActivityUtc":{"type":["null","string"],"description":"Fr\u00FChestm\u00F6glicher Beginn der T\u00E4tigkeit (UTC)","format":"date-time"},"workingHours":{"type":["null","number"],"description":"Arbeitszeit","format":"double"},"workingHoursUnitId":{"type":["null","integer"],"description":"Einheit der Arbeitszeit (Id)","format":"int32"},"workingHoursFrom":{"type":["null","integer"],"description":"Arbeitszeit von","format":"int32"},"workingHoursTo":{"type":["null","integer"],"description":"Arbeitszeit bis","format":"int32"},"shiftIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Ids der Schichten"},"jobDescription":{"type":["null","string"],"description":"T\u00E4tigkeitsbeschreibung"},"qualifications":{"type":["null","array"],"items":{"type":"string"},"description":"Qualifikationen"},"driversLicenseIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Ids der F\u00FChrerscheinklassen"},"notes":{"type":["null","string"],"description":"Anmerkungen"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schl\u00FCsselw\u00F6rter"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Arbeitnehmer\u00FCberlassungs-Anfrage mit \u00DCberlassungsdauer, Arbeitszeit, T\u00E4tigkeit, Qualifikationen und Anforderungen."},"RequestCreateServiceContractRequestDto":{"type":"object","properties":{"contractDurationId":{"type":["null","integer"],"description":"Identifikation der Vertragsdauer","format":"int32"},"contractLimitedUntilUtc":{"type":["null","string"],"description":"Befristung bis (UTC)","format":"date-time"},"contractLimitedFor":{"type":["null","integer"],"description":"Dauer der Befristung","format":"int32"},"contractLimitedForPeriodId":{"type":["null","integer"],"description":"Identifikation der Zeiteinheit der Befristung","format":"int32"},"workingTimeModelId":{"type":["null","integer"],"description":"Identifikation des Arbeitszeitmodells","format":"int32"},"workPlaceId":{"type":["null","integer"],"description":"Identifikation des Arbeitsplatzes","format":"int32"},"hasWillingnessToStandby":{"type":"boolean","description":"Gibt an, ob Bereitschaft zu Rufbereitschaft besteht"},"hasWillingnessToTravel":{"type":"boolean","description":"Gibt an, ob Reisebereitschaft besteht"},"hasEmployeeLeasingExperience":{"type":"boolean","description":"Gibt an, ob Erfahrung in der Arbeitnehmer\u00FCberlassung vorhanden ist"},"primaryLanguageId":{"type":["null","integer"],"description":"Identifikation der prim\u00E4ren Sprache","format":"int32"},"primaryLanguageLevelId":{"type":["null","integer"],"description":"Identifikation des Niveaus der prim\u00E4ren Sprache","format":"int32"},"secondaryLanguageId":{"type":["null","integer"],"description":"Identifikation der sekund\u00E4ren Sprache","format":"int32"},"secondaryLanguageLevelId":{"type":["null","integer"],"description":"Identifikation des Niveaus der sekund\u00E4ren Sprache","format":"int32"},"isCompanyCarProvided":{"type":"boolean","description":"Gibt an, ob ein Firmenwagen gestellt wird"},"companyCarBudget":{"type":["null","number"],"description":"Budget f\u00FCr den Firmenwagen","format":"double"},"additionalBenefits":{"type":["null","string"],"description":"Zus\u00E4tzliche Leistungen"},"labourLeasingDuration":{"type":["null","integer"],"description":"Dauer der Arbeitnehmer\u00FCberlassung","format":"int32"},"labourLeasingDurationUnitId":{"type":["null","integer"],"description":"Identifikation der Zeiteinheit der Arbeitnehmer\u00FCberlassung","format":"int32"},"serviceContractDuration":{"type":["null","integer"],"description":"Dauer des Werkvertrags","format":"int32"},"serviceContractDurationUnitId":{"type":["null","integer"],"description":"Identifikation der Zeiteinheit des Werkvertrags","format":"int32"},"serviceContractHourlyWageRemote":{"type":["null","number"],"description":"Stundensatz des Werkvertrags bei Remote-T\u00E4tigkeit","format":"double"},"serviceContractHourlyWageOnSite":{"type":["null","number"],"description":"Stundensatz des Werkvertrags bei T\u00E4tigkeit vor Ort","format":"double"},"serviceContractWageCurrencyId":{"type":["null","integer"],"description":"Identifikation der W\u00E4hrung der Werkvertragsverg\u00FCtung","format":"int32"},"serviceContractWorkLocationId":{"description":"Arbeitsort des Werkvertrags","$ref":"#/components/schemas/WorkLocation"},"amount":{"type":["null","integer"],"description":"Anzahl","format":"int32"},"workingTitleId":{"type":"integer","description":"Identifikation der Berufsbezeichnung","format":"int32"},"earliestStartOfActivityUtc":{"type":["null","string"],"description":"Fr\u00FChestm\u00F6glicher Beginn der T\u00E4tigkeit (UTC)","format":"date-time"},"workingHours":{"type":["null","number"],"description":"Arbeitszeit","format":"double"},"workingHoursUnitId":{"type":["null","integer"],"description":"Identifikation der Einheit der Arbeitszeit","format":"int32"},"workingHoursFrom":{"type":["null","integer"],"description":"Arbeitszeit von","format":"int32"},"workingHoursTo":{"type":["null","integer"],"description":"Arbeitszeit bis","format":"int32"},"shiftIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Identifikationen der Schichten"},"jobDescription":{"type":["null","string"],"description":"Stellenbeschreibung"},"qualifications":{"type":["null","array"],"items":{"type":"string"},"description":"Qualifikationen"},"driversLicenseIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Identifikationen der F\u00FChrerscheinklassen"},"notes":{"type":["null","string"],"description":"Anmerkungen"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Schl\u00FCsselw\u00F6rter"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Werkvertrags-Anfrage mit Vertrags-, Werkvertrags-, Verg\u00FCtungs-, Arbeitszeit- und Anforderungsangaben."},"RequestDirectTransmissionCreateDto":{"type":"object","properties":{"request":{"description":"Details der Anfrage","$ref":"#/components/schemas/RequestCreateDirectTransmissionRequestDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr die Anfrage","$ref":"#/components/schemas/ResponsibilityCreateDto"},"customer":{"description":"Angaben zum Kunden","$ref":"#/components/schemas/RequestCreateCustomerDto"},"candidateProfileTemplateConfigurationId":{"type":["null","integer"],"description":"Identifikation der Konfiguration der Bewerberprofil-Vorlage","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Direktvermittlungs-Anfrage inklusive Anfragedetails, Zust\u00E4ndigkeit, Kunde und Profilvorlagen-Konfiguration."},"RequestEmployeeLeasingCreateDto":{"type":"object","properties":{"request":{"description":"Details der Anfrage zur Arbeitnehmer\u00FCberlassung","$ref":"#/components/schemas/RequestCreateEmployeeLeasingRequestDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr die Anfrage","$ref":"#/components/schemas/ResponsibilityCreateDto"},"customer":{"description":"Kundendaten der Anfrage","$ref":"#/components/schemas/RequestCreateCustomerDto"},"candidateProfileTemplateConfigurationId":{"type":["null","integer"],"description":"Identifikation der Konfiguration der Bewerberprofil-Vorlage","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Arbeitnehmer\u00FCberlassungs-Anfrage inklusive Anfragedetails, Zust\u00E4ndigkeit, Kunde und Profilvorlagen-Konfiguration."},"RequestProcessStatus":{"enum":["New","Editing","Offers","Discarded","Completed"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Bearbeitungsstatus einer Anfrage."},"RequestProcessStatusChangeDto":{"type":"object","properties":{"processStatusId":{"description":"Neuer Bearbeitungsstatus der Anfrage","$ref":"#/components/schemas/RequestProcessStatus"}},"additionalProperties":false,"description":"Datenobjekt zum \u00C4ndern des Bearbeitungsstatus einer Anfrage."},"RequestReadDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation der Anfrage","format":"int32"},"jobTitle":{"type":["null","string"],"description":"Bezeichnung der Stelle"},"customer":{"type":["null","string"],"description":"Name des Kunden"},"customerId":{"type":"integer","description":"Identifikation des Kunden","format":"int32"},"office":{"type":["null","string"],"description":"Name der Niederlassung"},"officeId":{"type":["null","integer"],"description":"Identifikation der Niederlassung","format":"int32"},"contactId":{"type":["null","integer"],"description":"Identifikation des Ansprechpartners","format":"int32"},"contactFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name des Ansprechpartners"},"location":{"type":["null","string"],"description":"Name des Standorts"},"locationId":{"type":["null","integer"],"description":"Identifikation des Standorts","format":"int32"},"workingTitleId":{"type":["null","integer"],"description":"Identifikation der Berufsbezeichnung","format":"int32"},"workingTitle":{"type":["null","string"],"description":"Berufsbezeichnung"},"responsibleAccountUserId":{"type":"integer","description":"Identifikation des zust\u00E4ndigen Benutzers","format":"int32"},"responsibleAccountOfficeId":{"type":"integer","description":"Identifikation der zust\u00E4ndigen Niederlassung","format":"int32"},"responsibleAccountUserEmail":{"type":["null","string"],"description":"E-Mail-Adresse des zust\u00E4ndigen Benutzers"},"amount":{"type":["null","integer"],"description":"Anzahl der gesuchten Personen","format":"int32"},"earliestStartOfActivityUtc":{"type":["null","string"],"description":"Fr\u00FChestm\u00F6glicher T\u00E4tigkeitsbeginn (UTC)","format":"date-time"},"labourLeasingDuration":{"type":["null","integer"],"description":"Dauer der Arbeitnehmer\u00FCberlassung","format":"int32"},"labourLeasingDurationUnitId":{"type":["null","integer"],"description":"Identifikation der Einheit f\u00FCr die Dauer der Arbeitnehmer\u00FCberlassung","format":"int32"},"workingHours":{"type":["null","number"],"description":"Arbeitszeit (Stunden)","format":"double"},"workingHoursUnitId":{"type":["null","integer"],"description":"Identifikation der Einheit f\u00FCr die Arbeitszeit","format":"int32"},"workingHoursFrom":{"type":["null","integer"],"description":"Arbeitszeit von","format":"int32"},"workingHoursTo":{"type":["null","integer"],"description":"Arbeitszeit bis","format":"int32"},"jobDescription":{"type":["null","string"],"description":"Stellenbeschreibung"},"contractDurationId":{"type":["null","integer"],"description":"Identifikation der Vertragsdauer","format":"int32"},"contractLimitedFor":{"type":["null","integer"],"description":"Dauer der Befristung des Vertrags","format":"int32"},"contractLimitedForPeriodId":{"type":["null","integer"],"description":"Identifikation der Einheit der Befristungsdauer","format":"int32"},"contractLimitedForPeriod":{"type":["null","string"],"description":"Einheit der Befristungsdauer"},"contractLimitedUntilUtc":{"type":["null","string"],"description":"Befristet bis (UTC)","format":"date-time"},"recruitmentWorkspace":{"type":["null","string"],"description":"Recruiting-Arbeitsbereich"},"hasWillingnessToStandby":{"type":["null","boolean"],"description":"Gibt an, ob Bereitschaft zur Rufbereitschaft besteht"},"hasWillingnessToTravel":{"type":["null","boolean"],"description":"Gibt an, ob Reisebereitschaft besteht"},"wageCurrencyId":{"type":["null","integer"],"description":"Identifikation der Verg\u00FCtungsw\u00E4hrung","format":"int32"},"wageCurrency":{"type":["null","string"],"description":"Verg\u00FCtungsw\u00E4hrung"},"wagePeriodId":{"type":["null","integer"],"description":"Identifikation des Verg\u00FCtungszeitraums","format":"int32"},"wageRangeEnd":{"type":["null","number"],"description":"Obergrenze der Verg\u00FCtungsspanne","format":"double"},"wageRangeStart":{"type":["null","number"],"description":"Untergrenze der Verg\u00FCtungsspanne","format":"double"},"wageTypeId":{"type":["null","integer"],"description":"Identifikation der Verg\u00FCtungsart","format":"int32"},"bonus":{"type":["null","number"],"description":"Bonus","format":"double"},"bonusTypeId":{"type":["null","integer"],"description":"Identifikation der Bonusart","format":"int32"},"bonusType":{"type":["null","string"],"description":"Bonusart"},"isCompanyCarProvided":{"type":["null","boolean"],"description":"Gibt an, ob ein Firmenwagen gestellt wird"},"companyCarBudget":{"type":["null","number"],"description":"Budget f\u00FCr den Firmenwagen","format":"double"},"additionalBenefits":{"type":["null","string"],"description":"Zus\u00E4tzliche Zusatzleistungen"},"notes":{"type":["null","string"],"description":"Anmerkungen"},"matchingFilterId":{"type":["null","integer"],"description":"Identifikation des Matching-Filters","format":"int32"},"requestedAtUtc":{"type":"string","description":"Zeitpunkt der Anfrage (UTC)","format":"date-time"},"workingTimeModelId":{"type":["null","integer"],"description":"Identifikation des Arbeitszeitmodells","format":"int32"},"workingTimeModel":{"type":["null","string"],"description":"Arbeitszeitmodell"},"workPlaceId":{"type":["null","integer"],"description":"Identifikation des Arbeitsplatzes","format":"int32"},"workPlace":{"type":["null","string"],"description":"Arbeitsplatz"},"hasEmployeeLeasingExperience":{"type":["null","boolean"],"description":"Gibt an, ob Erfahrung mit Arbeitnehmer\u00FCberlassung vorhanden ist"},"shifts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ShiftsDto"},"description":"Liste der Schichten"},"driversLicenses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/EnumValueDto"},"description":"Liste der F\u00FChrerscheine"},"qualifications":{"type":["null","array"],"items":{"type":"string"},"description":"Liste der Qualifikationen"},"keywords":{"type":["null","array"],"items":{"type":"string"},"description":"Liste der Schl\u00FCsselw\u00F6rter"},"suggestedCandidates":{"type":["null","array"],"items":{"$ref":"#/components/schemas/SuggestedCandidateDto"},"description":"Liste der vorgeschlagenen Bewerber"},"placementTypeId":{"description":"Art der Vermittlung (Id)","$ref":"#/components/schemas/PlacementTypeCode"},"labourLeasingDurationUnit":{"type":["null","string"],"description":"Einheit der Dauer der Arbeitnehmer\u00FCberlassung"},"workingHoursUnit":{"type":["null","string"],"description":"Einheit der Arbeitszeit"},"contractDuration":{"type":["null","string"],"description":"Vertragsdauer"},"wagePeriod":{"type":["null","string"],"description":"Verg\u00FCtungszeitraum"},"placementType":{"type":["null","string"],"description":"Art der Vermittlung"},"candidateProfileTemplateConfigurationId":{"type":["null","integer"],"description":"Identifikation der Konfiguration der Bewerberprofilvorlage","format":"int32"},"serviceContractWageCurrencyId":{"type":["null","integer"],"description":"Identifikation der Verg\u00FCtungsw\u00E4hrung des Werkvertrags","format":"int32"},"serviceContractWageCurrency":{"type":["null","string"],"description":"Verg\u00FCtungsw\u00E4hrung des Werkvertrags"},"serviceContractWorkLocationId":{"anyOf":[{"$ref":"#/components/schemas/WorkLocation"},{"type":"null"}],"description":"Arbeitsort des Werkvertrags (Id); null bei Anfragen ohne Werkvertrag"},"serviceContractWorkLocation":{"type":["null","string"],"description":"Arbeitsort des Werkvertrags"},"serviceContractHourlyWageRemote":{"type":["null","number"],"description":"Stundensatz des Werkvertrags bei Remote-Arbeit","format":"double"},"serviceContractHourlyWageOnSite":{"type":["null","number"],"description":"Stundensatz des Werkvertrags bei Arbeit vor Ort","format":"double"},"serviceContractDuration":{"type":["null","integer"],"description":"Dauer des Werkvertrags","format":"int32"},"serviceContractDurationUnitId":{"type":["null","integer"],"description":"Identifikation der Einheit der Werkvertragsdauer","format":"int32"},"serviceContractDurationUnit":{"type":["null","string"],"description":"Einheit der Werkvertragsdauer"},"customerReference":{"type":["null","string"],"description":"Referenz des Kunden"},"proposalDeadlineUtc":{"type":["null","string"],"description":"Frist f\u00FCr Vorschl\u00E4ge (UTC)","format":"date-time"},"processStatusReason":{"type":["null","string"],"description":"Begr\u00FCndung des Prozessstatus"},"homeOfficePortionInPercent":{"type":["null","number"],"description":"Homeoffice-Anteil in Prozent","format":"double"},"fieldServicePortionInPercent":{"type":["null","number"],"description":"Au\u00DFendienstanteil in Prozent","format":"double"},"processStatusId":{"description":"Prozessstatus der Anfrage (Id)","$ref":"#/components/schemas/RequestProcessStatus"},"contractSignedAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Vertragsunterzeichnung (UTC)","format":"date-time"},"name":{"type":["null","string"],"description":"Name der Anfrage"}},"additionalProperties":false,"description":"Datenobjekt einer Anfrage mit Stellen-, Kunden-, Standort- und Zust\u00E4ndigkeitsdaten sowie Vertrags-, Verg\u00FCtungs-, Arbeitszeit- und Werkvertragsdetails und vorgeschlagenen Bewerbern."},"RequestResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"description":"Nutzdaten der Antwort","$ref":"#/components/schemas/RequestReadDto"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt eines Anfrage-Endpunkts mit Anfragedaten, Fehlerstatus, Meldung, Validierungsfehlern, Service-Hinweisen und Statuscode."},"RequestServiceContractCreateDto":{"type":"object","properties":{"request":{"description":"Details der Werkvertrags-Anfrage","$ref":"#/components/schemas/RequestCreateServiceContractRequestDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr die Anfrage","$ref":"#/components/schemas/ResponsibilityCreateDto"},"customer":{"description":"Kunde der Anfrage","$ref":"#/components/schemas/RequestCreateCustomerDto"},"candidateProfileTemplateConfigurationId":{"type":["null","integer"],"description":"Kennung der Vorlagenkonfiguration f\u00FCr Bewerberprofile","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Anlegen einer Werkvertrags-Anfrage inklusive Anfragedetails, Zust\u00E4ndigkeit, Kunde und Profilvorlagen-Konfiguration."},"ResponsibilityCreateDto":{"type":"object","properties":{"userId":{"type":"integer","description":"Identifikation des Benutzers","format":"int32"},"officeId":{"type":"integer","description":"Kennung der Niederlassung","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zur Angabe der Zust\u00E4ndigkeit \u00FCber Benutzer und Niederlassung beim Anlegen einer Anfrage."},"ResponsibilityReadDto":{"type":"object","properties":{"userId":{"type":"integer","description":"Identifikation des Benutzers","format":"int32"},"userFirstName":{"type":["null","string"],"description":"Vorname des Benutzers"},"userLastName":{"type":["null","string"],"description":"Nachname des Benutzers"},"officeId":{"type":"integer","description":"Identifikation der Niederlassung","format":"int32"},"officeName":{"type":["null","string"],"description":"Name der Niederlassung"},"userEmail":{"type":["null","string"],"description":"E-Mail-Adresse des Benutzers"}},"additionalProperties":false,"description":"Datenobjekt der Zust\u00E4ndigkeit mit Benutzer (Name und E-Mail) und zugeordneter Niederlassung."},"ResumeDto":{"type":"object","properties":{"startDateMonth":{"type":["null","string"],"description":"Monat des Beginns"},"startDateYear":{"type":["null","string"],"description":"Jahr des Beginns"},"endDateMonth":{"type":["null","string"],"description":"Monat des Endes"},"endDateYear":{"type":["null","string"],"description":"Jahr des Endes"},"endCurrent":{"type":"boolean","description":"Gibt an, ob der Zeitraum bis heute andauert"},"title":{"type":["null","string"],"description":"Titel"},"company":{"type":["null","string"],"description":"Firma"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"country":{"type":["null","string"],"description":"Land"},"description":{"type":["null","string"],"description":"Beschreibung"},"hasManagementExperience":{"type":"boolean","description":"Gibt an, ob F\u00FChrungserfahrung vorliegt"},"hasProjectExperience":{"type":"boolean","description":"Gibt an, ob Projekterfahrung vorliegt"}},"additionalProperties":false,"description":"Datenobjekt einer beruflichen Station im Lebenslauf eines Bewerbers mit Zeitraum, Position, Firma, Ort sowie Management- und Projekterfahrung."},"Salutation":{"enum":[1,2,3],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Anredeformen einer Person.","format":"int32"},"SchoolEducationDto":{"type":"object","properties":{"title":{"type":["null","string"],"description":"Titel"},"organization":{"type":["null","string"],"description":"Bildungseinrichtung"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"country":{"type":["null","string"],"description":"Land"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"startDateMonth":{"type":["null","string"],"description":"Monat des Beginns"},"startDateYear":{"type":["null","string"],"description":"Jahr des Beginns"},"endDateMonth":{"type":["null","string"],"description":"Monat des Endes"},"endDateYear":{"type":["null","string"],"description":"Jahr des Endes"},"endCurrent":{"type":["null","boolean"],"description":"Gibt an, ob der Zeitraum bis heute andauert"}},"additionalProperties":false,"description":"Datenobjekt einer schulischen Ausbildung eines Bewerbers mit Abschluss, Bildungseinrichtung, Ort, Land und Zeitraum."},"ServiceAlertAudience":{"enum":[0,1,2,4],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Empf\u00E4ngergruppen einer Service-Benachrichtigung (ServiceAlert).","format":"int32"},"ServiceAlertDto":{"type":"object","properties":{"accountId":{"type":"integer","description":"Identifikation des Kontos","format":"int32"},"accountName":{"type":["null","string"],"description":"Name des Kontos"},"timestampUtc":{"type":"string","description":"Zeitpunkt der Benachrichtigung (UTC)","format":"date-time"},"message":{"type":["null","string"],"description":"Meldungstext"},"priority":{"type":"integer","description":"Priorit\u00E4t der Benachrichtigung","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung"},"tag":{"type":["null","string"],"description":"Tag / Kennzeichnung"},"entityId":{"type":["null","integer"],"description":"Identifikation der betroffenen Entit\u00E4t","format":"int32"},"audience":{"description":"Empf\u00E4ngergruppe der Benachrichtigung","$ref":"#/components/schemas/ServiceAlertAudience"}},"additionalProperties":false,"description":"Datenobjekt einer Service-Benachrichtigung mit Konto, Zeitstempel, Meldung, Priorit\u00E4t, Beschreibung, Tag, betroffener Entit\u00E4t und Empf\u00E4ngergruppe."},"ShiftsDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation der Schicht","format":"int32"},"name":{"type":["null","string"],"description":"Name der Schicht"}},"additionalProperties":false,"description":"Datenobjekt einer Arbeitsschicht mit Kennung und Name."},"SmsImportDto":{"type":"object","properties":{"userId":{"type":["null","integer"],"description":"Identifikation des Benutzers","format":"int32"},"messageStatus":{"description":"Status der Nachricht","$ref":"#/components/schemas/MessageStatus"},"eventDateTimeUtc":{"type":["null","string"],"description":"Zeitpunkt des Ereignisses (UTC)","format":"date-time"},"receiverNumber":{"type":["null","string"],"description":"Empf\u00E4ngernummer"},"senderNumber":{"type":["null","string"],"description":"Absendernummer"},"message":{"type":["null","string"],"description":"Nachrichtentext"}},"additionalProperties":false,"description":"Datenobjekt zum Import einer SMS mit Benutzer, Nachrichtenstatus, Ereigniszeitpunkt, Empf\u00E4nger- und Absendernummer sowie Nachrichtentext."},"Source":{"enum":[1064,1065,1066,1182],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Quellen, \u00FCber die ein Bewerber gewonnen wurde.","format":"int32"},"Status":{"enum":[0,1,5,9,23,31],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Statuswerte.","format":"int32"},"StatusHistoryResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadStatusHistoryResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt einer Statushistorie-Abfrage mit den Verlaufsdaten, Statuscode, Meldung, Validierungsfehlern und Service-Benachrichtigungen."},"StatusUpdateDto":{"type":"object","properties":{"statusId":{"type":"integer","description":"Kennung des Status (Id)","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Aktualisieren des Status \u00FCber die Status-Kennung."},"SuggestedCandidateDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Bewerbers","format":"int32"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"processStatusId":{"description":"Kennung des Prozessstatus","$ref":"#/components/schemas/RequestCandidateStatus"},"processStatus":{"type":["null","string"],"description":"Prozessstatus"},"processStatusChangedAtUtc":{"type":"string","description":"Zeitpunkt der letzten \u00C4nderung des Prozessstatus (UTC)","format":"date-time"},"sourceId":{"description":"Kennung der Quelle","$ref":"#/components/schemas/Source"},"source":{"type":["null","string"],"description":"Quelle"},"sentAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Versands (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt eines f\u00FCr eine Anfrage vorgeschlagenen Bewerbers mit Name, Prozessstatus, Quelle und relevanten Zeitpunkten."},"AvailabilityDto":{"type":"object","properties":{"isCurrentlyEmployed":{"type":"boolean","description":"Gibt an, ob der Bewerber aktuell besch\u00E4ftigt ist"},"isImmediatelyAvailable":{"type":"boolean","description":"Gibt an, ob der Bewerber sofort verf\u00FCgbar ist"},"availableFromUtc":{"type":["null","string"],"description":"Verf\u00FCgbar ab (UTC)","format":"date-time"},"noticePeriodId":{"type":["null","integer"],"description":"Identifikation der K\u00FCndigungsfrist","format":"int32"},"noticePeriodValue":{"type":["null","integer"],"description":"Wert der K\u00FCndigungsfrist","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zur Verf\u00FCgbarkeit eines Bewerbers mit aktuellem Besch\u00E4ftigungsstatus, sofortiger Verf\u00FCgbarkeit, verf\u00FCgbarem Startdatum und K\u00FCndigungsfrist."},"BirthDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Geburtsname"},"day":{"type":["null","integer"],"description":"Tag der Geburt","format":"int32"},"month":{"type":["null","integer"],"description":"Monat der Geburt","format":"int32"},"year":{"type":["null","integer"],"description":"Jahr der Geburt","format":"int32"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung des Geburtslands (Id)","format":"int32"},"cityOfBirth":{"type":["null","string"],"description":"Geburtsort"}},"additionalProperties":false,"description":"Datenobjekt zu den Geburtsangaben eines Bewerbers mit Geburtsname, Geburtsdatum sowie Geburtsland und -ort."},"CandidateStatusDto":{"type":"object","properties":{"statusId":{"type":"integer","description":"Kennung des Status (Id)","format":"int32"},"message":{"type":["null","string"],"description":"Meldungstext"}},"additionalProperties":false,"description":"Datenobjekt zum Status eines Bewerbers mit Status-Kennung und optionaler Meldung."},"ContactDto":{"type":"object","properties":{"email":{"type":["null","string"],"description":"E-Mail-Adresse. Ersetzt beim \u00C4ndern die bisherige Hauptadresse; die bisherige wird nicht automatisch nach \u0060additionalEmailAddresses\u0060 \u00FCbernommen. Weitere Adressen werden \u00FCber \u0060POST /candidates/{id}/email\u0060 gepflegt."},"isEmailVeryfied":{"type":"boolean","description":"Gibt an, ob die E-Mail-Adresse verifiziert ist. Der Eigenschaftsname enth\u00E4lt einen Schreibfehler (Veryfied), wird aus Kompatibilit\u00E4tsgr\u00FCnden aber beibehalten."},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer, \u00FCblicherweise die Festnetznummer. Neu in V 3.4.0: Wird zusammen mit \u0060mobileNumber\u0060 gespeichert. Sind beide Felder bef\u00FCllt, belegt \u0060phoneNumber\u0060 den prim\u00E4ren und \u0060mobileNumber\u0060 den sekund\u00E4ren Platz; ist nur eines der beiden Felder bef\u00FCllt, belegt dieses den prim\u00E4ren Platz. Bisher \u00FCberschrieb \u0060mobileNumber\u0060 diese Nummer und der Wert ging verloren."},"mobileNumber":{"type":["null","string"],"description":"Mobiltelefonnummer. Neu in V 3.4.0: Wird zusammen mit \u0060phoneNumber\u0060 gespeichert (Platzvergabe siehe dort). Wer weiterhin nur dieses Feld \u00FCbermittelt, erh\u00E4lt unver\u00E4ndert das bisherige Verhalten. F\u00FCr den Versand von SMS und WhatsApp wird die mobilf\u00E4hige der beiden Nummern verwendet, nicht zwingend die hier \u00FCbermittelte."},"availability":{"type":["null","string"],"description":"Erreichbarkeit"},"preferredContactType":{"type":["null","string"],"description":"Bevorzugter Kontaktweg"},"hasWhatsApp":{"type":["null","boolean"],"description":"Gibt an, ob WhatsApp genutzt wird"},"isWhatsAppConsentGranted":{"type":["null","boolean"],"description":"Gibt an, ob eine Einwilligung zur Kontaktaufnahme per WhatsApp vorliegt"},"additionalEmailAddresses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ContactInfoDto"},"description":"Weitere E-Mail-Adressen"}},"additionalProperties":false,"description":"Datenobjekt zu den Kontaktdaten eines Bewerbers mit E-Mail (inkl. Verifizierungsstatus), Telefon- und Mobilnummer, Erreichbarkeit, bevorzugtem Kontaktweg, WhatsApp-Angaben und weiteren E-Mail-Adressen. Neu in V 3.4.0: Beide Telefonnummern werden gespeichert."},"ContactInfoDto":{"type":"object","properties":{"candidateId":{"type":"integer","description":"Eindeutige Identifikation des Bewerbers","format":"int32"},"typeId":{"description":"Kennung der Kontaktart","$ref":"#/components/schemas/ContactInfoType"},"value":{"type":["null","string"],"description":"Wert der Kontaktinformation"}},"additionalProperties":false,"description":"Datenobjekt einer einzelnen Kontaktinformation eines Bewerbers mit Bewerber-Kennung, Kontaktart und Wert."},"DisabilityDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation der Schwerbehinderung","format":"int32"},"handyCapValue":{"type":["null","integer"],"description":"Grad der Behinderung","format":"int32"},"handyCappedSince":{"type":["null","string"],"description":"Zeitpunkt, seit dem die Behinderung besteht","format":"date-time"},"isHandycapped":{"type":"boolean","description":"Gibt an, ob eine Schwerbehinderung vorliegt"}},"additionalProperties":false,"description":"Datenobjekt zur Schwerbehinderung eines Bewerbers mit Kennung, Grad der Behinderung, Zeitpunkt seit Bestehen und Behindertenstatus."},"LocationDto":{"type":"object","properties":{"additionalAddressInformation":{"type":["null","string"],"description":"Adresszusatz"},"street":{"type":["null","string"],"description":"Stra\u00DFe"},"streetNumber":{"type":["null","string"],"description":"Hausnummer"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"federalStateId":{"type":["null","integer"],"description":"Bundeslandkennung (Id)","format":"int32"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum Standort eines Bewerbers mit Adresszusatz, Stra\u00DFe, Hausnummer, PLZ, Ort, Bundesland und Land."},"MobilityDto":{"type":"object","properties":{"hasOwnCar":{"type":"boolean","description":"Gibt an, ob ein eigener Pkw vorhanden ist"},"hasDriverLicense":{"type":"boolean","description":"Gibt an, ob ein F\u00FChrerschein vorhanden ist"},"traveling":{"type":"boolean","description":"Gibt an, ob Reisebereitschaft besteht"},"mobilityTypeId":{"type":["null","integer"],"description":"Kennung der Mobilit\u00E4tsart (Id)","format":"int32"},"maxTravelTimeInMinutes":{"type":["null","integer"],"description":"Maximale Fahrzeit zum Arbeitsplatz in Minuten","format":"int32"},"maxDistanceToWorkplace":{"type":["null","integer"],"description":"Maximale Entfernung zum Arbeitsplatz","format":"int32"},"isDeployableInDefaultCountry":{"type":["null","boolean"],"description":"Gibt an, ob ein Einsatz im Standardland m\u00F6glich ist"},"relocation":{"type":["null","boolean"],"description":"Gibt an, ob Umzugsbereitschaft besteht"}},"additionalProperties":false,"description":"Datenobjekt zur Mobilit\u00E4t eines Bewerbers mit Angaben zu eigenem Pkw, F\u00FChrerschein und Reisebereitschaft."},"PrivacyPolicyDto":{"type":"object","properties":{"isAccepted":{"type":"boolean","description":"Gibt an, ob die Einwilligung erteilt wurde"},"validUntilUtc":{"type":["null","string"],"description":"G\u00FCltig bis (UTC)","format":"date-time"}},"additionalProperties":false,"description":"Datenobjekt zur Datenschutzeinwilligung eines Bewerbers mit Zustimmungsstatus und G\u00FCltigkeitsdatum."},"ResponsibilityDto":{"type":"object","properties":{"officeId":{"type":"integer","description":"Identifikation der Niederlassung","format":"int32"},"recruiterId":{"type":"integer","description":"Identifikation des Recruiters","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zur Zust\u00E4ndigkeit f\u00FCr einen Bewerber mit zugeordneter Niederlassung und Recruiter."},"SalaryExpectationsDto":{"type":"object","properties":{"rangeStart":{"type":"number","description":"Untergrenze der Gehaltsspanne","format":"double"},"rangeEnd":{"type":"number","description":"Obergrenze der Gehaltsspanne","format":"double"},"periodId":{"type":["null","integer"],"description":"Identifikation des Zeitraums (z. B. pro Monat oder Jahr)","format":"int32"},"currencyId":{"type":["null","integer"],"description":"Identifikation der W\u00E4hrung","format":"int32"},"serviceContractRemoteHourlyRate":{"type":["null","number"],"description":"Stundensatz f\u00FCr Remote-T\u00E4tigkeit im Dienst-/Werkvertrag","format":"double"},"serviceContractOnSiteHourlyRate":{"type":["null","number"],"description":"Stundensatz f\u00FCr T\u00E4tigkeit vor Ort im Dienst-/Werkvertrag","format":"double"},"serviceContractCurrencyId":{"type":["null","integer"],"description":"Identifikation der W\u00E4hrung f\u00FCr Dienst-/Werkvertragss\u00E4tze","format":"int32"},"bonusTypeId":{"type":["null","integer"],"description":"Identifikation der Bonusart","format":"int32"},"bonusValue":{"type":["null","number"],"description":"H\u00F6he des Bonus","format":"double"},"benefits":{"type":["null","string"],"description":"Zusatzleistungen"}},"additionalProperties":false,"description":"Datenobjekt zur Gehaltsvorstellung eines Bewerbers mit Spanne, Zeitraum, W\u00E4hrung, Stundens\u00E4tzen f\u00FCr Dienst-/Werkvertr\u00E4ge, Bonus und Zusatzleistungen."},"WorkingPreferencesDto":{"type":"object","properties":{"isShiftWorkPossible":{"type":"boolean","description":"Gibt an, ob Schichtarbeit m\u00F6glich ist"},"isPublicHolidayWorkPossible":{"type":"boolean","description":"Gibt an, ob Feiertagsarbeit m\u00F6glich ist"},"isWeekendWorkPossible":{"type":"boolean","description":"Gibt an, ob Wochenendarbeit m\u00F6glich ist"},"isEarlyShiftPossible":{"type":"boolean","description":"Gibt an, ob Fr\u00FChschicht m\u00F6glich ist"},"isLateShiftPossible":{"type":"boolean","description":"Gibt an, ob Sp\u00E4tschicht m\u00F6glich ist"},"isNightShiftPossible":{"type":"boolean","description":"Gibt an, ob Nachtschicht m\u00F6glich ist"},"isContiShiftPossible":{"type":"boolean","description":"Gibt an, ob Konti-Schicht m\u00F6glich ist"},"employmentTypeId":{"type":["null","integer"],"description":"Identifikation der Besch\u00E4ftigungsart","format":"int32"},"workingHoursFrom":{"type":["null","integer"],"description":"Gew\u00FCnschter Arbeitszeitbeginn","format":"int32"},"workingHoursTo":{"type":["null","integer"],"description":"Gew\u00FCnschtes Arbeitszeitende","format":"int32"}},"additionalProperties":false,"description":"Arbeitspr\u00E4ferenzen eines Bewerbers: Bereitschaft zu Schicht-, Feiertags- und Wochenendarbeit, m\u00F6gliche Schichtarten, Besch\u00E4ftigungsart sowie gew\u00FCnschter Arbeitszeitrahmen."},"MasterDataEnumValueDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Stammdatenwerts","format":"int32"},"value":{"type":["null","string"],"description":"Anzeigewert. Die Stammdaten-Endpunkte liefern ihn in englischer Sprache (z. B. \u0022Female\u0022, \u0022HOUR\u0022, \u0022A1 - Beginner 1\u0022), w\u00E4hrend die Bewerber-Detailansicht denselben Wert auf Deutsch ausgibt (\u0022Weiblich\u0022, \u0022Stunde\u0022). F\u00FCr den Abgleich zwischen beiden Sichten daher die \u0060id\u0060 verwenden, nicht den Anzeigewert."}},"additionalProperties":false,"description":"Stammdaten-Enum-Wert mit numerischer Id und zugeh\u00F6rigem Anzeigewert."},"PlacementType":{"enum":["DirectTransmission","EmployeeLeasing"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Vermittlungsarten (Direktvermittlung, Arbeitnehmer\u00FCberlassung)."},"CustomerStatus":{"enum":["Active","Prospect","Former"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Kundenstatus (aktiv, Interessent, ehemalig)."},"AvailabilityExportDto":{"type":"object","properties":{"isCurrentlyEmployed":{"type":["null","boolean"],"description":"Ist aktuell besch\u00E4ftigt"},"isImmediatelyAvailable":{"type":["null","boolean"],"description":"Ist sofort verf\u00FCgbar"},"availableFromUtc":{"type":["null","string"],"description":"Ist verf\u00FCgbar ab","format":"date-time"},"noticePeriodId":{"type":["null","integer"],"description":"Kennung der K\u00FCndigungsfrist (Zeiteinheit aus \u0060GET /masterdata/periods\u0060)","format":"int32"},"noticePeriodValue":{"type":["null","integer"],"description":"Wert der K\u00FCndigungsfrist, also die Anzahl der unter \u0060noticePeriod\u0060 genannten Zeiteinheiten.","format":"int32"},"noticePeriod":{"type":["null","string"],"description":"K\u00FCndigungsfrist (Zeiteinheit im Klartext)"}},"additionalProperties":false,"description":"Verf\u00FCgbarkeit eines Bewerbers: aktuelle Besch\u00E4ftigung, sofortige Verf\u00FCgbarkeit, verf\u00FCgbar ab und K\u00FCndigungsfrist."},"BirthExportDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Geburtsname"},"day":{"type":["null","integer"],"description":"Geburstag","format":"int32"},"month":{"type":["null","integer"],"description":"Geburtsmonat","format":"int32"},"year":{"type":["null","integer"],"description":"Geburtsjahr","format":"int32"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung des Geburtslandes (Id)","format":"int32"},"countryOfBrith":{"type":["null","string"],"description":"Geburtsland (veraltete Schreibweise)"},"countryOfBirth":{"type":["null","string"],"description":"Geburtsland"},"cityOfBirth":{"type":["null","string"],"description":"Geburtsort"}},"additionalProperties":false,"description":"Geburtsdaten eines Bewerbers: Geburtsname, Geburtsdatum (Tag/Monat/Jahr) sowie Geburtsland und -ort."},"CandidateStatusExportDto":{"type":"object","properties":{"statusId":{"description":"Stage-Kennung des Bewerbers (Id)","$ref":"#/components/schemas/CandidateProcessStatus"},"value":{"type":["null","string"],"description":"Stage des Bewerbers (Neu, In Kontakt, Interview, Qualifiziert, Eingestellt, Abgelehnt)"},"message":{"type":["null","string"],"description":"Meldungstext"}},"additionalProperties":false,"description":"Status eines Bewerbers im Bewerbungsprozess mit Stage-Kennung, Stage-Bezeichnung und optionaler Nachricht."},"ContactExportDto":{"type":"object","properties":{"email":{"type":["null","string"],"description":"Email Adresse"},"isEmailVeryfied":{"type":"boolean","description":"Wurde die Email Adresse \u00FCberpr\u00FCft"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer (prim\u00E4re Nummer). Bei Bewerbern, die noch keine hinterlegte Telefon-Kontaktinformation haben, wird weiterhin die bisher gespeicherte Nummer geliefert."},"mobileNumber":{"type":["null","string"],"description":"Neu in V 3.4.0: Zweite Telefonnummer (sekund\u00E4re Nummer), sofern eine hinterlegt ist. Ist nur eine Nummer gepflegt, steht sie in \u0060phoneNumber\u0060 und dieses Feld ist leer."},"availability":{"type":["null","string"],"description":"Erreichbarkeit"},"additionalEmailAddresses":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ContactInfoExportDto"},"description":"Weitere E-Mail-Adressen"},"hasWhatsApp":{"type":["null","boolean"],"description":"Ist WhatsApp verf\u00FCgbar?"},"isWhatsAppConsentGranted":{"type":["null","boolean"],"description":"Wurde eine Einwilligung zur Nutzung von WhatsApp erteilt?"},"preferredContactType":{"type":["null","string"],"description":"Bevorzugte Kontaktart"}},"additionalProperties":false,"description":"Kontaktdaten eines Bewerbers: E-Mail (inkl. Verifizierungsstatus), beide Telefonnummern, Erreichbarkeit und weitere Kontaktangaben."},"ContactInfoExportDto":{"type":"object","properties":{"typeId":{"description":"Art der Kontaktinformation (Id)","$ref":"#/components/schemas/ContactInfoType"},"type":{"type":["null","string"],"description":"Bezeichnung der Art der Kontaktinformation"},"value":{"type":["null","string"],"description":"Wert der Kontaktinformation"}},"additionalProperties":false,"description":"Einzelne Kontaktinformation eines Bewerbers mit Art (Kennung und Bezeichnung) und zugeh\u00F6rigem Wert."},"DisabilityExportDto":{"type":"object","properties":{"id":{"type":["null","integer"],"description":"Eindeutige Identifikation der Schwerbehinderung","format":"int32"},"name":{"type":["null","string"],"description":"Bezeichnung der Schwerbehinderung"},"handyCapValue":{"type":["null","integer"],"description":"Grad der Schwerbehinderung in Prozent (z. B. 50).","format":"int32"},"handyCappedSince":{"type":["null","string"],"description":"Schwerbehindert seit","format":"date-time"},"isHandycapped":{"type":["null","boolean"],"description":"Ist Schwerbehindert"}},"additionalProperties":false,"description":"Angaben zur Schwerbehinderung eines Bewerbers: Bezeichnung, Grad, Bestehen seit und Schwerbehinderten-Kennzeichen."},"LocationExportDto":{"type":"object","properties":{"additionalAddressInformation":{"type":["null","string"],"description":"Zus\u00E4tzliche Adressinformationen"},"street":{"type":["null","string"],"description":"Stra\u00DFe"},"streetNumber":{"type":["null","string"],"description":"Hausnummer"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"federalState":{"type":["null","string"],"description":"Bundesland"},"federalStateId":{"type":["null","integer"],"description":"Kennung des Bundeslandes","format":"int32"},"country":{"type":["null","string"],"description":"Land"},"geoLon":{"type":["null","number"],"description":"Geokoordinaten Longitude","format":"double"},"geoLat":{"type":["null","number"],"description":"Geokoordinaten Latidude","format":"double"},"countryCode":{"type":["null","string"],"description":"L\u00E4ndercode"},"countryId":{"type":"integer","description":"L\u00E4nderkennung (Id)","format":"int32"}},"additionalProperties":false,"description":"Standort/Adresse eines Bewerbers mit Stra\u00DFe, Hausnummer, PLZ, Ort, Bundesland, Land sowie Geokoordinaten."},"MobilityExportDto":{"type":"object","properties":{"hasOwnCar":{"type":["null","boolean"],"description":"Hat sein eigenen PKW"},"hasDriverLicense":{"type":["null","boolean"],"description":"Hat einen F\u00FChrerschein"},"traveling":{"type":["null","boolean"],"description":"Hat Reisebereitschaft"},"relocation":{"type":["null","boolean"],"description":"Umzugsbereitschaft"},"isDeployableInDefaultCountry":{"type":["null","boolean"],"description":"Ist im Stammland einsetzbar"},"maxDistanceToWorkplace":{"type":["null","integer"],"description":"Maximale Entfernung zum Arbeitsplatz","format":"int32"},"maxTravelTimeInMinutes":{"type":["null","integer"],"description":"Maximale Fahrzeit in Minuten","format":"int32"},"mobilityType":{"type":["null","string"],"description":"Art der Mobilit\u00E4t"},"mobilityTypeId":{"type":["null","integer"],"description":"Kennung der Mobilit\u00E4tsart","format":"int32"}},"additionalProperties":false,"description":"Mobilit\u00E4t eines Bewerbers: eigener PKW, F\u00FChrerschein, Reisebereitschaft, Umzugsbereitschaft sowie Grenzen f\u00FCr Entfernung und Fahrzeit."},"PrivacyPolicyExportDto":{"type":"object","properties":{"isAccepted":{"type":"boolean","description":"Datenschutzerkl\u00E4rung wurde akzeptiert"},"validUntilUtc":{"type":["null","string"],"description":"Datenschutzerkl\u00E4rung g\u00FCltig bis","format":"date-time"}},"additionalProperties":false,"description":"Zustimmung eines Bewerbers zur Datenschutzerkl\u00E4rung mit Akzeptanz-Kennzeichen und G\u00FCltigkeitsdatum."},"ResponsibilityExportDto":{"type":"object","properties":{"office":{"description":"Verantwortliche Niederlassung","$ref":"#/components/schemas/OfficeDto"},"recruiter":{"description":"Zugeordneter Recruiter","$ref":"#/components/schemas/RecruiterDto"}},"additionalProperties":false,"description":"Zust\u00E4ndigkeit f\u00FCr einen Bewerber: verantwortliche Niederlassung und zugeordneter Recruiter. Hinweis: Der Name der Niederlassung kann hier von dem abweichen, den \u0060GET /users/responsibilities\u0060 unter \u0060assignedOffices[].name\u0060 ausgibt (etwa \u0022K\u00D6NIG\u0022 gegen\u00FCber \u0022K\u00D6NIG | HQ\u0022). F\u00FCr den Abgleich zwischen beiden Sichten die Ids verwenden, nicht die Namen."},"SalaryExpectationsExportDto":{"type":"object","properties":{"type":{"type":["null","string"],"description":"Art der Gehaltsvorstellung"},"rangeStart":{"type":["null","number"],"description":"Gehaltsvorstellung von","format":"double"},"rangeEnd":{"type":["null","number"],"description":"Gehaltsvorstellung bis","format":"double"},"period":{"type":["null","string"],"description":"Zeiteinheit"},"currency":{"type":["null","string"],"description":"W\u00E4hrung"},"benefits":{"type":["null","string"],"description":"Zus\u00E4tzliche Zuwendungen"},"bonusType":{"type":["null","string"],"description":"Art des Bonus"},"bonusTypeId":{"type":["null","integer"],"description":"Kennung der Bonusart","format":"int32"},"bonusValue":{"type":["null","number"],"description":"H\u00F6he des Bonus","format":"double"},"serviceContractCurrency":{"type":["null","string"],"description":"W\u00E4hrung f\u00FCr Dienstleistungsvertr\u00E4ge"},"serviceContractOnSiteHourlyRate":{"type":["null","number"],"description":"Stundensatz vor Ort f\u00FCr Dienstleistungsvertr\u00E4ge","format":"double"},"serviceContractRemoteHourlyRate":{"type":["null","number"],"description":"Stundensatz remote f\u00FCr Dienstleistungsvertr\u00E4ge","format":"double"}},"additionalProperties":false,"description":"Gehaltsvorstellungen eines Bewerbers: Spanne von/bis, Zeiteinheit, W\u00E4hrung, Bonus, Stundens\u00E4tze f\u00FCr Dienstleistungsvertr\u00E4ge sowie zus\u00E4tzliche Zuwendungen."},"WorkingPreferencesExportDto":{"type":"object","properties":{"isShiftWorkPossible":{"type":["null","boolean"],"description":"Ist Schichtarbeit m\u00F6glich"},"isPublicHolidayWorkPossible":{"type":["null","boolean"],"description":"Ist arbeiten an Feiertagen m\u00F6glich"},"isWeekendWorkPossible":{"type":["null","boolean"],"description":"Ist arbeiten an Wochenenden m\u00F6glich"},"isEarlyShiftPossible":{"type":"boolean","description":"Ist Fr\u00FChschicht m\u00F6glich?"},"isLateShiftPossible":{"type":"boolean","description":"Ist Sp\u00E4tschicht m\u00F6glich?"},"isNightShiftPossible":{"type":"boolean","description":"Ist Nachtschicht m\u00F6glich?"},"isContiShiftPossible":{"type":"boolean","description":"Ist Kontischicht m\u00F6glich?"},"employmentType":{"type":["null","string"],"description":"Art des Besch\u00E4ftigungsverh\u00E4ltnisses"},"employmentTypeId":{"type":["null","integer"],"description":"Kennung des Besch\u00E4ftigungsverh\u00E4ltnisses","format":"int32"},"workingHoursFrom":{"type":"integer","description":"Gew\u00FCnschte Arbeitszeit ab","format":"int32"},"workingHoursTo":{"type":"integer","description":"Gew\u00FCnschte Arbeitszeit bis","format":"int32"}},"additionalProperties":false,"description":"Arbeitspr\u00E4ferenzen eines Bewerbers: Besch\u00E4ftigungsart, Bereitschaft zu Schicht-, Feiertags- und Wochenendarbeit sowie gew\u00FCnschter Arbeitszeitrahmen."},"EnumValueDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Enum-Wertes","format":"int32"},"groupId":{"type":"integer","description":"Kennung der Gruppe","format":"int32"},"value":{"type":["null","string"],"description":"Technischer Wert"},"displayValue":{"type":["null","string"],"description":"Anzeigewert"}},"additionalProperties":false,"description":"Enum-Wert der Stammdaten mit Id, Gruppen-Id, technischem Wert und Anzeigewert."},"CustomerStatusCode":{"enum":[5000,5001,5002,5003],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Kundenstatus als numerische Codes.","format":"int32"},"PlacementTypeCode":{"enum":[0,135,136,137,1241],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Vermittlungsarten als numerische Codes.","format":"int32"},"UserResponsibilitiesResponse":{"type":"object","properties":{"users":{"type":["null","array"],"items":{"$ref":"#/components/schemas/UserResponsibilityDto"},"description":"Liste der Benutzer und ihrer Zust\u00E4ndigkeiten"}},"additionalProperties":false,"description":"Antwortobjekt mit der Liste der Benutzer und ihrer Zust\u00E4ndigkeiten."},"UserResponsibilityDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Benutzers","format":"int32"},"rowGuid":{"type":"string","description":"Eindeutige Kennung (GUID) des Benutzers","format":"uuid"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"userFullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"assignedOffices":{"type":["null","array"],"items":{"$ref":"#/components/schemas/IdNameDto"},"description":"Liste der zugewiesenen Niederlassungen"}},"additionalProperties":false,"description":"Datenobjekt zur Zust\u00E4ndigkeit eines Benutzers mit Name, Kennungen und den ihm zugewiesenen Niederlassungen."},"UsersResponse":{"type":"object","properties":{"isFaulty":{"type":"boolean","description":"Gibt an, ob die Verarbeitung fehlerhaft war"},"data":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ReadAllUsersResponse"},"description":"Nutzdaten der Antwort"},"message":{"type":["null","string"],"description":"Meldungstext"},"validationErrors":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ValidationError"},"description":"Liste der Validierungsfehler"},"serviceAlerts":{"type":["null","array"],"items":{"$ref":"#/components/schemas/ServiceAlertDto"},"description":"Liste der Service-Hinweise"},"statusCode":{"type":"integer","description":"HTTP-Statuscode der Antwort","format":"int32"},"messageGuid":{"type":["null","string"],"description":"Eindeutige Kennung der Meldung (GUID)","format":"uuid"}},"additionalProperties":false,"description":"Antwortobjekt einer Benutzerabfrage mit Benutzerliste, Fehlerstatus, Meldung, Validierungsfehlern, Service-Hinweisen und Statuscode."},"ValidationError":{"type":"object","properties":{"propertyName":{"type":["null","string"],"description":"Name des betroffenen Feldes"},"propertyNameFrom":{"type":["null","string"],"description":"Name des Ausgangsfeldes"},"propertyNameTo":{"type":["null","string"],"description":"Name des Zielfeldes"},"errorType":{"type":["null","string"],"description":"Art des Fehlers"},"methodType":{"type":["null","string"],"description":"Art der Methode"},"value":{"type":["null","boolean","number","string"],"description":"Fehlerhafter Wert im Originaltyp des betroffenen Feldes (z.B. Zahl bei Id-Feldern)"}},"additionalProperties":false,"description":"Einzelner Validierungsfehler mit betroffenem Feld, Fehlerart, Methodenkontext und fehlerhaftem Wert."},"WebhookEventDataType":{"enum":[0,1482,1483],"type":"integer","description":"Datenformat eines Webhook-Ereignisses. Legt die Struktur der \u00FCbermittelten Ereignisdaten fest. Werte: \u00600\u0060 = nicht festgelegt, \u00601482\u0060 = Standard (talent360), \u00601483\u0060 = Azure Cloud Event.","format":"int32"},"WebhookEventProtocolDto":{"type":"object","properties":{"sendStatusId":{"type":"integer","description":"Kennung des Sendestatus (Id)","format":"int32"},"sendStatus":{"description":"Sendestatus des Webhook-Ereignisses","$ref":"#/components/schemas/WebhookSendStatus"},"sendStatusReason":{"type":["null","string"],"description":"Begr\u00FCndung des Sendestatus"},"webhookUrl":{"type":["null","string"],"description":"Aufgerufene Webhook-URL"},"id":{"type":"string","description":"Eindeutige Identifikation des Protokolleintrags","format":"uuid"},"eventId":{"description":"Kennung des Ereignistyps","$ref":"#/components/schemas/WebhookEventType"},"event":{"type":["null","string"],"description":"Ereignistyp"},"entityId":{"type":"integer","description":"Kennung der betroffenen Entit\u00E4t","format":"int32"},"endpoint":{"type":["null","string"],"description":"Aufgerufener Endpunkt"},"endpointMethod":{"type":["null","string"],"description":"HTTP-Methode des Endpunkts"},"eventDateUtc":{"type":"string","description":"Zeitpunkt des Ereignisses (UTC)","format":"date-time"},"additionalData":{"type":"string","description":"Zus\u00E4tzliche Daten"}},"additionalProperties":false,"description":"Protokolleintrag eines Webhook-Ereignisses mit Sendestatus, aufgerufener URL und Endpunkt, Ereignistyp, betroffener Entit\u00E4t und Zeitpunkt."},"WebhookEventType":{"enum":[1377,1378,1379,1380,1381,1382,1383,1384,1385,1386,1419,1420,1421,1423,1424],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Webhook-Ereignistypen.","format":"int32"},"WebhookReadEventTypeDto":{"type":"object","properties":{"eventId":{"description":"Kennung des Ereignistyps","$ref":"#/components/schemas/WebhookEventType"},"event":{"type":["null","string"],"description":"Textuelle Beschreibung des Ereignisses"},"cloudEvent":{"type":["null","string"],"description":"Id des ausgel\u00F6sten Ereignisses im Cloud Format"}},"additionalProperties":false,"description":"Datenobjekt eines Webhook-Ereignistyps mit Kennung, textueller Beschreibung und CloudEvent-Kennung."},"WebhookReadEventTypesResponse":{"type":"object","properties":{"eventTypes":{"type":["null","array"],"items":{"$ref":"#/components/schemas/WebhookReadEventTypeDto"},"description":"Liste der verf\u00FCgbaren Webhook-Ereignistypen"}},"additionalProperties":false,"description":"Antwortobjekt mit der Liste der verf\u00FCgbaren Webhook-Ereignistypen."},"WebhookReadProtocolRequest":{"type":"object","properties":{"eventDateFromUtc":{"type":"string","description":"Beginn des Zeitraums (UTC)","format":"date-time"},"eventDateToUtc":{"type":"string","description":"Ende des Zeitraums (UTC)","format":"date-time"},"entityId":{"type":["null","integer"],"description":"Kennung der Entit\u00E4t","format":"int32"},"eventTypes":{"type":["null","array"],"items":{"$ref":"#/components/schemas/WebhookEventType"},"description":"Liste der Ereignistypen"}},"additionalProperties":false,"description":"Anfrageobjekt zum Auslesen des Webhook-Ereignisprotokolls, gefiltert nach Zeitraum, Entit\u00E4t und Ereignistypen."},"WebhookReadProtocolResponse":{"type":"object","properties":{"events":{"type":["null","array"],"items":{"$ref":"#/components/schemas/WebhookEventProtocolDto"},"description":"Liste der protokollierten Webhook-Ereignisse"}},"additionalProperties":false,"description":"Antwortobjekt mit der Liste protokollierter Webhook-Ereignisse."},"WebhookReadSettingsDto":{"type":"object","properties":{"eventDataTypeId":{"description":"Kennung des Datenformates","$ref":"#/components/schemas/WebhookEventDataType"},"eventDataType":{"type":["null","string"],"description":"Bezeichnung des Datenformates"}},"additionalProperties":false,"description":"Datenobjekt der Webhook-Einstellungen mit dem konfigurierten Datenformat der \u00FCbermittelten Ereignisse."},"WebhookReadSettingsResponse":{"type":"object","properties":{"settings":{"description":"Aktuelle Webhook-Einstellungen","$ref":"#/components/schemas/WebhookReadSettingsDto"}},"additionalProperties":false,"description":"Antwortobjekt mit den aktuellen Webhook-Einstellungen."},"WebhookReadSubscriptionsDto":{"type":"object","properties":{"eventId":{"description":"Kennung des Ereignistyps","$ref":"#/components/schemas/WebhookEventType"},"event":{"type":["null","string"],"description":"Textuelle Beschreibung des Ereignisses"},"url":{"type":["null","string"],"description":"Url, die f\u00FCr die \u00DCbermittlung des Ereignisses aufgerufen werden soll"},"errorCount":{"type":"integer","description":"Anzahl aktuell aufgetretener Fehler beim Aurufen","format":"int32"},"status":{"type":["null","string"],"description":"Aktueller Status der Registrierung - active: Beim Ausl\u00F6sen eines Ereignisses wird der Webhook aufgerufen - paused: Beim Ausl\u00F6sen eines Ereignisses wird der Webhook nicht aufgerufen, aber weiterhin protokolliert"}},"additionalProperties":false,"description":"Datenobjekt einer Webhook-Registrierung mit Ereignistyp, Ziel-URL, Fehlerz\u00E4hler und aktuellem Status."},"WebhookReadSubscriptionsResponse":{"type":"object","properties":{"subscriptions":{"type":["null","array"],"items":{"$ref":"#/components/schemas/WebhookReadSubscriptionsDto"},"description":"Liste der Webhook-Registrierungen"}},"additionalProperties":false,"description":"Antwortobjekt mit der Liste der bestehenden Webhook-Registrierungen."},"WebhookSendStatus":{"enum":["Transfered","Failed","Skipped"],"type":"string","description":"Aufz\u00E4hlung der m\u00F6glichen Sendestatus eines Webhook-Ereignisses."},"WebhookSetEventDataTypeResponse":{"type":"object","additionalProperties":false,"description":"Antwortobjekt zum Setzen des Webhook-Datenformats ohne weitere Nutzdaten."},"WebhookSubscribeRequest":{"type":"object","properties":{"event":{"description":"Ereignistyp, f\u00FCr den der Webhook registriert wird","$ref":"#/components/schemas/WebhookEventType"},"url":{"type":["null","string"],"description":"Ziel-URL des Webhooks"}},"additionalProperties":false,"description":"Anfrageobjekt zum Registrieren eines Webhooks f\u00FCr einen Ereignistyp an einer Ziel-URL."},"WebhookUnsubscribeRequest":{"type":"object","properties":{"event":{"description":"Ereignistyp des Webhooks","$ref":"#/components/schemas/WebhookEventType"},"url":{"type":["null","string"],"description":"Ziel-URL des Webhooks"}},"additionalProperties":false,"description":"Anfrageobjekt zum Abmelden eines Webhooks f\u00FCr einen Ereignistyp an einer Ziel-URL."},"WhatsAppImportDto":{"type":"object","properties":{"userId":{"type":["null","integer"],"description":"Identifikation des Benutzers","format":"int32"},"messageStatus":{"description":"Status der Nachricht","$ref":"#/components/schemas/MessageStatus"},"eventDateTimeUtc":{"type":["null","string"],"description":"Zeitpunkt des Ereignisses (UTC)","format":"date-time"},"receiverNumber":{"type":["null","string"],"description":"Telefonnummer des Empf\u00E4ngers"},"senderNumber":{"type":["null","string"],"description":"Telefonnummer des Absenders"},"message":{"type":["null","string"],"description":"Nachrichtentext"}},"additionalProperties":false,"description":"Datenobjekt zum Import einer WhatsApp-Nachricht mit Absender- und Empf\u00E4ngernummer, Nachrichtentext, Status und Zeitpunkt."},"WorkLocation":{"enum":[1246,1247,1248],"type":"integer","description":"Aufz\u00E4hlung der m\u00F6glichen Arbeitsorte.","format":"int32"},"CandidateLanguageChangeDto":{"required":["levelId"],"type":"object","properties":{"levelId":{"type":"integer","description":"Kennung des Sprachniveaus","format":"int32"}},"additionalProperties":false,"description":"\u00C4nderungsdaten einer Sprachkenntnis eines Bewerbers. Enth\u00E4lt das neue Sprachniveau; die Sprache selbst wird \u00FCber den Pfadparameter languageId adressiert."},"CustomerChangeDto":{"type":"object","properties":{"name":{"type":["null","string"],"description":"Name des Kunden. Ohne Rechtsform; die geh\u00F6rt nach companyTypeId und wird von uns nicht an den Namen angeh\u00E4ngt. Neu in V 3.4.0: Endet ein mitgeschickter Name trotzdem auf eine Rechtsform aus GET /masterdata/CompanyTypes (z. B. Musterfirma GmbH), wird sie serverseitig abgetrennt und companyTypeId aus dem Suffix gesetzt, auch ohne mitgeschickten companyTypeId; ein mitgeschickter Wert wird vom Suffix \u00FCberschrieben."},"companyTypeId":{"type":"integer","description":"Kennung des Firmentyps (Rechtsform). Beim \u00C4ndern optional; wer nur den Namen \u00E4ndert, muss den Firmentyp nicht mitschicken. G\u00FCltige Werte liefert GET /masterdata/CompanyTypes; f\u00FCr keine Angabe ist 130 (Unknown) vorgesehen. Neu in V 3.4.0: Tr\u00E4gt ein mitgeschickter name eine Rechtsform am Ende, wird der Wert daraus abgeleitet und \u00FCberschreibt den mitgeschickten.","format":"int32"},"corporationId":{"type":["null","integer"],"description":"Neu in V 3.4.0: Kennung des Konzerns (Unternehmensgruppe). Es l\u00E4sst sich ausschlie\u00DFlich ein bereits vorhandener Konzern zuordnen; neue Konzerne legt die Public API nicht an. G\u00FCltige Werte liefert GET /customers/corporations; eine unbekannte Id wird mit 400 und einem Validierungsfehler auf CorporationId abgelehnt. Wird das Feld weggelassen, bleibt der Konzern unver\u00E4ndert.","format":"int32"},"description":{"type":["null","string"],"description":"Beschreibung (max. 255 Zeichen). Der Wert wird gespeichert und \u00FCber GET /customers/{id} wieder ausgegeben, in talent.Flow am Kunden aber nicht angezeigt und fachlich nicht ausgewertet. F\u00FCr eine sichtbare Bezeichnung ist das gleichnamige Feld an Betriebsst\u00E4tte und Einsatzort gedacht."},"notes":{"type":["null","string"],"description":"Notizen (max. 1000 Zeichen)"},"location":{"description":"Adresse des Kunden. Der Kunde f\u00FChrt keine Adresszeilen; addressLine1 und addressLine2 gibt es nur an der Betriebsst\u00E4tte, Zus\u00E4tze zur Anschrift geh\u00F6ren hier in street.","$ref":"#/components/schemas/AddressCreateDto"},"ranking":{"description":"Ranking des Kunden","$ref":"#/components/schemas/CustomerRanking"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Neu in V 3.4.0: Wird auch beim \u00C4ndern \u00FCbernommen; der \u00C4nderungszeitpunkt bleibt der Zeitpunkt dieses Aufrufs.","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Kunden. Neu in V 3.4.0: Wird beim \u00C4ndern ausgewertet; bisher still verworfen.","$ref":"#/components/schemas/ResponsibilityCreateDto"}},"description":"\u00C4nderungsdaten einer Firma (Name, Firmentyp, Konzern, Beschreibung, Adresse, Ranking und Zust\u00E4ndigkeit). Nur die \u00FCbermittelten Felder werden ge\u00E4ndert. Adresszeilen (addressLine1/2) f\u00FChrt der Kunde nicht; die gibt es nur an der Betriebsst\u00E4tte."},"OfficeChangeDto":{"type":"object","properties":{"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Neu in V 3.4.0: Wird auch beim \u00C4ndern \u00FCbernommen; der \u00C4nderungszeitpunkt bleibt der Zeitpunkt dieses Aufrufs.","format":"date-time"},"addressLine1":{"type":["null","string"],"description":"Adresszeile 1. Neu in V 3.4.0: Wird sowohl hier auf oberster Ebene als auch in location akzeptiert; beide schreiben dasselbe Feld. Kommt der Wert in beiden, gewinnt der aus location."},"addressLine2":{"type":["null","string"],"description":"Adresszeile 2. Neu in V 3.4.0: Wird sowohl hier auf oberster Ebene als auch in location akzeptiert; beide schreiben dasselbe Feld. Kommt der Wert in beiden, gewinnt der aus location."},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"telephone":{"type":["null","string"],"description":"Telefonnummer"},"phoneNumberForCommunication":{"type":["null","string"],"description":"Telefonnummer f\u00FCr die Kommunikation. Wird beim \u00C4ndern derzeit nicht \u00FCbernommen; der Wert wird aus telephone abgeleitet."},"telefax":{"type":["null","string"],"description":"Faxnummer"},"vatId":{"type":["null","string"],"description":"Umsatzsteuer-Identifikationsnummer (USt-IdNr.)"},"costCenter":{"type":["null","string"],"description":"Kostenstelle"},"description":{"type":["null","string"],"description":"Beschreibung. An der Betriebsst\u00E4tte ist das die in talent.Flow sichtbare Bezeichnung."},"companyTypeId":{"type":["null","integer"],"description":"Kennung des Firmentyps (Rechtsform). An der Betriebsst\u00E4tte optional, anders als beim Kunden, wo das Feld beim Anlegen Pflicht ist. G\u00FCltige Werte liefert GET /masterdata/CompanyTypes.","format":"int32"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"location":{"description":"Adresse der Betriebsst\u00E4tte, inklusive addressLine1 und addressLine2. Eine Adress\u00E4nderung berechnet die Koordinaten neu; geoLat und geoLon sind nicht schreibbar.","$ref":"#/components/schemas/AddressChangeDto"},"responsibility":{"description":"Zust\u00E4ndigkeit der Betriebsst\u00E4tte. Neu in V 3.4.0: Wird beim \u00C4ndern ausgewertet; bisher still verworfen.","$ref":"#/components/schemas/ResponsibilityCreateDto"}},"description":"\u00C4nderungsdaten einer Betriebsst\u00E4tte (Kontaktdaten, Adresse, Firmentyp, USt-IdNr., Kostenstelle und Zust\u00E4ndigkeit). Nur die \u00FCbermittelten Felder werden ge\u00E4ndert. Neu in V 3.4.0: Die Adresszeilen werden wie beim Anlegen auf oberster Ebene akzeptiert und zus\u00E4tzlich in location."},"CandidateWorkContractChangeDto":{"type":"object","properties":{"isWorkContractSigned":{"type":"boolean","description":"Ist der Arbeitsvertrag unterzeichnet? (Ja/Nein)"},"workContractSignedAtUtc":{"type":"string","description":"Datum der Vertragsunterzeichnung","format":"date-time"},"didNotShowUpForWork":{"type":"boolean","description":"Hat die Stelle nicht angetreten? (Ja/Nein)"}},"description":"\u00C4nderungsdaten zum Arbeitsvertrag eines Bewerbers (Unterzeichnung, Datum der Unterzeichnung, Nichtantritt der Stelle)."},"CandidateChangeDto":{"type":"object","properties":{"salutationId":{"type":["null","integer"],"description":"Kennung der Anrede (Id)","format":"int32"},"genderId":{"examples":["591"],"type":["null","integer"],"description":"Kennung des Geschlechts (Id) 591 = divers, 592 = weiblich, 593 = m\u00E4nnlich","format":"int32"},"title":{"type":["null","string"],"description":"Titel"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"fullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"description":{"type":["null","string"],"description":"Freitextbeschreibung zum Bewerber"},"contact":{"description":"Kontaktdaten des Bewerbers","$ref":"#/components/schemas/ContactDto"},"location":{"description":"Standort des Bewerbers","$ref":"#/components/schemas/LocationDto"},"birth":{"description":"Geburtsangaben des Bewerbers","$ref":"#/components/schemas/BirthDto"},"availability":{"description":"Verf\u00FCgbarkeit des Bewerbers","$ref":"#/components/schemas/AvailabilityDto"},"disability":{"description":"Angaben zur Schwerbehinderung des Bewerbers","$ref":"#/components/schemas/DisabilityDto"},"mobility":{"description":"Mobilit\u00E4t des Bewerbers","$ref":"#/components/schemas/MobilityDto"},"workingPreferences":{"description":"Arbeitspr\u00E4ferenzen des Bewerbers","$ref":"#/components/schemas/WorkingPreferencesDto"},"salaryExpectations":{"description":"Gehaltsvorstellung des Bewerbers","$ref":"#/components/schemas/SalaryExpectationsDto"},"personalStatus":{"description":"Pers\u00F6nlicher Status des Bewerbers","$ref":"#/components/schemas/PersonalStatusDto"},"professionalProfile":{"description":"Berufliches Profil des Bewerbers","$ref":"#/components/schemas/ProfessionalProfileDto"},"desiredWorkLocation":{"description":"Gew\u00FCnschter Arbeitsort des Bewerbers","$ref":"#/components/schemas/DesiredWorkLocationDto"},"placementTypes":{"description":"Gew\u00FCnschte Vermittlungsarten des Bewerbers","$ref":"#/components/schemas/PlacementTypesDto"},"privacyPolicy":{"description":"Datenschutzeinwilligung des Bewerbers","$ref":"#/components/schemas/PrivacyPolicyDto"},"responsibility":{"description":"Zust\u00E4ndigkeit f\u00FCr den Bewerber","$ref":"#/components/schemas/ResponsibilityDto"}},"description":"\u00C4nderungsdaten der Bewerberstammdaten (Name, Beschreibung, Kontakt, Standort, Geburt, Verf\u00FCgbarkeit, Mobilit\u00E4t, Arbeitspr\u00E4ferenzen, Gehaltsvorstellung, pers\u00F6nlicher Status, berufliches Profil, gew\u00FCnschter Arbeitsort, Vermittlungsarten, Datenschutz und Zust\u00E4ndigkeit). Nur die \u00FCbermittelten Felder werden ge\u00E4ndert."},"ContactChangeDto":{"type":"object","properties":{"salutationId":{"type":"integer","description":"Identifikation der Anrede","format":"int32"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"position":{"type":["null","string"],"description":"Position im Unternehmen"},"department":{"type":["null","string"],"description":"Abteilung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer"},"mobilePhoneNumber":{"type":["null","string"],"description":"Mobiltelefonnummer"},"isDecider":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Entscheider ist"},"isPhoneAdvertisingAllowed":{"type":["null","boolean"],"description":"Gibt an, ob telefonische Werbung erlaubt ist"},"isEmailAdvertisingAllowed":{"type":["null","boolean"],"description":"Gibt an, ob Werbung per E-Mail erlaubt ist"},"isContactBanned":{"type":["null","boolean"],"description":"Gibt an, ob eine Kontaktsperre f\u00FCr den Ansprechpartner besteht"},"remark":{"type":["null","string"],"description":"Bemerkung"},"isSafetyOfficer":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Sicherheitsbeauftragter ist"},"isPrivacyOfficer":{"type":["null","boolean"],"description":"Gibt an, ob der Ansprechpartner Datenschutzbeauftragter ist"},"linkedInUrl":{"type":["null","string"],"description":"URL des LinkedIn-Profils. Neu in V 3.4.0: Akzeptiert wird die vollst\u00E4ndige URL (Host muss auf linkedin.com enden, sonst 400 mit errorType InvalidUrl), ein Host ohne Schema oder nur der Profilpfad (z. B. in/max-mustermann); gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL. Bisher wurde ein blo\u00DFer Pfad abgelehnt."},"xingUrl":{"type":["null","string"],"description":"URL des Xing-Profils. Neu in V 3.4.0: Akzeptiert wird die vollst\u00E4ndige URL (Host muss auf xing.com enden, sonst 400 mit errorType InvalidUrl), ein Host ohne Schema oder nur der Profilpfad (z. B. profile/Max_Mustermann); gespeichert wird immer der Pfad, gelesen wird die vollst\u00E4ndige URL. Bisher wurde ein blo\u00DFer Pfad abgelehnt."},"assignedOfficeIds":{"type":["null","array"],"items":{"type":"integer"},"description":"Ids der zugeordneten Betriebsst\u00E4tten. Die gesendete Liste ersetzt die Zuordnung vollst\u00E4ndig; eine leere Liste ([]) hebt alle Zuordnungen auf. Neu in V 3.4.0: Ein JSON-null wird ignoriert und wirkt wie ein weggelassenes Feld; die Zuordnungen bleiben unver\u00E4ndert, die Antwort ist 204 (bisher 500). Wer alle Zuordnungen entfernen will, schickt ausdr\u00FCcklich []."},"phoneNumberForCommunication":{"type":["null","string"],"description":"Telefonnummer f\u00FCr die Kommunikation. Wird beim \u00C4ndern derzeit nicht \u00FCbernommen; der Wert wird aus mobilePhoneNumber abgeleitet."},"hasWhatsApp":{"type":["null","boolean"],"description":"Gibt an, ob WhatsApp verf\u00FCgbar ist"},"isWhatsAppConsentGranted":{"type":["null","boolean"],"description":"Gibt an, ob eine Einwilligung zur Nutzung von WhatsApp erteilt wurde"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. Neu in V 3.4.0: Wird auch beim \u00C4ndern \u00FCbernommen; der \u00C4nderungszeitpunkt bleibt der Zeitpunkt dieses Aufrufs.","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit des Ansprechpartners. Neu in V 3.4.0: Wird beim \u00C4ndern ausgewertet; bisher still verworfen.","$ref":"#/components/schemas/ResponsibilityCreateDto"},"image":{"type":["null","string"],"description":"Bild des Ansprechpartners"}},"description":"\u00C4nderungsdaten eines Firmenkontakts (Name, Position, Kontaktdaten, Werbe- und Kontakteinwilligungen, zugeordnete Betriebsst\u00E4tten und Zust\u00E4ndigkeit). Nur die \u00FCbermittelten Felder werden ge\u00E4ndert."},"PlacementTypesDto":{"type":"object","properties":{"personnelPlacement":{"type":"boolean","description":"Gibt an, ob Personalvermittlung gew\u00FCnscht ist"},"employeeLeasing":{"type":"boolean","description":"Gibt an, ob Arbeitnehmer\u00FCberlassung gew\u00FCnscht ist"},"serviceContract":{"type":"boolean","description":"Gibt an, ob ein Dienst-/Werkvertrag gew\u00FCnscht ist"}},"additionalProperties":false,"description":"Datenobjekt zu den gew\u00FCnschten Vermittlungsarten eines Bewerbers (Personalvermittlung, Arbeitnehmer\u00FCberlassung, Dienst-/Werkvertrag)."},"ProfessionalProfileDto":{"type":"object","properties":{"hasWorkPermission":{"type":["null","boolean"],"description":"Gibt an, ob eine Arbeitserlaubnis vorliegt"},"workPermissionValidUntilUtc":{"type":["null","string"],"description":"G\u00FCltigkeit der Arbeitserlaubnis (UTC)","format":"date-time"},"workExperienceInYears":{"type":"integer","description":"Berufserfahrung in Jahren","format":"int32"},"hasCompletedProfessionalTraining":{"type":["null","boolean"],"description":"Gibt an, ob eine abgeschlossene Berufsausbildung vorliegt"}},"additionalProperties":false,"description":"Datenobjekt zum beruflichen Profil eines Bewerbers mit Arbeitserlaubnis, deren G\u00FCltigkeit, Berufserfahrung in Jahren und abgeschlossener Berufsausbildung."},"ProfessionDto":{"type":"object","properties":{"id":{"type":"integer","description":"Interne Kennung dieser Berufszuordnung (wird beim Zuordnen fortlaufend erzeugt). ACHTUNG: nicht die professionId \u2014 zum Anlegen und L\u00F6schen ist die DKZID des BA-Katalogs zu verwenden.","format":"int32"},"profession":{"type":["null","string"],"description":"Bezeichnung des Berufs"}},"additionalProperties":false,"description":"Datenobjekt zu einem Beruf / Einsatzgebiet eines Bewerbers mit Kennung und Bezeichnung."},"PersonalStatusDto":{"type":"object","properties":{"nationalityId":{"type":["null","integer"],"description":"Kennung der Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"nationalitySecondId":{"type":["null","integer"],"description":"Kennung der zweiten Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"nationalityThirdId":{"type":["null","integer"],"description":"Kennung der dritten Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"maritalStatusId":{"type":["null","integer"],"description":"Kennung des Familienstands (Id)","format":"int32"},"amountOfChildren":{"type":"integer","description":"Anzahl der Kinder","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum pers\u00F6nlichen Status eines Bewerbers mit Staatsangeh\u00F6rigkeiten, Familienstand und Anzahl der Kinder."},"PersonalStatusExportDto":{"type":"object","properties":{"nationalityId":{"type":["null","integer"],"description":"Kennung der Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"nationality":{"type":["null","string"],"description":"Bezeichnung der Staatsangeh\u00F6rigkeit"},"nationalitySecondId":{"type":["null","integer"],"description":"Kennung der zweiten Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"nationalitySecond":{"type":["null","string"],"description":"Bezeichnung der zweiten Staatsangeh\u00F6rigkeit"},"nationalityThirdId":{"type":["null","integer"],"description":"Kennung der dritten Staatsangeh\u00F6rigkeit (Id)","format":"int32"},"nationalityThird":{"type":["null","string"],"description":"Bezeichnung der dritten Staatsangeh\u00F6rigkeit"},"maritalStatusId":{"type":["null","integer"],"description":"Kennung des Familienstands (Id)","format":"int32"},"maritalStatus":{"type":["null","string"],"description":"Bezeichnung des Familienstands"},"amountOfChildren":{"type":"integer","description":"Anzahl der Kinder","format":"int32"}},"additionalProperties":false,"description":"Export-Variante zum pers\u00F6nlichen Status eines Bewerbers \u2014 wie PersonalStatusDto, zus\u00E4tzlich mit den ausgeschriebenen Bezeichnungen zu Staatsangeh\u00F6rigkeiten und Familienstand."},"DesiredWorkLocationDto":{"type":"object","properties":{"city":{"type":["null","string"],"description":"Ort / Stadt"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"}},"additionalProperties":false,"description":"Datenobjekt zum gew\u00FCnschten Arbeitsort eines Bewerbers mit Ort, Postleitzahl und Land."},"DesiredWorkLocationExportDto":{"type":"object","properties":{"city":{"type":["null","string"],"description":"Ort / Stadt"},"geoLon":{"type":["null","number"],"description":"Geografische L\u00E4nge","format":"double"},"geoLat":{"type":["null","number"],"description":"Geografische Breite","format":"double"},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id)","format":"int32"},"country":{"type":["null","string"],"description":"Bezeichnung des Landes"},"countryCode":{"type":["null","string"],"description":"L\u00E4ndercode"}},"additionalProperties":false,"description":"Export-Variante zum gew\u00FCnschten Arbeitsort eines Bewerbers \u2014 wie DesiredWorkLocationDto, zus\u00E4tzlich mit Geokoordinaten sowie Landesbezeichnung und L\u00E4ndercode."},"ContactDetailsReadDto":{"type":"object","properties":{"customerId":{"type":"integer","description":"Identifikation des Kunden, zu dem der Ansprechpartner geh\u00F6rt","format":"int32"},"customerName":{"type":["null","string"],"description":"Name des Kunden"},"id":{"type":"integer","description":"Eindeutige Identifikation des Ansprechpartners","format":"int32"},"salutationId":{"description":"Kennung der Anrede","$ref":"#/components/schemas/Salutation"},"salutation":{"type":["null","string"],"description":"Anrede"},"firstName":{"type":["null","string"],"description":"Vorname"},"lastName":{"type":["null","string"],"description":"Nachname"},"fullName":{"type":["null","string"],"description":"Vollst\u00E4ndiger Name (Vor- und Nachname)"},"position":{"type":["null","string"],"description":"Position im Unternehmen"},"department":{"type":["null","string"],"description":"Abteilung"},"email":{"type":["null","string"],"description":"E-Mail-Adresse"},"phoneNumber":{"type":["null","string"],"description":"Telefonnummer"},"mobilePhoneNumber":{"type":["null","string"],"description":"Mobiltelefonnummer"},"isDecider":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Entscheider ist"},"isPhoneAdvertisingAllowed":{"type":"boolean","description":"Gibt an, ob telefonische Werbung erlaubt ist"},"isEmailAdvertisingAllowed":{"type":"boolean","description":"Gibt an, ob Werbung per E-Mail erlaubt ist"},"isContactBanned":{"type":"boolean","description":"Gibt an, ob eine Kontaktsperre besteht"},"remark":{"type":["null","string"],"description":"Bemerkung"},"isSafetyOfficer":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Sicherheitsbeauftragter ist"},"isPrivacyOfficer":{"type":"boolean","description":"Gibt an, ob der Ansprechpartner Datenschutzbeauftragter ist"},"linkedInUrl":{"type":["null","string"],"description":"URL des LinkedIn-Profils, vollst\u00E4ndig mit Host (https://www.linkedin.com/\u2026); ohne Wert null. Neu in V 3.4.0: An allen Leseendpunkten gleich (Einzelabruf, Firmendetails, Betriebsst\u00E4ttendetails)."},"xingUrl":{"type":["null","string"],"description":"URL des Xing-Profils, vollst\u00E4ndig mit Host (https://www.xing.com/\u2026); ohne Wert null. Neu in V 3.4.0: An allen Leseendpunkten gleich (Einzelabruf, Firmendetails, Betriebsst\u00E4ttendetails)."},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"phoneNumberForCommunication":{"type":["null","string"],"description":"Telefonnummer f\u00FCr die Kommunikation. Folgt der Mobiltelefonnummer; ein eigener Wert wird beim Schreiben verworfen"},"hasWhatsApp":{"type":"boolean","description":"Gibt an, ob WhatsApp verf\u00FCgbar ist"},"isWhatsAppConsentGranted":{"type":"boolean","description":"Gibt an, ob eine Einwilligung zur Nutzung von WhatsApp vorliegt"},"importedAtUtc":{"type":["null","string"],"description":"Zeitpunkt des Imports (UTC)","format":"date-time"},"responsibility":{"description":"Zust\u00E4ndigkeit des Ansprechpartners","$ref":"#/components/schemas/ResponsibilityReadDto"},"assignedOfficeIds":{"type":["null","array"],"items":{"type":"integer","format":"int32"},"description":"Ids der zugeordneten Betriebsst\u00E4tten"}},"additionalProperties":false,"description":"Einzelabruf eines Ansprechpartners: alle Felder des ContactReadDto, zus\u00E4tzlich Kunde (Id und Name)."},"ValidationProblemDetails":{"type":"object","properties":{"type":{"type":["null","string"],"description":"URI, die den Fehlertyp beschreibt"},"title":{"type":["null","string"],"description":"Kurzbeschreibung des Fehlers"},"status":{"type":["null","integer"],"description":"HTTP-Statuscode","format":"int32"},"detail":{"type":["null","string"],"description":"Ausf\u00FChrliche Beschreibung des Fehlers"},"instance":{"type":["null","string"],"description":"URI der betroffenen Anfrage"},"traceId":{"type":["null","string"],"description":"Kennung des Aufrufs f\u00FCr die Fehlersuche"},"errors":{"type":["null","object"],"additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Fehlermeldungen je betroffenem Feld"}},"description":"Standardisierte Fehlerantwort nach RFC 9457 (application/problem\u002Bjson), die das Framework bei Binde- und Deserialisierungsfehlern liefert \u2014 etwa bei einem unbekannten Enum-Wert oder einem nicht konvertierbaren Pfadparameter. Fachliche Validierungsfehler liefert die API dagegen als ErrorResponse."},"CurrencyDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation der W\u00E4hrung","format":"int32"},"name":{"type":["null","string"],"description":"Bezeichnung der W\u00E4hrung"},"code":{"type":["null","string"],"description":"ISO-Code der W\u00E4hrung, zum Beispiel EUR"},"symbol":{"type":["null","string"],"description":"Symbol der W\u00E4hrung, zum Beispiel \u20AC"}},"additionalProperties":false,"description":"Eine W\u00E4hrung mit Id, Bezeichnung, ISO-Code und Symbol."},"CurrenciesResponse":{"type":"object","properties":{"currencies":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CurrencyDto"},"description":"Liste der W\u00E4hrungen"}},"additionalProperties":false,"description":"Antwortobjekt mit einer Liste von W\u00E4hrungen (jeweils ID, Bezeichnung, ISO-Code und Symbol)."},"CorporationDto":{"type":"object","properties":{"id":{"type":"integer","description":"Eindeutige Identifikation des Konzerns","format":"int32"},"name":{"type":["null","string"],"description":"Name des Konzerns"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"}},"additionalProperties":false,"description":"Datenobjekt eines Konzerns (Unternehmensgruppe) mit Id, Name und externer Id aus dem Quellsystem."},"CorporationsResponse":{"type":"object","properties":{"corporations":{"type":["null","array"],"items":{"$ref":"#/components/schemas/CorporationDto"},"description":"Liste der aktiven Konzerne des Accounts"},"values":{"type":["null","array"],"items":{"$ref":"#/components/schemas/MasterDataEnumValueDto"},"description":"Derselbe Katalog in der einheitlichen Form aller Katalog-Endpunkte: value enth\u00E4lt den Konzernnamen. Die externe Id steht ausschlie\u00DFlich in corporations[].importExternalId."}},"additionalProperties":false,"description":"Antwortobjekt mit den aktiven Konzernen des Accounts. Zus\u00E4tzlich in der einheitlichen Form values, die alle Katalog-Endpunkte verwenden."},"LocationChangeDto":{"type":"object","properties":{"description":{"type":["null","string"],"description":"Beschreibung (Bezeichnung des Einsatzortes)"},"directions":{"type":["null","string"],"description":"Anfahrtshinweise"},"contactId":{"type":["null","integer"],"description":"Kennung des Ansprechpartners (Id)","format":"int32"},"importExternalId":{"type":["null","string"],"description":"Externe Id des Datensatzes aus dem Quellsystem (Import)"},"createdAtUtc":{"type":["null","string"],"description":"Zeitpunkt der Erstellung (UTC). F\u00FCr Importe, die das Erstelldatum des Quellsystems nachtragen. \u00DCbernommen wird nur der Erstellzeitpunkt; der \u00C4nderungszeitpunkt bleibt der Zeitpunkt dieses Aufrufs.","format":"date-time"},"location":{"description":"Adresse des Einsatzortes. Eine Adress\u00E4nderung berechnet die Koordinaten neu; geoLat und geoLon sind nicht schreibbar. Adresszeilen f\u00FChrt der Einsatzort nicht.","$ref":"#/components/schemas/AddressCreateDto"}},"description":"Neu in V 3.4.0: \u00C4nderungsdaten eines Einsatzortes (Bezeichnung, Anfahrtshinweise, Ansprechpartner, externe Id und Adresse). Nur die \u00FCbermittelten Felder werden ge\u00E4ndert. Das Umh\u00E4ngen auf eine andere Betriebsst\u00E4tte ist nicht m\u00F6glich; die Betriebsst\u00E4tte kommt aus der Route."},"RequestChangeDto":{"type":"object","properties":{"officeId":{"type":["null","integer"],"description":"Kennung der Betriebsst\u00E4tte. Muss zum Kunden der Anfrage geh\u00F6ren.","format":"int32"},"locationId":{"type":["null","integer"],"description":"Kennung des Einsatzortes. Muss zur resultierenden Betriebsst\u00E4tte geh\u00F6ren.","format":"int32"},"contactId":{"type":["null","integer"],"description":"Kennung des Ansprechpartners. Muss zum Kunden geh\u00F6ren und der resultierenden Betriebsst\u00E4tte zugeordnet sein.","format":"int32"}},"description":"\u00C4nderungsdaten einer Anfrage: die drei Beziehungsfelder Betriebsst\u00E4tte, Einsatzort und Ansprechpartner. Nicht mitgeschickte Werte werden aus der Anfrage \u00FCbernommen; validiert wird immer die resultierende Kombination."},"AddressChangeDto":{"type":"object","properties":{"addressLine1":{"type":["null","string"],"description":"Adresszeile 1. Neu in V 3.4.0: Wird alternativ auf oberster Ebene des OfficeChangeDto akzeptiert; kommt der Wert in beiden, gewinnt der aus diesem Objekt."},"addressLine2":{"type":["null","string"],"description":"Adresszeile 2. Neu in V 3.4.0: Wird alternativ auf oberster Ebene des OfficeChangeDto akzeptiert; kommt der Wert in beiden, gewinnt der aus diesem Objekt."},"street":{"type":["null","string"],"description":"Stra\u00DFe, ohne Hausnummer; die geh\u00F6rt nach streetNumber. Neu in V 3.4.0: Wird street ohne streetNumber mitgeschickt und enth\u00E4lt beides (z. B. Musterstra\u00DFe 5a), zerlegt die API selbst: Das letzte durch Leerzeichen getrennte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt; sonst bleibt der Wert unver\u00E4ndert Stra\u00DFe und die gespeicherte Hausnummer bleibt stehen. Kommt streetNumber im selben Request mit, bleibt street unangetastet."},"streetNumber":{"type":["null","string"],"description":"Hausnummer, getrennt von der Stra\u00DFe. Wer sie mitschickt, schaltet die serverseitige Zerlegung von street ab."},"zipCode":{"type":["null","string"],"description":"Postleitzahl"},"city":{"type":["null","string"],"description":"Ort / Stadt"},"federalStateId":{"type":["null","integer"],"description":"Kennung des Bundeslandes (Id). Ein Bundesland geh\u00F6rt zu genau einem Land. Neu in V 3.4.0: Wird countryId auf ein anderes Land ge\u00E4ndert und federalStateId nicht mitgeschickt, leert die API das gespeicherte Bundesland selbst, so wie talent.Flow beim L\u00E4nderwechsel. Wird federalStateId mitgeschickt, gilt der \u00FCbermittelte Wert und muss zum neuen Land geh\u00F6ren, sonst 400 NotMatchCountry. Bleibt countryId unver\u00E4ndert, bleibt auch das Bundesland stehen.","format":"int32"},"federalState":{"type":["null","string"],"description":"Name des Bundeslandes. Wird nicht ausgewertet; das Bundesland wird ausschlie\u00DFlich \u00FCber federalStateId gesetzt."},"countryId":{"type":["null","integer"],"description":"L\u00E4nderkennung (Id). Neu in V 3.4.0: Ein Wechsel auf ein anderes Land leert ein gespeichertes Bundesland, wenn federalStateId nicht mitgeschickt wird.","format":"int32"}},"description":"\u00C4nderungsdaten einer Adresse der Betriebsst\u00E4tte. Anders als AddressCreateDto f\u00FChrt dieses Objekt die beiden Adresszeilen; Geokoordinaten enth\u00E4lt es nicht, sie werden serverseitig berechnet. Nur die \u00FCbermittelten Felder werden ge\u00E4ndert."}},"securitySchemes":{"BearerAuth":{"type":"oauth2","description":"Alle Endpunkte der Public API erfordern ein g\u00FCltiges Zugriffstoken. Das Token wird \u00FCber den OAuth-2.0-Flow \u0060client_credentials\u0060 am Token-Endpunkt \u0060https://id.talent360.io/oauth/token\u0060 bezogen und anschlie\u00DFend als \u0060Authorization: Bearer \u003Ctoken\u003E\u0060 gesendet.\n\nClient-Id und Client-Secret werden je Mandant von talent360 bereitgestellt und am Token-Endpunkt per HTTP-Basic-Authentifizierung \u00FCbergeben.\n\n**Wichtig:** Die Token-Anfrage ben\u00F6tigt zus\u00E4tzlich den Parameter \u0060audience\u0060 mit dem Wert \u0060https://api.talent360.io/api/v3\u0060. Dieser Parameter ist eine Besonderheit des Identity-Providers und l\u00E4sst sich in OpenAPI nicht abbilden \u2014 er muss vom Aufrufer selbst mitgeschickt werden, sonst wird ein Token ohne Berechtigung f\u00FCr diese API ausgestellt.\n\nEs sind keine Scopes definiert; die Berechtigungen ergeben sich aus dem Mandanten der Zugangsdaten. Ein fehlendes oder ung\u00FCltiges Token beantwortet die API mit \u0060401\u0060.","flows":{"clientCredentials":{"tokenUrl":"https://id.talent360.io/oauth/token","scopes":{}}}}}},"tags":[{"name":"Bewerber\u00FCbersichten","description":"Listen und \u00C4nderungsstr\u00F6me \u00FCber den gesamten Bewerberbestand. Hier beginnt jede Anbindung: einmalig der Vollabzug \u00FCber die Export-Endpunkte, danach ausschlie\u00DFlich Deltas \u00FCber die \u00C4nderungsendpunkte. Enth\u00E4lt au\u00DFerdem die Dublettenpr\u00FCfung per E-Mail-Adresse.\n\nDie \u00C4nderungsantwort ist bereits nach \u0060new\u0060, \u0060modified\u0060 und \u0060deleted\u0060 getrennt. Die \u0060deleted\u0060-Liste ist der **einzige** Weg, von gel\u00F6schten Bewerbern zu erfahren \u2014 es gibt keinen L\u00F6schendpunkt f\u00FCr Bewerber.\n\nBeachten Sie: Diese Endpunkte kennen kein Paging. Grenzen Sie gro\u00DFe Abfragen \u00FCber Zeitr\u00E4ume ein."},{"name":"Bewerberdetails","description":"Alles, was an einem einzelnen Bewerber h\u00E4ngt: Stammdaten anlegen und \u00E4ndern, Kontaktwege, Profil, Werdegang, Status und Arbeitsvertrag.\n\nZwei Dinge, die man kennen sollte:\n\n- \u0060PUT /candidates/{candidateId}\u0060 ist ein **Teil-Update** \u2014 es werden nur die \u00FCbermittelten Felder ge\u00E4ndert. Sie m\u00FCssen den Datensatz nicht vollst\u00E4ndig zur\u00FCckschicken.\n- Die vier \u0060DELETE\u0060-Endpunkte dieses Bereichs (F\u00FChrerschein, Sprache, Beruf, Qualifikation) sind die **einzigen L\u00F6schendpunkte der gesamten API**.\n\nEin \u00FCber \u0060POST /candidates\u0060 angelegter Bewerber wird in talent.Flow erst sichtbar, wenn zu ihm mindestens eine Bewerbung existiert."},{"name":"Bewerberdokumente","description":"Lebenslauf, Zeugnisse und sonstige Unterlagen eines Bewerbers hochladen und abrufen.\n\nDokumente haben einen **eigenen \u00C4nderungsstrom**. Ein Bewerber kann unver\u00E4ndert bleiben, w\u00E4hrend ein Dokument dazukommt \u2014 wer nur den Bewerberstrom abfragt, verpasst neue Lebensl\u00E4ufe und Zeugnisse. Fragen Sie beide Str\u00F6me ab, wenn Sie Dokumente spiegeln."},{"name":"Bewerberkommunikation","description":"Kommunikationseintr\u00E4ge zu einem Bewerber anlegen und mit Anh\u00E4ngen versehen.\n\nGedacht f\u00FCr Systeme, die eigene Korrespondenz f\u00FChren \u2014 etwa ein Mailsystem oder ein Messenger \u2014 und diese in talent.Flow sichtbar machen wollen, damit die Historie am Bewerber vollst\u00E4ndig bleibt."},{"name":"Candidates","description":"Kurzprofil eines Bewerbers, seine Status- und Kontakthistorie sowie das Anlegen einer Bewerbung.\n\nDie Historien-Endpunkte beantworten \u201Ewie war der Stand am Stichtag\u0022 statt \u201Ewie ist der Stand jetzt\u0022 \u2014 n\u00FCtzlich f\u00FCr Auswertungen und Nachvollziehbarkeit. F\u00FCr den aktuellen Stand nutzen Sie die Endpunkte unter **Bewerberdetails**."},{"name":"Bewerbungen","description":"\u00DCbertragung einer Bewerbung auf eine Stellenanzeige aus einem Fremdsystem \u2014 etwa einer eigenen Karriereseite oder einem Jobportal.\n\nWichtig f\u00FCr jede Anbindung, die Bewerber anlegt: **Ein Bewerber ohne mindestens eine Bewerbung wird in talent.Flow nicht angezeigt.** Legen Sie deshalb Bewerber und Bewerbung im selben Vorgang an."},{"name":"Firmendetails","description":"Firmen anlegen, \u00E4ndern und lesen \u2014 samt Kunden- und Vertragsstatus.\n\n\u0060GET /customers/{id}\u0060 liefert die Firma **vollst\u00E4ndig verschachtelt**: Betriebsst\u00E4tten, deren Einsatzorte und die Ansprechpartner in einem einzigen Aufruf. Sie m\u00FCssen die Unterobjekte nicht einzeln nachladen.\n\nDas Feld \u0060importExternalId\u0060 nimmt die Id Ihres Quellsystems auf \u2014 beim Anlegen schreibbar, beim Lesen sichtbar. Damit brauchen Sie keine eigene Zuordnungstabelle und kein Matching \u00FCber den Firmennamen.\n\nL\u00F6schen ist im Firmenbereich nicht vorgesehen; der Weg f\u00FChrt \u00FCber den Statuswechsel."},{"name":"Firmen\u00FCbersichten","description":"\u00C4nderungsstr\u00F6me \u00FCber den Firmenbestand \u2014 nach Zeitraum, pro Tag oder pro Stunde.\n\nF\u00FCr den laufenden Abgleich sind Webhooks der bessere Weg: sie melden fr\u00FCher und mit weniger Aufrufen. Diese Endpunkte sind f\u00FCr den Erstabgleich gedacht und f\u00FCr die Wiederherstellung nach einer St\u00F6rung."},{"name":"Einsatzorte","description":"Einsatzorte lesen und anlegen.\n\nEin Einsatzort h\u00E4ngt immer an einer Betriebsst\u00E4tte. Die Reihenfolge beim Anlegen ist damit vorgegeben: erst Firma, dann Betriebsst\u00E4tte, dann Einsatzort.\n\nEinen \u00C4nderungsendpunkt gibt es nicht \u2014 eine Korrektur bedeutet in der Praxis, einen neuen Einsatzort anzulegen und den alten fachlich au\u00DFer Betrieb zu nehmen."},{"name":"Firmenkontakte","description":"Ansprechpartner einer Firma lesen, anlegen und \u00E4ndern.\n\nBeim Lesen der Firma sind die Kontakte bereits enthalten. Die Einzelabrufe hier brauchen Sie vor allem f\u00FCr gezielte Nachladungen, etwa nachdem ein Webhook einen neu hinzugef\u00FCgten Ansprechpartner gemeldet hat."},{"name":"Anfragendetails","description":"Anfragen anlegen, lesen und im Status weiterschalten.\n\nJede Anfrageart hat einen eigenen Anlage-Endpunkt mit eigenem Datenmodell: **Arbeitnehmer\u00FCberlassung**, **Direktvermittlung** und **Dienstleistungsvertrag**. Der Statuswechsel ist f\u00FCr alle drei derselbe Endpunkt."},{"name":"Anfragenauswertungen","description":"Kennzahlen zu Anfragen \u00FCber einen Zeitraum.\n\nErg\u00E4nzt die Stellenanzeigenauswertungen um die Vertriebsseite: nicht \u201Ewie liefen die Anzeigen\u0022, sondern \u201Ewie entwickelten sich die Anfragen der Kunden\u0022."},{"name":"Stellenanzeigenauswertungen","description":"Kennzahlen zu Anzeigen und Kampagnen \u2014 je Tag und je Kanal aufgeschl\u00FCsselt.\n\nZwei Statistikarten, die sich in genau einer Kennzahl unterscheiden: die **organische** Statistik f\u00FChrt Klicks und Bewerbungen, die **Performance**-Statistik zus\u00E4tzlich die Kosten.\n\nDer ergiebigste Einstieg ist \u0060GET /reports/performance/jobs\u0060 \u2014 der Monatsbericht \u00FCber alle Anzeigen. Er liefert trotz des Namens tagesgenaue Zeilen und enth\u00E4lt zus\u00E4tzlich Kampagnennamen und Schlagworte.\n\nAchtung beim Auswerten: Die Statistik-Endpunkte antworten mit einem Umschlag (Nutzdaten unter \u0060data\u0060), der Monatsbericht dagegen mit einem nackten Array."},{"name":"Stellenanzeigen\u00FCbersichten","description":"Stellenanzeigen auflisten und \u00C4nderungen im Zeitraum abrufen.\n\nLiefert die Stammdaten zu den Kennzahlen aus den **Stellenanzeigenauswertungen** \u2014 Titel, Laufzeit und Zuordnung, die eine reine Kennzahlenzeile nicht enth\u00E4lt."},{"name":"Stellenanzeigendetails","description":"Eine einzelne Stellenanzeige mit allen Feldern.\n\nNutzen Sie diesen Endpunkt, wenn Sie aus einer \u00DCbersicht oder einer Kennzahlenzeile heraus die vollst\u00E4ndigen Angaben zu einer Anzeige brauchen."},{"name":"talent.Flow Stammdaten","description":"Wertelisten, die in anderen Endpunkten als Id referenziert werden: Anreden, L\u00E4nder, Bundesl\u00E4nder, Sprachen, Nationalit\u00E4ten, Familienst\u00E4nde, Arbeitszeitmodelle, Mobilit\u00E4ts- und Behinderungsarten, Bonusarten, Zeiteinheiten und Bezugsquellen.\n\nDiese Listen \u00E4ndern sich selten. **Cachen Sie sie**, statt sie bei jedem Vorgang abzurufen \u2014 ein t\u00E4glicher Abgleich gen\u00FCgt.\n\nEin lesender Stammdaten-Endpunkt eignet sich au\u00DFerdem gut als Smoke-Test f\u00FCr eine frisch eingerichtete Anbindung, weil er keine Daten ver\u00E4ndert."},{"name":"Benutzer","description":"Die Benutzer des Mandanten und ihre Zust\u00E4ndigkeiten.\n\nGebraucht \u00FCberall dort, wo ein Datensatz einer verantwortlichen Person zugeordnet werden soll \u2014 etwa beim Anlegen einer Firma oder eines Bewerbers \u00FCber das Feld \u0060responsibility\u0060."},{"name":"Niederlassungen","description":"Die Niederlassungen des Mandanten.\n\nIhre Ids dienen in mehreren \u00C4nderungsendpunkten als Filter (\u0060officeId\u0060) \u2014 etwa um den Bewerberabgleich auf eine einzelne Niederlassung einzugrenzen.\n\nNicht zu verwechseln mit den **Betriebsst\u00E4tten**: Niederlassungen geh\u00F6ren zu Ihnen, Betriebsst\u00E4tten zu Ihren Kundenfirmen."},{"name":"Webhooks","description":"Registrierung und Verwaltung von Webhooks: verf\u00FCgbare Ereignistypen lesen, Endpunkte an- und abmelden, das Datenformat setzen und das Zustellprotokoll abrufen.\n\n**Ein Webhook liefert keine Nutzdaten**, sondern eine Referenz auf den Datensatz \u2014 \u0060entityId\u0060 samt Abruf-Endpunkt. Den eigentlichen Abruf macht Ihr System selbst.\n\nZwei Dinge sind f\u00FCr den Betrieb entscheidend:\n\n- Antworten Sie sofort mit \u0060200\u0060. Nach **10** fehlgeschlagenen Zustellungen wird die Registrierung pausiert.\n- Auch dann gehen keine Ereignisse verloren: sie werden weiter protokolliert und lassen sich \u00FCber den Protokoll-Endpunkt nachtr\u00E4glich abrufen.\n\nWie das im Zusammenspiel aussieht, zeigt der [Integrationsguide](/integrationsguide-einstieg)."},{"name":"Bewerber","description":"Alles rund um Bewerber \u2014 Bestandsabgleich, Stammdaten, Dokumente und Kommunikation.\n\nF\u00FCr eine neue Anbindung ist die Reihenfolge meist dieselbe: **Bewerber\u00FCbersichten** f\u00FCr den Abgleich, **Bewerberdetails** f\u00FCr die laufende Pflege, **Bewerberdokumente** f\u00FCr Unterlagen."},{"name":"Firmen","description":"Kundenfirmen mit ihren Betriebsst\u00E4tten, Einsatzorten und Ansprechpartnern.\n\nZum **Lesen** gen\u00FCgt ein einziger Aufruf: \u0060GET /customers/{id}\u0060 liefert den ganzen Baum verschachtelt. Die Unterbereiche brauchen Sie zum Anlegen und \u00C4ndern \u2014 und f\u00FCr gezielte Nachladungen nach einem Webhook-Ereignis.\n\nBeim Anlegen ist die Reihenfolge vorgegeben: erst Firma, dann Betriebsst\u00E4tte, dann Einsatzort."},{"name":"Anfragen","description":"Kundenanfragen \u2014 von der Anlage \u00FCber den Statusverlauf bis zur Auswertung.\n\nDrei Anfragearten mit je eigenem Anlage-Endpunkt und eigenem Datenmodell: **Arbeitnehmer\u00FCberlassung**, **Direktvermittlung** und **Dienstleistungsvertrag**."},{"name":"Stellenanzeigen","description":"Stellenanzeigen und ihre Kennzahlen.\n\nDie **\u00DCbersichten** und **Details** liefern die Stammdaten einer Anzeige, die **Auswertungen** die Leistungsdaten: Klicks, Bewerbungen und \u2014 in der Performance-Variante \u2014 Kosten, je Tag und Kanal.\n\nF\u00FCr Excel und BI-Werkzeuge ist der Monatsbericht unter den Auswertungen der richtige Einstieg."},{"name":"Stammdaten","description":"Organisatorische Grunddaten Ihres Mandanten: **Benutzer** und ihre Zust\u00E4ndigkeiten sowie die **Niederlassungen**.\n\nDie fachlichen Wertelisten \u2014 Anreden, L\u00E4nder, Sprachen, Nationalit\u00E4ten und weitere \u2014 stehen separat unter **talent.Flow Stammdaten**."},{"name":"Betriebsst\u00E4tten","description":"Betriebsst\u00E4tten einer Firma lesen, anlegen und \u00E4ndern.\n\nJede Betriebsst\u00E4tte tr\u00E4gt eigene Kontaktdaten, Kostenstelle und USt-IdNr. sowie eine eigene \u0060importExternalId\u0060 f\u00FCr die Zuordnung zu Ihrem System. Die zugeordneten Einsatzorte h\u00E4ngen darunter und kommen beim Lesen der Firma bereits mit."},{"name":"Beriebsst\u00E4tten"}],"x-routebase-folders":[{"name":"Anfragen","children":[{"name":"Anfragendetails","children":[]},{"name":"Anfragenauswertungen","children":[]}]},{"name":"Bewerber","children":[{"name":"Bewerber\u00FCbersichten","children":[]},{"name":"Bewerberdetails","children":[]},{"name":"Bewerberdokumente","children":[]},{"name":"Bewerberkommunikation","children":[]}]},{"name":"Bewerbungen","children":[]},{"name":"Firmen","children":[{"name":"Firmen\u00FCbersichten","children":[]},{"name":"Firmendetails","children":[]},{"name":"Betriebsst\u00E4tten","children":[]},{"name":"Einsatzorte","children":[]},{"name":"Firmenkontakte","children":[]}]},{"name":"Stellenanzeigen","children":[{"name":"Stellenanzeigen\u00FCbersichten","children":[]},{"name":"Stellenanzeigendetails","children":[]},{"name":"Stellenanzeigenauswertungen","children":[]}]},{"name":"Stammdaten","children":[{"name":"Benutzer","children":[]},{"name":"Niederlassungen","children":[]}]},{"name":"talent.Flow Stammdaten","children":[]},{"name":"Webhooks","children":[]}]}