Ir al contenido principal

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ámetro Tipo Obligatorio Descripción
empleado string ✔ Código del empleado a consultar
proceso string ✔ Nombre del proceso a buscar
anio int ✖ Año del proceso (filtrado opcional)
mes int ✖ 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_app ORDER BY fecha DESC LIMIT 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 error if proceso is empty → return error where = [ empleado = input.empleado, proceso = input.proceso ] if anio present: where.year = input.anio if mes present: where.month = input.mes result = DB.historial_procesos_app .where(where) .orderBy(fecha desc) .first() if result is null: return error "No se encontró el proceso" return success + result

No hay comentarios para mostrar

Volver arriba