User/Edit

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

Descripción

Edita a un usuario existente 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

• 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"
}

Response

Response Body

Campos	Tipo de dato	Descripción
Success	Booleano	Indica el estado resultante de la operación
Response	Objeto	Indica campos asociados a la respuesta
– UserId	String	Indica el identificador cifrado del usuario editado

Importante

• En Response se devuelve un objeto que incluye el campo UserId.

Códigos

Código	Descripción
200	Éxito
400	Error en el request
500	Error no controlado, contactar a GV

Ejemplo response

{ 
  "Success": true, 
  "Response": { 
    "UserId": "K9Haf2M1uKPRuVPpfwIw9g" 
  } 
}

Postman

Ejemplo 1
Ejemplo 1