Ir al contenido principal

Cambio Salarial Administrativo(Empleados Activos (1)) - [getEmployeeActive]

🧾 Descripción

Servicio que obtiene el listado completo de empleados activos desde el ERP.
Solo devuelve empleados cuyo status = "active" y expone información básica:

  • nombre_completo

  • passport_number (DNI u otro documento)

  • name (ID interno del empleado)

Este servicio se utiliza para obtener la lista de empleados habilitados dentro del sistema.

🚀 Endpoint

POST /get-employee-active

📌 El método es POST, pero internamente realiza una consulta GET al ERP.

📥 Request Body

El servicio no requiere parámetros en el body.


{}

Todo se obtiene directamente del ERP mediante ServiceErp().

🔐 Seguridad

Requiere conexión autorizada al ERP.
La autenticación se maneja internamente mediante: $this->general->ServiceErp(...)

🧠 Flujo del Servicio (Resumen Real)

  1. Construye la solicitud hacia el ERP:

GET Employee ?limit=None &fields=["nombre_completo","passport_number","name"] &filters=[["status","=","active"]]

  1. Envía la solicitud al ERP mediante: 

$this->general->ServiceErp('GET', null, $body, APICAPACITACION . 'resource/Employee');


  1. Verifica:

    • Si el ERP respondió con error.

    • Si no existen registros de empleados activos.

  2. En caso de éxito:

    • Devuelve la lista completa de empleados encontrados.

📤 Response 200 – Ejemplo

✅ Caso exitoso

{ "valor": true, "msn": "Busqueda Existosa", "data": [ { "nombre_completo": "Juan Pérez López", "passport_number": "45382910", "name": "HR-EMP-00231" }, { "nombre_completo": "Ana Torres", "passport_number": "72839201", "name": "HR-EMP-00412" } ] }

❗ Error interno del ERP

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

❗ Sin registros encontrados

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

❗ Posibles Errores

1. Error en la llamada al ERP

Ocurre cuando ServiceErp() devuelve valor = false.

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

2. No existen empleados activos

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

3. Error inesperado del servidor

(si se implementara un try/catch)

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

📚 Schemas utilizados

Employee (GET)

Campos usados:

{ "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 with body if response.valor == false: return error if response.data.count == 0: return "No se encontraron registros" return { valor: true, msn: "Busqueda Existosa", data: response.data }

No hay comentarios para mostrar

Volver arriba