---
title: "Propiedades del empleado"
description: "Cada campo de un empleado, las relaciones entre empleados, los ids externos que unen un perfil a sus fuentes, cómo se decide la etapa del ciclo de vida y cómo se resuelve una zona horaria."
sidebar:
  order: 3
area: directory
feature: employees
appPath: /directory/home
lastVerified: 2026-11-15
version: "2026-11-03"
audience: admin
related:
  - directory/employees/fix-missing-details
  - directory/employees/upload-employees-from-a-spreadsheet
  - directory/employee-groups/reference-group-types
intercom:
  - id: "6024089"
    title: "How does Pyn determine a message recipient's time zone?"
    url: https://intercom.help/pyn/en/articles/6024089-how-does-pyn-determine-a-message-recipient-s-time-zone
    note: draws on
translation:
  source: directory/employees/reference-employee-properties.mdx
  sourceSha: 26c518f755f0f65bd8a7a9d1ee1045b6b8884d0a
---

El perfil de un empleado es un conjunto fijo de propiedades más los campos personalizados que añada tu HRIS. La clave de la primera columna es el nombre que usa un token; cuando **Columna de carga** dice Sí, también es la cabecera que lee una carga del Employee File.

## Propiedades

| Clave | Etiqueta | Columna de carga | Notas |
| --- | --- | --- | --- |
| `displayName` | Display Name | Sí | El nombre completo que se muestra en todas partes. |
| `preferredName` | Preferred Name | Sí | Lo usan tokens como el nombre de pila de un saludo. |
| `legalName` | Legal Name | Sí | Para documentos. |
| `jobTitle` | Job Title | Sí | |
| `primaryEmail` | Primary Email Address | Sí, obligatoria | La dirección de trabajo a la que llegan los mensajes. |
| `personalEmail` | Personal Email Address | Sí | Se muestra en cursiva en las listas cuando no hay dirección de trabajo. |
| `secondaryEmail` | Secondary Email Address | Sí | |
| `avatarUri` | Avatar Image | Sí | Una URL. Cuando está vacía se muestran las iniciales. |
| `startDate` | Start Date | Sí | El inicio más reciente o el próximo. `yyyy-MM-dd` o `yyyy/MM/dd`. Gobierna los triggers de Onboarding y de aniversario y la vista Upcoming. |
| `terminationDate` | Termination Date | Sí | `yyyy-MM-dd` o `yyyy/MM/dd`. |
| `tenureDate` | Tenure Date | Sí | El inicio original a efectos de antigüedad, cuando difiere de Start Date. `yyyy-MM-dd` o `yyyy/MM/dd`. |
| `probationEndDate` | Probation End Date | No | Se muestra solo cuando una fuente la proporciona. |
| `birthday` | Birthday | Sí | `MM-dd` en el perfil; una carga también acepta `dd/MM`, `yyyy-MM-dd` y una fecha y hora ISO 8601. |
| `businessUnit`, `department`, `division`, `location`, `team` | Business Unit, Department, Division, Location, Team | Sí | Texto libre. Department, Division, Location y Country son demografías desde el principio. |
| `employmentType` | Employment Type | No | Texto libre como Full-Time o Contractor, de tu HRIS. Una demografía desde el principio. |
| `jobClass` | Job Class | No | Texto libre de ADP; puede convertirse en demografía. |
| `country` | Primary Country | Sí | Código ISO en el perfil; una carga acepta un nombre. |
| `postalCode` | Postal Code | Sí | Se usa para resolver una zona horaria en EE. UU., Canadá y Australia. |
| `timeZone` | Time Zone | Sí | Nombre IANA. |
| `locale` | Locale | No | Etiqueta BCP 47 como `en-US`. Se deduce del país cuando falta. |
| `active` | Active status | Sí, como `status` | **Active**, **Inactive**, **On Leave** o **Removed**. En blanco en una carga significa activo. |
| `stage` | Lifecycle | No | La calcula Pyn; ver más abajo. |
| `exempt` | Exempt Status | No | **Exempt** o **Non-Exempt** (EE. UU.). |
| `workerType`, `employeeType`, `timeType` | Worker Type, Employee Type, Time Type | No | **Contingent Worker** / **Employee**; **Fixed Term** / **PEO** / **Regular**; **Full-Time** / **Part-Time**. De Workday y Rippling. |
| `removed` | Removed | No | Se activa cuando la persona ha desaparecido del sistema de origen. |
| `returningEmployee` | Returning Employee | No | Recontratado tras haberse ido (BambooHR). |
| `missingSsn` | Missing Social Security Number | No | Sí/no, de Workday. Esta fila y las cuatro siguientes aparecen en el perfil solo en los workspaces donde Pyn las ha activado. |
| `orientationDate` | Orientation Date | No | La fecha de orientación de una nueva incorporación, de Workday. |
| `orientationEligible` | Orientation Eligible | No | Sí/no, de Workday. |
| `over401kLimit` | Over-contribution to 401k | No | Sí/no, de Workday. |
| `surveyLink` | Survey Link | No | URL de la encuesta activa de la persona, de Workday. |

