- Potenzial: Gebührenziffern, die hätten abgerechnet werden können, aber nicht erfasst wurden — inklusive Punkt- und Euro-Summe.
- Korrekturen: Ziffern, die entfernt werden müssen.
- Begrenzungen: Ziffern, die durch Abrechnungsbestimmungen (z. B. Häufigkeitsregeln) limitiert wurden.
Authentifizierung
Alle Anfragen benötigen einen API-Key im HeaderX-Api-Key:
Wie viel Behandlungshistorie wird benötigt?
Richtwerte:
Das Feld
quarter bestimmt, welches Quartal analysiert wird — die übrige Historie dient
der Regelprüfung als Kontext und erscheint nicht in den Ergebnissen.
Aufbau der Anfrage
Die Anfrage ist ein JSON-Objekt mit dem Zielquartal, dem KZV-Bereich (bundesland) und
einer Liste von Patienten. Jeder Patient bringt seinen Zahnbefund und seine
Terminhistorie mit:
idist Ihre Patienten-ID; sie wird unverändert in den Ergebnissen zurückgegeben und muss innerhalb der Anfrage eindeutig sein.documentationist der Freitext der Behandlungsdokumentation aus dem PVS. Die Regelerkennung wertet diesen Text aus — je vollständiger, desto zuverlässiger das Ergebnis.birthdayist erforderlich, da einige Leistungen altersabhängig sind (z. B. IP und FU).bundeslandverwendet die KZV-Kürzel; Nordrhein-Westfalen ist inNR(Nordrhein) undWL(Westfalen-Lippe) geteilt.
Der Zahnbefund
befund ist für jeden Patienten erforderlich und bildet den Zahnstatus im FDI-Schema ab:
Schlüssel sind die Zahnnummern 18–48, Werte sind Listen von Befund-Tokens. Zähne ohne
Befund können weggelassen werden. Ohne Befund können prothetik- und
erhaltungsbezogene Regeln nicht greifen.
Das Ergebnis lesen
Die Antwort enthält vier Ebenen:summary— die Kernzahlen des Quartals, inklusivetotal_add_pointsundtotal_add_eur(Punkte × Punktwert).add_code_stats— das Potenzial aggregiert je Gebührenziffer.rule_impacts— welche Regeln wie oft ausgelöst haben, mit fachlicher Begründung.appointments— die betroffenen Termine mit den konkreten Vorschlägen (add_codes,remove_codes) je Patient und Datum. Termine ohne Auffälligkeiten sind nicht enthalten.
Grenzen und Datenschutz
- Die Analyse läuft synchron; bei sehr großen Praxen (mehrere zehntausend Termine) kann die Antwort entsprechend dauern.
- Die übermittelten Daten werden ausschließlich zur Berechnung der Antwort verarbeitet und nicht gespeichert.
- Für die Übermittlung von Patientendaten ist ein Auftragsverarbeitungsvertrag (AVV) mit Clinero erforderlich. Wenden Sie sich dazu an support@clinero.de.