Recent Posts

Recent Comments

Archives

Categories

User/EditBulk

Publicado
Updated
BySantiago






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


Descripción

Editar 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
Email 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á.
Birthdate 8 No String Indica la fecha de nacimiento del usuario en formato yyyyMMdd


Importante

  • Permite editar como máximo 20 usuarios a la vez.
  • Se pueden ver los cambios en Usuarios > Listado de usuarios.
  • Para editar 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
  • Para editar el grupo de un usuario se debe utilizar el campo “CostCenterCode”.
  • El campo “Birthdate” permite calcular automáticamente la edad (“Age”) del usuario.

Ejemplo request


[
    {
        "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",
        "Birthdate": "19991201"  
    },
    {
        "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



Ejemplo response

{
    "Success": true,
    "BulkLoadId": "RX0SJbvEn6z2bGXAd1U-RDMGQ8xGB4mo3yuvyGeLGOz3ABqyGfSS0mvFLMXmk6gb"
}

Postman

Ejemplo 1
Ejemplo 1

Tabla de contenidos