Metadatos DIAN: qué son, para qué sirven y ejemplos prácticos

Qué son los metadatos en la información exógena DIAN

Cuando usted prepara la información exógena para reportar a la DIAN, cada archivo XML que genera contiene dos partes fundamentales: el encabezado y los registros. El encabezado es, precisamente, el conjunto de metadatos del archivo.

Los metadatos son datos sobre los datos. En el contexto de la exógena DIAN, son los campos que identifican quién reporta, qué formato se está presentando, para qué año gravable y en qué versión del esquema. Sin metadatos correctos, la DIAN no puede procesar su información, así el contenido de los registros sea perfecto.

Piense en los metadatos como la carátula de un informe: si la carátula dice “Formato 1001 – Año 2024” pero el contenido corresponde al 2025, el archivo será rechazado.

Estructura de un archivo XML de exógena: encabezado vs. contenido

Todo archivo XML de información exógena sigue una estructura jerárquica definida por los esquemas XSD que publica la DIAN. A grandes rasgos, la estructura es:

1. Encabezado (metadatos): contiene la información de identificación del archivo: año gravable, concepto, formato, NIT del informante, dígito de verificación, tipo de documento y versión del formato.
2. Contenido (registros): contiene cada uno de los registros individuales que se reportan, como pagos a terceros (formato 1001), retenciones practicadas (formato 1003), IVA descontable (formato 1005), entre otros.

La DIAN valida primero los metadatos y luego los registros. Si el encabezado tiene errores, el prevalidador rechaza el archivo completo sin siquiera revisar el contenido.

Metadatos principales que exige la DIAN

A continuación se detallan los campos de metadatos que debe incluir todo archivo XML de exógena:

Ejemplo práctico: encabezado XML de exógena

A continuación puede ver cómo luce un encabezado típico de un archivo XML para el formato 1001 (pagos y abonos en cuenta a terceros):

<?xml version="1.0" encoding="UTF-8"?>
<mas xmlns="http://www.dian.gov.co/muisca/esquemas">

  <!-- ENCABEZADO: Metadatos del archivo -->
  <Cab>
    <Ano>2025</Ano>
    <CodCpt>1001</CodCpt>
    <Formato>1001</Formato>
    <Version>10</Version>
    <NumNit>900123456</NumNit>
    <DV>7</DV>
    <TipoDoc>31</TipoDoc>
  </Cab>

  <!-- CONTENIDO: Registros individuales -->
  <Reg>
    <!-- Aquí van los registros de cada tercero -->
    <TipoDocInf>13</TipoDocInf>
    <NumDocInf>1098765432</NumDocInf>
    <PagAbon>15000000.00</PagAbon>
    <!-- ... más campos según el formato -->
  </Reg>

</mas>

Observe cómo la sección <Cab> agrupa todos los metadatos, mientras que cada <Reg> contiene la información de un registro individual. Esta separación es fundamental: la DIAN procesa el encabezado primero para saber qué tipo de información está recibiendo y de quién.

Errores comunes en metadatos que causan rechazo

Estos son los errores que con mayor frecuencia generan rechazo en el prevalidador de la DIAN. Conózcalos para evitarlos:

Cómo el prevalidador DIAN valida los metadatos

El prevalidador de la DIAN es la herramienta oficial que verifica la estructura y el contenido de los archivos XML antes de su presentación. La validación de metadatos sigue este orden:

1. Validación estructural (XSD): el prevalidador verifica que el archivo XML cumple con el esquema XSD correspondiente al formato y versión declarados. Si la estructura no coincide, se rechaza.
2. Validación del año gravable: confirma que el año gravable indicado corresponda al período de reporte habilitado.
3. Validación del NIT: verifica que el NIT del informante exista en el RUT y que el dígito de verificación sea correcto.
4. Validación de concepto y formato: cruza el código de concepto con el número de formato para asegurar coherencia.
5. Validación de versión: confirma que la versión del formato sea la vigente para el año gravable reportado.

Solo cuando todos los metadatos pasan estas cinco validaciones, el prevalidador procede a revisar los registros individuales.

Recomendaciones para evitar rechazos

• Verifique siempre la resolución DIAN vigente para conocer las versiones actualizadas de cada formato.
• Calcule el dígito de verificación con el algoritmo oficial; no lo ingrese manualmente.
• No reutilice archivos XML de años anteriores sin actualizar todos los metadatos del encabezado.
• Antes de enviar a la DIAN, pase siempre el archivo por el prevalidador para detectar errores a tiempo.

Resumen

Los metadatos son la primera línea de validación que aplica la DIAN sobre cualquier archivo XML de información exógena. Incluyen campos como el año gravable, el concepto, el formato, el NIT con dígito de verificación, el tipo de documento y la versión del esquema. Un error en cualquiera de estos campos significa el rechazo total del archivo.

Comprender la función de cada metadato, conocer los errores más frecuentes y utilizar herramientas que automaticen su generación le ahorrará tiempo, reprocesos y posibles sanciones por extemporaneidad ante la DIAN.