Calcular o progresso percentual de um resultado-chave OKR
Um resultado-chave que começou em 20, está em 65 e mira 100 tem 56,25% de progresso, porque o avanço é medido a partir do valor inicial. Metas que devem cair, como o tempo de resposta, funcionam do mesmo jeito. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Valor inicial
- 20
- Valor atual
- 65
- Valor-alvo
- 100
- Progresso (%)
- 56,25
Esta calculadora transforma o valor inicial, a medição atual e o alvo de um resultado-chave OKR em um percentual claro. Ela funciona com metas que devem aumentar, como receita, e com metas que devem diminuir, como tempo de resposta ou defeitos. Valores abaixo de 0 e acima de 100 são preservados para mostrar retrocessos e superações sem limites artificiais. Você pode usá-la em uma revisão isolada ou como componente determinístico de relatórios automatizados.
Meça o avanço a partir da referência real
Um percentual de OKR só faz sentido quando parte do valor registrado no início do ciclo. A calculadora mede a fração percorrida entre referência e alvo. Ir de 20 para 60 com alvo 100 representa 50 por cento, não os 60 por cento obtidos ao dividir o atual pelo alvo.
Mantenha unidade, período e escopo iguais nos três valores; não misture receita mensal com anual ou dados regionais com globais. O resultado é arredondado para seis casas decimais, garantindo relatórios estáveis sem perder precisão prática.
Use a mesma fórmula para aumento e redução
A fórmula direcional atende aos dois tipos de resultado sem outro modo. Em uma meta crescente, um valor atual maior normalmente indica mais avanço; em uma meta decrescente, ocorre o inverso. Reduzir o tempo médio de 12 horas para 4 horas e chegar a 8 horas corresponde a 50 por cento.
Os sinais se anulam porque os movimentos realizado e necessário são negativos. Isso serve para custos, churn, defeitos, latência e emissões. O alvo não pode ser igual ao início, pois não haveria distância mensurável e ocorreria divisão por zero.
Valores negativos continuam válidos quando a própria métrica os comporta, como fluxo de caixa líquido.
Interprete retrocessos e superações
A saída não é limitada entre 0 e 100. Um percentual negativo indica afastamento do alvo; acima de 100, indica que ele foi ultrapassado na direção correta. Limitar esses casos esconderia informação gerencial.
Trate o número como medição, não como julgamento completo, e compare resultados apenas quando referências, alvos e datas forem igualmente confiáveis. Se o painel exigir uma barra limitada, preserve o valor bruto nos dados e limite somente a exibição. Na automação, calcule após validar a medição mais recente e armazene os três valores de origem junto ao percentual, mantendo alterações posteriores explicáveis e auditáveis.
Casos de uso
Atualizar um painel trimestral de OKR
Converta cada medição aprovada em percentual consistente no ciclo atual.
Acompanhar uma meta de redução
Meça o avanço rumo a menos churn, defeitos ou tempo de resposta.
Auditar cálculos de progresso
Refaça um percentual pela referência, medição e alvo para validá-lo.
Perguntas frequentes
Qual fórmula é utilizada?
Calcula (valor atual menos inicial) dividido por (alvo menos inicial) e multiplica por 100.
É possível calcular uma meta decrescente?
Sim. A fórmula direcional funciona quando o alvo fica abaixo do valor inicial.
Por que o resultado pode ser negativo ou maior que 100?
O negativo mostra afastamento; acima de 100 mostra que o alvo foi superado.
Por que início e alvo iguais são rejeitados?
O movimento necessário seria zero, causando divisão por zero sem percentual definido.
Por que não basta dividir o valor atual pela meta?
Porque isso ignora o ponto de partida. Ir de 20 para 60 com meta de 100 cobre metade do caminho, ou 50% de progresso, enquanto 60 dividido por 100 indicaria, por engano, 60%.
Ferramentas relacionadas
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/okr-progress-percent \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"starting_value":20,"current_value":65,"target_value":100}'const res = await fetch("https://api.kit.forhosting.com/biz/okr-progress-percent", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"starting_value": 20,
"current_value": 65,
"target_value": 100
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/biz/okr-progress-percent",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"starting_value": 20,
"current_value": 65,
"target_value": 100
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/okr-progress-percent", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"starting_value":20,"current_value":65,"target_value":100}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"starting_value":20,"current_value":65,"target_value":100}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/okr-progress-percent", 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
{
"starting_value": 20,
"current_value": 65,
"target_value": 100
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "biz.okr_progress_percent",
"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. |
Notas técnicas
Meça o avanço a partir da referência real
Informe essa referência em starting_value, a medição confiável mais recente em current_value e o destino em target_value.
Perguntas técnicas
Quanto custa um cálculo pela API?
Cada solicitação API custa US$ 0,002. A versão web executa localmente o mesmo cálculo determinístico.