GET /v1/time-records/draft-summary

Liefert pro Kundenfirma eine Übersicht der Zeitbuchungen, die noch im Status DRAFT stehen: Anzahl, Minuten und geschätzter Betrag, dazu isComplete als Ampel für Firmen ohne offene Entwürfe. Es werden alle Organisationen zurückgegeben, auch die ohne offene Entwürfe — im Modus party_team eingeschränkt auf die Kundenfirmen des Teams.

from/to begrenzen das Buchungsdatum. teamId wird gemäß der Mandanten-Einstellung teamFilterMode aufgelöst — entweder auf die Mitglieder des Teams oder auf dessen Kundenfirmen.

Zwei Mengen sind bewusst nicht enthalten:

• Projektarbeit — Buchungen auf ein Projekt oder auf eine Aufgabe, die zu einem Projekt gehört. Diese Zeit wird im Projekt bei Projektabschluss geprüft, nicht in der Leistungserfassung. Die Übersicht wendet damit dieselbe Regel an wie die Einträge-Tabelle (GET /v1/time_records?excludeProjectWork=true), in die der Klick auf eine Firma springt — sonst würde eine Kachel Stunden ankündigen, die die Liste darunter nicht zeigt.
• Eigenständig abgerechnete Projekte und Tickets — Einheiten mit standaloneBilling.enabled. Sie werden pro Einheit fakturiert und dürfen in einer Sammel-Vorschau pro Kunde nicht doppelt erscheinen.

Beide Kriterien sind unabhängig voneinander und nicht deckungsgleich.

Datenmodell

Diese Operation arbeitet auf der Entität Time Record (time_record). Alle 87 Felder — Typ, Validierung, Pflichtangabe, Beziehungen — stehen in der Schema-Referenz.

Query-Parameter

Beispiel

curl -X GET https://api.codemeta-os.de/v1/time-records/draft-summary \
  -H "X-Tenant-Id: $TENANT" \
  -b cookies.txt

const result = await cm.time-records.list();

Best Practice

Nutzen Sie den Endpunkt als Arbeitsvorrat, nicht als Abrechnungssumme. Die Beträge entstehen über dieselbe Preis-Kaskade wie der Leistungsnachweis, sind aber eine Schätzung auf Basis von Entwürfen — sie ändern sich noch, solange die Buchungen nicht freigegeben sind.

Fragen Sie mit from/to einen konkreten Zeitraum ab statt ohne Grenzen: ohne Datumsfenster wächst die Antwort mit der Historie des Mandanten, und die Kennzahl „letzte Leistung“ ist dann kaum noch aussagekräftig.

Antwortcodes