Lista Sucursales (1) - [listSucursalSupervition]

🧾 Descripción

Este servicio obtiene todas las supervisiones realizadas por un Supervisor Nacional, junto con información adicional relacionada a:

El servicio consolida datos procedentes de:

y devuelve una lista enriquecida de supervisiones.

🚀 Endpoint

POST /list-sucursal-supervition

📥 Parámetros de Entrada (Request)

Body / FormData

Parámetro Tipo Obligatorio Descripción
Employe string ✔️ Código del empleado supervisor cuyo historial de supervisiones será consultado.

Ejemplo:

{ "Employe": "EMP-001245" }

🔐 Seguridad

🧠 Flujo del Servicio (Resumen Detallado)

1️⃣ Validar parámetro recibido

Si Employe viene vacío, se retorna un mensaje de validación.

2️⃣ Listar supervisiones creadas por el supervisor

Consulta en el ERP:

GET resource/Check List del Supervisor Nacional 2 Filters: supervisor = Employe Fields: sucursal, fecha, name

3️⃣ Obtener la relación con Tabla Supervisores

Con los name obtenidos, se consulta:

POST send-query-database FROM tabCheck List del Supervisor Nacional 2 spr LEFT JOIN tabTabla supervisores tab ON spr.name = tab.id_doctype WHERE spr.name IN (...) SELECT spr.name, tab.parent

Construye:

4️⃣ Obtener programación de supervisores

Si existen supervisiones relacionadas, consulta:

POST send-query-database FROM tabProgramacion de Supervisores WHERE name IN parents SELECT name, prog_supervisores, fecha_real_de_la_supervicion

Se agrega esta información a cada supervisión detectada.

5️⃣ Unir los datos

Cada supervisión final contendrá:

📤 Response (200 – Ejemplo)

{ "valor": true, "msn": "Lista de Sucursales", "data": [ { "sucursal": "SUC-014", "fecha": "2024-10-03", "name": "CHK-SUP-00045", "supervision": "SUP-NACIONAL-05", "fechaSupervision": "2024-10-04" } ] }

❗ Posibles Errores

1. Supervisor no enviado

{ "valor": false, "msn": "El campo empleado es obligatorio", "data": [] }

2. Error del servicio ERP

{ "valor": false, "msn": "Ocurrio un error al listar", "data": [] }

3. Supervisor sin supervisiones registradas

{ "valor": false, "msn": "No hay ningun registro creado", "data": [] }

📚 Tablas / Recursos involucrados

Check List del Supervisor Nacional 2

Campos usados:

{ "sucursal": "string", "fecha": "date", "name": "string", "supervisor": "string" }

Tabla supervisores

Relación entre registros checklist y programaciones.

Programación de Supervisores

Campos utilizados:

{ "name": "string", "prog_supervisores": "string", "fecha_real_de_la_supervicion": "date" }

🗃 Pseudocódigo del Servicio

if Employe is empty: return error listName = GET Check List supervisor where supervisor=Employe if listName empty: return sin registros names = extract "name" from listName relations = QUERY tabla supervisores WHERE spr.name IN names parents = extract unique parent programaciones = QUERY programacion supervisores WHERE name IN parents merge programaciones into listName return listName enriched
Revisión #1
Creado 2025-11-26 17:25:12 -05 por Elian
Actualizado 2025-11-26 17:28:26 -05 por Elian