Endpoints / Autenticación
Login
Inicia sesión de usuario y emite un accessToken junto con un refreshToken.
/auth/loginCaso de Uso
Usa este endpoint cuando un usuario necesita ingresar al sistema con el RUC de la empresa, su apodo y su contraseña. Si las credenciales son válidas, obtiene los tokens necesarios para mantener la sesión activa y consumir endpoints protegidos.
Autenticación
No requiere token JWT previo.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
emrucstringobligatorioRUC de la empresa a la que pertenece el usuario.
usapodostringobligatorioApodo del usuario que desea iniciar sesión.
uspasswordstringobligatorioContraseña del usuario.
Reglas de negocio
Validación de acceso
La empresa y el usuario deben coincidir para permitir el ingreso.
Estado de la empresa
La empresa debe estar activa.
Estado del usuario
El usuario debe estar activo.
Acceso concedido
Si las credenciales son correctas, el sistema entrega tokens para continuar la sesión.
Protección de acceso
Si hay varios intentos fallidos, el acceso se bloquea por un tiempo.
Errores esperados
Las credenciales enviadas no son válidas.
Se superó el límite de intentos permitidos; intente de nuevo en 15 minutos.
El body no incluyó el campo obligatorio emruc.
El valor enviado en emruc no tiene un formato válido.
El body no incluyó el campo obligatorio usapodo.
El body no incluyó el campo obligatorio uspassword.
El usuario existe, pero no está habilitado para iniciar sesión.
La empresa existe, pero no está habilitada para permitir el ingreso de usuarios.
Notas de uso
Guarda el accessToken para enviarlo en endpoints protegidos con el formato Authorization: Bearer <token>.
Guarda el refreshToken para renovar la sesión con POST /auth/refresh.
Si el usuario cierra sesión, deja de usar el refreshToken anterior.
Las credenciales inválidas responden con código HTTP 401.