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. |
| 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.
{
"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=="
}
}