DocoMatic

Verificación

Pruebas, no promesas: un informe de verificación para cada archivo

Cualquiera puede decir que un PDF es accesible.

DocoMatic puntúa cada archivo, valida los resultados de Nivel 2 y Nivel 3 frente a PDF/UA-1 con veraPDF(se abre en una pestaña nueva)un validador independiente que no escribimos nosotros y que no podemos ajustar —, conserva el historial de versiones de cada documento y le entrega el informe.

Está escrito para quienes piden pruebas: responsables de archivos, auditores, coordinadores de ADA y abogados de la parte contraria. La verificación es una parte de la plataforma de accesibilidad documental.

El ejemplo es la salida real de nuestro proceso, generada a partir de un documento de prueba sintético. Ninguno de los dos enlaces requiere cuenta.

La primera página de un informe de verificación de DocoMaticUn panel de veredicto que dice «verificado frente al umbral del Nivel 2», una Puntuación DocoMatic de 40 antes de la corrección y 100 después, y una línea de veraPDF PDF/UA-1 que muestra 106 reglas aprobadas y ningún fallo.Informe de verificación de accesibilidadbudget-000.pdfVerificado frente al umbral del Nivel 2Comprobaciones automáticas correctas · texto preservado · puntuación ≥ 95 · veraPDF sin fallosPuntuación DocoMatic, antes y después40100sobre 100Validación PDF/UA-1 (veraPDF)Aprobado — 106 reglas aprobadas, 0 con falloLo que las máquinas no pueden verificarOrden de lectura inferido, nivel de encabezado inferido, idioma detectado…Página 1 de 7El veredictonombra cada condiciónNuestra puntuaciónantes y despuésLos límitesen lista, no ocultos
El informe de ejemplo publicado, página 1 de 7.

El informe

Qué contiene un informe de verificación

Cada versión de un documento produce su propio informe, descargable en PDF y en JSON. Estas son las secciones del informe real, en el orden en que las imprime.

Las secciones de un informe de verificación de DocoMatic
SecciónQué contiene
Identidad del documentoNombre del archivo, número de páginas, nivel de corrección, identificador de versión y marca de tiempo de la corrección.
VeredictoSi la versión alcanzó el umbral de su nivel, en una frase que nombra cada condición y su resultado — y que dice con claridad cuándo una condición no quedó establecida.
Puntuación DocoMatic, antes y despuésLa puntuación del archivo de entrada y del archivo entregado, y luego cada una de las seis categorías con su peso, su resultado y si había algo que medir.
Resultado de veraPDFEl veredicto PDF/UA-1, el validador, el perfil, cuántas reglas se aprobaron, cuántas fallaron y cada regla con fallo.
Comprobaciones automáticasCada comprobación estructural realizada, con su resultado sobre el archivo original y sobre el archivo entregado, lado a lado.
Puntos de control del Matterhorn ProtocolLas condiciones de fallo de PDF/UA que DocoMatic asocia a sus propias comprobaciones, por número de punto de control, antes y después.
Lo que las máquinas no pueden verificarTodo lo decidido por software y no confirmado por una persona: orden de lectura inferido, niveles de encabezado inferidos, idioma detectado, encabezados de tabla inferidos, descripciones de baja confianza.
Contenido generado por IA y revisión humanaQué se escribió a máquina, si es que hubo algo, y si un revisor con nombre firmó el documento. «Ninguno» se imprime con la misma claridad que un nombre.
Cambios aplicadosCada cambio hecho al archivo, contado por tipo, con las fuentes sustituidas y las propiedades del documento nombradas una a una.
Jurisdicción y avisosLas reglas frente a las que se midió el documento, la línea de «no es asesoramiento legal» y la nota de que el informe cubre solo el archivo exacto al que está vinculado.
ApéndicesDetalles técnicos — las huellas de ambos archivos, el umbral aplicado, las versiones del analizador, del motor de puntuación y del proceso — y un glosario de cada término empleado.

El informe de ejemplo

