Ir al contenido
PynPyn

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.

  • 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.
The Installed view with the Employee File panel open, showing Download Sample File and Upload.
La integración Employee File bajo Installed, con el panel de carga abierto.
  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.

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.

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.

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.

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.