Actualizar Datos del Usuario (1) - [update-perfil-info]

🧾 Descripción 

 Actualiza la información de perfil del empleado dentro del ERP (doctype Employee ) mediante una petición PUT , modificando uno o varios de los siguientes datos: 

 

 

 Número de celular ( cell_number ) 

 

 

 Correo personal ( personal_email ) 

 

 

 Dirección permanente ( permanent_address ) 

 

 

 Solo actualiza los campos enviados; los no enviados no se modifican. 

 

 🚀 Endpoint 

 

 

 

 

 

 

 PUT / update - date - perfil

 

 

 

 La ruta real depende del archivo routes/api.php . 

 

 

 🔐 Seguridad 

 

 

 Requiere que la app ya tenga autenticación o sesión aplicada. 

 

 

 Internamente el servicio usa ServiceErp (ERPNext API con permiso necesario). 

 

 

 

 📥 Request Body 

 

 

 

 

 

 

 

 

 

 

 

 { 

 "employe" : "HR-EMP-001" , 

 "celular" : "987654321" , 

 "correo" : "example@correo.com" , 

 "direccion" : "Av. Los Olivos 123" 

 } 

 

 

 

 Campos 

 

 

 

 

 

 Campo 

 Tipo 

 Requerido 

 Descripción 

 

 

 

 

 employe 

 string 

 ✔️ Sí 

 ID del empleado en ERPNext ( Employee.name ). 

 

 

 celular 

 string 

 No 

 Nuevo número de celular. 

 

 

 correo 

 string 

 No 

 Nuevo correo personal. (Actualiza personal_email ). 

 

 

 direccion 

 string 

 No 

 Nueva dirección permanente del empleado. 

 

 

 

 

 

 

 🧩 Validaciones 

 

 

 employe vacío → se devuelve error mediante responseValidate() . 

 

 

 Los demás campos son opcionales. 

 

 

 Solo se actualizan los campos enviados. 

 

 

 

 📤 Responses 

 ✔️ 200 – Actualización exitosa 

 

 

 

 

 

 

 

 { 

 "value" : false , 

 "msn" : "Actualizacion Exitosa" , 

 "data" : { 

 ...respuesta del ERPNext...

 } 

 } 

 

 

 

 

 

 

 

 

 

 Nota: El valor "value": false parece un bug en tu código, ya que indica éxito pero devuelve false . Te lo dejo documentado según tu implementación real. 

 

 

 ❌ 400 – Faltan parámetros requeridos 

 Ejemplo cuando no se envía employe : 

 

 

 

 

 

 

 

 

 

 

 

 { 

 "valor" : false , 

 "msn" : "Debe enviar el empleado" , 

 "data" : [ ] 

 } 

 

 

 

 (Respuesta generada por  responseValidate() ) 

 

 🧠 Lógica Interna (Resumen) 

 

 

 Recibe parámetros del request. 

 

 

 Si employe está vacío → error. 

 

 

 Crea un arreglo updateKeys solo con los campos enviados. 

 

 

 Llama a: 

 

 

 

 

 

 

 

 

 PUT /api/ resource /Employee/ {employe}

 

 

 Con el body: 

 

 

 

 

 

 

 

 { 

 "cell_number" : "..." , 

 "personal_email" : "..." , 

 "permanent_address" : "..." 

 } 

 

 

 

 

 

 

 

 

 

 

 Devuelve la respuesta del ERP. 

 

 

 

 📚 Schemas 

 Request 

 

 

 

 

 

 

 

 

 

 

 

 { 

 "employe" : "string" , 

 "celular" : "string (opcional)" , 

 "correo" : "string (opcional)" , 

 "direccion" : "string (opcional)" 

 } 

 

 

 

 Response 

 

 

 

 

 

 

 

 { 

 "value" : "boolean" , 

 "msn" : "string" , 

 "data" : "object (respuesta del ERP)" 

 } 

 

 

 

 

 

 

 

 

 

 🧪 Ejemplo de Uso (curl) 

 

 

 

 

 

 

 

 curl -X PUT https://midominio.com/api/update-date-perfil \

-H "Content-Type: application/json" \

-d '{

 "employe": "EMP-0005",

 "celular": "987654321",

 "correo": "nuevo@correo.com",

 "direccion": "Calle 123"

}'