budget-000.pdf, 7 páginas, Nivel 2. Puntuación DocoMatic 40 → 100; veraPDF PDF/UA-1 aprobado con 106 reglas y cero fallos.

Generado a partir de un documento de prueba sintético, no de un archivo de un cliente. El informe lo dice en su primera línea.

El manifiesto de cambios completo — cada modificación, etapa por etapa — se descarga aparte desde el historial de versiones del documento.

Qué se ejecuta en cada nivel

Qué comprueban realmente los validadores automáticos

Los validadores automáticos como PAC(se abre en una pestaña nueva) y veraPDF(se abre en una pestaña nueva) comprueban la mecánica de PDF/UA: que exista un árbol de etiquetas y esté bien formado, que el contenido esté etiquetado o marcado como decoración, que las tablas tengan encabezados, que el documento declare un título y un idioma, y que las fuentes estén correctamente incrustadas.

Qué se ejecuta en cada nivel de corrección y qué exige el umbral de cada nivel
Nivel 1Nivel 2Nivel 3
Comprobaciones automáticas estructuralesEn cada archivoEn cada archivoEn cada archivo
Texto extraído preservado byte a byteEn cada archivoEn cada archivoEn cada archivo
Puntuación DocoMatic (0–100)Calculada y reportadaCalculada; debe alcanzar 95Calculada; debe alcanzar 95
Validación PDF/UA-1 con veraPDFSe ejecuta cuando el validador está disponible; se reporta a título informativo, fuera del umbralObligatoria — cero fallosObligatoria — cero fallos
Umbral para que se cobreLas comprobaciones automáticas se superan y el texto se preservaLas comprobaciones automáticas se superan, el texto se preserva, la puntuación alcanza 95 y veraPDF no reporta ningún falloLas comprobaciones automáticas se superan, el texto se preserva, la puntuación alcanza 95 y veraPDF no reporta ningún fallo

La puntuación es nuestra. El veredicto PDF/UA-1 no lo es. Viene de veraPDF(se abre en una pestaña nueva), un validador de código abierto creado por un consorcio dirigido por la Open Preservation Foundation y la PDF Association. No lo escribimos nosotros, no podemos ajustarlo, y su veredicto es la medida de nuestra facturación.

La salida de Nivel 1 recibe una comprobación estructural y no se valida con PDF/UA-1: la conformidad no forma parte del umbral del Nivel 1, y un archivo de Nivel 1 no lleva ninguna afirmación de PDF/UA-1. Cuando el validador está disponible, su resultado se registra igualmente, a título informativo y no como condición. La conformidad con PDF/UA-1 empieza en el Nivel 2. Vea qué hace cada nivel con un documento.

Dos validadores, una norma

PAC y veraPDF: por qué usamos uno y no el otro

Dos lupas revisan el mismo documento etiquetado; una corre sobre un riel con documentos en fila detrás

PAC(se abre en una pestaña nueva) (PDF Accessibility Checker) es un validador gratuito publicado por axes4, en Zúrich. veraPDF(se abre en una pestaña nueva) es un validador de código abierto creado por un consorcio dirigido por la Open Preservation Foundation y la PDF Association. Ambos comprueban un PDF frente a los requisitos de PDF/UA-1 verificables por máquina.

Nosotros usamos veraPDF. No usamos PAC. Comprueban los mismos requisitos de PDF/UA-1: veraPDF es de código abierto, programable y versionado, y eso es lo que nos permite ejecutarlo automáticamente en cada archivo y dejar constancia de qué validador produjo qué veredicto, en un informe que usted puede presentar junto al archivo.

Si su auditor pide un informe de PAC, ejecute PAC usted mismo sobre nuestra salida: es gratuito, y nuestros archivos están construidos para cumplir los mismos requisitos que comprueba. Si contradice nuestro informe, envíenoslo; eso es un error y queremos conocerlo.

La puntuación DocoMatic

Cómo se construye la puntuación

La Puntuación DocoMatic es un valor de 0 a 100 sobre las reglas de PDF/UA-1 y WCAG 2.1 AA verificables por máquina. Existe para darle una sola cifra que seguir entre versiones y en todo su inventario. Estas son las seis categorías que combina y el peso de cada una.

Las seis categorías de la Puntuación DocoMatic, por peso publicadoLa estructura vale 30 puntos, las alternativas textuales 20, las tablas 15, los formularios 15, la navegación y los metadatos 10, y el idioma y las fuentes 10. Los formularios se dibujan con contorno discontinuo porque son el único peso que se mueve.Estructura30Alternativas textuales20Tablas15Formularios15Navegación, metadatos10Idioma, fuentes10
Los pesos de categoría publicados de la Puntuación DocoMatic
CategoríaPesoQué mide
Estructura30Árbol de etiquetas presente y bien formado, sin contenido sin etiquetar, encabezados visibles realmente etiquetados como encabezados, encabezados que empiezan en H1 y no saltan ningún nivel, elementos de lista dentro de listas.
Alternativas textuales20Las figuras llevan texto alternativo; las imágenes que son solo decoración se marcan como decoración para que un lector de pantalla las omita.
Tablas15Las tablas etiquetadas tienen celdas de encabezado, y esos encabezados están asociados a las celdas de datos que describen.
Formularios15Los campos de formulario llevan una descripción que un lector de pantalla puede leer en lugar de la casilla.
Navegación y metadatos10Título del documento definido, visores configurados para mostrar el título en vez del nombre del archivo, marcadores, orden de tabulación, identificador XMP de PDF/UA.
Idioma y fuentes10El documento declara su idioma natural, todas las fuentes están incrustadas y el texto se puede extraer.

Los formularios son el único peso que se mueve. Un documento sin campos de formulario no tiene nada que medir ahí, así que esos 15 puntos se reparten proporcionalmente entre las otras cinco categorías. Ninguna otra categoría se redistribuye nunca.

Tres fallos limitan el total a 40 sea cual sea el resto: sin estructura de etiquetas, sin idioma de documento declarado, o con contenido real que no está ni etiquetado ni marcado como decoración. A un archivo al que le falte alguno de esos elementos le queda mucho para ser utilizable, y una puntuación de noventa y tantos diría lo contrario.

Una categoría sin nada que medir cuenta como cumplida, y el informe dice cuáles fueron. Eso corta por los dos lados, y preferimos que lo lea aquí: el analizador ve las tablas etiquetadas, así que una tabla visual que nunca se etiquetó como tal es invisible para esa categoría. Cada informe enumera lo que no se pudo comprobar.

Dos cosas que queremos decir con claridad. El umbral de 95 es una cifra que elegimos nosotros: ninguna norma fija una. Y la puntuación es nuestra medida, no una medida independiente. Para eso está exactamente el veredicto de veraPDF junto a ella.

El ejemplo publicado es el caso resuelto. Obtiene 40 antes de la corrección — limitado, porque el archivo no tenía estructura de etiquetas, ni idioma de documento, y tenía contenido sin etiquetar — y 100 después. Su página de puntuación imprime las seis categorías con sus pesos y sus tasas.

Honestos sobre los límites

Lo que las máquinas no pueden comprobar

Ningún validador puede decir si un texto alternativo describe lo correcto, si el orden de lectura tiene sentido para una persona, o si la etiqueta de un campo corresponde a lo que el campo pide realmente. Un archivo puede superar todas las comprobaciones automáticas y seguir siendo inutilizable.

Qué decide el software y qué solo puede decidir una personaA la izquierda, cinco cosas que un validador resuelve solo: el árbol de etiquetas, el idioma del documento, el título, los encabezados de tabla y las fuentes incrustadas. A la derecha, tres que no puede: si una descripción significa lo correcto, si el orden de lectura tiene sentido, y si la etiqueta de un campo corresponde a ese campo.El software resuelve estoPresente o ausente, correcto o noSolo una persona resuelve estoEl significado, no la mecánica¿Hay un árbol de etiquetas y está bien formado?¿Está declarado el idioma del documento?¿Hay un título y los visores lo muestran?¿Las tablas etiquetadas tienen celdas de encabezado?¿Están incrustadas todas las fuentes?¿La descripción dice lo que significa la imagen?¿El orden de lectura tiene sentido al escucharlo?¿La etiqueta corresponde a lo que el campo pide?Enumerado en cada informe, para que sepa dónde mirar.

Tres preguntas que ningún validador responde

  • ¿El texto alternativo describe lo correcto? Un validador comprueba que exista una descripción, nunca qué dice.

  • ¿El orden de lectura tiene sentido al escucharlo? El software puede comprobar que exista un orden; solo una persona puede decir si es el orden que el documento quiere decir.

  • ¿La etiqueta corresponde a lo que el campo pide? Un campo etiquetado aprueba. Uno mal etiquetado también.

Cómo se señala la baja confianza

Cada descripción de imagen escrita por la máquina lleva una cifra de confianza. Por debajo de 0.5, la entrada se marca como necesitada de revisión humana, se cuenta en el informe y se nombra en lugar de diluirse en un total. El OCR de baja confianza recibe el mismo trato.

Todo lo que el proceso infirió en vez de leer aparece al lado — el orden de lectura tomado de la maquetación, un nivel de encabezado tomado del tamaño y la posición de la fuente, un idioma detectado estadísticamente, un encabezado de tabla tomado de las líneas de filete — cada uno marcado como no revisado por una persona. La lista del informe de ejemplo llega a siete entradas.

Ese hueco necesita a una persona. El informe de verificación enumera lo que una máquina no pudo verificar, incluido el texto alternativo de baja confianza, para que sepa dónde mirar.

Para la revisión humana, actívela al solicitar una corrección o acuérdela con nuestro equipo. Se cobra por página en lugar de incluirse, porque la mayoría de los documentos no la necesitan y los que sí saltan a la vista en el informe. Todo ello es una parte de la plataforma de accesibilidad documental.

Historial de versiones

Un historial de versiones para cada documento

Cada versión de un documento conserva su propio estado, sus puntuaciones y su informe. Así se ven tres versiones de un mismo documento.

Historial de versiones a modo de ilustración. No son las cifras de un cliente.
VersiónFechaNivelPuntuación, antes → despuésveraPDFCobrado
v3Nivel 24197Aprobado, cero fallosSí — 4 créditos por página
v2Nivel 241922 reglas con falloNo — créditos liberados
v1Nivel 14188Fuera del umbral del Nivel 1Sí — 1 créditos por página

Lea la fila del medio. La v2 no alcanzó su umbral y no se cobró nada por ella; la v3 sí lo alcanzó y se cobró. La promesa que hay debajo de esta tabla no es una política que haya que creer sin más: es una fila en el historial de cada documento que nos envía.

Cada versión conserva su estado, sus puntuaciones y un manifiesto de cambios que registra qué modificó cada etapa del proceso. Mientras un documento se procesa, puede seguirlo etapa por etapa.

Comparación honesta

Cómo lo describe el resto del mercado

La mayoría de los proveedores de accesibilidad documental describen la validación en términos generales — industry-leading compliance checkers, comprehensive accessibility reports, enterprise-grade validation — sin nombrar el validador, el perfil que se ejecutó ni el umbral que un archivo tiene que superar.

Eso no es necesariamente deshonesto. Pero no es una prueba, y la diferencia importa el día en que alguien le pide una. Aquí no se nombra a ningún proveedor: son frases de categoría, y el argumento no necesita un blanco.

La tabla le invita a hacernos esas mismas cinco preguntas. Solo está en la página porque podemos responder a las cinco, y todas las respuestas están más arriba.

Cinco preguntas que hace un auditor, y dónde las responde esta página
Pregunta que hará su auditorDónde está nuestra respuesta
¿Qué norma?PDF/UA-1 (ISO 14289-1) y WCAG 2.1 AA. Qué se ejecuta en cada nivel
¿Qué validador, y qué dejó registrado?veraPDF, con su perfil, sus recuentos de reglas y cada regla con fallo impresa en el informe. Qué contiene un informe
¿Quién eligió el umbral?Nosotros, y lo decimos. Cómo se construye la puntuación
¿En qué falló?Cada regla con fallo, por número, en el informe. Qué contiene un informe
¿Puedo reproducirlo?Sí. Ejecute PAC o veraPDF usted mismo sobre nuestra salida. PAC y veraPDF

La promesa sin cargo

Por debajo del umbral no hay cobro

No se le cobra por un documento que no supera la verificación.

Los créditos se reservan cuando arranca un trabajo. Si una versión de un documento no alcanza el umbral de su nivel, la reserva se libera automáticamente y usted no paga nada por ella. Vuelva a ejecutarla, suba de nivel o añada revisión humana: usted decide.

El historial de versiones de arriba lo muestra: la v2 no llegó, la v3 sí, y solo se cobró la v3.

Si el validador no está disponible

Un validador al que no se puede llegar no puede condenar un archivo, y tampoco puede absolverlo. El informe se marca como «validación pendiente» y se vuelve a poner en cola, con una espera creciente, hasta que veraPDF responde; entonces la comprobación se repite y el informe se sustituye. Hasta ese momento, una versión de Nivel 2 o Nivel 3 sigue por debajo del umbral: no se cobra nada y nada se marca como verificado sin la validación que exige su nivel.

El mismo informe, como datos

El mismo informe, en JSON

Cada informe está disponible en JSON junto al PDF, para que pueda guardar las puntuaciones en su propio sistema de archivo o volcar el inventario en un panel.

Extracto del informe de ejemplo publicado para budget-000.pdf

{
  "kind": "verification-report",
  "report_version": 2,
  "level": "L2",
  "document": {
    "source_name": "budget-000.pdf",
    "version_id": "v-d1b6ac39c32759aa-L2",
    "pages": 1,
    "sha256_after": "d82b7c3af7a85da220fb7aadf05d3f7a154b0f45299747ad16ead80b8fc382ba"
  },
  "scores": {
    "before": {
      "total": 40
    },
    "after": {
      "total": 100
    }
  },
  "verapdf": {
    "validator": "veraPDF",
    "profile": "PDF/UA-1",
    "status": "passed",
    "passed_rules": 106,
    "failed_rules": 0,
    "in_threshold": true
  },
  "machine_unverifiable": [
    "Reading order for 5 tagged element(s) was inferred from layout analysis (position, columns, flow); not human-reviewed."
  ],
  "credits": {
    "reserved": 4,
    "consumed": 4
  },
  "threshold": "L2: machine checks pass + text preserved + Score ≥ 95 + veraPDF PDF/UA-1 conformant",
  "verdict": "verified"
}

Estos son los nombres de campo reales. El bloque se construye a partir del ejemplo publicado al compilar esta página, no se transcribe a mano: lo que lee aquí es lo que va a analizar.

El archivo completo añade las seis categorías de puntuación con sus pesos y tasas, los puntos de control del Matterhorn, el resumen del manifiesto de cambios, las sustituciones de fuentes, la atestación del revisor y las versiones del analizador, del motor de puntuación y del proceso.

Descargar el informe de ejemplo completo en JSON

Preguntas frecuentes

Preguntas frecuentes

No es asesoramiento legal. DocoMatic publica esto como información general para equipos de accesibilidad, archivos y TI. Para las decisiones sobre las obligaciones de su organización, apóyese en las fuentes primarias enlazadas aquí y en los materiales del DOJ en ADA.gov, y consulte a su abogado.

¿Qué es un informe de PAC?

PAC (PDF Accessibility Checker) es un validador gratuito publicado por axes4, en Zúrich que comprueba un PDF frente a los requisitos de PDF/UA verificables por máquina. DocoMatic no usa PAC; usa veraPDF, que comprueba los mismos requisitos de PDF/UA-1. La sección de arriba explica por qué, y qué hacer si alguna vez discrepan.

Si un archivo pasa veraPDF, ¿es accesible?

No necesariamente. La validación automática demuestra que la estructura es técnicamente correcta. No puede juzgar si el texto alternativo tiene sentido ni si el orden de lectura es coherente. Por eso DocoMatic puntúa las comprobaciones automáticas, señala el contenido de baja confianza en el informe y ofrece revisión humana: actívela al solicitar una corrección o acuérdela con nuestro equipo.

¿Puedo compartir el informe de verificación?

Sí. Los informes son archivos PDF y JSON autónomos, uno por versión de documento, pensados para adjuntarse a solicitudes de información pública, declaraciones de accesibilidad, expedientes de junta o auditorías de proveedores.

¿Cómo funciona la política de no cobro?

Los créditos se reservan cuando arranca un trabajo. Si la salida no alcanza el umbral de su nivel — por ejemplo un documento de Nivel 2 por debajo de 95, o que falla veraPDF —, la reserva se libera automáticamente. No se le cobra por un documento que no supera la verificación.

¿Qué versión de veraPDF ejecutan?

Cada informe registra el validador y el perfil que se ejecutaron — veraPDF, PDF/UA-1 — con cuántas reglas se aprobaron y cuántas fallaron, junto al analizador (l1-analyzer-0.4.0), el motor de puntuación (docomatic-score-2.0.0) y el proceso (l2-0.1.0) exactos que produjeron el resultado, y el SHA-256 tanto del archivo original como del entregado. Todavía no imprime un número de compilación de veraPDF. Si su auditor lo necesita para un documento concreto, pídanoslo y le diremos qué compilación se ejecutó.

¿Por qué 95 y no 100?

Porque 95 es una cifra que elegimos nosotros y ninguna norma fija una: preferimos decirlo a disfrazarlo. Está donde está para que perder una señal entera deje un archivo por debajo: un documento cuyos encabezados visibles están todos etiquetados como simples párrafos saca alrededor de 91, y no queremos cobrar por eso. Tres fallos limitan una puntuación a 40 sea cual sea el resto: sin estructura de etiquetas, sin idioma declarado, o con contenido real sin etiquetar. El umbral puede moverse a medida que crece el conjunto de reglas, y por eso cada informe imprime la versión del motor de puntuación que produjo su cifra.

¿Puede nuestro auditor reproducir su resultado?

Sí. Ejecute PAC o veraPDF usted mismo sobre la salida; ambos comprueban los mismos requisitos de PDF/UA-1 verificables por máquina. Cada informe lleva el SHA-256 del archivo que describe, así que puede confirmar que está comprobando los mismos bytes que nosotros. Si otra herramienta contradice nuestro informe, envíenoslo; eso es un error y queremos conocerlo.

¿Un informe de verificación demuestra el cumplimiento de la ADA?

No. Nadie puede certificar que un documento cumple la ADA; ese certificado no existe, y DocoMatic no emite ninguno. El informe es prueba de conformidad con una norma técnica y un registro de lo que se hizo al archivo. Lo que exige su obligación legal es una determinación que corresponde a su abogado.

¿Qué pasa con los archivos de Nivel 1?

Reciben una comprobación estructural: todas las comprobaciones automáticas deben superarse en la salida y el texto extraído debe preservarse byte a byte. La validación PDF/UA-1 no forma parte del umbral del Nivel 1, así que un archivo de Nivel 1 no lleva ninguna afirmación de conformidad con PDF/UA-1 y su informe lo dice con esas palabras. Cuando el validador está disponible, el resultado se registra igualmente, a título informativo. La conformidad con PDF/UA-1 empieza en el Nivel 2, donde la Puntuación DocoMatic también debe alcanzar 95.

Cada archivo, verificado antes de entregárselo

Vea cómo es la verificación

Lea primero un informe de ejemplo completo: es la salida real de nuestro proceso sobre un documento de prueba. O pase cualquier PDF por el revisor gratuito para ver las comprobaciones automáticas que hay detrás de nuestras puntuaciones.