Diferença do KPI para a meta: valor absoluto e percentual
A calculadora de distância do KPI até a meta transforma dois valores em uma medida clara do que separa o desempenho atual do objetivo definido.
Executar grátis
Informe o KPI atual e a meta para receber a diferença absoluta e, quando solicitado, essa diferença como percentual da meta. O cálculo atende indicadores de receita, conversão, atendimento, produção, qualidade e outras métricas numéricas sem pressupor uma unidade ou um modelo de negócio.
Leia a diferença absoluta na unidade do próprio KPI
A diferença absoluta é a magnitude da distância entre o valor atual e a meta. A calculadora subtrai um do outro e usa o resultado absoluto, portanto a saída nunca é negativa. Se a receita recorrente mensal atual for 72 e a meta for 90, a diferença absoluta será 18 na mesma unidade usada nas entradas. Caso o desempenho já tenha ultrapassado o objetivo, o resultado ainda mostrará a distância entre os valores, em vez de classificá-la como déficit. Essa distinção é importante quando o cálculo alimenta um painel: o número mede a separação, enquanto o relatório deve informar se o valor atual está acima ou abaixo da meta. Use a mesma unidade e escala nos dois campos. Não compare um percentual representado por 0.72 com uma meta representada por 90, nem dólares com milhares de dólares. Entradas consistentes tornam a diferença diretamente útil em previsões, painéis, alertas e análises de progresso.
Entenda como a diferença percentual é calculada
Quando a saída percentual está ativada, a calculadora divide a diferença absoluta pelo valor absoluto da meta e multiplica o resultado por 100. Com os valores anteriores, 18 dividido por 90 produz uma diferença percentual de 20 por cento. Usar a meta como referência facilita comparar KPI de escalas diferentes: uma distância de 10 pode ser pequena diante de uma meta de 1,000, mas relevante diante de 25. O denominador usa a magnitude da meta; assim, uma meta negativa ainda gera um percentual não negativo que representa a distância relativa ao seu tamanho. Uma meta igual a zero não pode funcionar como denominador. Por isso, solicitar um percentual com meta zero retorna um erro de entrada, não infinito nem um valor enganoso. Se apenas a diferença absoluta fizer sentido para esse KPI, desative a saída percentual. A resposta omitirá o campo percentual e retornará normalmente a diferença absoluta.
Use o resultado de modo consistente nos relatórios
Defina o KPI, o período de medição, a unidade e a meta antes de calcular a diferença. Um valor semanal deve ser comparado a uma meta semanal, e uma taxa líquida precisa usar a mesma representação nos dois lados. O resultado é determinístico, o que permite usá-lo em relatórios agendados, substituições de planilhas, pipelines de dados e verificações automáticas. Guarde os dois valores de origem junto com a saída calculada para que revisores possam reproduzir a conta e compreender alterações posteriores da meta. Como o cálculo informa magnitude, acrescente uma regra de status separada quando a direção for importante. Em um KPI no qual valores maiores são melhores, compare atual e meta para classificá-lo como abaixo, atingido ou superado; quando valores menores forem melhores, inverta essa regra de negócio. Não trate a diferença percentual como crescimento necessário se houver capitalização, mudanças de taxa ou relações não lineares. Ela é uma diferença relativa direta em relação à meta, não uma previsão das ações necessárias para alcançá-la.
Casos de uso
Acompanhe o desempenho comercial
Compare receita, reservas ou unidades vendidas com a meta do período e publique uma medida consistente da diferença.
Monitore níveis operacionais
Meça a distância de um KPI de tempo de resposta, produtividade ou qualidade em relação à meta acordada.
Padronize painéis executivos
Calcule diferenças percentuais comparáveis para KPI com unidades e escalas distintas, preservando cada diferença absoluta.
Perguntas frequentes
Como a diferença absoluta é calculada?
Ela é o valor absoluto de target_value menos current_value, portanto o resultado é sempre zero ou positivo.
Como a diferença percentual é calculada?
A diferença absoluta é dividida pelo valor absoluto da meta e multiplicada por 100.
O que acontece quando a meta é zero?
Uma meta zero causa erro de entrada quando o percentual é solicitado, pois a divisão por zero é indefinida. Desative o percentual para calcular somente a diferença absoluta.
O resultado informa se o desempenho está acima ou abaixo da meta?
Não. A calculadora retorna a magnitude da diferença. Compare o valor atual e a meta separadamente quando precisar de direção ou status.
Posso usar valores de KPI negativos?
Sim. As duas entradas podem ser números finitos negativos. O percentual usa a magnitude absoluta da meta como denominador.
Quanto custa um cálculo pela API?
Cada solicitação pela API custa US$ 0,002. O mesmo cálculo determinístico também está disponível no navegador.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
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)Exemplo de requisição
{
"current_value": 72,
"target_value": 90
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.kpi_target_gap_calc",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |