EditorialXML

validacion

Errores comunes en JATS XML y cómo corregirlos

EditorialXML5 min de lectura
  • jats
  • errores
  • validacion

La validación JATS revela patrones de error que se repiten en revistas de todos los tamaños y disciplinas. Conocer estos patrones acelera la corrección y evita que los mismos problemas reaparezcan número tras número. Esta guía recopila los errores más frecuentes que detectamos al validar miles de artículos, con ejemplos concretos y soluciones aplicables de inmediato.

Para diagnósticos detallados de cada tipo de error, consulte también nuestra biblioteca de guías de errores.

1. Elemento en posición no permitida

Síntoma: El validador reporta "elemento no permitido" o "invalid content model".

Causa: Un elemento hijo aparece donde el esquema JATS no lo admite. Ejemplo clásico: colocar <table-wrap> directamente dentro de <abstract> o un <p> suelto fuera de cualquier <sec> en el body.

Incorrecto:

<body>
  <p>Párrafo sin sección contenedora.</p>
</body>

Correcto:

<body>
  <sec sec-type="intro">
    <title>Introducción</title>
    <p>Párrafo dentro de una sección válida.</p>
  </sec>
</body>

2. Atributo requerido faltante

Síntoma: "Required attribute missing" en elementos como <article>, <contrib> o <ref>.

Causa: JATS exige atributos específicos. El más olvidado es article-type en <article> y id en referencias, figuras y tablas.

Incorrecto:

<article dtd-version="1.3">

Correcto:

<article article-type="research-article" dtd-version="1.3">

3. IDs duplicados

Síntoma: Referencias cruzadas rotas o errores de unicidad en validadores avanzados.

Causa: Dos elementos comparten el mismo valor de id. Ocurre frecuentemente cuando se copian bloques de referencias o figuras de un artículo anterior.

Solución: Implemente una convención de IDs (ref1, ref2, fig1, tbl1) y verifique unicidad antes de la validación final.

4. Afiliaciones sin vincular

Síntoma: Autores con <aff> definidas pero sin <xref ref-type="aff"> en el contrib.

Causa: Separación entre la declaración de afiliaciones en <aff id="aff1"> y la vinculación en cada autor. SciELO y PMC rechazan artículos con autores "huérfanos".

<contrib contrib-type="author">
  <name><surname>Pérez</surname><given-names>Luis</given-names></name>
  <xref ref-type="aff" rid="aff1"><sup>1</sup></xref>
</contrib>

5. Referencias en texto libre sin estructura

Síntoma: <mixed-citation> con datos incompletos o sin elementos parseables.

Causa: Conversión automática desde Word que no separa autor, título y fuente.

Solución: Migrar a <element-citation> con todos los subelementos. Si la conversión es masiva, use herramientas de parsing de referencias y revise manualmente los casos ambiguos.

6. DOI mal formado

Síntoma: El DOI incluye prefijo https://doi.org/ dentro del valor del elemento, o contiene espacios.

Incorrecto:

<article-id pub-id-type="doi">https://doi.org/10.1234/example</article-id>

Correcto:

<article-id pub-id-type="doi">10.1234/example</article-id>

7. Caracteres especiales sin escapar

Síntoma: XML mal formado o caracteres corruptos en nombres y títulos.

Causa: Codificación incorrecta (Latin-1 en lugar de UTF-8) o caracteres &, <, > sin entidad.

Solución: Guarde todos los archivos en UTF-8. Escape & como &amp; en texto que no sea markup.

Síntoma: Figuras sin imagen, material suplementario inaccesible.

Causa: Rutas relativas incorrectas en <graphic xlink:href="..."> o namespace xlink no declarado.

Verifique que el namespace esté en el elemento raíz:

<article xmlns:xlink="http://www.w3.org/1999/xlink" ...>

9. Resumen sin atributo de idioma

Síntoma: Advertencia o error en validadores SciELO SPS.

Causa: <abstract> sin xml:lang cuando el artículo tiene metadatos multilingües.

<abstract xml:lang="es">
  <p>Resumen en español...</p>
</abstract>
<trans-abstract xml:lang="en">
  <p>Abstract in English...</p>
</trans-abstract>

10. Fechas incoherentes

Síntoma: Rechazo en control de calidad SciELO.

Causa: Fecha de aceptación anterior a recepción, o fecha de publicación anterior a aceptación.

Revise la lógica del ciclo editorial antes de etiquetar <history>.

11. article-type incompatible con contenido

Síntoma: Artículo marcado como research-article sin secciones de métodos y resultados.

Causa: Uso de un tipo genérico para todos los artículos independientemente de su naturaleza.

Use tipos precisos: review-article, case-report, editorial, letter.

12. Tablas sin estructura semántica

Síntoma: Tablas que no se renderizan correctamente en HTML derivado.

Causa: Uso de <table> HTML sin la envoltura JATS <table-wrap>, o celdas sin <th> en encabezados.

<table-wrap id="tbl1">
  <label>Tabla 1</label>
  <caption><title>Descripción de la tabla</title></caption>
  <table>
    <thead>
      <tr><th>Columna A</th><th>Columna B</th></tr>
    </thead>
    <tbody>
      <tr><td>Dato 1</td><td>Dato 2</td></tr>
    </tbody>
  </table>
</table-wrap>

13. Licencia ausente o incorrecta

Síntoma: Error en validación SciELO para revistas de acceso abierto.

Causa: Bloque <permissions> omitido o URI de Creative Commons que no coincide con la política de la revista.

14. ORCID con formato incorrecto

Síntoma: ORCID no reconocido por harvesters.

Causa: ORCID almacenado sin URL completa o con guiones incorrectos.

Correcto:

<contrib-id contrib-id-type="orcid">https://orcid.org/0000-0001-2345-6789</contrib-id>

15. Validación solo al final del proceso

Síntoma: Acumulación de errores en lotes completos.

Causa: Validar el fascículo entero una sola vez, días antes de la entrega a SciELO.

Solución: Valide cada artículo al incorporarlo al flujo de producción. Use el validador JATS de forma continua, no como paso final de emergencia.

Estrategia de corrección sistemática

  1. Clasifique errores por tipo (estructura, metadatos, referencias, multimedia).
  2. Priorice errores bloqueantes sobre advertencias.
  3. Corrija en plantilla los errores que se repiten para prevenir recurrencia.
  4. Documente convenciones internas de etiquetado para su revista.
  5. Revalide tras cada ronda de correcciones.

Recursos adicionales

Conclusión

Los errores JATS no son señal de incompetencia técnica: son el resultado predecible de convertir documentos diseñados para lectura humana (Word, PDF) en datos estructurados para máquinas. La diferencia entre revistas que publican sin fricción y las que enfrentan devoluciones recurrentes está en detectar y corregir estos patrones de forma temprana y sistemática.

Empiece validando su próximo artículo en el validador JATS y explore las guías de errores para profundizar en cada categoría.

Artículos relacionados