Datos para gráfico de progreso e hitos de objetivos
Vea el progreso real de un objetivo que no empezó en cero: de 20 hacia 100, un valor de 68 supone un 60 % completado, los hitos del 25 % y el 50 % están alcanzados y el siguiente es el 75 %. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Valor inicial
- 20
- Valor actual
- 68
- Valor objetivo
- 100
- Porcentajes de hitos
- 100, 25, 50, 75, 50
- Dirección
- increasing
- Porcentaje de avance
- 60
- Porcentaje de avance en el gráfico
- 60
- Hitos alcanzados
- 2
Convierta una medición de su objetivo en datos coherentes para hitos y gráficos de progreso, sin tener que rehacer los cálculos en cada panel. Indique el valor inicial, el valor más reciente, el objetivo y los porcentajes de los hitos que desea mostrar. El resultado presenta el progreso real, una posición limitada apta para el gráfico, los hitos alcanzados, el siguiente hito cuando exista y una serie ordenada de puntos. Funciona tanto con objetivos ascendentes como con metas que deben disminuir, por ejemplo defectos, gastos o tiempos de respuesta.
Defina el objetivo con un punto de partida explícito
Para obtener un porcentaje de progreso útil se necesitan tres valores, no solo el valor actual y el objetivo. El valor inicial establece el cero por ciento, el objetivo establece el cien por ciento y el valor actual indica la situación presente. Esta diferencia resulta esencial cuando el trabajo parte de una referencia distinta de cero.
Por ejemplo, si una puntuación debe subir de 20 a 100, el punto medio es 60, no un progreso del sesenta por ciento calculado directamente sobre la puntuación. Envíe estos datos como números e incluya al menos un porcentaje de hito entre cero y cien. Puede indicar los hitos en cualquier orden; los porcentajes repetidos se consolidan para entregar al gráfico una serie ascendente limpia.
El objetivo debe ser diferente del inicio, porque un intervalo de longitud cero no permite calcular una proporción significativa. Si ambos coinciden, la capacidad devuelve un error de entrada tipado, en lugar de infinito, un porcentaje arbitrario o datos que solo parecen correctos. Cada solicitud admite hasta cien elementos de hito, suficientes para planes detallados sin dejar de limitar el procesamiento y la salida.
Interprete de forma uniforme objetivos ascendentes y descendentes
Una misma fórmula sirve para ambos sentidos: el progreso es la distancia recorrida desde el inicio dividida por la distancia total entre inicio y objetivo. Cuando el objetivo supera al inicio, el resultado identifica una meta ascendente. Cuando es menor, identifica una meta descendente; así, pasar de 100 incidencias a un objetivo de 20 se considera avance y no un resultado negativo.
El porcentaje de progreso devuelto no se limita de manera intencionada. Un valor inferior a cero revela un retroceso más allá del punto inicial, mientras que uno superior a cien refleja que se ha superado el objetivo. La decisión sobre qué hitos se han alcanzado utiliza el progreso real sin limitar.
Cada hito normalizado incluye su porcentaje, el valor correspondiente dentro del trayecto y un indicador de cumplimiento. La salida incluye además la cantidad y los porcentajes de los hitos alcanzados, junto con el siguiente hito si todavía queda alguno pendiente. Si todos se han cumplido, ese campo opcional se omite en lugar de devolver null.
Qué puede hacer con ella
Mostrar un panel de OKR
Convierta la referencia, la última medición, el objetivo y los umbrales de revisión de cada objetivo en marcadores uniformes.
Seguir un objetivo de reducción
Muestre un avance correcto cuando el resultado deseado sea menor, como menos defectos, incidencias o demoras de soporte.
Generar avisos de hitos
Compare los porcentajes alcanzados con el estado anterior de su aplicación para decidir qué mensajes de logro debe enviar.
Preguntas frecuentes
¿Admite objetivos cuyo valor final sea menor que el inicial?
Sí. Los objetivos descendentes emplean el mismo cálculo basado en distancias y se identifican como descendentes.
¿Qué ocurre si el progreso supera el objetivo?
El porcentaje real puede superar 100 para conservar el sobrecumplimiento, mientras que la posición gráfica se limita a 100.
¿Cómo se tratan los hitos desordenados o duplicados?
Se eliminan los duplicados y se ordenan de menor a mayor antes de calcular sus valores y estados.
¿Por qué se rechazan un inicio y un objetivo iguales?
El intervalo tendría longitud cero, por lo que la división no podría producir un porcentaje de progreso significativo.
¿Cómo se calcula el progreso de un objetivo que parte de un valor inicial?
Se divide lo avanzado desde el inicio entre la distancia total hasta la meta. Al pasar de 20 hacia 100, un valor actual de 68 equivale a un 60 % completado, no a un 68 %, porque los primeros 20 ya estaban ahí.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/final3/goal-milestone-progress-chart-data \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"start_value":20,"current_value":68,"target_value":100,"milestone_percentages":[25,50,75,100]}'const res = await fetch("https://api.kit.forhosting.com/final3/goal-milestone-progress-chart-data", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"start_value": 20,
"current_value": 68,
"target_value": 100,
"milestone_percentages": [
25,
50,
75,
100
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/final3/goal-milestone-progress-chart-data",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"start_value": 20,
"current_value": 68,
"target_value": 100,
"milestone_percentages": [
25,
50,
75,
100
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/goal-milestone-progress-chart-data", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"start_value":20,"current_value":68,"target_value":100,"milestone_percentages":[25,50,75,100]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"start_value":20,"current_value":68,"target_value":100,"milestone_percentages":[25,50,75,100]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/goal-milestone-progress-chart-data", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"start_value": 20,
"current_value": 68,
"target_value": 100,
"milestone_percentages": [
25,
50,
75,
100
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "final3.goal_milestone_progress_chart_data",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_items | 100 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Interprete de forma uniforme objetivos ascendentes y descendentes
Para la presentación, chart_progress_percentage y chart_percentage del punto actual sí se restringen al intervalo de cero a cien.
Utilice los puntos en gráficos y vistas de estado
Cada registro contiene su tipo, porcentaje, valor y estado de cumplimiento, por lo que puede alimentar gráficos de líneas, barras de avance, marcadores cronológicos y resúmenes textuales accesibles. Esta separación permite colocar el marcador en un extremo cuando la meta se encuentra retrasada o superada, sin ocultar la cifra verdadera en la etiqueta o descripción emergente. El cálculo es determinista y no usa red, hora, estado almacenado ni valores aleatorios; la misma entrada siempre produce la misma salida. El array chart_points aporta un punto inicial ordenado, un punto por cada hito normalizado y un punto final para el objetivo. El objeto current_point conserva el valor actual y el progreso real, y también ofrece la coordenada limitada para el gráfico. Use reached_milestone_percentages para insignias, celebraciones o eventos de auditoría, y next_milestone para explicar el próximo paso sin volver a recorrer la lista. Puede ejecutarlo gratis en el navegador para planificar o usar la API por $0.002 por solicitud al generar informes, actualizar paneles o procesar objetivos automáticamente.
Preguntas técnicas
¿Cuánto cuesta una solicitud de API?
Cada solicitud de API cuesta $0.002; la versión interactiva del navegador es gratuita.