Auswertungen

Der Bereich Auswertungen liefert aggregierte Umsatz- und Produktivitätskennzahlen der Abrechnungsleistungen deines Unternehmens.

Erforderlicher Scope: reports – für die Gruppierung nach Kunde zusätzlich customers

Die Einrichtung eines API-Zugangs ist im Help Center beschrieben.

Endpoints

Method	Endpoint	Beschreibung
GET	/api/oauth/v2/resource/fee-note-services/turnover	Aggregierter Umsatz, mehrdimensional gruppierbar
GET	/api/oauth/v2/resource/fee-note-services/productivity	Termindauer, Terminanzahl, Umsatz und Umsatz pro Behandler-Stunde

Wichtig – Datengrundlage sind Abrechnungsleistungen, nicht Rechnungen. Die Umsatzzahlen enthalten deshalb keinen Waren-, Produkt- und Gutscheinumsatz und kein Storno. Sie weichen bewusst von den Rechnungsauswertungen in der Offisy-Oberfläche ab. Brauchst du Rechnungsumsatz inklusive Waren, nutze diese Endpunkte nicht, sondern Rechnungen.

Verrechnungsstatus

Erfasst ist nicht verrechnet. Jede Zeile führt einen Verrechnungsstatus (billStatus) – dieselben Begriffe wie im Journaling:

Wert	Bedeutung
open	Offen – noch nicht verrechnet
invoiced	Verrechnet – bereits in einer Honorarnote enthalten
ignore	Ignoriert – als nicht verrechenbar markiert
unknown	Unbekannt

Zeitraum und Gruppierung

• from und until (ISO-Datum) sind auf beiden Endpunkten Pflicht.
• Das ausgewiesene Datum ist das Leistungsdatum. Ist bei einer Abrechnungsleistung keines gesetzt, verwendet die Auswertung stattdessen das Erstelldatum. Die Zeile bleibt damit im angefragten Zeitraum enthalten, rutscht aber in den Bucket, der zum Erstelldatum passt.
• Zeitspannen-Grenzen: max. 366 Tage bei Gruppierung nach Tag oder Woche, max. 732 Tage bei Monat oder Jahr. Überschreitung → 400 validation_error.
• Kalenderwochen folgen ISO 8601: die Woche beginnt am Montag, Woche 1 ist die erste Woche mit einem Donnerstag im neuen Jahr.
• Pro Anfrage ist höchstens ein Zeit-Token in groupBy erlaubt (day, week, month oder year).

Begriffsklärung: Kategorie

Die Dimension „Kategorie" in diesen Auswertungen ist die Kostenstelle der Abrechnungsleistung. Sie ist nicht dasselbe wie:

• die Kategorie der Kalenderleistungen aus GET /services/categories – das ist die Kalenderseite,
• das Leistungsbündel.

Wer nach der UI-Kategorie oder dem Leistungsbündel sucht, bekommt in diesen Auswertungen die falschen Zahlen.

Weitere Einschränkungen

• Abrechnungsleistungen ohne Terminbezug haben keine Dauer und erscheinen als eigene Position. Sie zählen in den Umsatz, aber nicht in die Dauer – wer sie in den Stundensatz einrechnet, bekommt falsche Werte.
• Abrechnungsleistungen ohne Leistungszuordnung (Freitext) erscheinen als Sammelposten „Ohne Leistungszuordnung". Die Gesamtsummen sind vollständig, nur die Aufschlüsselung der Freitext-Namen fehlt.
• Ein OP ist eine gewöhnliche Ressource – es gibt keine eigene OP-Auswertung. Du erkennst OP-Räume am Ressourcennamen.