Ir al contenido principal

Cambio Salarial Administrativo(Obtener Salario (1)) - [getEmployeeActive]

🧾 Descripción

Este servicio obtiene todos los empleados activos desde el ERP, retornando únicamente la información básica necesaria para listarlos:

  • nombre_completo

  • passport_number

  • name (ID interno del empleado)

Es un servicio de consulta que solo consume los datos de la API del ERP usando ServiceErp().


🚀 Endpoint

GET /get-employee-active

No recibe parámetros en el body; todo se obtiene del ERP.


🔐 Seguridad

Requiere autenticación válida hacia el ERP (manejada internamente por ServiceErp()).


🧠 Flujo del Servicio (Resumen Real)

  1. Construye el body de consulta para el ERP:

    { "limit": "none", "fields": ["nombre_completo", "passport_number", "name"], "filters": [["status", "=", "active"]] }
  2. Realiza el request: GET Employee

  3. Valida:

    • Si hubo error en el ERP → retorna error.

    • Si la respuesta está vacía → retorna mensaje "No se encontraron registros".

  4. Si hay resultados, retorna:

    • valor = true

    • msn = "Busqueda Exitosa"

    • data = lista de empleados activos


📥 Request Body

Este endpoint no recibe body.


{}

📤 Response 200 – Ejemplo

✔️ Con empleados encontrados

{ "valor": true, "msn": "Busqueda Existosa", "data": [ { "nombre_completo": "Juan Pérez", "passport_number": "12345678", "name": "EMP-0001" }, { "nombre_completo": "Ana Torres", "passport_number": "87654321", "name": "EMP-0002" } ] }

❗ Sin registros

{ "valor": false, "msn": "No se encontraron Registros", "data": [] }

❌ Error interno

{ "valor": false, "msn": "Error interno, cominique con soporte", "data": [] }

❗ Posibles Errores

1️⃣ Error del ERP

Ocurre cuando ServiceErp() retorna "valor" => false

{ "valor": false, "msn": "Error interno, cominique con soporte", "data": [] }

2️⃣ No hay registros activos

{ "valor": false, "msn": "No se encontraron Registros", "data": [] }

3️⃣ Error inesperado en servidor

{ "valor": false, "msn": "Error del servidor", "data": [] }

📚 Schemas Usados

📄 Employee (GET)

Campos utilizados:

{ "name": "string", "nombre_completo": "string", "passport_number": "string" }

🗃 Lógica en Pseudo-código

body = { limit: none fields: ["nombre_completo", "passport_number", "name"] filters: [["status","=","active"]] } response = GET ERP Employee if response.valor == false: return error if response.data is empty: return no registros return { valor: true msn: "Busqueda Exitosa" data: response.data }