Ir al contenido principal

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

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

  2. Los demás campos son opcionales.

  3. 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)

  1. Recibe parámetros del request.

  2. Si employe está vacío → error.

  3. Crea un arreglo updateKeys solo con los campos enviados.

  4. Llama a:


PUT /api/resource/Employee/{employe}

Con el body:

{ "cell_number": "...", "personal_email": "...", "permanent_address": "..." }
  1. 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" }'