TGSS: consultas sin resultados, 404 en vez de 502
17/06/2026
Hasta hoy, cuando el Sistema RED contestaba a una consulta diciendo que no hay nada, la API lo devolvía como 502, igual que un fallo del organismo. Por ejemplo:
SISTEMA RED: Error: 3543* NO EXISTEN DATOS PARA ESTA CONSULTASISTEMA RED: No hay registros para el movimiento seleccionado!SISTEMA RED: No se encontró el informe con la fecha solicitada.SISTEMA RED: No existe información para el período solicitado.SISTEMA RED: Error. El Empleado no está en situación de Alta. Consulte Situación de Empleado en la Empresa
Para una integración eso es indistinguible de una caída, así que lo razonable era reintentar — y reintentar una consulta sin resultados devuelve siempre lo mismo.
A partir de ahora:
| Código | Cuándo |
|---|---|
404 | La TGSS ha respondido y no hay datos para esa consulta. Respuesta definitiva: no reintentes. |
502 | La TGSS rechaza la operación por otro motivo, o responde de forma inesperada. |
El cuerpo de la respuesta no cambia: mismo success, message y errors.tgss con el texto del organismo. Solo cambia el código HTTP.
Afecta a las consultas, informes y duplicados de la TGSS, entre otros: Situación del empleado, Situación del CCC, IDC, Vida laboral del afiliado, Duplicados de documentos TA, Ficheros FIE, Duplicado de maternidad/paternidad, Consultar IT, Consulta de convenios y Formulario A1.
Qué revisar en tu integración: si tratas cualquier 5xx como "reintentar", ahora los 404 salen de ese camino y dejas de repetir consultas que no van a cambiar.