Betriebsstätten

Betriebsstätte lesen

GET /customers/offices/{officeId}

Liest die Detaildaten einer Betriebsstätte anhand ihrer Id, einschließlich Adresse, Zuständigkeit, zugeordneter Ansprechpartner und Einsatzorte. Die Betriebsstätte wird direkt adressiert, die Firma muss nicht mit angegeben werden. Zum Ändern dient PUT /customers/{customerId}/offices/{officeId}, zum Anlegen POST /customers/{customerId}/offices.

Neu in V 3.4.0:

• contacts[].assignedOfficeIds ist nie mehr null und enthält alle Betriebsstätten-Zuordnungen des Ansprechpartners, nicht nur die der abgefragten Betriebsstätte. Damit liefert das Feld dasselbe wie an GET /customers/{id} und GET /customers/contacts/{contactId}. Bisher war die Liste an diesem Endpunkt immer null.
• contacts[].linkedInUrl und contacts[].xingUrl werden vollständig mit Host geliefert (https://www.linkedin.com/…, https://www.xing.com/…), ohne Wert null. Bisher stand hier nur der gespeicherte Profilpfad.
• Die Einsatzorte in locations[] führen importExternalId und importedAtUtc.
• Eine unbekannte oder gelöschte Id liefert 404 mit ErrorResponse. Bisher antwortete der Endpunkt in diesem Fall mit 204 ohne Inhalt.

Parameters

Responses

200 — OK

404 — Betriebsstätte nicht gefunden

Betriebsstätte anlegen

POST /customers/{customerId}/offices

Mit diesem Endpunkt kann man eine Betriebsstätte anlegen.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma nicht gefunden

Betriebsstätte ändern

PUT /customers/{customerId}/offices/{officeId}

Ändert die Daten einer Betriebsstätte einer Firma: Adresse, Kontaktdaten, Firmentyp, Kostenstelle, USt-IdNr. und Zuständigkeit. Es werden ausschließlich die im Request-Body übermittelten Felder geändert; nicht übermittelte Felder bleiben unverändert (einzige Ausnahme: das Bundesland beim Länderwechsel, siehe unten). Angelegt wird eine Betriebsstätte über POST /customers/{customerId}/offices, gelesen über GET /customers/offices/{officeId}.

Eine Adressänderung berechnet die Koordinaten neu; geoLat/geoLon sind nicht schreibbar.

Neu in V 3.4.0:

• responsibility (userId, officeId) wird ausgewertet und geändert; eine unbekannte Id ergibt 400. Bisher wurde das Objekt stillschweigend verworfen.
• Schlägt die Geokodierung fehl, bleiben vorhandene Koordinaten erhalten, statt auf null zurückzufallen.
• Länderwechsel: Wird location.countryId auf ein anderes Land geändert und location.federalStateId nicht mitgeschickt, leert die API das gespeicherte Bundesland, so wie talent.Flow beim Länderwechsel. Bisher wurde der Aufruf mit 400 abgelehnt. Ein mitgeschicktes federalStateId muss zum neuen Land gehören, sonst 400 NotMatchCountry auf FederalStateId. Bleibt countryId unverändert, bleibt auch das Bundesland stehen.
• addressLine1 und addressLine2 werden sowohl auf oberster Ebene als auch in location akzeptiert. Kommt der Wert in beiden, gewinnt der aus location. Bisher gingen die Adresszeilen auf oberster Ebene beim Ändern verloren.
• Enthält location.street Straße und Hausnummer und fehlt streetNumber, zerlegt die API den Wert selbst: Das letzte Wort wird zur Hausnummer, wenn es mit einer Ziffer beginnt.
• createdAtUtc wird auch beim Ändern übernommen, gedacht für Importe, die das Erstelldatum des Quellsystems nachtragen. Der Änderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.

Parameters

Request body

Required.

Zu ändernde Daten der Betriebsstätte. Nur die übermittelten Felder werden geändert.

Content type: application/json

Responses

204 — Betriebsstätte geändert — die API antwortet ohne Inhalt.

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma oder Betriebsstätte nicht gefunden

Betriebsstätte löschen

DELETE /customers/{customerId}/offices/{officeId}

Neu in V 3.4.0: Löscht eine Betriebsstätte 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 Betriebsstätte wird deaktiviert und erscheint nicht mehr in GET /customers/{id}; GET /customers/offices/{officeId} liefert anschließend 404. Einsatzorte, Ansprechpartner-Zuordnungen und Anfragen dieser Betriebsstätte bleiben unverändert bestehen. Wer sie ebenfalls entfernen will, löscht sie vorher über die jeweiligen Endpunkte. In der Firmenhistorie entsteht eine Aktivität „Betriebsstätte … gelöscht".

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

Parameters

Responses

204 — Betriebsstätte gelöscht — die API antwortet ohne Inhalt.

400 — Ungültige Anfrage oder Validierungsfehler

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