Leistungsnachweis

---

1. Überblick

Folgende Modelle sind am Leistungsnachweis beteiligt:

• Mandant
• Patient
• Kostengruppe
• AbrConfig
• IstLeistung
• Leistung, LeistungData
• PatientLeistung

In dieser Kurzanleitung werden nur die wichtigsten Felder beschrieben, die Leistungsnachweis relevant sind.

Wichtig: Leistungsnachweise sind nur für die vergangenen 2 und die kommenden 5 Tage in der API verfügbar.

IstLeistungen sind nach einem Monat nicht mehr verfügbar.

---

2. Modell Mandant

Siehe Kapitel Allgemeines

---

3. Modelle Patient und Kostengruppe

Diese zwei Modelle sind die jeweiligen Stammdaten. Weitere Details können der OpenAPI-Dokumentation entnommen werden.

Request URLs

GET /web/v3/rest/Patient
GET /web/v3/rest/Kostengruppe

---

4. Modell AbrConfig

Das Modell AbrConfig enthält die Besuche, die für eine Leistung auf dem Leistungsnachweis wichtig sind.

Eine Leistung mit ihrer Anzahl auf dem Leistungsnachweis ist einem Besuch zugeordnet. Die Besuche sind in CuraSoft individuell einstellbar und können sich zu einem bestimmten Datum ändern.

AbrConfig ist somit ein Historien-Datensatz.
Das bedeutet, dass jeder Datensatz ein Datum besitzt und passend zu einem bestimmten Datum geladen werden muss.

Das Feld besuche ist ein JSON-Array als String (escaped). Das Feld datum gibt an, welche Historie aktuell gilt. Je datum in einem Leistungsnachweis muss der passende AbrConfig-Datensatz geladen werden.

Request URL

GET /web/v3/rest/AbrConfig

Felder

Feld	Typ	Beschreibung
mandant_id	int	ID des Mandanten, zu dem dieser Datensatz gehört
datum	date	Datum im Format yyyy-mm-dd
besuche	string	Alle Besuche aus CuraSoft als JSON (escaped)

Beispiel für das richtige Auffinden eines AbrConfig-Datensatzes

Folgende AbrConfig-Datensätze sind vorhanden:

id: 1
mandant_id: 250
datum: 2024-10-01

id: 2
mandant_id: 250
datum: 2025-01-01

id: 3
mandant_id: 250
datum: 2025-04-01

id: 4
mandant_id: 251
datum: 2025-01-01

Folgender Leistungsnachweis ist vorhanden:

mandant_id: 250
datum: 2025-02-16

Der richtige AbrConfig-Datensatz ist hier der Datensatz mit ID 2,
da die mandant_id identisch ist und das aktuell gültige Historien-Datum zum Leistungsnachweis passt.

---

5. Modell IstLeistung

Die IstLeistung ist die tatsächlich geleistete Anzahl einer Leistung von einem Mitarbeiter bei einem Patienten. Für die Leistungsdaten selbst (Name etc.) siehe Model LeistungData.

Felder

Feld	Typ	Beschreibung
mandant_id	int	mandant_id aus dem Patienten-Datensatz
edited	bool	true wenn der Datensatz bearbeitet wurde
deleted	bool	true wenn Datensatz gelöscht
patient_id	int	id aus dem Patienten-Datensatz welcher diese Leistung bekommen hat
datum	string	Tag an welchem die Leistung geleistet wurde im Format yyyy-dd-mm
besuch	int	Nr. des Besuchs (siehe Modell AbrConfig)
leistung_id	int	id des Leistung-Datensatzes (alle verfügbaren Leistungen mit der entsprechenden leistung_id können mit dem Modell LeistungData historiell gelistet werden)
kostengruppe_id	int	id des Kostengruppe-Datensatzes
anzahl	int	Anzahl der geleisteten Leistung, je nach Typ stundenbasiert oder nicht
mitarbeiter_id	int	id aus dem Mitarbeiter-Datensatz der diesen Einsatz durchgeführt hat
app_created	string	Datensatz erstellt am (ISO8601-Format)
app_updated	string	Datensatz geändert am (ISO8601-Format)
app_id	int	lokale ID von diesem Datensatz (muss zusammen mit dem token unique sein)
token	string	app_token (wenn vorhanden) oder eindeutiger String (muss zusammen mit app_id unique sein)

---

6. Modell Leistung, LeistungData

Eine Leistung hat n-Leistungsdaten (Historien).

Bei dem Modell LeistungData hat alle Informationen zur Leistung selbst (Name, Stundenbasiert etc.). Da LeistungData ein Historiendatensatz ist gilt das gleiche für das Feld datum wie bei dem Modell AbrConfig.
Der derzeit aktuell gültige Datensatz ist somit der Datensatz mit dem höchsten datum, welcher nicht in der Zukunft liegt.

Die einzelnen Felder können der offiziellen API-Dokumentation entnommen werden.

---

7. Modell PatientLeistung

Das Modell PatientLeistung ist der eigentliche Leistungsnachweis. Repräsentiert wird hier sozusagen eine Anzahl im Leistungsnaweis (eine Zelle).

Felder

Feld	Typ	Beschreibung
mandant_id	int	ID des Mandanten, zu dem dieser Datensatz gehört
datum	date	Tag im Leistungsnachweis im Format yyyy-mm-dd
besuch	int	Besuchsnummer. Siehe AbrConfig
kostengruppe_id	int	ID der zugehörigen Kostengruppe
patient_id	int	ID des Patienten
leistung_id	int	ID der Leistung. Siehe -> Leistung->LeistungData
anzahl	float	Die Anzahl der Leistung. Es können auch Kommawerte vorkommen oder der Wert kann als Minuten interpretiert werden. Siehe Feld dezimal, stundenbasiert in LeistungData.

Zum datum müssen die passenden Historiendatensätze von AbrConfig und LeistungData herangezogen werden um diesen Leistungsnachweis richtig darzustellen.