Guía de error

Estructura de documento inválida en JATS XML

El error estructura de documento inválida (invalid document structure) se refiere a problemas en la arquitectura global del artículo JATS, no a un solo elemento mal colocado. Típicamente indica que faltan bloques obligatorios, están en orden incorrecto o que el documento mezcla perfiles JATS incompatibles.

Este error bloquea la indexación en SciELO, PMC y otros repositorios porque el procesador no puede determinar dónde están los metadatos, el contenido narrativo y las referencias.

Anatomía correcta de un artículo JATS

Un documento JATS Archiving válido organiza el contenido en tres regiones principales dentro de <article>:

<article xmlns:xlink="http://www.w3.org/1999/xlink"
         article-type="research-article"
         dtd-version="1.3">
  <front>
    <journal-meta>...</journal-meta>
    <article-meta>...</article-meta>
  </front>
  <body>
    <sec>...</sec>
  </body>
  <back>
    <ref-list>...</ref-list>
  </back>
</article>

Bloque	Contenido
`<front>`	Metadatos de revista y artículo
`<body>`	Texto principal, figuras, tablas
`<back>`	Referencias, agradecimientos, notas

Errores estructurales frecuentes

1. Falta el bloque `<front>`

Síntoma: Metadatos sueltos fuera de <front> o directamente bajo <article>.

Incorrecto:

<article article-type="research-article" dtd-version="1.3">
  <article-meta>
    <title-group>
      <article-title>Título</article-title>
    </title-group>
  </article-meta>
  <body>...</body>
</article>

Correcto:

<article article-type="research-article" dtd-version="1.3">
  <front>
    <journal-meta>...</journal-meta>
    <article-meta>
      <title-group>
        <article-title>Título</article-title>
      </title-group>
    </article-meta>
  </front>
  <body>...</body>
</article>

2. Referencias dentro del body

Las citas bibliográficas pertenecen a <back>, no al final del <body>.

Incorrecto:

<body>
  <sec><title>Discusión</title><p>...</p></sec>
  <ref-list>...</ref-list>
</body>

Correcto:

<body>
  <sec><title>Discusión</title><p>...</p></sec>
</body>
<back>
  <ref-list>...</ref-list>
</back>

3. Orden incorrecto de bloques

JATS exige el orden front → body → back. Colocar <back> antes de <body> genera error estructural.

4. `<journal-meta>` ausente

Aunque algunos flujos omiten metadatos de revista en artículos individuales, SciELO SPS y la mayoría de indexadores los requieren dentro de <front>.

<front>
  <journal-meta>
    <issn pub-type="epub">1234-5678</issn>
    <journal-title-group>
      <journal-title>Revista Científica</journal-title>
    </journal-title-group>
  </journal-meta>
  <article-meta>...</article-meta>
</front>

Diferencia entre well-formed y estructura válida

Un XML well-formed parsea sin errores de sintaxis (etiquetas cerradas, un solo raíz). Un XML estructuralmente válido cumple además la jerarquía JATS. Puede ser well-formed y fallar estructura:

Declaración XML ausente o encoding incorrecto (UTF-8 recomendado).
Múltiples elementos raíz.
Bloques obligatorios faltantes.

Valide ambos niveles en el validador JATS.

Diagnóstico sistemático

Confirme un solo elemento raíz <article>.
Verifique presencia de <front>, <body> y <back> (back puede estar vacío en algunos tipos, pero la etiqueta suele ser necesaria).
Confirme <journal-meta> y <article-meta> dentro de <front>.
Mueva <ref-list> a <back> si está en otro lugar.
Revise el orden de los tres bloques principales.
Revalide y aborde errores secundarios como elemento no permitido.

Prevención

Use plantillas con estructura completa predefinida.
No permita que autores editen XML sin validación automática.
Documente variaciones por article-type (editoriales pueden tener body mínimo).
Consulte la guía completa de JATS XML como referencia de arquitectura.

Para revistas sin experiencia XML, producción XML JATS garantiza estructura conforme desde el primer fascículo.

Conclusión

La estructura de documento inválida es un error de arquitectura, no de detalle. Corregir la jerarquía front/body/back resuelve la base sobre la cual todos los demás metadatos y contenidos dependen. Una vez alineada la estructura global, los errores restantes suelen reducirse drásticamente.

Valide su artículo en el validador JATS y consulte errores comunes en JATS para el panorama completo.