Cambio Salarial Administrativo(Actualizar Salario (1)) - [updateSalarialbyEmployee]

🧾 Descripción 

 Este servicio registra una solicitud de actualización salarial para un empleado. Envía al ERP los nuevos valores de: 

 

 

 Sueldo 

 

 

 Movilidad 

 

 

 Bono nocturno 

 

 

 Fecha de actualización 

 

 

 El servicio solo valida la estructura y los datos requeridos , mientras que el proceso interno de aprobación o registro es manejado por el ERP a través del recurso Cambio Salarial Administrativo . 

 

 🚀 Endpoint 

 POST /update-salarial-by-employee 

 

 📥 Request Body (JSON) 

 Todos los campos son obligatorios . 

 

 

 

 

 

 Campo 

 Tipo 

 Descripción 

 

 

 

 

 empleado 

 string 

 ID del empleado 

 

 

 sueldo 

 number 

 Nuevo sueldo propuesto 

 

 

 movilidad 

 number 

 Nuevo monto de movilidad 

 

 

 bono_nocturno 

 number 

 Monto de bono nocturno 

 

 

 fecha 

 string (YYYY-MM-DD) 

 Fecha de aplicación del cambio salarial 

 

 

 

 

 

 Ejemplo de entrada 

 

 

 

 

 

 

 

 { 

 "empleado" : "EMP-00123" , 

 "sueldo" : "1500" , 

 "movilidad" : "200" , 

 "bono_nocturno" : "150" , 

 "fecha" : "2025-01-15" 

 } 

 

 

 

 

 

 

 

 

 

 🔐 Seguridad 

 Requiere token válido del ERP (interno), administrado desde: 

 

 

 

 

 

 

 

 $this ->general-> ServiceErp () 

 

 

 

 

 

 

 

 

 

 🧠 Flujo del Servicio (resumen real) 

 

 

 Valida que se hayan enviado todos los campos requeridos. Si falta alguno, retorna error. 

 

 

 Valida formato de fecha usando validateDate() . 

 

 

 Construye el body que será enviado al ERP: 

 

 

 

 

 

 

 

 

 

 { 

 "empleado" : "<id>" , 

 "nuevo_sueldo" : "<sueldo>" , 

 "nueva_movilidad" : "<movilidad>" , 

 "nuevo_bono_nocturno" : "<bono nocturno>" , 

 "fecha_de_actualizacion_date" : "<fecha>" 

 } 

 

 

 

 

 

 

 

 

 

 

 Envía la solicitud al ERP :  POST resource/Cambio Salarial Administrativo

 

 

 

 

 

 Devuelve al cliente el resultado , incluyendo la respuesta del ERP. 

 

 

 

 📤 Response 200 – Ejemplo exitoso 

 

 

 

 

 

 

 

 { 

 "valor" : true , 

 "msn" : "¡Excelente! Se ha registrado exitosamente tu solicitud." , 

 "data" : { 

 "name" : "CSA-00045" , 

 "empleado" : "EMP-00123" , 

 "nuevo_sueldo" : "1500" , 

 "nueva_movilidad" : "200" , 

 "nuevo_bono_nocturno" : "150" , 

 "fecha_de_actualizacion_date" : "2025-01-15" 

 } 

 } 

 

 

 

 

 

 

 

 

 

 ❗ Posibles Errores 

 1. Campos faltantes 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese los campos requeridos" 

 } 

 

 

 

 

 

 

 

 

 2. Empleado vacío 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese el empleado" 

 } 

 

 

 

 

 

 

 

 

 3. Sueldo vacío 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese el sueldo" 

 } 

 

 

 

 

 

 

 

 

 4. Movilidad vacío 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese la movilidad" 

 } 

 

 

 

 

 

 

 

 

 5. Bono nocturno vacío 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese el Bono Nocturno" 

 } 

 

 

 

 

 

 

 

 

 6. Fecha inválida 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Ingrese la fecha de actualizacion" 

 } 

 

 

 

 

 

 

 

 

 

 📚 Schemas 

 Cambio Salarial Administrativo (ERP) 

 Body enviado: 

 

 

 

 

 

 

 

 { 

 "empleado" : "string" , 

 "nuevo_sueldo" : "number" , 

 "nueva_movilidad" : "number" , 

 "nuevo_bono_nocturno" : "number" , 

 "fecha_de_actualizacion_date" : "YYYY-MM-DD" 

 } 

 

 

 

 

 

 

 

 

 

 🗃 Lógica en Pseudocódigo 

 

 

 

 

 

 

 

 required = [empleado, sueldo, movilidad, bono_nocturno, fecha]

 if falta alguno:

 return error

 if fecha no válida:

 return error

body = {

 empleado,

 nuevo_sueldo: sueldo,

 nueva_movilidad: movilidad,

 nuevo_bono_nocturno: bono_nocturno,

 fecha_de_actualizacion_date: fecha

}

response = POST ERP Cambio Salarial Administrativo

 return success with response