Employee File
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
Sección titulada «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
employeeIdyprimaryEmail. Para los empleados de un país con varias zonas horarias, indica untimeZone; para Estados Unidos, Canadá y Australia basta con unpostalCodejunto con elcountry. Si no, la fila se rechaza.

Conecta
Sección titulada «Conecta»-
En Pyn, abre Settings en la navegación izquierda y después Available bajo Integrations.
-
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.”
-
Selecciona Download Sample File y construye tu archivo a partir de él, conservando la fila de cabecera.
-
Selecciona Upload y elige tu archivo. El panel muestra Uploading… mientras lo valida y lo guarda.
-
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
Sección titulada «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, 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
Sección titulada «Pruébalo»Abre 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
Sección titulada «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
Sección titulada «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
Sección titulada «Relacionado»- Integrations para las alternativas de HRIS.
- Employees para comprobar los registros cargados y añadir a una persona.
- Cadencia de sincronización y emparejamiento para saber cómo se emparejan ids y correos.
- Sample Data para probar Pyn con una plantilla ficticia.