Pre-validación vs consulta gubernamental
La pre-validación es el filtro barato. La consulta gubernamental es la fuente autoritativa. Corren en secuencia, no en competencia.
La pre-validación (Normadata) corre en milisegundos, cuesta poco, rechaza inputs obviamente inválidos — longitud incorrecta, clase de caracteres incorrecta, dígito verificador incorrecto. La consulta gubernamental habla con el registro oficial (AFIP, Receita Federal, SII, DIAN, SUNAT, etc.) y devuelve existencia + datos de entidad autoritativos. La pre-validación protege a la capa gubernamental del desperdicio y protege tu presupuesto de latencia. Son secuenciales.
Comparación rápida
| Aspecto | Pre-validación (Normadata) | Consulta gubernamental |
|---|---|---|
| Alcance | Forma + dígito verificador + normalización | Existencia + datos de entidad |
| Cobertura LATAM | 10 países, una sola API | Un registro por país |
| Consulta gubernamental | No | Sí |
| Verificación de identidad | No | No (solo datos de entidad) |
| Forma de la respuesta | Envelope Normadata estable | Formato por registro |
| Modelo de precio | Por llamada a la API | Variable — cuota, pago o tarifa del registro |
| Perfil de latencia | Rápida y predecible | Variable, depende del registro |
| Posición en el flujo | Primer filtro | Paso autoritativo |
¿Cuándo usar cada uno?
- Bloquear input malformado en el borde de tu API antes de gastar cuota de consulta gubernamental.
- Un único contrato a través de 10 países de LATAM en vez de una integración por registro.
- Latencia predecible para el 80–95% de casos que no necesitan la fuente oficial.
- Reservar tu cuota de consulta gubernamental para inputs que realmente tienen chances de existir.
- Necesitás existencia autoritativa ("¿este CUIT está realmente registrado hoy?").
- Necesitás datos de entidad — razón social, estado fiscal, domicilio.
- Un flujo regulado lo exige.
- Podés absorber la latencia, cuota y uptime del registro.
Qué hace cada capa
Pre-validación (Normadata): un chequeo rápido y determinístico sobre el identificador mismo. Forma, clase de caracteres, dígito verificador. Latencia típica sub-30 ms. Sin dependencia externa. Consulta gubernamental: una consulta al registro oficial. Devuelve existencia, nombre de entidad, estado, a veces domicilio fiscal. El contrato lo controla el registro gubernamental, no nosotros.
Dónde no compiten
La pre-validación no dice nada sobre si el ID existe. La consulta gubernamental no dice nada sobre si el input estaba bien formado primero. Pre-validación = contrato estable controlado por el vendor; consulta gubernamental = cambia cuando cambia el registro. Pre-validación = uniforme en LATAM; consulta gubernamental = por país por definición. Son capas distintas del mismo flujo.
El patrón en producción: en serie, no en paralelo
Paso 1: Normadata pre-valida el identificador. Si la forma, longitud o dígito verificador falla, retornás error antes de tocar el registro oficial. Paso 2: solo si el input es estructuralmente válido, hacés la consulta gubernamental para confirmar existencia y traer datos de entidad. El resultado: menos cuota consumida en el registro, latencia predecible en la mayoría de requests, y separación clara de responsabilidades.
Ejemplos de código
# Same input. Two layers, run in this order.
# 1) Pre-validation — Normadata
curl -X POST https://api.normadata.io/v1/verify/tax-id \
-H "X-API-Key: nd_..." \
-d '{"value": "20-12345678-9", "country": "AR"}'
# -> { "valid": true, "type": "CUIT", "country": "AR", "formatted": "20-12345678-9" }
# 2) Government lookup — AFIP (or a scraper)
# -> { "estado": "ACTIVO", "razonSocial": "...", "domicilio": {...} }Normadata es la capa de pre-validación: forma, dígito verificador, normalización. No consulta AFIP, Receita Federal, SII, DIAN, SUNAT ni ningún otro registro oficial. La consulta gubernamental es una preocupación separada — usá los servicios oficiales o un scraper específico para cada registro. Normadata todavía está en acceso anticipado y no expone datos de entidad.
Preguntas frecuentes
¿Por qué pagar por dos capas?
Porque saltarse la pre-validación te hace pagar costos de consulta gubernamental sobre input basura. Saltarse la consulta gubernamental te hace confiar en datos de entidad no verificados. Cada capa hace una cosa distinta.
¿Normadata habla con AFIP / Receita?
No. Normadata es la capa de pre-validación. Las consultas gubernamentales son una preocupación separada — usá los servicios oficiales o un scraper específico para cada registro.
¿Qué porcentaje de requests suele fallar la pre-validación?
Depende de tu funnel. Forms públicos ven tasas significativas de input malformado (10-25%); data de back-office o pre-limpiada ve mucho menos. La pre-validación filtra antes de que el costo de la capa autoritativa se dispare.