# Entender la puntuación

Cada caso completado lleva una **`score`** (puntuación) — un número entero de **0 a 100**
que valora la calidad de accesibilidad del resultado PDF/UA **remediado**. La lees desde
[`GET /job-status/{caseId}`](https://docs.accessful.de/es/reference/job-status/):

```json
{ "jobStatus": "completed", "stage": "finished", "score": 87 }
```

Cuanto más alta, mejor: **100** significa que no quedó ningún problema de accesibilidad
tras la remediación.

## Cuándo es definitiva la puntuación

El número solo es significativo una vez que el trabajo está **`completed`**
(`stage: finished`). Antes de eso es un valor provisional — un caso `queued` informa
`"score": 0`, y durante [`revalidating`](https://docs.accessful.de/es/reference/job-status/#fase-de-procesamiento)
la puntuación todavía se está recalculando sobre el archivo remediado. Léela solo tras el
estado terminal [`completed`](https://docs.accessful.de/es/reference/job-status/); ignórala en cualquier otro estado.

**Note:** La puntuación describe el **resultado que producimos**, no tu subida. Mide lo que sigue
estando mal *después* de que Accessful haya corregido todo lo posible — así que responde
a «qué tan accesible es el archivo que voy a descargar», no «qué tan malo era el original».

## Cómo se calcula

La puntuación se basa en **penalizaciones**. Cada archivo empieza en **100**, y cada
problema de accesibilidad que **permanece** en el resultado resta. Cuatro factores
moldean el número:

- **La gravedad domina.** Un bloqueante estructural cuesta mucho más que un hallazgo
  cosmético. Las gravedades, de la más alta a la más baja:

  | Gravedad | Qué cubre |
  | --- | --- |
  | Bloqueante | Estructura de etiquetas básica, imágenes sin etiquetar, falta de idioma del documento |
  | Mayor | Problemas estructurales importantes para la tecnología de asistencia |
  | Menor | Metadatos, marcadores, numeración de páginas, artefactos |
  | Info | Hallazgos de buenas prácticas / informativos |

- **Lo corregido no cuesta nada.** Solo cuentan los hallazgos **abiertos**. Todo lo que
  Accessful remedió con éxito es gratis — ese es justamente el objetivo de la conversión.
- **Las repeticiones no dominan.** Muchos hallazgos del *mismo* tipo se amortiguan de
  forma logarítmica, de modo que el mismo problema en 200 páginas no se penaliza 200×
  más que en una sola página.
- **La revisión manual es barata.** Algunos problemas no se pueden corregir
  automáticamente con confianza (p. ej. «¿este texto alternativo es realmente
  significativo?»). Esos llevan una pequeña penalización fija en lugar del peso completo
  de la gravedad y se dejan para que una persona los confirme.

**Una señal de calidad, no un certificado legal:** Una puntuación alta significa que quedan pocos problemas de accesibilidad — **no** es una
garantía de conformidad legal PDF/UA ni un sustituto de una auditoría de accesibilidad
manual. Trátala como un indicador fuerte, no como una aprobación de conformidad.

La ponderación exacta se ajusta con el tiempo a medida que mejora la remediación; solo el
**rango 0–100** y «más alta es mejor» forman parte del contrato de la API.

## Leer una puntuación

La API devuelve solo el número. Como regla práctica:

| Puntuación | Cómo leerla | Acción típica |
| --- | --- | --- |
| **90–100** | Excelente — esencialmente limpio | Publícalo. |
| **75–89** | Buena — quedan problemas menores | Utilizable tal cual; revisa los documentos críticos. |
| **50–74** | Aceptable — quedan brechas reales | Revisa antes de publicar; la fuente probablemente tenía debilidades estructurales. |
| **Menos de 50** | Pobre | La fuente fue difícil de remediar automáticamente; mejórala y vuelve a subirla. |

## Por qué una puntuación no es más alta

La razón más común de que una puntuación se estanque por debajo de 100 es el **documento
de origen**: un PDF escaneado sin capa de texto, imágenes que no se pueden describir con
confianza, o contenido cuyo orden de lectura no se puede inferir con seguridad. Accessful
corrige estructura, etiquetas, metadatos, idioma y texto alternativo allí donde puede
determinarlos de forma fiable, y deja el resto como hallazgos abiertos o de revisión
manual en lugar de adivinar.

Para mover el número, **mejora la fuente** — añade una capa de texto real, aporta
encabezados auténticos — y sube el nuevo archivo. Reenviar los *mismos* bytes no ayuda:
el contenido idéntico se detecta como [duplicado](https://docs.accessful.de/es/reference/upload/) y se omite.