Validating Excel Column Schemas

Markdown
---
name: validating-excel-column-schemas
description: Valida archivos Excel contra un esquema fijo de 16 columnas (A:P), verificando encabezados exactos, orden, formatos de dato, valores permitidos, campos obligatorios y reglas condicionales entre columnas. Úsalo cuando el usuario solicite revisar la estructura o los datos de una hoja Excel según este esquema de clientes/organizaciones (TIPO DOC., NUMERO DOC., DIGITO VERIF., TIPO ORGANIZACIÓN, etc.).
---

# Validación de columnas y datos de Excel

Inspeccionar un archivo Excel (solo lectura) y detectar todas las anomalías de:

• Encabezados ausentes, incorrectos, duplicados o fuera de orden.
• Datos en columnas distintas a las esperadas, o fuera del rango A:P.
• Celdas vacías en campos obligatorios.
• Tipos de dato incompatibles con el formato requerido.
• Valores fuera de catálogos permitidos.
• Incumplimiento de reglas condicionales (TIPO ORGANIZACIÓN → DIGITO VERIF., nombres/apellidos).

No modificar, corregir ni reordenar el archivo original salvo petición explícita.

1. Identifica el archivo y todas las hojas con datos.
2. Fila 1 = encabezados; fila 2 en adelante = registros.
3. Compara A1:P1 exactamente contra el esquema (ver tabla abajo), carácter por carácter, incluyendo tildes y mayúsculas.
4. Recorre cada fila de datos aplicando reglas de tipo, obligatoriedad, catálogo y condicionales.
5. Revisa si hay datos no vacíos en columnas Q en adelante.
6. Produce la tabla de anomalías + resumen final (VÁLIDO/NO VÁLIDO).

No declares VÁLIDO sin haber recorrido todas las filas y hojas.

Reglas de interpretación de tipos:

• Texto almacenado como número en columna de texto → anomalía de formato (no convertir silenciosamente).
• Entero: sin decimales; "7" texto no vale como entero salvo en TIPO DOC..
• Vacío = sin valor o solo espacios en blanco.
• No aceptar 7.0 como entero válido si no está almacenado como entero real.
• Si no se puede determinar el formato interno con certeza, repórtalo como limitación, no como válido por defecto.

Tabla Markdown:

• Celda = dirección exacta (C8, Q2).
• Datos fuera de A:P → columna esperada = FUERA DE RANGO A:P.
• Vacíos → mostrar (vacío).
• No omitir anomalías repetidas entre filas.
• Minimizar exposición de datos sensibles ajenos a la anomalía reportada.

Resumen final (siempre incluir):

• Archivo, hojas revisadas, filas examinadas por hoja.
• Total de anomalías y conteo por categoría (estructura/encabezados, vacíos, formato, catálogo, condicionales).
• Veredicto: VÁLIDO solo si cero anomalías; si no, NO VÁLIDO.

Ejemplo 1 — Valor no permitido: Input: A4 = 5 (entero) Output: fila de anomalía — "Valor no permitido. Los valores permitidos son 3, 6, 4, 7 y 10."

Ejemplo 2 — Campo obligatorio vacío: Input: L8 vacío (EMAIL) Output: Clientes | L8 | EMAIL | (vacío) | Campo obligatorio vacío | EMAIL no puede estar vacío.

Ejemplo 3 — Regla DIGITO VERIF.: Input: D2=2, C2=4 Output: anomalía en C2 — "Para TIPO ORGANIZACIÓN=2, DIGITO VERIF. debe ser 0."

Ejemplo 4 — Nombres condicionales: Input: D3=2, H3 vacío Output: anomalía en H3 — "SEGUNDO NOMBRE obligatorio cuando TIPO ORGANIZACIÓN=2."

Ejemplo 5 — Encabezados invertidos: Input: A1="NUMERO DOC.", B1="TIPO DOC." Output: dos filas de anomalía, una por celda, indicando el encabezado esperado en cada posición.

Ejemplo 6 — Dato fuera de rango: Input: Q2 = "Observaciones adicionales" Output: Clientes | Q2 | FUERA DE RANGO A:P | Observaciones adicionales | Dato fuera de rango | Solo se permiten columnas A:P.

Ejemplo 7 — Sin anomalías: Output: "Resultado: VÁLIDO — Se revisaron todas las hojas, encabezados, tipos, obligatorios, catálogos y condicionales. No se encontraron anomalías."

• Verificar tildes, mayúsculas y espacios exactos en encabezados; no normalizar antes de comparar.
• Tratar NUMERO DOC. y TELEFONO siempre como texto, preservando ceros iniciales.
• Reportar cada incumplimiento de forma explícita, aunque varias celdas compartan el mismo motivo.
• Usar la lista de comprobación final antes de entregar el resultado.

• Todas las hojas con datos revisadas
• Encabezados exactos y en orden A:P
• Todas las filas de datos revisadas
• Tipos de dato y obligatoriedad verificados
• Catálogos permitidos verificados
• Reglas condicionales (DIGITO VERIF., nombres/apellidos) aplicadas
• Celdas fuera de A:P inspeccionadas
• Cada anomalía con referencia de celda exacta
• Total del resumen coincide con anomalías listadas
• Archivo original sin cambios

• No declarar VÁLIDO sin revisar todas las filas/hojas.
• No convertir tipos silenciosamente para "hacer pasar" una celda.
• No inventar validaciones de formato de email, teléfono o catálogos de país/ciudad.
• No ignorar celdas fuera de A:P.
• No asumir reglas condicionales cuando TIPO ORGANIZACIÓN es inválido/vacío.
• No desplazar columnas para compensar columnas vacías dentro de A:P.