Guía de error

Referencias mal formadas en JATS XML

El error referencias mal formadas agrupa fallos en el bloque <back> relacionados con citas bibliográficas: elementos obligatorios ausentes, publication-type incorrecto, DOI mal escrito o uso de <mixed-citation> cuando el indexador exige estructura parseable. Es una de las principales causas de devolución en SciELO y PMC.

Las referencias en JATS no son texto decorativo: alimentan la vinculación de citas, métricas de impacto y descubrimiento en bases de datos. Una <ref-list> incompleta puede invalidar un artículo cuyo body es perfecto.

Formato preferido: element-citation

SciELO y PMC favorecen citas estructuradas:

<ref id="ref1">
  <element-citation publication-type="journal">
    <person-group person-group-type="author">
      <name>
        <surname>García</surname>
        <given-names>María</given-names>
      </name>
    </person-group>
    <article-title>Título del artículo citado</article-title>
    <source>Revista Científica</source>
    <year>2024</year>
    <volume>10</volume>
    <issue>3</issue>
    <fpage>45</fpage>
    <lpage>52</lpage>
    <pub-id pub-id-type="doi">10.1234/rc.2024.003</pub-id>
  </element-citation>
</ref>

Cada publication-type exige subelementos distintos:

Tipo	Elementos mínimos
`journal`	Autor, título artículo, fuente, año
`book`	Autor, título, editorial, año
`web`	Título, URI, fecha acceso
`thesis`	Autor, título, institución, año

Errores frecuentes

1. DOI con prefijo URL

Incorrecto:

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

Correcto:

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

2. publication-type ausente o incorrecto

Incorrecto:

<element-citation>
  <article-title>Título</article-title>
  <year>2024</year>
</element-citation>

Correcto:

<element-citation publication-type="journal">
  <article-title>Título</article-title>
  <source>Revista</source>
  <year>2024</year>
</element-citation>

3. Referencia sin año

Las citas sin <year> fallan en validadores de reglas de negocio aunque el XSD las acepte parcialmente.

4. mixed-citation sin estructura

<ref id="ref2">
  <mixed-citation publication-type="journal">
    Pérez J, López A. Título. Revista. 2023;12(4):100-110.
  </mixed-citation>
</ref>

Aceptable en algunos contextos, pero dificulta validación automática. Migre a <element-citation> cuando sea posible.

5. ID duplicado o ausente en ref

Cada <ref> referenciada desde el body necesita id único:

<p>Como se reportó <xref ref-type="bibr" rid="ref1">1</xref>...</p>

Sin id="ref1" en la referencia correspondiente, la vinculación se rompe.

Libro y capítulo de libro

<ref id="ref3">
  <element-citation publication-type="book">
    <person-group person-group-type="author">
      <name><surname>Smith</surname><given-names>John</given-names></name>
    </person-group>
    <source>Título del libro</source>
    <publisher-name>Editorial Académica</publisher-name>
    <year>2022</year>
    <isbn>978-3-16-148410-0</isbn>
  </element-citation>
</ref>

Recurso web

<ref id="ref4">
  <element-citation publication-type="web">
    <person-group person-group-type="author">
      <collab>Organización Mundial de la Salud</collab>
    </person-group>
    <article-title>Título del informe</article-title>
    <year>2025</year>
    <ext-link ext-link-type="uri" xlink:href="https://www.who.int/example">
      https://www.who.int/example
    </ext-link>
    <date-in-citation content-type="access-date">
      <day>01</day><month>06</month><year>2026</year>
    </date-in-citation>
  </element-citation>
</ref>

Estrategia de corrección masiva

Exporte referencias a hoja de cálculo con columnas: autor, título, fuente, año, DOI.
Normalice DOI (sin prefijo URL).
Asigne publication-type por fila.
Regenere <element-citation> desde plantilla.
Valide el lote en el validador JATS.
Revise manualmente casos ambiguos (sin autor, sin año, sitios web).

Relación con otros errores

Referencias mal ubicadas en <body> generan estructura de documento inválida. Atributos faltantes en <ref> se documentan en atributo requerido faltante.

Para conversión sistemática, consulte producción XML JATS o validación editorial.

Conclusión

Las referencias mal formadas son predecibles en conversiones desde Word pero evitables con plantillas y validación temprana. Invertir en <element-citation> estructurado mejora indexación, citación y cumplimiento en SciELO y PMC.

Valide sus referencias en el validador JATS y lea errores comunes en JATS para el contexto completo.