Anfragendetails

Anfragen per Id

GET /requests/{id}

Liest die Detaildaten einer Anfrage anhand ihrer Id, unabhängig von der Vermittlungsart. Die Anfrage wird direkt adressiert, die Firma muss nicht mit angegeben werden. Angelegt wird eine Anfrage über die drei Endpunkte unter POST /customers/{customerId}/requests/…, umgehängt über PUT /customers/{customerId}/requests/{requestId}, der Status geändert über PUT /customers/{customerId}/requests/{requestId}/status. Eine unbekannte oder gelöschte Id liefert 404.

Neu in V 3.4.0:

• labourLeasingDurationUnit liefert den Anzeigetext zu labourLeasingDurationUnitId (z. B. „Monat"), analog zu workingHoursUnit und serviceContractDurationUnit. Bisher war das Feld immer null.
• keywords und qualifications sind unmittelbar nach dem Anlegen der Anfrage gefüllt, auch für Begriffe, die im System noch nicht als Schlagwort existierten. Bisher blieben beide Listen in diesem Fall dauerhaft leer.

Parameters

Responses

200 — OK — die Anfrage wird direkt als Objekt zurückgegeben, nicht in einer Antworthülle.

404 — Anfrage nicht gefunden

Anfrage für AÜV anlegen

POST /customers/{customerId}/requests/employeeleasing

Mit diesem Endpunkt kann man eine Anfrage für die Arbeitnehmerüberlassung anlegen.

Neu in V 3.4.0:

• Die Zuordnungen shiftIds, driversLicenseIds, qualifications und keywords werden zusammen mit der Anfrage angelegt. Schlägt 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 200 gespeichert.
• Jede Schicht-Id muss ein Wert aus /masterdata/shifts sein, jede Führerschein-Id ein Wert aus /masterdata/driverslicenses. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert 400 mit dem Validierungsfehler NotExisting auf ShiftIds bzw. DriversLicenseIds. Bisher lief eine unbekannte Id in 500 CREATEDATAERROR und hinterließ eine Anfrage ohne Zuordnungen.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma nicht gefunden

Anfrage für Direktvermittlung anlegen

POST /customers/{customerId}/requests/directtransmission

Mit diesem Endpunkt kann man eine Anfrage für eine Direktvermittlung anlegen.

Neu in V 3.4.0:

• Die Zuordnungen shiftIds, driversLicenseIds, qualifications und keywords werden zusammen mit der Anfrage angelegt. Schlägt 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 200 gespeichert.
• Jede Schicht-Id muss ein Wert aus /masterdata/shifts sein, jede Führerschein-Id ein Wert aus /masterdata/driverslicenses. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert 400 mit dem Validierungsfehler NotExisting auf ShiftIds bzw. DriversLicenseIds. Bisher lief eine unbekannte Id in 500 CREATEDATAERROR und hinterließ eine Anfrage ohne Zuordnungen.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma nicht gefunden

Anfrage für Dienstleistungsvertrag anlegen

POST /customers/{customerId}/requests/servicecontract

Mit diesem Endpunkt kann man eine Anfrage für einen Dienstleistungsvertrag anlegen.

Neu in V 3.4.0:

• Die Zuordnungen shiftIds, driversLicenseIds, qualifications und keywords werden zusammen mit der Anfrage angelegt. Schlägt 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 200 gespeichert.
• Jede Schicht-Id muss ein Wert aus /masterdata/shifts sein, jede Führerschein-Id ein Wert aus /masterdata/driverslicenses. Eine unbekannte Id, eine Id aus einer anderen Gruppe oder eine Id kleiner als 1 liefert 400 mit dem Validierungsfehler NotExisting auf ShiftIds bzw. DriversLicenseIds. Bisher lief eine unbekannte Id in 500 CREATEDATAERROR und hinterließ eine Anfrage ohne Zuordnungen.
• Die Vertrags- und Konditionsfelder in request werden gespeichert und validiert: contractDurationId (/masterdata/contractdurations), contractLimitedUntilUtc, contractLimitedFor, contractLimitedForPeriodId, workingTimeModelId, workPlaceId (/masterdata/workplaces), primaryLanguageId, primaryLanguageLevelId, secondaryLanguageId, secondaryLanguageLevelId, companyCarBudget und additionalBenefits. Eine unbekannte Stammdaten-Id liefert 400 mit einem Validierungsfehler auf dem jeweiligen Feld. Bisher wurden diese zwölf Felder still verworfen und blieben in GET /requests/{id} leer.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma nicht gefunden

Anfragestatus ändern

PUT /customers/{customerId}/requests/{requestId}/status

Über diesen Endpunkt kann man den Anfragestatus ändern.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler. Fachliche Prüfungen antworten als ErrorResponse; scheitert dagegen schon das Binden des Requests (z.B. unbekannter Wert für processStatusId), liefert das Framework ValidationProblemDetails mit Content-Type application/problem+json.

404 — Firma oder Anfrage nicht gefunden

Anfrage umhängen (Betriebsstätte, Einsatzort, Ansprechpartner)

PUT /customers/{customerId}/requests/{requestId}

Neu in V 3.4.0: Ändert die drei Beziehungsfelder einer Anfrage: Betriebsstätte, Einsatzort und Ansprechpartner. Der fachliche Inhalt der Anfrage (Tätigkeit, Menge, Vergütung, Listen) und ihr Status sind über diesen Endpunkt nicht änderbar; der Status läuft weiterhin über PUT /customers/{customerId}/requests/{requestId}/status.

Teilweise Angaben werden gegen den Bestand validiert. Nicht mitgeschickte Werte werden aus der Anfrage übernommen, und geprüft wird immer die resultierende Kombination mit derselben Konsistenzkette wie beim Anlegen:

• der Ansprechpartner gehört zum Kunden,
• die Betriebsstätte gehört zum Kunden,
• der Einsatzort gehört zur Betriebsstätte,
• der Ansprechpartner ist der Betriebsstätte zugeordnet.

Wer nur officeId schickt, bekommt 400, wenn der bestehende Einsatzort nicht zur neuen Betriebsstätte gehört. Beim Umhängen deshalb alle drei Ids gemeinsam schicken.

Gehört die Anfrage zu einer anderen Firma oder existiert sie nicht, antwortet der Endpunkt mit 404.

Parameters

Request body

Required.

Die neuen Beziehungsfelder der Anfrage. Nicht mitgeschickte Werte werden aus der Anfrage übernommen.

Content type: application/json

Responses

204 — Anfrage geändert — die API antwortet ohne Inhalt.

400 — Ungültige Anfrage oder Validierungsfehler — insbesondere eine inkonsistente Kombination aus Betriebsstätte, Einsatzort und Ansprechpartner. Die Validierungsfehler sind dieselben wie beim Anlegen der Anfrage.

404 — Firma oder Anfrage nicht gefunden — auch dann, wenn die Anfrage zu einer anderen Firma gehört.

Anfrage löschen

DELETE /customers/{customerId}/requests/{requestId}

Neu in V 3.4.0: Löscht eine Anfrage der Firma, etwa um Löschungen aus einem Fremdsystem zu spiegeln oder Testdaten zu entfernen.

Gelöscht wird als Soft-Delete, genau wie in talent.Flow: Die Anfrage wird deaktiviert und liefert unter GET /requests/{id} anschließend 404. Bewerbervorstellungen, Schlagwörter, Schichten und Führerscheine der Anfrage bleiben als Historie erhalten. Wer eine Anfrage fachlich beenden statt löschen will, nutzt weiterhin PUT /customers/{customerId}/requests/{requestId}/status.

Eine Anfrage, die nicht zu dieser Firma gehört oder bereits gelöscht ist, ergibt 404.

Parameters

Responses

204 — Anfrage gelöscht — die API antwortet ohne Inhalt.

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma oder Anfrage nicht gefunden — auch dann, wenn die Anfrage nicht zu dieser Firma gehört oder bereits gelöscht ist.