Potenzial-Check durchführen
curl --request POST \
--url https://ui.clinero.de/api/v1/potential-check \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"patients": [
{
"id": "<string>",
"birthday": "2023-12-25",
"insurance_status": "public",
"befund": {
"16": [
"crown"
],
"24": [
"caries",
"vital"
]
},
"appointments": [
{
"date": "2023-12-25",
"documentation": "eingehende Untersuchung, ZST o.B.",
"codings": [
{
"code": "01",
"schema_type": "BEMA",
"amount": 1,
"factor": 1,
"tooth": "<string>",
"provider": "<string>"
}
]
}
]
}
]
}
'import requests
url = "https://ui.clinero.de/api/v1/potential-check"
payload = {
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"patients": [
{
"id": "<string>",
"birthday": "2023-12-25",
"insurance_status": "public",
"befund": {
"16": ["crown"],
"24": ["caries", "vital"]
},
"appointments": [
{
"date": "2023-12-25",
"documentation": "eingehende Untersuchung, ZST o.B.",
"codings": [
{
"code": "01",
"schema_type": "BEMA",
"amount": 1,
"factor": 1,
"tooth": "<string>",
"provider": "<string>"
}
]
}
]
}
]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
quarter: {year: 2050, quarter: 2},
bundesland: 'BW',
patients: [
{
id: '<string>',
birthday: '2023-12-25',
insurance_status: 'public',
befund: {'16': ['crown'], '24': ['caries', 'vital']},
appointments: [
{
date: '2023-12-25',
documentation: 'eingehende Untersuchung, ZST o.B.',
codings: [
{
code: '01',
schema_type: 'BEMA',
amount: 1,
factor: 1,
tooth: '<string>',
provider: '<string>'
}
]
}
]
}
]
})
};
fetch('https://ui.clinero.de/api/v1/potential-check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ui.clinero.de/api/v1/potential-check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'quarter' => [
'year' => 2050,
'quarter' => 2
],
'bundesland' => 'BW',
'patients' => [
[
'id' => '<string>',
'birthday' => '2023-12-25',
'insurance_status' => 'public',
'befund' => [
'16' => [
'crown'
],
'24' => [
'caries',
'vital'
]
],
'appointments' => [
[
'date' => '2023-12-25',
'documentation' => 'eingehende Untersuchung, ZST o.B.',
'codings' => [
[
'code' => '01',
'schema_type' => 'BEMA',
'amount' => 1,
'factor' => 1,
'tooth' => '<string>',
'provider' => '<string>'
]
]
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://ui.clinero.de/api/v1/potential-check"
payload := strings.NewReader("{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://ui.clinero.de/api/v1/potential-check")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://ui.clinero.de/api/v1/potential-check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"point_value": 123,
"summary": {
"total_appointments": 123,
"affected_appointments": 123,
"additions": 123,
"removals": 123,
"limitations": 123,
"total_add_points": 123,
"total_add_eur": 123
},
"add_code_stats": [
{
"code": "<string>",
"count": 123,
"points_per_code": 123,
"total_points": 123,
"total_eur": 123
}
],
"rule_impacts": [
{
"action": "add",
"rule_id": "<string>",
"label": "<string>",
"explanation": "<string>",
"count": 123,
"appointments_affected": 123,
"codes": [
"<string>"
]
}
],
"appointments": [
{
"patient_id": "<string>",
"date": "2023-12-25",
"add_codes": [
"<string>"
],
"remove_codes": [
"<string>"
],
"additions": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>",
"tooth": "<string>"
}
],
"removals": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>",
"tooth": "<string>"
}
],
"limitations": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>"
}
]
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Copilot
Potenzial-Check durchführen
Analysiert die übermittelten Patienten- und Termindaten mit der Clinero-Regelprüfung und liefert das Abrechnungspotenzial für das angegebene Quartal. Details zum Datenformat und zur benötigten Behandlungshistorie finden Sie im Leitfaden “Potenzial-Check per API”.
POST
/
api
/
v1
/
potential-check
Potenzial-Check durchführen
curl --request POST \
--url https://ui.clinero.de/api/v1/potential-check \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"patients": [
{
"id": "<string>",
"birthday": "2023-12-25",
"insurance_status": "public",
"befund": {
"16": [
"crown"
],
"24": [
"caries",
"vital"
]
},
"appointments": [
{
"date": "2023-12-25",
"documentation": "eingehende Untersuchung, ZST o.B.",
"codings": [
{
"code": "01",
"schema_type": "BEMA",
"amount": 1,
"factor": 1,
"tooth": "<string>",
"provider": "<string>"
}
]
}
]
}
]
}
'import requests
url = "https://ui.clinero.de/api/v1/potential-check"
payload = {
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"patients": [
{
"id": "<string>",
"birthday": "2023-12-25",
"insurance_status": "public",
"befund": {
"16": ["crown"],
"24": ["caries", "vital"]
},
"appointments": [
{
"date": "2023-12-25",
"documentation": "eingehende Untersuchung, ZST o.B.",
"codings": [
{
"code": "01",
"schema_type": "BEMA",
"amount": 1,
"factor": 1,
"tooth": "<string>",
"provider": "<string>"
}
]
}
]
}
]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
quarter: {year: 2050, quarter: 2},
bundesland: 'BW',
patients: [
{
id: '<string>',
birthday: '2023-12-25',
insurance_status: 'public',
befund: {'16': ['crown'], '24': ['caries', 'vital']},
appointments: [
{
date: '2023-12-25',
documentation: 'eingehende Untersuchung, ZST o.B.',
codings: [
{
code: '01',
schema_type: 'BEMA',
amount: 1,
factor: 1,
tooth: '<string>',
provider: '<string>'
}
]
}
]
}
]
})
};
fetch('https://ui.clinero.de/api/v1/potential-check', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://ui.clinero.de/api/v1/potential-check",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'quarter' => [
'year' => 2050,
'quarter' => 2
],
'bundesland' => 'BW',
'patients' => [
[
'id' => '<string>',
'birthday' => '2023-12-25',
'insurance_status' => 'public',
'befund' => [
'16' => [
'crown'
],
'24' => [
'caries',
'vital'
]
],
'appointments' => [
[
'date' => '2023-12-25',
'documentation' => 'eingehende Untersuchung, ZST o.B.',
'codings' => [
[
'code' => '01',
'schema_type' => 'BEMA',
'amount' => 1,
'factor' => 1,
'tooth' => '<string>',
'provider' => '<string>'
]
]
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://ui.clinero.de/api/v1/potential-check"
payload := strings.NewReader("{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://ui.clinero.de/api/v1/potential-check")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://ui.clinero.de/api/v1/potential-check")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"quarter\": {\n \"year\": 2050,\n \"quarter\": 2\n },\n \"bundesland\": \"BW\",\n \"patients\": [\n {\n \"id\": \"<string>\",\n \"birthday\": \"2023-12-25\",\n \"insurance_status\": \"public\",\n \"befund\": {\n \"16\": [\n \"crown\"\n ],\n \"24\": [\n \"caries\",\n \"vital\"\n ]\n },\n \"appointments\": [\n {\n \"date\": \"2023-12-25\",\n \"documentation\": \"eingehende Untersuchung, ZST o.B.\",\n \"codings\": [\n {\n \"code\": \"01\",\n \"schema_type\": \"BEMA\",\n \"amount\": 1,\n \"factor\": 1,\n \"tooth\": \"<string>\",\n \"provider\": \"<string>\"\n }\n ]\n }\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"quarter": {
"year": 2050,
"quarter": 2
},
"bundesland": "BW",
"point_value": 123,
"summary": {
"total_appointments": 123,
"affected_appointments": 123,
"additions": 123,
"removals": 123,
"limitations": 123,
"total_add_points": 123,
"total_add_eur": 123
},
"add_code_stats": [
{
"code": "<string>",
"count": 123,
"points_per_code": 123,
"total_points": 123,
"total_eur": 123
}
],
"rule_impacts": [
{
"action": "add",
"rule_id": "<string>",
"label": "<string>",
"explanation": "<string>",
"count": 123,
"appointments_affected": 123,
"codes": [
"<string>"
]
}
],
"appointments": [
{
"patient_id": "<string>",
"date": "2023-12-25",
"add_codes": [
"<string>"
],
"remove_codes": [
"<string>"
],
"additions": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>",
"tooth": "<string>"
}
],
"removals": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>",
"tooth": "<string>"
}
],
"limitations": [
{
"code": "<string>",
"label": "<string>",
"explanation": "<string>"
}
]
}
]
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
API-Key aus dem Clinero Entwickler-Bereich.
Body
application/json
Abrechnungsquartal, das analysiert werden soll.
Show child attributes
Show child attributes
KZV-Bereich der Praxis (Bundesland-Kürzel, z. B. "BW"; Nordrhein-Westfalen ist in "NR" und "WL" geteilt). Bestimmt KZV-Zielwerte und Quartalsziele.
Available options:
BW, BY, BE, BB, HB, HH, HE, MV, NDS, NR, WL, RPS, SL, SN, ST, SH, TH Example:
"BW"
Patienten mit Befund und vollständiger Terminhistorie.
Minimum array length:
1Show child attributes
Show child attributes
Response
Successful Response
Analysiertes Abrechnungsquartal.
Show child attributes
Show child attributes
KZV-Bereich der Analyse.
Available options:
BW, BY, BE, BB, HB, HH, HE, MV, NDS, NR, WL, RPS, SL, SN, ST, SH, TH Für die Euro-Umrechnung verwendeter BEMA-Punktwert.
Show child attributes
Show child attributes
Vorgeschlagene Ziffern, aggregiert je Gebührenziffer.
Show child attributes
Show child attributes
Auswirkung je Regel, absteigend nach Häufigkeit.
Show child attributes
Show child attributes
Termine des Zielquartals mit mindestens einem Befund. Termine ohne Vorschläge sind nicht enthalten.
Show child attributes
Show child attributes