Muestra la información de la cuenta que hace la solicitud a través del token. La información de la cuenta permite conocer generalidades del usuario y de la unidad de negocio a la que pertenece, así como sus permisos y configuraciones activas.

Tipos de cuenta

Existen tres tipos de cuentas principales en la plataforma:

Tipo	Valor	Descripción
Empleados	`empleado`	Personas o colaboradores con un expediente activo dentro de Talentify.
Proveedores	`proveedor`	Usuarios externos con acceso a servicios específicos.
Tempo	`tempo`	Usuarios específicos para terminales de asistencia y reconocimiento facial.

Estructura de la Respuesta

La respuesta se divide en objetos principales que segmentan la identidad, la jerarquía y las reglas de negocio del usuario.

1. Usuario (`usuario`)

Contiene los datos de identidad y perfil del colaborador.

Campo	Tipo	Descripción
`id`	`int`	Identificador único del usuario en el sistema.
`nombre`	`string`	Nombre de pila del usuario.
`primerApellido`	`string`	Primer apellido legal.
`correoElectronico`	`string`	Correo principal vinculado a la cuenta.
`activo`	`boolean`	Estado actual de la cuenta (true/false).
`roles`	`array`	Lista de etiquetas de roles técnicos asignados.
`foto.url`	`string`	Enlace directo a la imagen de perfil del usuario.

2. Unidad de Negocio (`unidad`)

Detalles legales y de configuración de la empresa a la que pertenece el usuario.

Campo	Tipo	Descripción
`nombre`	`string`	Nombre de la empresa o unidad.
`identificacionJuridica`	`string`	Número de registro legal de la entidad.
`pais`	`string`	Código ISO del país de operación (ej: `CRC`).
`ubicacion`	`object`	Datos de localización física y geocerca para marcajes.
`ubicacion.radioDeTolerancia`	`int`	Radio en metros permitido para realizar acciones de asistencia.

3. Nóminas y Ciclos (`nominas`)

Diccionario de objetos que representan las nóminas configuradas y disponibles para el usuario.

formaDePago: Define la frecuencia (ej: MENSUAL, QUINCENAL, BISEMANAL, SEMANAL, HORAS).

moneda: Código de moneda y símbolo (ej: CRC / ₡).

periodo: Contiene las fechas de rige (rigeDesde, rigeHasta) y la fecha límite de pago del ciclo actual.

4. Permisos y Atribuciones

Define el alcance de las acciones que el usuario puede ejecutar en la interfaz.

jefatura: (boolean) Si es true, el usuario tiene la capacidad de supervisar y aprobar solicitudes de subalternos.

administrador: (boolean) Define si tiene acceso total a los módulos de configuración.

permisos: Arreglo de strings con llaves técnicas (slugs) que habilitan funciones específicas (ej: asistencia.tiempo_extra.aprobar).

Configuración de Reglas de Negocio (`configuraciones`)

Valores clave que alteran el comportamiento de los módulos de autoservicio:

PERMITIR_MEDIA_VACACION: Indica si el colaborador puede solicitar fracciones de día.

SALDO_MINIMO_VACACIONES: Cantidad de días negativos que el sistema permite antes de bloquear solicitudes.

TEMPO_HABILITADO: Indica si el módulo de marcaje facial está activo para esta unidad.

Ejemplo de Respuesta (JSON)

{
    "usuario": {
        "id": 509,
        "nombre": "Manfred",
        "tipo": "empleado",
        "activo": true
    },
    "unidad": {
        "nombre": "Empresa de ejemplo",
        "identificacionJuridica": "35434534"
    },
    "jefatura": true,
    "permisos": [
        "asistencia.bitacora.consultar",
        "planilla.nomina.mostrar"
    ]
}

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Este JSON representa la información de la cuenta de un usuario en Talentify. Contiene datos del usuario, la unidad organizacional a la que pertenece, las nóminas disponibles, permisos, configuraciones y otros elementos asociados.

📑 Tabla de Referencia Rápida del JSON: Información de la Cuenta

