Changelog
14/10/2026 · Certific@ no disponible: 503 inmediato con Retry-After

Certific@ no disponible: 503 inmediato con Retry-After

14/10/2026

Hasta hoy, cuando el servicio Certific@ del SEPE no estaba disponible, una consulta de certificados de empresa (GET /sepe/certifica) podía tardar unos 12 segundos y acabar en 500 con un mensaje de «Tiempo agotado» que invitaba a revisar el certificado. A partir de hoy la API responde enseguida con 503 Service Unavailable, maintenance: true y la cabecera Retry-After:

HTTP/1.1 503 Service Unavailable
Content-Type: application/json
Retry-After: 120
Respuesta 503
{
  "success": false,
  "message": "SEPE: El servicio Certific@ no está disponible en este momento. Inténtalo de nuevo más tarde.",
  "status": 503,
  "errors": {
    "sepe": ["SEPE: El servicio Certific@ no está disponible en este momento. Inténtalo de nuevo más tarde."]
  },
  "maintenance": true,
  "retry_after": 120
}

Afecta a todos los endpoints de Certific@: enviar el certificado de empresa (POST /sepe/certifica), enviarlo por XML (POST /sepe/certifica/xml), el duplicado (GET /sepe/certifica), el listado (GET /sepe/certifica/list) y el detalle (GET /sepe/certifica/detail).

Mientras el servicio Certific@ siga sin estar disponible, las peticiones siguientes también reciben un 503 de inmediato, a veces con el mensaje SEPE: El SEPE no responde. Inténtelo de nuevo en unos minutos.. En los dos casos, Retry-After (igual que retry_after en el cuerpo) indica los segundos que faltan para que merezca la pena volver a intentarlo.

El formato del cuerpo no cambia (success, message, status, errors, maintenance, retry_after).

Qué revisar en tu integración:

  • Un 503 no es un problema de tu certificado ni de los datos enviados. No cambies de certificado ni corrijas la petición: es una indisponibilidad del SEPE.
  • Espera lo que indique Retry-After y no reintentes en bucle: reintentar antes devuelve el mismo 503.
  • Si tratabas el 500 de Certific@ como un caso aparte, pásalo a la lógica que ya tengas para el 503 con maintenance: true. Los códigos de estado están en Errores del SEPE.