# Utilidades(Obtener Proceso de Descarga (1, 2, 3,4,5)) - [show] ## 🧾 Descripción *Este servicio permite **consultar el último registro** almacenado en la tabla `historial_procesos_app` según:* - Empleado - Proceso - (Opcional) Año - (Opcional) Mes Es usado para validar si un empleado ya realizó o no un proceso específico dentro del aplicativo. --- # 🚀 Endpoint **POST** `/show` --- # 📥 Parámetros de Entrada (Request Body)
`{ "empleado": "EMP-0001", "proceso": "descargaContratoTrabajo", "anio": 2025, "mes": 1}`
### 🔎 Descripción de parámetros
ParámetroTipoObligatorioDescripción
empleadostring✔Código del empleado a consultar
procesostring✔Nombre del proceso a buscar
anioint✖Año del proceso (filtrado opcional)
mesint✖Mes del proceso (filtrado opcional)
--- # 🔐 Seguridad Utiliza conexión directa a la base de datos `dbapp`. No requiere token ERP, pero depende de la autenticación interna del backend. --- # 🧠 Flujo del Servicio (Resumen real) 1. **Validar parámetros obligatorios** - Si no se envía *empleado* → retorna error - Si no se envía *proceso* → retorna error 2. **Construir filtros dinámicos** - Base: empleado + proceso - Si llega año → se agrega al `WHERE` - Si llega mes → se agrega al `WHERE` 3. **Consultar la tabla interna** Query sobre:
`historial_procesos_appORDER BY fecha DESCLIMIT 1`
Utiliza `first()` para obtener el último registro. 4. **Validar si existe registro** - Si no existe, devuelve mensaje informando que no se encontró el proceso. 5. **Retornar información del proceso encontrado** Incluye toda la fila obtenida desde la base de datos. --- # 📤 Response 200 – Ejemplos ### ✅ Caso exitoso
`{ "valor": true, "msn": "Proceso encontrado.", "data": { "id": 1524, "empleado": "EMP-0001", "proceso": "descargaContratoTrabajo", "year": 2025, "month": 1, "fecha": "2025-01-03 09:32:11" }}`
### ❌ Faltan parámetros
`{ "valor": false, "msn": "Falta empleado."}`
`{ "valor": false, "msn": "Falta proceso."}`
### ❌ No existe el proceso
`{ "valor": false, "msn": "No se encontró el proceso."}`
--- # ❗ Posibles Errores 1. **No se envía `empleado`**
`{ "valor": false, "msn": "Falta empleado." }`
2. **No se envía `proceso`**
`{ "valor": false, "msn": "Falta proceso." }`
3. **No se encontró el registro**
`{ "valor": false, "msn": "No se encontró el proceso." }`
4. **Error interno de base de datos** (Puede retornar error 500 desde DB, manejado por Laravel) --- # 📚 Estructura usada (historial\_procesos\_app)
`{ "empleado": "string", "proceso": "string", "year": "int", "month": "int", "fecha": "datetime"}`
--- # 🗃 Lógica en Pseudo-código
`if empleado is empty → return errorif proceso is empty → return errorwhere = [ empleado = input.empleado, proceso = input.proceso]if anio present: where.year = input.anioif mes present: where.month = input.mesresult = DB.historial_procesos_app .where(where) .orderBy(fecha desc) .first()if result is null: return error "No se encontró el proceso"return success + result`