01 · METODOLOGÍA
Metodología
Somos transparentes sobre cómo Normadata valida cada identificador en nuestros 10 mercados sudamericanos. Saber qué chequea la API — y qué no — te ayuda a decidir dónde encaja en tu pipeline de calidad de datos.
02 · WE DO
Qué valida la API
- FormatoLongitud, juego de caracteres, patrones de prefijo.
- EstructuraReglas posicionales — p.ej., el layout del RFC con 4 letras del nombre + fecha de nacimiento + homoclave.
- Dígito verificadorAplica el algoritmo oficial publicado por cada autoridad emisora.
- Reglas de negocio por paísP.ej., CPFs con todos los dígitos iguales son inválidos aunque el cálculo pase; el prefijo del CUIT codifica el tipo de entidad.
03 · WE DON'T
Qué no valida la API
- ExistenciaLa API no consulta ningún registro. Un CUIT/CPF/RFC válido puede no corresponder a ningún contribuyente registrado.
- IdentidadLa API no confirma que el identificador pertenezca a una persona o empresa específica.
- EstadoLa API no verifica si un tax ID está activo, suspendido o revocado.
- Autenticidad de documentos físicosEl escaneo de documentos basado en imagen (DNI, pasaportes, etc.) está fuera del alcance.
04 · SOURCES
Fuentes
Cada validador se implementa basado en la especificación oficial del algoritmo publicada por la autoridad emisora — AFIP (Argentina), Receita Federal (Brasil), SAT (México), SII (Chile), DIAN (Colombia), SUNAT (Perú), IRS / Service Canada / CRA (EE.UU./Canadá), ISO 13616 para IBAN, y IETF RFC 1035 para dominio. Cuando la documentación oficial entra en conflicto con ejemplos del mundo real, seguimos el algoritmo y registramos la discrepancia.
05 · WHEN TO USE
Cuándo la validación es la herramienta correcta
- Validación de formularios front-end antes de enviar al backend.
- Controles de higiene en el backend antes de persistir datos de clientes.
- Limpieza masiva de registros legacy de CRM/ERP.
- Verificaciones previas antes de enviar a un proveedor de KYC/KYB pago.
06 · ALSO NOT
Cuándo necesitás más que validación
- Verificación de identidadUsá un proveedor regulado de KYC (Persona, Sumsub, Veriff, Onfido, MetaMap).
- Consulta de registro fiscalUsá la API oficial de la agencia (cuando esté disponible) o un proveedor especializado.
- Screening de sanciones / PEPUsá un proveedor de compliance.
07 · DEEP DIVES
Análisis técnico por algoritmo
- Dígito verificador del CUIT — Mod-11 →Pesos, ejemplo numérico paso a paso, casos borde, código Python y JavaScript.
- Dígito de verificación del NIT colombiano — módulo 11 →Pesos [3,7,13,17,19,23,29,37,41] de derecha a izquierda, ejemplo paso a paso, casos borde. Sin consulta a la DIAN.
- Dígito verificador del CPF — doble pasada Mod-11 →Doble pasada Mod-11, ejemplo numérico completo, caso borde de dígitos repetidos, código.
- Dígito verificador del CNPJ — doble pasada Mod-11 →Doble dígito verificador para personas jurídicas, ejemplo trabajado, código.
- Estructura y validación del RFC mexicano →Letras del nombre, fecha YYMMDD, homoclave — qué valida Normadata y qué no.
- IBAN — algoritmo MOD-97 (ISO 13616) →Rearranjar → sustitución de letras → mod 97 = 1. Ejemplo completo, nota sobre BigInt en JS.
- Luhn vs Mod-11: comparativa →Cuándo usar cada uno, comparativa de detección de errores, tabla de identificadores por algoritmo.