Firmenkontakte

Kontakt lesen

GET /customers/contacts/{contactId}

Liest einen Ansprechpartner anhand seiner Id. Die Firma muss nicht mit angegeben werden.

Die Antwort enthält alle Stamm- und Kontaktdaten des Ansprechpartners, seine Zuständigkeit und die Ids der zugeordneten Betriebsstätten, dazu Id und Name der Firma.

Zum Ändern eines Ansprechpartners dient PUT /customers/{customerId}/contacts/{contactId}, zum Anlegen POST /customers/{customerId}/contacts.

Neu in V 3.4.0:

• linkedInUrl und xingUrl werden vollständig mit Host geliefert (https://www.linkedin.com/…, https://www.xing.com/…), ohne Wert null. Dasselbe Format gilt jetzt auch in contacts[] der Firmen- und Betriebsstättendetails.
• 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 — der Ansprechpartner mit allen Stamm- und Kontaktdaten sowie der zugehörigen Firma.

404 — Ansprechpartner nicht gefunden

Kontakt anlegen

POST /customers/{customerId}/contacts

Mit diesem Endpunkt kann man einen Kontakt anlegen.

Um diesen neuen Kontakt direkt mit Betriebsstätten des Kunden zu verknüpfen können entsprechende Id's per assignedOfficeIds übergeben werden.

Neu in V 3.4.0:

• linkedInUrl und xingUrl werden normalisiert. Akzeptiert wird die vollständige URL, ein Host ohne Schema (www.linkedin.com/in/…) oder nur der Profilpfad (in/…, profile/…). Gespeichert wird immer der Pfad, gelesen wird die vollständige URL. Ein Host, der nicht auf linkedin.com bzw. xing.com endet, liefert 400 mit errorType InvalidUrl.

Parameters

Request body

Content type: application/json

Responses

200 — OK

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma nicht gefunden

Kontakt ändern

PUT /customers/{customerId}/contacts/{contactId}

Ändert die Daten eines Ansprechpartners. Es werden ausschließlich die im Request-Body übermittelten Felder geändert; nicht übermittelte Felder bleiben unverändert.

Betriebsstätten-Zuordnung über assignedOfficeIds. Das Feld ersetzt die Zuordnung vollständig: Um einen Kontakt einer weiteren Betriebsstätte zuzuordnen, müssen alle gewünschten Betriebsstätten-Ids gemeinsam übergeben werden. Ein weggelassenes Feld lässt die Zuordnungen unverändert, eine leere Liste ([]) entfernt alle Zuordnungen.

Neu in V 3.4.0:

• assignedOfficeIds: null wird ignoriert und wirkt wie ein weggelassenes Feld: Die Zuordnungen bleiben, die Antwort ist 204. Bisher führte null zu einem 500. Wer alle Zuordnungen entfernen will, schickt ausdrücklich [].
• responsibility (userId, officeId) wird ausgewertet und geändert. Bisher wurde das Objekt stillschweigend verworfen.
• createdAtUtc wird auch beim Ändern übernommen, gedacht für Importe, die das Erstelldatum des Quellsystems nachtragen. Der Änderungszeitpunkt bleibt der Zeitpunkt des Aufrufs.
• linkedInUrl und xingUrl akzeptieren die vollständige URL, einen Host ohne Schema (www.xing.com/profile/…) oder nur den Profilpfad (in/…, profile/…). Gespeichert wird immer der Pfad, gelesen wird die vollständige URL. Ein Host, der nicht auf linkedin.com bzw. xing.com endet, liefert 400 mit errorType InvalidUrl. Bisher wurde ein bloßer Pfad mit 400 abgelehnt.

Parameters

Request body

Required.

Zu ändernde Kontaktdaten. Nur die übermittelten Felder werden geändert. Für die Zuordnung zu Betriebsstätten müssen alle gewünschten Ids per assignedOfficeIds übergeben werden.

Content type: application/json

Responses

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

400 — Ungültige Anfrage oder Validierungsfehler

404 — Firma oder Ansprechpartner nicht gefunden

Kontakt löschen

DELETE /customers/{customerId}/contacts/{contactId}

Neu in V 3.4.0: Löscht einen Ansprechpartner der Firma. Bisher ließ sich ein Kontakt nur über PUT … assignedOfficeIds: [] von seinen Betriebsstätten lösen, aber nicht entfernen.

Gelöscht wird als Soft-Delete, genau wie in talent.Flow: Der Ansprechpartner wird deaktiviert und erscheint nicht mehr in GET /customers/{id}, GET /customers/offices/{officeId} und GET /customers/contacts/{contactId}. Bei den Berufen der Einsatzorte, die diesen Ansprechpartner tragen, wird die Zuordnung gelöst; ein hinterlegtes Bild wird entfernt. Anfragen, die auf den Ansprechpartner verweisen, bleiben unverändert. In der Firmenhistorie entsteht eine Aktivität „Kontakt … gelöscht".

Ein Ansprechpartner, der nicht zu dieser Firma gehört oder bereits gelöscht ist, ergibt 404.

Parameters

Responses

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

400 — Ungültige Anfrage oder Validierungsfehler

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