Como podemos ayudarte?
User/AddBulkLoad
Descripción
Crear uno o varios usuarios con la información proporcionada.
Request
Request Body
| Campos | Largo | Requerido | Tipo de dato | Descripción |
|---|---|---|---|---|
| Identifier | 16 | Sí | String | Identificador único del usuario |
| 200 | Sí | String | Correo electrónico del usuario | |
| Name | 256 | Sí | String | Nombre del usuario |
| Lastname | 100 | Sí | String | Apellido del usuario |
| TimeZone | 30 | No | String | Indica el identificador cifrado de la zona horaria del usuario |
| Address | 100 | No | String | Indica la dirección del usuario |
| Phone | 15 | No | String | Indica el número telefónico del usuario |
| CostCenterCode | 200 | No | String | Indica el código de centro de costos del grupo al que va a pertenecer el usuaro. |
| CustomColumn1 | 100 | No | String | Indica el contenido de la columna personalizada 1 |
| CustomColumn2 | 100 | No | String | Indica el contenido de la columna personalizada 2 |
| CustomColumn3 | 300 | No | String | Indica el contenido de la columna personalizada 3 |
| ContractDate | 14 | No | String | Indica la fecha de inicio de contrato del usuario en formato YYYYMMDDHHMMSS |
| EndContractDate | 14 | No | String> | Indica la fecha de fin de contrato del usuario en formato YYYYMMDDHHMMSS |
| ProfileId | 30 | No | String | Indica el identificador cifrado del perfil que posee el usuario |
| UserScheduler | 30 | No | String | Indica el identificador cifrado de la planificación que posee el usuario |
| StartSchedulerDate | 14 | No | String | Indica la fecha de inicio del planificador del usuario en formato YYYYMMDDHHMMSS |
| UserCompanyIdentifier | 30 | No | String | Indica la razón social cifrada externa del usuario. Permite asociar al usuario a una razón social. |
| WeeklyWorkingHoursCodeId | 30 | No | String | Indica el identificador cifrado del código de jornada del usuario |
| WeeklyWorkingHoursCodeDescription | 50 | No | String | Indica el nombre del código de jornada del usuario |
| PositionId | 30 | No | String | Indica identificador cifrado del cargo que posee el usuario |
| UserCard | 30 | No | String | Indica número de la tarjeta del usuario |
| LegalSundayIndicator | 1 | No | String | Indica si es que al usuario se le aplican los domingos legales. Si tiene un 1 se le aplican y si tiene 0 no se le aplica. |
| PIS | 12 | No | String | Indica el número de programa de integración social del usuario |
| IsHiddenForReports | 1 | No | String | Indica si el usuario esta oculto en los reportes. Si tiene un 1 está oculto y si es 0 no lo está. |
Importante
- Permite crear como máximo 20 usuarios a la vez.
- Se pueden ver los cambios en Usuarios > Listado de usuarios.
- Para crear un usuario es necesario ingresar el campo «Identifier» o «Email», además del campo «Name» y «Lastname».
- El formato de fecha YYYYMMDDHHMMSS se descompone en:
YYYY: Año, por ejemplo: 1987
MM: Mes, por ejemplo: 01
DD: Día, por ejemplo: 13
HH: Hora, por ejemplo: 18
MM: Minuto, por ejemplo: 32
SS: Segundo, por ejemplo 54
En resumen: 19870113183254 - El usuario queda con estado «Activo» por defecto.
- La cantidad de usuarios de la empresa no debe superar el límite permitido (definido por empresa) para crear al usuario.
- No puede crear un usuario si ya existe en la empresa.
- Para asignar al usuario a un grupo se debe utilizar el campo «CostCenterCode».
[
{
"Identifier": "111111118",
"Email": "correoejemplo8@gmail.com",
"Name": "NombreUsuario4",
"LastName": "ApellidoUsuario4",
"TimeZone": "1",
"Address": "Avenida Valdivieso",
"Phone": "111111117",
"CostCenterCode": "base",
"CustomColumn1": "Ejemplo 1",
"CustomColumn2": "Ejemplo 2",
"CustomColumn3": "Ejemplo 3",
"ContractDate": "20240910110000",
"EndContractDate": "20240910110000",
"ProfileId": "Xmr3uj8XMr4Tv2h6Epoecw",
"UserScheduler": "1",
"StartSchedulerDate": "20240901090000",
"UserCompanyIdentifier": "WBlTS2dvAOwN4Kk7XZliiA",
"WeeklyWorkingHoursCodeId": "ZTr3uj8xMr5Tb2h6epOoecw",
"WeeklyWorkingHoursCodeDescription": "base",
"PositionId": "sXRGS9wLs7E5zu09Yqyn3Q",
"UserCard": "123456789",
"LegalSundayIndicator": "1",
"PIS": "123456789",
"IsHiddenForReports": "0"
},
{
"Identifier": "111111119",
"Name": "Pedro",
"LastName": "Jimenez"
}
]
Response
Response Body
| Campos | Tipo de dato | Descripción |
|---|---|---|
| Success | Boolean | Indica True en caso de que la operación finalizó y False en caso de que la operación no se pudo finalizar |
| BulkLoadId | String | Identificador que representa a la operación llevada a cabo |
Importante
- El campo BulkLoadId puede ser usado como parámetro en el endpoint BulkLoadStatus para consultar el detalle de la operación.
Códigos
| Código | Descripción |
|---|---|
| 200 | Éxito |
| 400 | Error en el request |
| 500 | Error no controlado, contactar a GV |
{
"Success": Boolean,
"BulkLoadId": "String"
}Postman
Ejemplo 1
Ejemplo 1
