ForHosting KIT · Entwickler-Tools

KPI-Abstand zum Ziel: absolut und prozentual berechnen

Der Rechner für den KPI-Zielabstand macht aus zwei Werten eine klare Kennzahl für die Entfernung zwischen dem aktuellen Stand und dem festgelegten Ziel.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Geben Sie den aktuellen KPI und den Zielwert ein, um die absolute Differenz und auf Wunsch deren Anteil am Ziel in Prozent zu erhalten. Die Berechnung eignet sich für Umsatz, Konversion, Service, Produktion, Qualität und andere numerische Kennzahlen, ohne eine bestimmte Einheit oder ein Geschäftsmodell vorauszusetzen.

Lesen Sie den absoluten Abstand in der Einheit des KPI

Der absolute Abstand ist der Betrag der Differenz zwischen aktuellem Wert und Zielwert. Der Rechner zieht einen Wert vom anderen ab und verwendet den Betrag des Ergebnisses, sodass die Ausgabe niemals negativ ist. Liegt der aktuelle monatlich wiederkehrende Umsatz bei 72 und das Ziel bei 90, beträgt der absolute Abstand 18 in derselben Einheit wie die Eingaben. Wurde das Ziel bereits überschritten, zeigt das Ergebnis weiterhin die Entfernung zwischen beiden Werten und bezeichnet sie nicht als Rückstand. Diese Unterscheidung ist wichtig, wenn die Berechnung ein Dashboard speist: Die Zahl misst den Abstand, während der Bericht angeben sollte, ob der Istwert über oder unter dem Ziel liegt. Verwenden Sie für beide Eingaben dieselbe Einheit und Skala. Vergleichen Sie keinen als 0.72 dargestellten Prozentsatz mit einem als 90 dargestellten Ziel und keine Dollar mit Tausenden Dollar. Einheitliche Eingaben machen den Abstand unmittelbar für Prognosen, Kennzahlenkarten, Warnungen und Fortschrittskontrollen nutzbar.

Verstehen Sie die Berechnung des prozentualen Abstands

Wenn die prozentuale Ausgabe aktiviert ist, teilt der Rechner den absoluten Abstand durch den Betrag des Zielwerts und multipliziert das Ergebnis mit 100. Bei den vorherigen Werten ergeben 18 geteilt durch 90 einen Abstand von 20 Prozent. Der Bezug auf das Ziel erleichtert den Vergleich von KPI mit unterschiedlichen Skalen: Ein Abstand von 10 kann gegenüber einem Ziel von 1,000 gering, gegenüber 25 jedoch erheblich sein. Der Nenner verwendet den Betrag des Ziels. Deshalb ergibt auch ein negativer Zielwert einen nicht negativen Prozentsatz, der die relative Entfernung zu seiner Größe beschreibt. Ein Zielwert von null kann nicht als Nenner dienen. Wird dennoch ein Prozentsatz angefordert, gibt der Rechner einen Eingabefehler statt unendlich oder eines irreführenden Ersatzwerts zurück. Wenn bei einem Nullziel nur die absolute Differenz sinnvoll ist, deaktivieren Sie die Prozentangabe. In der Antwort fehlt dieses Feld dann bewusst, während der absolute Abstand normal ausgegeben wird.

Nutzen Sie das Ergebnis einheitlich in Berichtsabläufen

Legen Sie KPI, Messzeitraum, Einheit und Ziel fest, bevor Sie den Abstand berechnen. Ein wöchentlicher Istwert sollte mit einem Wochenziel verglichen werden, und eine Nettorate muss auf beiden Seiten dieselbe Darstellung verwenden. Das Ergebnis ist deterministisch und eignet sich daher für geplante Berichte, den Ersatz von Tabellenkalkulationen, Datenpipelines und automatische Prüfungen. Speichern Sie beide Ausgangswerte gemeinsam mit dem berechneten Ergebnis, damit Prüfer die Rechnung nachvollziehen und spätere Zieländerungen verstehen können. Da die Berechnung einen Betrag liefert, benötigen Sie eine separate Statusregel, wenn die Richtung wichtig ist. Bei einem KPI, bei dem mehr besser ist, vergleichen Sie Ist und Ziel für die Kennzeichnung unter Ziel, erreicht oder übertroffen; bei einem KPI, bei dem weniger besser ist, kehren Sie diese Geschäftsregel um. Deuten Sie den prozentualen Abstand nicht als erforderliches Wachstum, wenn Zinseszinseffekte, Ratenänderungen oder nichtlineare Beziehungen beteiligt sind. Er ist eine direkte relative Differenz zum Ziel und keine Prognose der nötigen Maßnahmen.

Anwendungsfälle

Vertriebsleistung verfolgen

Vergleichen Sie Umsatz, Buchungen oder verkaufte Einheiten mit dem Periodenziel und veröffentlichen Sie eine einheitliche Abstandszahl.

Betriebliche Servicewerte überwachen

Messen Sie, wie weit ein KPI für Antwortzeit, Durchsatz oder Qualität vom vereinbarten Ziel entfernt ist.

Management-Dashboards vereinheitlichen

Berechnen Sie vergleichbare prozentuale Abstände für KPI mit verschiedenen Einheiten und Skalen und behalten Sie die absoluten Differenzen bei.

Häufige Fragen

Wie wird der absolute Abstand berechnet?

Er ist der Betrag von target_value minus current_value und daher stets null oder positiv.

Wie wird der prozentuale Abstand berechnet?

Der absolute Abstand wird durch den Betrag des Zielwerts geteilt und mit 100 multipliziert.

Was geschieht bei einem Zielwert von null?

Wenn Sie den Prozentsatz anfordern, führt ein Nullziel zu einem Eingabefehler, da eine Division durch null nicht definiert ist. Deaktivieren Sie die Prozentangabe, um nur den absoluten Abstand zu berechnen.

Zeigt das Ergebnis, ob die Leistung über oder unter dem Ziel liegt?

Nein. Der Rechner liefert den Betrag des Abstands. Vergleichen Sie Ist- und Zielwert separat, wenn Sie eine Richtung oder Statusangabe benötigen.

Kann ich negative KPI-Werte verwenden?

Ja. Beide Eingaben dürfen negative endliche Zahlen sein. Für den Prozentsatz dient der Betrag des Zielwerts als Nenner.

Was kostet eine Berechnung per API?

Jede API-Anfrage kostet $0.002. Dieselbe deterministische Berechnung steht auch im Browser bereit.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/biz/kpi-target-gap-calc

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/biz/kpi-target-gap-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_value":72,"target_value":90}'

const res = await fetch("https://api.kit.forhosting.com/biz/kpi-target-gap-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current_value": 72,
    "target_value": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/kpi-target-gap-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current_value": 72,
    "target_value": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/kpi-target-gap-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current_value":72,"target_value":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current_value":72,"target_value":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/kpi-target-gap-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "current_value": 72,
  "target_value": 90
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.kpi_target_gap_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →