Écart du KPI à l'objectif : valeur absolue et pourcentage
Le calculateur d'écart de KPI transforme deux valeurs en une mesure claire de la distance entre la performance actuelle et l'objectif fixé.
Lancer gratuitement
Saisissez le KPI actuel et la cible pour obtenir l'écart absolu et, si vous le demandez, cet écart en pourcentage de l'objectif. Il convient aux indicateurs de chiffre d'affaires, de conversion, de service, de production, de qualité et à tout autre indicateur numérique, sans imposer d'unité ni de modèle économique.
Lisez l'écart absolu dans l'unité propre au KPI
L'écart absolu correspond à l'amplitude de la différence entre la valeur actuelle et l'objectif. Le calculateur soustrait une valeur de l'autre et retient le résultat absolu : la sortie n'est donc jamais négative. Si le revenu mensuel récurrent actuel vaut 72 et que l'objectif vaut 90, l'écart absolu est de 18 dans l'unité employée pour les deux entrées. Lorsque la performance dépasse déjà la cible, le résultat indique toujours la distance entre les valeurs plutôt que de la qualifier de retard. Cette nuance compte si le calcul alimente un tableau de bord : le nombre mesure une séparation, tandis que le rapport doit préciser si la valeur actuelle est supérieure ou inférieure à l'objectif. Utilisez la même unité et la même échelle pour les deux entrées. Ne comparez pas un pourcentage écrit 0.72 à une cible écrite 90, ni des dollars à des milliers de dollars. Des données cohérentes rendent l'écart directement exploitable dans les prévisions, alertes et revues de progression.
Comprenez le calcul de l'écart en pourcentage
Lorsque la sortie en pourcentage est activée, le calculateur divise l'écart absolu par la valeur absolue de l'objectif, puis multiplie le résultat par 100. Avec les valeurs précédentes, 18 divisé par 90 donne un écart de 20 pour cent. Prendre la cible comme référence facilite la comparaison de KPI d'échelles différentes : un écart de 10 peut être faible face à un objectif de 1,000, mais important face à 25. Le dénominateur utilise l'amplitude de l'objectif ; une cible négative produit donc également un pourcentage non négatif représentant la distance relative à sa taille. Une cible nulle ne peut pas servir de dénominateur. Demander un pourcentage avec un objectif nul renvoie donc une erreur de saisie, plutôt qu'une valeur infinie ou trompeuse. Si seul l'écart absolu est utile pour un KPI dont la cible vaut zéro, désactivez le pourcentage. La réponse omettra alors ce champ et fournira normalement l'écart absolu.
Employez le résultat de façon cohérente dans vos rapports
Définissez le KPI, la période de mesure, l'unité et l'objectif avant de calculer l'écart. Une valeur hebdomadaire doit être comparée à une cible hebdomadaire, et un taux net doit conserver la même représentation des deux côtés. Le résultat est déterministe, ce qui le rend adapté aux rapports planifiés, aux remplacements de feuilles de calcul, aux pipelines de données et aux contrôles automatisés. Conservez les deux valeurs sources avec le résultat afin que les personnes chargées de la vérification puissent reproduire le calcul et comprendre les modifications ultérieures de la cible. Comme cette opération mesure une amplitude, ajoutez une règle d'état distincte lorsque le sens est important. Pour un KPI où une valeur élevée est préférable, comparez la valeur actuelle à la cible afin d'indiquer si elle est inférieure, atteinte ou dépassée ; inversez cette règle si une valeur faible est préférable. N'interprétez pas l'écart relatif comme la croissance nécessaire en présence de capitalisation, de variations de taux ou de relations non linéaires. Il s'agit d'un instantané relatif, pas d'une prévision des actions à entreprendre.
Cas d’usage
Suivre la performance commerciale
Comparez le chiffre d'affaires, les réservations ou les unités vendues à l'objectif de la période et publiez une mesure cohérente.
Surveiller les niveaux de service
Mesurez la distance qui sépare un KPI de délai, de débit ou de qualité de son objectif convenu.
Uniformiser les tableaux de direction
Calculez des écarts relatifs comparables pour des KPI d'unités et d'échelles différentes tout en conservant chaque écart absolu.
Questions fréquentes
Comment l'écart absolu est-il calculé ?
Il correspond à la valeur absolue de target_value moins current_value ; le résultat est donc toujours nul ou positif.
Comment l'écart en pourcentage est-il calculé ?
L'écart absolu est divisé par la valeur absolue de l'objectif, puis multiplié par 100.
Que se passe-t-il si l'objectif vaut zéro ?
Une cible nulle provoque une erreur de saisie si vous demandez le pourcentage, car la division par zéro est indéfinie. Désactivez le pourcentage pour calculer uniquement l'écart absolu.
Le résultat indique-t-il si la performance est supérieure ou inférieure ?
Non. Le calculateur renvoie l'amplitude de l'écart. Comparez séparément la valeur actuelle et l'objectif si vous avez besoin d'un sens ou d'un état.
Puis-je utiliser des valeurs de KPI négatives ?
Oui. Les deux entrées peuvent être des nombres finis négatifs. Le pourcentage utilise l'amplitude absolue de l'objectif comme dénominateur.
Quel est le coût d'un calcul via l'API ?
Chaque requête API coûte $0.002. Le même calcul déterministe est également disponible dans le navigateur.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"current_value": 72,
"target_value": 90
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.kpi_target_gap_calc",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |