| Error 401/403 en Peticiones REST | Token expirado, ausencia del token, o falta de scopes. | Revisar headers HTTP de la petición, decodificar JWT para validar vigencia y Audiences/Scopes. | Renovar token en el proveedor (OAuth2). Verificar en application.yaml si el issuer URI es correcto. |
| Error validación XSD / Addenda | Nodos faltantes o namespaces incorrectos en XML. | Revisar logs buscando validaciones de JAXB/Jackson o SAX parser. | Corregir payload JSON para que el ModelMapper o el motor de plantillas complete correctamente la petición. |
| Fallo en Conexión a Base de Datos (Connection Refused) | H2 no inicializó, o PostgreSQL fuera de línea. | Ver traza de HikariCP y logs de inicio de Spring Boot. | Validar credenciales y URL en profile de properties (staging/prod). |
| Error al publicar en Pub/Sub (Timeout) | Credenciales inválidas o tópico inexistente. | Ver logs del PubSubController. | Revisar pub-sub-consumer.json y permisos IAM del Service Account asociado en GCP. |
| No se genera el Jasper (Nomina.jrxml) | Plantilla no encontrada en el Classpath. | Log ResourceNotFoundException. | Asegurar que Nomina.jrxml y dependencias subyacentes están presentes en el /resources final. |