ÜbersichtZuweisungen & Mitarbeitende

Zuweisungen & Mitarbeitende

Besetzung und Personen-Referenzen abrufen

Zuweisungen & Mitarbeitende

Ein Assignment beschreibt den aktuellen Besetzungsstatus einer konkreten Schicht. Die API liefert die für Ihr System freigegebenen Status- und Referenzdaten.

Zuweisungen auflisten

GET /staffing-orders/{order_id}/assignments

Response (200):

{
  "items": [
    {
      "assignment_id": "jr_assignment_456",
      "external_shift_id": "PARTNER-SHIFT-987",
      "worker_reference": "jr_wref_789",
      "display_name": "Max M.",
      "status": "confirmed",
      "role": "Service",
      "date": "2026-07-10",
      "start_time": "17:00",
      "end_time": "23:00"
    }
  ]
}

Assignment-Status

StatusBeschreibung
confirmedBestätigt
cancelledZuweisung wurde aufgehoben
completedEinsatz abgeschlossen
no_showNicht erschienen

Datenschutz: Personen-Referenzen

Die API verwendet bewusst pseudonyme Referenzen anstelle vollständiger Personenprofile.

Standard-Verhalten

  • worker_reference: Pseudonyme, partner-spezifische Referenz auf die Person
  • display_name: Reduzierter Name (Max M.)

Erweiterte Personendaten

Vollständige Kontaktdaten (Name, Telefon, E-Mail) werden nur auf explizite Vereinbarung freigegeben. Die Freigabe hängt ab von:

  • Dem definierten Integration-Scope
  • Der Rechtsgrundlage (DPA, DSGVO/FADP)
  • Dem konkreten Use-Case

Sprechen Sie mit uns, welche Felder für Ihren Anwendungsfall erforderlich sind.

Assignment-Objekt

FeldBeschreibung
assignment_idjob.rocks Referenz für diese Zuweisung
external_shift_idIhre Schicht-ID (Referenz)
worker_referencePseudonyme Referenz auf die Person
display_nameReduzierter Anzeigename
statusZuweisungsstatus (siehe oben)
roleRolle/Funktion
dateEinsatzdatum
start_time / end_timeGeplante Zeiten

Hinweis: Read-only in v0.1

In der aktuellen Version sind Zuweisungen read-only. Schreiboperationen werden erst nach Klärung des führenden Systems hinzugefügt.