Cartera sobrecotizando por CNAE 2025: detectarla con API bulk

Si lleváis una gestoría o un despacho de asesoría fiscal en España, desde el 1 de enero de 2026 tenéis un problema silencioso en cartera: cada cliente autónomo o pyme que no comunicó su nuevo código CNAE 2025 a la Tesorería General de la Seguridad Social antes del 30 de junio de 2025 está, en cada liquidación de cuotas, pagando el tipo de cotización superior entre todos los CNAE 2025 equivalentes a su antigua CNAE 2009. Y, lo más doloroso: las comunicaciones que hagáis ahora no tienen efecto retroactivo, solo surten efecto desde el mes siguiente a la comunicación.

Traducido a euros: cada mes que tardáis en identificar a un cliente afectado y remitir su CNAE 2025 correcto es dinero perdido, para él y para la confianza que tiene depositada en vuestro despacho. En este artículo os explicamos cómo la API Conversor IAE CNAE — en concreto el endpoint POST /api/v1/bulk y el endpoint GET /api/v1/cnae-2009/{code} — os permite escanear toda la cartera en minutos, identificar a los afectados y preparar el flujo de remediación.

El marco regulatorio, en dos párrafos

El Real Decreto 10/2025, de 14 de enero (BOE-A-2025-587) aprobó la CNAE 2025 y estableció que todos los sujetos responsables del ingreso de cuotas de Seguridad Social debían comunicar a la TGSS la equivalencia con su CNAE 2009 antes del 30 de junio de 2025. Quien no lo hizo y mantiene su código antiguo en el sistema RED, desde enero de 2026 se enfrenta a una cotización agravada en contingencias profesionales: la TGSS toma la tabla de equivalencias del INE y aplica, para el CNAE 2009 declarado, el tipo de contingencias más alto entre todos los CNAE 2025 posibles. No es una sanción puntual; es un sobrecoste que se repite en cada liquidación mensual hasta que se comunique el código correcto.

Para una gestoría media con 120 clientes activos, suponer que "solo unos cuantos" están afectados es optimista. Según las circulares profesionales publicadas entre enero y marzo de 2026, una parte no despreciable de autónomos — especialmente los que se dieron de alta antes de 2023 y no han tocado su alta en RED — no han hecho la comunicación. Hacer el cruce manual, cliente a cliente, consultando el buscador del INE y la tabla de equivalencias, es inviable. Por eso la API.

Cómo identifica la API a los clientes afectados

El flujo es simple y se resuelve con dos endpoints:

1. POST /api/v1/bulk — enviáis hasta 50 códigos CNAE de vuestros clientes en una sola petición y os devuelve, para cada uno, el registro oficial. Si el código sigue siendo un CNAE 2009 "vivo" en el sistema, el campo cnae_2009_codes en la respuesta os lo indicará. Los registros CNAE 2025 tienen este campo; los CNAE 2009 "puros" no existen en el catálogo 2025 y devolverán found: false.
2. GET /api/v1/cnae-2009/{code} — para cada cliente con CNAE 2009 detectado, este endpoint os devuelve la correspondencia oficial con CNAE 2025, incluido título y categoría. Es el dato que debéis comunicar a la TGSS vía sistema RED o a través de IMPORTASS.

Ejemplo de petición al endpoint bulk

curl -X POST https://www.conversoriaecnae.es/api/v1/bulk -H "X-API-Key: cvr_tu_clave_api" -H "Content-Type: application/json" -d '{"codes": ["4711", "6820", "8621", "4399", "5610"], "type": "cnae"}'

Con una cartera de 120 clientes, son 3 peticiones bulk (límite de 50 códigos por llamada) y una decena de peticiones individuales al endpoint de correspondencia. Total: menos de 2 minutos. Lo que antes era una tarde entera cruzando PDFs del INE ahora es una tarea cron que puede lanzar el becario.

Cuánto estáis ahorrando a vuestros clientes

Hagamos números redondos. Si un cliente autónomo cotiza por la base mínima, y por no haber comunicado su CNAE 2025 el tipo agravado de contingencias profesionales se traduce en un sobrecoste de entre 4 y 12 euros mensuales (varía según el salto entre CNAE 2009 y los múltiples CNAE 2025 equivalentes), detectarlo y corregirlo en abril le ahorra unos 80 euros de aquí a fin de año. Para un cliente con base reguladora más alta, el número se multiplica por 3. Extendido a una cartera de 50 clientes afectados, estamos hablando de miles de euros anuales que vuestro despacho puede devolver a los clientes solo por haber ejecutado el cruce con la API.

Y hay un beneficio que no sale en la hoja de cálculo: el valor diferencial frente a la competencia. Pocas gestorías están haciendo este cruce de forma proactiva. Llamar a un cliente con "He visto que estás en un tipo agravado desde enero, vamos a corregirlo esta semana" es exactamente el tipo de servicio que genera referidos.

En qué plan está incluido

El endpoint /bulk y el endpoint /cnae-2009/{code} forman parte del plan Profesional (29 €/mes) y superiores. El plan gratuito Desarrollador os da 100 consultas al día contra el endpoint individual /cnae/{code}, más que suficiente para probar la API antes de decidir si compensa el bulk. El alta de la clave gratuita es por correo, sin tarjeta, desde el formulario al final de la documentación oficial de la API.

Las 2 000 peticiones/día del plan Profesional equivalen a verificar hasta 100 000 códigos diarios (50 por petición × 2 000 peticiones). Para cualquier gestoría española, eso es suficiente margen para automatizar toda la cartera sin mirar el contador.

Cómo integrarlo en vuestro flujo de trabajo

Tres patrones que funcionan en despachos reales:

1. Script mensual de chequeo: un cron en vuestro ERP que, el día 1 de cada mes, saca los CNAE de los clientes en cartera y los pasa por /bulk. Los que devuelvan found: false o marquen CNAE 2009 van a una lista de remediación. Genera un CSV que revisa el jefe de despacho.
2. Alerta en alta nueva: cuando dais de alta un autónomo, además de validar su CNAE 2025 contra /cnae/{code}, comprobáis con /cnae-2009/{code} si por error os han dado un código antiguo.
3. Informe trimestral al cliente: un PDF con "Tu CNAE 2025 está correctamente comunicado" o "Pendiente de comunicar — sobrecoste estimado X €/mes", que justifica la cuota que el cliente paga al despacho.

Podéis consultar la tabla de equivalencias IAE-CNAE completa para cruces manuales puntuales, y utilizar el conversor gratuito desde la web para casos individuales, pero para cartera a partir de 30 clientes el endpoint /bulk es la vía natural.

Lee también

• Para el equipo técnico de vuestro ERP o plataforma propia: Integrar la API Conversor IAE CNAE en tu ERP: guía de arquitectura.
• Para compartir con clientes autónomos que llevan ellos mismos su alta: 100 consultas gratis al día: valida tu CNAE sin coste.

Preguntas frecuentes

¿Si un cliente comunica su CNAE 2025 ahora en 2026, recuperamos los meses de sobrecotización pasados?

No. El RD 10/2025 establece de forma expresa que las comunicaciones hechas a partir del 1 de enero de 2026 solo surten efecto respecto a los tipos de cotización desde el primer día del mes siguiente a la comunicación. No hay retroactividad. Por eso cada semana de demora tiene coste real para el cliente.

¿Podemos lanzar el endpoint /bulk desde Excel o Google Sheets sin proyecto de desarrollo?

Sí. Google Sheets con IMPORTDATA o Power Query desde Excel pueden consumir el endpoint individual /cnae/{code}. Para el endpoint /bulk (POST con JSON body) necesitaréis un pequeño script Python o Node, pero nada que no se resuelva en una tarde y que pueda mantener un junior del despacho.

¿Qué pasa con los clientes que tienen varios códigos de cuenta de cotización con CNAE distintos?

Cada CCC se comunica por separado. La API os devuelve el dato oficial por código, así que generar una lista "CCC → CNAE 2025 correcto" es directo. La comunicación a la TGSS se hace por cada CCC desde el sistema RED.

¿Hay un límite mensual o solo diario en el plan Profesional?

Solo diario: 2 000 peticiones por día con reset a las 00:00 UTC. No hay límite mensual adicional, así que podéis concentrar el uso los días de cierre fiscal o de campaña sin penalización.