Campo	Descripción	Ejemplo
usuario.id	Identificador único del usuario	`509`
usuario.nombre	Nombre del usuario	`Manfred`
usuario.primerApellido	Primer apellido	`Juárez`
usuario.segundoApellido	Segundo apellido (puede estar vacío)	``
usuario.correoElectronico	Email del usuario	`prueba@prueba.com`
usuario.nacionalidad	Código de país	`CRC`
usuario.tipoIdentificacion	Tipo de identificación	`01`
usuario.identificacion	Número de identificación	`5435345`
usuario.fechaCreacion	Fecha y hora de creación de la cuenta	`05/04/2024 16:13:32`
usuario.tipo	Tipo de usuario	`empleado`
usuario.administrador	Si es administrador (`true/false`)	`false`
usuario.activo	Estado de la cuenta	`true`
usuario.foto.url	URL de la foto del usuario	`https://.../um.png`
usuario.roles	Lista de roles asignados	`[ "SOPORTE" ]`
usuario.grupos	Lista de grupos asignados	`[ "Administrativo", "Encargado de Tiempo Extra" ]`
unidad.id	Identificador de la unidad	`449`
unidad.nombre	Nombre de la unidad	`Ensensis Lab`
unidad.administrador	Datos del administrador de la unidad	Objeto `usuario`
unidad.casaMatriz	Indica si es casa matriz	`true`
unidad.identificacionJuridica	Número legal de la empresa	`3101660525`
unidad.unidadSuperior	Unidad superior (puede ser `null`)	`null`
unidad.plan.estado	Estado del plan	`activo`
unidad.plan.pagoAutomatico	Pago automático habilitado (`true/false`)	`true`
unidad.logo	Información del logo (id, nombre, ruta, mime, etc.)	Objeto
unidad.pais	Código de país	`CRC`
unidad.correo	Email de contacto	`prueba@prueba.com`
unidad.nombreFacturacion	Nombre usado en facturación	`Prueba lab Facturacion`
unidad.identificacionFacturacion	Identificación fiscal para facturación	`117320037`
unidad.correoFacturacion	Email de facturación	`prueba2@prueba.com`
unidad.poliza	Póliza asociada (puede estar vacío)	``
unidad.telefono	Teléfono de contacto	`32432`
unidad.ubicacion	Datos de ubicación (nombre, lat/lng, dirección, provincia)	Objeto
unidad.subUnidades	Lista de subunidades con su propio administrador	Array
plan.estado	Estado general del plan	`activo`
plan.pagoAutomatico	Indica si hay pago automático	`true`
nominas.<n>.id	Identificador de la nómina	`961`
nominas.<n>.nombre	Nombre de la nómina	`Mensual`
nominas.<n>.formaDePago	Forma de pago (ej. `MENSUAL`, `QUINCENAL`)	`MENSUAL`
nominas.<n>.moneda	Moneda de la nómina	`CRC`
nominas.<n>.simbolo	Símbolo de la moneda	`₡`
nominas.<n>.incluidaEnSeguro	Si está incluida en seguro social	`true`
nominas.<n>.periodo	Información del periodo (inicio, cierre, pago, tipo de cambio)	Objeto
nominas.<n>.fechaCreacion	Fecha de creación de la nómina	`05/04/2024 16:13`
nominas.<n>.fechaActualizacion	Fecha de última actualización	`31/07/2024 16:33`
nominas.<n>.creadoPor	Usuario que creó la nómina	Objeto `usuario`
nominas.<n>.actualizadoPor	Usuario que actualizó la nómina	Objeto `usuario`
jefatura	Indica si el usuario es jefatura (`true/false`)	`false`
permisos	Lista de permisos otorgados	`[ "planilla.nomina.mostrar", "ausencias.vacacion.aprobar" ]`
administrador	Si el usuario es administrador global (`true/false`)	`true`
parametros.fotos	URL base para fotos	`https://dev-talentify.twic.pics`
configuraciones.PERMITIR_MEDIA_VACACION	Permite media vacación (`1/0`)	`1`
configuraciones.SALDO_MINIMO_VACACIONES	Saldo mínimo de vacaciones permitido	`-3`
configuraciones.VACACIONES_PERIODO_INCOMPLETO	Permite vacaciones en periodos incompletos	`1`
configuraciones.EXCEDER_SALDO_VACACIONES	Permite exceder saldo de vacaciones	`1`
configuraciones.DIAS_ANTIGUEDAD_OBLIGATORIOS	Días mínimos de antigüedad para vacaciones	`0`
alertas	Lista de alertas activas (puede estar vacía)	`[]`

Cuenta

Tipos de cuenta

Estructura de la Respuesta

1. Usuario (`usuario`)

2. Unidad de Negocio (`unidad`)

3. Nóminas y Ciclos (`nominas`)

4. Permisos y Atribuciones

Configuración de Reglas de Negocio (`configuraciones`)

Ejemplo de Respuesta (JSON)

Solicitud

Respuestas

📑 Tabla de Referencia Rápida del JSON: Información de la Cuenta

Cuenta

Tipos de cuenta#

Estructura de la Respuesta#

1. Usuario (usuario)#

2. Unidad de Negocio (unidad)#

3. Nóminas y Ciclos (nominas)#

4. Permisos y Atribuciones#

Configuración de Reglas de Negocio (configuraciones)#

Ejemplo de Respuesta (JSON)#

Solicitud

Respuestas

📑 Tabla de Referencia Rápida del JSON: Información de la Cuenta

Tipos de cuenta

Estructura de la Respuesta

1. Usuario (`usuario`)

2. Unidad de Negocio (`unidad`)

3. Nóminas y Ciclos (`nominas`)

4. Permisos y Atribuciones

Configuración de Reglas de Negocio (`configuraciones`)

Ejemplo de Respuesta (JSON)