Una carga también necesita `employeeId`, tu propio id estable para la fila, y admite las cuatro columnas de relación de abajo. Pyn ignora cualquier otra cabecera, así que una columna como `employmentType` en una hoja de cálculo no establece nada.

Un HRIS puede añadir campos personalizados; aparecen en **Details** antes de los campos estándar, y los de selección única y selección múltiple aparecen en la lista de **Filters**. Una propiedad de texto, booleana o de selección única puede convertirse en demografía: [Crea una demografía](https://support.pyn.ai/es/directory/demographics/create-a-demographic/).

## Relaciones

| Relación | Columna de carga | Para qué sirve |
| --- | --- | --- |
| **Manager** | `managerId` | El destinatario Manager y sus tokens; el grupo de relación **Managers**. |
| **Buddy** | `buddyId` | El destinatario Buddy; el grupo **Buddies**. |
| **HRBP** | `hrbpId` | El destinatario HRBP y sus tokens; el grupo **HRBPs**. |
| **Mentor** | `mentorId` | El grupo **Mentors**. |

Cada columna de carga contiene el `employeeId` de la otra persona en el mismo archivo. Un HRIS aporta sus propios ids y Pyn los empareja. Una relación cuenta para un grupo de relación solo cuando la persona relacionada es un empleado actual.

## Ids externos y fuentes

Pyn empareja los registros en un único perfil a partir del id del propio sistema (un id de empleado de BambooHR, un id de trabajador de Workday, tu `employeeId` en un Employee File) y del correo de la persona, así que una fila de hoja de cálculo y un registro de HRIS con el mismo correo de trabajo se convierten en un solo empleado. Iniciar sesión con un correo que coincide con un perfil vincula el usuario a él.

Cada valor se toma de la primera fuente que lo proporciona, en este orden: respuestas de formularios y envíos por webhook, después Workday, BambooHR, ADP, Greenhouse, Ashby, Rippling, HiBob, y después Employee File. Slack va al final, y solo para el nombre para mostrar, el nombre preferido, el correo principal, la zona horaria y los campos personalizados. El avatar es la excepción: la foto de Slack se usa antes que una de un HRIS. La pestaña **Sources** de un perfil enumera los registros, y **Disconnect** en uno de ellos lo retira de la fusión.

## Cómo se decide la etapa del ciclo de vida

Pyn ordena la fecha de inicio, la fecha de baja y el día de hoy, y lee la etapa a partir del orden:

| Fechas | Etapa |
| --- | --- |
| Eliminado de la fuente | **Terminated**, digan lo que digan las fechas. |
| Fecha de inicio en el futuro (sin baja o con baja anterior) | **Upcoming Joiner** |
| Fecha de inicio en el pasado, sin baja o con baja en el futuro, y no marcado como inactivo | **Current Active Employee** |
| Fecha de inicio en el pasado y marcado como inactivo (o sin fuente de empleo) | **Terminated** |
| Fecha de baja en el pasado | **Terminated** |
| Sin fechas | **Current Active Employee** si está activo; si no, **Terminated** |

"Marcado como inactivo" significa que la fuente de mayor preferencia dice `inactive`, o que ninguna fuente es un sistema de empleo. Slack, Microsoft Teams, Greenhouse y Ashby no lo son: una persona conocida solo por ellos cuenta como inactiva. Un `active` con valor `leave` se muestra como **On Leave** en el registro pero no cambia la etapa: un empleado que ya ha empezado y está de permiso es **Current Active Employee**.

## Cómo se resuelve una zona horaria

1. La zona horaria que proporciona la fuente, si es un nombre IANA válido, una abreviatura reconocida o un nombre de zona horaria de Windows.
2. Si no, el país y el código postal, para EE. UU. (ZIP), Canadá y Australia.
3. Si no, el país, cuando tiene una sola zona horaria.
4. Si no, ninguna. Los mensajes a esa persona se envían en la zona horaria del workspace definida en **Settings** > **Account Settings**, y una carga del Employee File señala la fila para que puedas añadir una zona horaria o un código postal.

## Relacionado

- [Corrige un manager, una zona horaria o un correo que faltan](https://support.pyn.ai/es/directory/employees/fix-missing-details/) para poner bien un valor.
- [Carga empleados desde una hoja de cálculo](https://support.pyn.ai/es/directory/employees/upload-employees-from-a-spreadsheet/) para el archivo que encabezan estas claves.
- [Tipos de grupo](https://support.pyn.ai/es/directory/employee-groups/reference-group-types/) para los grupos construidos a partir de estas propiedades.
