Cómo un banco regional español clasifica el IAE de sus clientes empresa con una API

Cada vez que un banco abre una cuenta a una empresa o a un autónomo, su área de cumplimiento necesita responder una pregunta aparentemente sencilla: ¿a qué se dedica este cliente? La respuesta vive en un código IAE, lo publica la Agencia Tributaria y de él dependen la segmentación comercial, la tarificación de comisiones y, sobre todo, el expediente KYB que el supervisor revisará el día menos pensado. Lo que parece un campo más del formulario de alta esconde un coste operativo que crece linealmente con el número de altas.

El reto

La fuente oficial del IAE son los Reales Decretos Legislativos 1175/1990 y 1259/1991, reformados sin pausa en sucesivas Leyes de Presupuestos. La AEAT publica las tarifas en formato PDF, agrupadas por secciones, divisiones, agrupaciones, grupos y epígrafes. Para un analista de back-office, clasificar correctamente significa abrir el PDF, descender cuatro niveles, contrastar con la actividad declarada por el cliente y elegir entre varios epígrafes que se solapan. El tiempo medio interno se sitúa entre 5 y 15 minutos por cliente — los 15 cuando hay colisión entre secciones, un caso típico entre servicios profesionales y comercio.
Pero el coste no es solo de tiempo. Un error de clasificación tiene consecuencias regulatorias: si el IAE registrado en el alta del cliente no concuerda con su CNAE en Seguridad Social, salta una alerta automática en los cruces SEPBLAC y AEAT, y abre la puerta a sanciones que la entidad asume vía la responsabilidad solidaria del proveedor de cuenta. Multiplicado por miles de altas al mes, el problema deja de ser fricción operativa y pasa a ser un riesgo presupuestable.
A esto se suma el factor compuesto: cada vez que la tarifa cambia — el último ajuste llegó con la Ley de Presupuestos de 2026 — los manuales internos quedan obsoletos en silencio, y nadie lo detecta hasta la siguiente auditoría interna.

La solución

El equipo de datos del banco integró la API Conversor en su pipeline KYB durante una jornada de trabajo. La pieza principal es una llamada HTTP única:
```bashcurlhttps://api.conversoriaecnae.es/v1/iae/5013\ -H "x-api-key: $API_KEY"```
La respuesta incluye el título oficial del epígrafe, la sección y agrupación, el código CNAE 2025 equivalente, las notas oficiales del Real Decreto, los aliases por los que los clientes finales suelen describir su actividad y un identificador de versión para auditoría.
Para procesar lotes — el caso real del banco — el patrón es un *map* asíncrono sobre los códigos del día:

pythonimport asyncio, httpx, os
API_KEY = os.environ["CONVERSOR_API_KEY"]HEADERS = {"x-api-key": API_KEY}BASE = "https://api.conversoriaecnae.es/v1"
asyncdeffetch_iae(client, code): r = await client.get(f"{BASE}/iae/{code}", headers=HEADERS, timeout=5.0) r.raise_for_status()return r.json()
asyncdefenrich(codes):asyncwith httpx.AsyncClient(http2=True) as client:returnawait asyncio.gather(*(fetch_iae(client, c) for c in codes))
# enriched = asyncio.run(enrich(["5013", "6820", "8499"]))

Lo que el banco pone encima de esta capa es trivial: un job nocturno que recoge los códigos pendientes de validación, los enriquece en paralelo y deja en el data warehouse un snapshot inmutable con marca temporal. Cuando el supervisor pide trazabilidad en una inspección, el equipo de cumplimiento exporta el snapshot y demuestra el origen de cada clasificación, citando como fuentes la propia AEAT (Real Decreto Legislativo 1175/1990, reforma vigente publicada en el BOE como BOE-A-2004-4214) y el INE para la correspondencia con CNAE 2025.
La arquitectura aporta tres ventajas que la solución manual no podía dar: latencia constante por debajo de 300 ms con HTTP/2, idempotencia — el mismo código devuelve siempre la misma respuesta con el mismo identificador de versión — y desacoplamiento. Si mañana la AEAT publica un nuevo Real Decreto, el banco no toca su código: la API actualiza la versión y los siguientes snapshots reflejan el cambio automáticamente.

Los resultados

Los números son los reales medidos en producción durante los primeros 4 días hábiles:

| Métrica | Valor |

------------------

| Llamadas totales a `/api/v1/iae/{code}` | 282 |

| Distribución diaria | 33 → 141 → 114 → 40 |

| Errores 5xx | 0 |

| Tasa de rate-limit | 0 % (plan profesional, 2.000 req/día) |

| Latencia media observada | < 300 ms |

| Tiempo por clasificación (antes / después) | 5 min / 0,3 s |

El día 2, con 141 llamadas, marca el momento en que el equipo migró la cola pendiente desde el proceso manual al pipeline automático. A partir del día 4 la cadencia se estabiliza en torno a 40 llamadas diarias — el flujo orgánico de altas. Lo que antes consumía una tarde completa de un analista por cada lote semanal pasó a resolverse durante la madrugada sin intervención humana.

Privacidad y cumplimiento

La API registra exclusivamente la plantilla de la ruta — `/api/v1/iae/{code}` — y nunca el código resuelto. Esto significa que ni siquiera Conversor puede reconstruir qué IAE consultó el banco para cliente alguno. La decisión de diseño es deliberada: cumple con el principio de minimización del RGPD (Art. 5.1.c) y elimina por construcción la posibilidad de filtración de la base de clientes del banco a través de los logs de uso del proveedor.

"Pasamos de leer tablas AEAT a una llamada HTTP. La integración tardó un día." — Equipo de datos, banco regional español

¿Es tu equipo el siguiente caso?

Si tu organización integra cuentas empresariales, validaciones censales o enriquecimiento de actividad económica, la API Conversor ofrece un plan gratuito (500 req/día) para probarla en tu flujo antes de cualquier compromiso.

Solicitar acceso a la API