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.
Email 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.

Ejemplo request

{
            "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=="
            }
        }
Tabla de contenidos