User/Add

 


POST https://customerapi.geovictoria.com/api/v1/User/Add

 

Descripción

Crear un nuevo usuario en la empresa asociada al token de autenticación. Recibe los datos del usuario en el
body y devuelve el identificador interno del usuario creado. La empresa se determina automáticamente 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 (ej. RUT, DNI, pasaporte). Se valida su formato. Es la llave que identifica al
usuario dentro de la empresa. Requerido.
Name String Nombre del usuario.
LastName String Apellido del usuario.
Email String Correo electrónico corporativo del usuario.
PersonalEmail String Correo electrónico personal del usuario. Opcional.
Enabled String Indica si el usuario queda habilitado. “1” = habilitado, “0” = deshabilitado.
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 del cargo del usuario. Si se envía un código de homologación de cliente, debe existir; en caso
contrario la creación falla. Opcional.
ProfileId String Identificador del perfil de permisos del usuario. Opcional.
WeeklyWorkingHoursCodeId String Código de la jornada de trabajo semanal. Opcional; si se envía y no se resuelve a una jornada válida, la creació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 creación falla. Opcional.
CustomColumn1 / CustomColumn2 / CustomColumn3 String Columnas personalizadas de la empresa. Opcionales.
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 creación falla. Opcional.
Birthdate String Fecha de nacimiento (formato yyyy-MM-dd). Opcional.

Nota: el modelo admite campos adicionales opcionales de configuración avanzada (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",
            "LastName": "Pérez",
            "Email": "juan.perez@empresa.com",
            "Enabled": "1",
            "PositionId": "100",
            "ProfileId": "5",
            "WeeklyWorkingHoursCodeId": "44",
            "GroupIdentifier": "G-01",
            "ContractDate": "2026-01-01"
        }

 

Importante

  • El campo Identifier es obligatorio y se valida su formato; un identificador mal formado
    rechaza la solicitud.
  • La empresa no se envía en el body: se determina a partir del token de autenticación.
  • Los campos de cargo, jornada de trabajo y razón social se
    validan contra los catálogos de la empresa cuando se envían; si el valor no existe, la creación falla.
  • El campo Gender sólo se aplica si la empresa tiene habilitado el privilegio
    correspondiente.

Response

Response Body

La respuesta es un objeto con el resultado de la operación y el identificador del usuario creado:

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 creado.
Response.UserId String Identificador interno del usuario creado (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