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) 

 

 

 Construye la solicitud hacia el ERP: 

 

 

 

 

 

 

 

 

 

 GET Employee

? limit = None 

&fields=["nombre_completo","passport_number","name"]

&filters=[["status","=","active"]] 

 

 

 

 

 

 

 

 

 

 

 Envía la solicitud al ERP mediante:  

 

 

 

 

 

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

 

 

 

 

 

 

 Verifica: 

 

 

 Si el ERP respondió con error. 

 

 

 Si no existen registros de empleados activos. 

 

 

 

 

 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

}