---
title: "Employee File"
description: "Usa una hoja de cálculo como fuente de empleados: descarga el archivo de ejemplo, rellena las columnas, súbelo y vuelve a subirlo para actualizar. La forma de usar Pyn sin un HRIS."
sidebar:
  label: Resumen
  order: 0
area: integrations
feature: employee-file
appPath: /settings/integrations/available
lastVerified: 2026-11-09
version: "2026-11-09"
audience: admin
related:
  - integrations
  - directory/employees
  - integrations/sync-and-matching
  - integrations/sample-data
intercom:
  - id: "16755797"
    title: How to Upload Employee Data Manually (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755797-how-to-upload-employee-data-manually-pyn-2
    note: replaces
  - id: "16755703"
    title: Connect  to your HRIS (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16755703-connect-to-your-hris-pyn-2
    note: draws on
  - id: "6024080"
    title: How to upload employee data manually (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6024080-how-to-upload-employee-data-manually-pyn-1
    note: "Pyn 1 article, kept for reference"
translation:
  source: integrations/employee-file/index.mdx
  sourceSha: 5e56e7dc24fde63c7998601735bb3a5093248c35
---

Employee File convierte una hoja de cálculo en tu directorio de empleados. Cada fila es un empleado, cada columna una propiedad de Pyn, y cada carga es tu plantilla completa: las filas se añaden o se actualizan por `employeeId`, y quien falte en el archivo se marca como eliminado de esta fuente. Pyn valida el archivo antes de guardar nada y te dice qué filas y columnas no pudo leer.

## Antes de empezar

- Eres administrador o propietario.
- Prepara un CSV, XLS o XLSX cuyas cabeceras de columna sean los nombres de propiedad de abajo. **Download Sample File** te da un CSV con todas las columnas y cinco filas de ejemplo.
- Cada fila necesita `employeeId` y `primaryEmail`. Para los empleados de un país con varias zonas horarias, indica un `timeZone`; para Estados Unidos, Canadá y Australia basta con un `postalCode` junto con el `country`. Si no, la fila se rechaza.

![La integración Employee File bajo Installed, con el panel de carga abierto.](https://support.pyn.ai/media/integrations/employee-file/integrations-employee-file-tile.png)

## Conecta

1. En Pyn, abre **Settings** en la navegación izquierda y después **Available** bajo **Integrations**.

2. Selecciona el mosaico **Employee File**; su portada dice **File Upload**. Pyn crea la integración y abre su panel: "Upload a spreadsheet of your employees to get started. Use the sample file to see the expected columns." Si la integración no se puede crear, un diálogo titulado **Add Employee File** dice "We could not create the Employee File integration. Please try again or contact support."

3. Selecciona **Download Sample File** y construye tu archivo a partir de él, conservando la fila de cabecera.

4. Selecciona **Upload** y elige tu archivo. El panel muestra **Uploading...** mientras lo valida y lo guarda.

5. Si todo va bien, dice "Success! Uploaded n records. Head over to the Directory to see employees after processing completes. This can take a minute or two."

Si hay filas que fallan, el panel enumera las cinco primeras bajo "There were n errors found in the uploaded file:" con la fila y el problema, y un recuento del resto, por ejemplo `Unknown country: "Engalnd"`, `Could not determine timezone from country "United States". Add a postal code or choose a time zone.` o `Invalid birthday format. Expected MM-dd, dd/MM, yyyy-MM-dd or ISO8601 datetime.` No se guarda nada mientras falle alguna fila. Corrige las filas indicadas y sube el archivo completo otra vez.

## Qué se sincroniza

| Columna | Obligatoria | Notas |
| --- | --- | --- |
| `employeeId` | Sí | Tu id estable para la persona; las cargas se emparejan por él |
| `primaryEmail` | Sí | Correo de trabajo, usado también para emparejar las cuentas de Slack y Google |
| `displayName`, `legalName`, `preferredName`, `jobTitle` | | |
| `personalEmail`, `secondaryEmail`, `avatarUri` | | El correo personal se usa para el pre-boarding |
| `status` | | `active`, `inactive` o `leave`; en blanco significa `active` |
| `startDate`, `terminationDate`, `tenureDate` | | `yyyy-MM-dd` o `yyyy/MM/dd`, o una celda de fecha en un archivo `.xls` o `.xlsx`; una fecha que no existe se rechaza |
| `birthday` | | `MM-dd`, `dd/MM`, `yyyy-MM-dd` o una fecha y hora ISO |
| `country`, `postalCode`, `timeZone` | | El país como nombre o código ISO; la zona horaria como nombre IANA, por ejemplo `Europe/London`. Una celda numérica en un archivo `.xls` o `.xlsx` se lee tal como la muestra la hoja, así que un código postal con formato `00000` conserva sus ceros iniciales |
| `businessUnit`, `department`, `division`, `location`, `team` | | Se convierten en demografías y grupos |
| `managerId`, `buddyId`, `hrbpId`, `mentorId` | | El `employeeId` de la persona relacionada |

No hay actualización programada; el archivo se lee cuando lo subes. La pestaña **Advanced** enumera **Fields in Employee File** con un recuento por columna. También puedes añadir a una persona cada vez con **Add employee** en [Employees](https://support.pyn.ai/es/directory/employees/), que pide **Full name\***, **Preferred name**, **Work email**, **Personal email**, **Start date\***, **Country\***, **Time zone\*** y **Manager**, y la añade como próxima incorporación.

## Pruébalo

Abre [Employees](https://support.pyn.ai/es/directory/employees/) uno o dos minutos después de la carga. Las filas activas aparecen bajo **Active**, las fechas de inicio futuras bajo **Upcoming** y el `status` `inactive` bajo **Inactive**. Abre a una persona para comprobar el enlace con su manager.

## Reconecta o desconecta

No hay credenciales. Sube un archivo nuevo para cambiar los datos, y sube siempre a todo el mundo: una fila ausente en un archivo posterior se marca como eliminada de esta fuente y la persona aparece como inactiva; incluirla en un archivo posterior la recupera con el `status` de esa fila. **Deactivate** conserva los datos pero ignora las cargas; **Activate** las vuelve a habilitar.

## Solución de problemas

| Qué ves | Qué significa |
| --- | --- |
| "The uploaded file was empty" | No hay filas de datos bajo la cabecera, o falta la fila de cabecera. |
| Un error de fila que menciona `country` o `postalCode` | No se reconoció el nombre del país, o el código postal no permitió determinar la zona horaria. Añade `timeZone`. |
| Un manager no está enlazado | `managerId` no coincide con el `employeeId` de ninguna fila. |
| Alguien aparece dos veces | Su `employeeId` y sus correos cambiaron todos entre cargas, así que nada coincidió con el registro anterior. Mantén estables los ids y los correos. |

## Relacionado

- [Integrations](https://support.pyn.ai/es/integrations/) para las alternativas de HRIS.
- [Employees](https://support.pyn.ai/es/directory/employees/) para comprobar los registros cargados y añadir a una persona.
- [Cadencia de sincronización y emparejamiento](https://support.pyn.ai/es/integrations/sync-and-matching/) para saber cómo se emparejan ids y correos.
- [Sample Data](https://support.pyn.ai/es/integrations/sample-data/) para probar Pyn con una plantilla ficticia.
