User/Edit
POST https://customerapi.geovictoria.com/api/v1/User/Edit
Descripción
Modificar un usuario existente de la empresa asociada al token de autenticación. Es una actualización
parcial: sólo se modifican los campos incluidos en el body; los campos que se omiten conservan su
valor actual. El usuario a modificar se ubica mediante su Identifier. La empresa se determina a
partir de las credenciales; no se envía en el request.
Request
Request Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Identifier | String | Identificador único del usuario a modificar (ej. RUT, DNI, pasaporte). Es la llave que ubica al usuario dentro de la empresa. Requerido. |
| Name | String | Nombre del usuario. Opcional. |
| LastName | String | Apellido del usuario. Opcional. |
| String | Correo electrónico corporativo del usuario. Opcional. | |
| PersonalEmail | String | Correo electrónico personal del usuario. Opcional. |
| Enabled | String | Indica si el usuario queda habilitado. “1” = habilitado, “0” = deshabilitado. Opcional. |
| UserCard | String | Número de tarjeta o credencial asociada al usuario. Opcional. |
| Phone | String | Teléfono del usuario. Opcional. |
| Address | String | Dirección del usuario. Opcional. |
| ContractDate | String | Fecha de contrato (formato yyyy-MM-dd). Opcional. |
| EndContractDate | String | Fecha de término de contrato (formato yyyy-MM-dd). Opcional. |
| AdmissionDate | String | Fecha de ingreso/admisión (formato yyyy-MM-dd). Opcional. |
| PositionId | String | Identificador encriptado del cargo del usuario (tal como lo devuelve la API). Opcional. |
| ProfileId | String | Identificador del perfil de permisos del usuario. Opcional. |
| WeeklyWorkingHoursCodeId | String | Identificador encriptado de la jornada de trabajo semanal (tal como lo devuelve la API). Opcional; si se envía y no se resuelve a una jornada válida, la edición falla. |
| WeeklyWorkingHoursCodeDescription | String | Descripción de la jornada de trabajo semanal. Alternativa a WeeklyWorkingHoursCodeId. Opcional. |
| GroupIdentifier | String | Identificador del grupo/planificador al que pertenece el usuario. Opcional. |
| GroupDescription | String | Descripción del grupo. Opcional. |
| CostCenterCode | String | Código del centro de costos. Opcional. |
| IntegrationCode | String | Código de integración externo del usuario. Opcional. |
| UserCompanyIdentifier | String | Identificador externo de la razón social del usuario. Si se envía, debe corresponder a una razón social existente de la empresa; en caso contrario la edición falla. Opcional. |
| CustomColumn1 | String | Columna personalizada 1. Máximo 100 caracteres. Opcional. |
| CustomColumn2 | String | Columna personalizada 2. Máximo 300 caracteres. Opcional. |
| CustomColumn3 | String | Columna personalizada 3. Máximo 300 caracteres. Opcional. |
| IsHiddenForReports | String | “1” oculta al usuario en los reportes, “0” lo muestra. Opcional. |
| Gender | String | Género del usuario (Male, Female, Other). Sólo se procesa si la empresa tiene el privilegio “Permite agregar sexo usuario”; si lo tiene y el valor es inválido, la edición falla. Opcional. |
| Birthdate | String | Fecha de nacimiento (formato yyyy-MM-dd). Opcional. |
Nota: el modelo admite los mismos campos adicionales opcionales de configuración avanzada que el endpoint de
creación (zona horaria, holguras, uso de app, geocerca, enrolamiento biométrico, etc.). Sólo se aplican si se envían
con un valor válido.
{
"Identifier": "12345678-9",
"Name": "Juan Andrés",
"Phone": "+56912345678",
"CostCenterCode": "CC-200"
}
Importante
- El campo Identifier es obligatorio: identifica al usuario que se va a modificar.
- Es una actualización parcial: los campos no incluidos en el body conservan su valor actual,
no se borran. - La empresa no se envía en el body: se determina a partir del token de autenticación.
- Los campos CustomColumn1 (máx. 100), CustomColumn2 y
CustomColumn3 (máx. 300) validan su largo; excederlo rechaza la solicitud. - Los campos PositionId y WeeklyWorkingHoursCodeId se esperan encriptados,
tal como los devuelven los endpoints de consulta.
Response
Response Body
La respuesta es un objeto con el resultado de la operación y el identificador del usuario modificado:
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Success | Boolean | Indica si la operación fue exitosa. |
| Message | String | Mensaje descriptivo del resultado (vacío o informativo en caso de éxito, detalle del error en caso de fallo). |
| Response | Object | Objeto con los datos del usuario modificado. |
| Response.UserId | String | Identificador interno del usuario modificado (valor encriptado). |
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
Ejemplo response
{
"Success": true,
"Message": "",
"Response": {
"UserId": "AbC123XyZ=="
}
}