Consultas sin resultados: 404 en vez de 502

18/09/2026

Hasta hoy, cualquier texto que el SEPE devolviera al rechazar una consulta salía como 502. Eso incluía las respuestas en las que el organismo contesta perfectamente y lo que dice es que no hay nada:

No existen certificados para ese NIF
No se encuentra el documento en esta fecha 19/06/2026. Última fecha disponible para descargar…
No se encontraron datos para la consulta solicitada.

Para una integración eso es indistinguible de un fallo del servicio, así que la respuesta razonable era reintentar — y reintentar una consulta sin resultados devuelve siempre lo mismo.

A partir de ahora:

Código	Cuándo
`404`	El SEPE ha respondido y no hay datos para esa consulta. Respuesta definitiva: no reintentes.
`422`	El SEPE rechaza los datos enviados (por ejemplo, `El NIF/NIE del trabajador es erróneo`).
`502`	El SEPE rechaza la operación por otro motivo, o responde de forma inesperada.
`503`	El SEPE está en mantenimiento (`maintenance: true`).

El cuerpo de la respuesta no cambia: mismo success, message y errors.sepe con el texto del organismo. Solo cambia el código HTTP.

Afecta a todas las consultas del SEPE, y en particular a Duplicado de CERTIFIC@2, Detalle y Datos.

Qué revisar en tu integración: si tratas cualquier 5xx como "reintentar", ahora los 404 y 422 salen de ese camino y dejas de repetir consultas que no van a cambiar. La tabla completa está en Errores del SEPE.