Antes de usar la integración con su cuenta real, le recomendamos probarla en una cuenta demo. Si desea hacerlo, consulte con su contacto en Factorial para obtener más información.
Para ello, primero debe configurar la integración en su entorno de demostración de Silae y realizar las pruebas. Una vez confirmado el correcto funcionamiento de la integración, se implementará en su cuenta real.
Paso a paso
1. Verificar la consistencia de los datos entre Factorial y Silae
Verifique que los datos de Factorial y Silae sean consistentes antes de activar el conector.
2. Instalar la integración de Silae en Factorial Marketplace
En la barra lateral, vaya a Descubrir → Integración → Conector API de Silae → Haga clic en "Instalar".

.png)
.png)
3. Complete la configuración según la información que su contable le haya compartido desde Silae:
Los códigos de establecimiento (correspondientes a los lugares de trabajo)
.png)
Los códigos de ausencia que el usuario desea sincronizar

Los códigos EVP que el usuario desea sincronizar

Los códigos de contadores que el usuario desea ajustar en Factorial
cpnAcquis o rttAcquis
Aquí es donde debes completar el código a través de la configuración:
.png)
Los números de carpeta y los códigos de establecimiento son obligatorios para que la integración funcione.
4. Proporcione la información requerida de Silae y Factorial
Recopila toda la información necesaria de tu cuenta de Silae y Factorial y compártela con nuestro socio Fortify:
soporte@fortifydigital.zendesk.com
- De Silae (es posible que su contable necesite ayuda para crearlos en Silae):
- ID de cliente - Clave de dominio de Silae
- Secreto del cliente: clave del modelo de API de Silae
- Clave de configuración de acceso a la API (denominada clave de suscripción o clave maestra): clave para las carpetas de Silae vinculadas a una cuenta de usuario
- Número de archivo SILAE (para conexión en Factorial )
Para obtener orientación adicional, consulte la Guía del usuario de activación de la API de Silae . Si desea probar primero la integración en el entorno de demostración de Silae, solicite ambos (entorno de demostración y producción) al mismo tiempo.
- De Factorial :
- Clave API (debe copiarla una vez generada, ya que solo se muestra una vez en Factorial ). Para obtener más información, consulte el artículo del Centro de ayuda Factorial .
5. ¡La integración está lista para usarse!
Una vez que recibas la confirmación de tu punto de contacto en Factorial , ¡la integración estará lista para ser utilizada!
¿Cómo hacer uso de la integración?
Proceso general para enviar datos a Silae
Los datos se transfieren de Factorial a Silae a través de nuestra sección "Actualizaciones de nómina de empleados" . Cualquier acción que realice en Factorial que afecte a la nómina generará una actualización de empleado.
Para garantizar la sincronización correcta de las actualizaciones, es importante activar las actualizaciones de empleados relevantes en Factorial . Estas pueden incluir nuevas contrataciones, cambios de contrato, actualizaciones de datos personales y ausencias. Para ello, vaya a Configuración > Nómina > Actualizaciones de empleados y active todas las actualizaciones que desee sincronizar con Silae.

Al generar una actualización de empleado, podrá revisarla y enviarla a Silae marcándola como "Completada". Los tiempos de transmisión pueden variar según el período. Por ejemplo, si se envía una gran cantidad de incidencias a final de mes durante el cierre de nómina, el procesamiento puede tardar entre 5 y 10 minutos.
El estado de las actualizaciones de empleados se puede modificar en bloque en Factorial ; sin embargo, esto no es compatible con la integración. Al marcar varias actualizaciones de empleados como Completadas en Factorial , dichas incidencias no se sincronizarán con Silae.

No podrás ver en Factorial si los datos se enviaron correctamente a Silae. Para verificarlo, deberás consultar el registro del empleado en Silae o el correo electrónico diario que resume los datos enviados e identifica cualquier error.
Sincronización de nuevas contrataciones
Al crear un nuevo empleado en Factorial , se crea una actualización. Puede abrirla y comprobar que todos los datos sean correctos, y marcarla como "Completada" para sincronizar el cambio con Silae.
El Número de Seguro Social y el Tipo de Contrato son campos obligatorios . Si se dejan vacíos, el nuevo empleado no se registrará en Silae.
Otras cosas importantes a considerar:
- Al crear el empleado y cargar la información del contrato, asegúrese de que la FECHA DEL CONTRATO coincida en SILAE. De lo contrario, Silae creará un nuevo contrato, lo que resultará en una duplicación.
- Si tiene empleados sin Número de Seguro Social , primero debe crear el empleado en Silae para obtener un número de seguro social provisional (después de la primera nómina) y luego ingresarlo en Factorial . A partir de ese momento, podrá sincronizar los cambios de este empleado de Factorial a Silae.
- La fecha de nacimiento y el género proporcionados deben ser consistentes con el número de seguro social .
- El nombre de nacimiento es obligatorio. Si se deja vacío, el apellido utilizado se considerará el nombre de nacimiento para evitar bloquear la creación.
- No es necesario añadir la matrícula en Factorial . Al sincronizar el nuevo empleado, se completará automáticamente el campo de matrícula en Factorial . Puede habilitar una opción en Silae para garantizar la unicidad del número de personal en varios archivos o grupos de archivos, si es necesario.
- El motivo de inicio del empleo se enviará por defecto con el código 001: Contratación, inicio de actividad, contratación directa o por concurso (servicio público), inicio de destacamento, inicio de vida cultural (religiones). Puede modificarlo en Silae si lo necesita.
.png)
El nuevo empleado se agregará a Silae con un código de empleado que sigue secuencialmente el código existente más alto en la cuenta Silae del cliente.
Campos que se envían a Silae
- Datos de empleados
- Nombre de pila
- Apellido
- Número de seguro social (el cliente debe seleccionar el número de seguro social en el campo de número de identificación)
- Apellido de soltera (si se deja en blanco en Factorial , el nombre también se sincronizará aquí)
- Género
- Correo electrónico profesional
- Correo electrónico personal (si se deja en blanco en Factorial , el correo electrónico personal será reemplazado por el correo electrónico profesional)
- Teléfono móvil
- Dirección de domicilio (ciudad, país, estado, calle, número y código postal)
- Código comunal del INSEE
- Fecha de nacimiento
- Departamento de nacimiento (lo toma del SSN y si está fuera de Francia, se envía como código “99” y el usuario debe editarlo manualmente en Silae)
- Código del país de nacimiento (lo toma del SSN)
- Nacionalidad
- IBAN
- BIC
- Datos del contrato
- Fecha de entrada (basada en el campo Fecha de inicio del contrato de Factorial )
- Fecha de inicio del contrato (basada en la fecha de vigencia del contrato de Factorial )
- Versión del contrato Fecha de inicio (basada en la fecha de vigencia del contrato de Factorial )
- Fecha de finalización
- Motivo de inicio (por defecto motivo sincronizado: 001)
- Establecimiento
- Título del puesto: en “otro título del puesto”
- Código de contrato de trabajo (debe ser un tipo de contrato disponible por defecto en Factorial )
- Salario base (debe ser mensual o anual)
- Para empleados por hora → Horas de trabajo en el contrato (deben ser mensuales o semanales). Se completarán los campos "Horas mensuales normales" y "Horas extra mensuales" en Silae.
- Para empleados con contrato por días → Número de días
Sincronización de cambios de datos de empleados y contratos
Al actualizar el perfil o los datos del contrato de un empleado en Factorial , se crea una actualización. Puede abrirla y comprobar que todos los datos sean correctos, y marcarla como "Completada" para sincronizar el cambio con Silae.
Los siguientes campos generarán una actualización de empleados que se puede sincronizar con Silae:
- Datos de empleados
- Apellido
- Nombre de pila
- Correo electrónico profesional
- Teléfono móvil
- Dirección de domicilio (ciudad, país, estado, calle, número y código postal)
- Nacionalidad (solo se cambia el código, el texto hay que cambiarlo manualmente desde Silae)
- IBAN
- BIC
- Datos del contrato
- Fecha de inicio del empleo
- Fecha de inicio del contrato
- Fecha de entrada
- Fecha de finalización
- Establecimiento
- Título del puesto (en "otro título del puesto")
- Código de contrato de trabajo (debe ser un tipo de contrato que esté disponible por defecto en Factorial )
- Salario base (debe ser el salario mensual o el salario anual)
- Para empleados por horas:
- Horas contractuales: se deben ingresar horas mensuales o semanales (estas completarán los campos “Horas mensuales normales” y “Horas mensuales extra” en Silae)
- Para empleados con contrato por día:
- Número de días
Importante: Cuando desee enviar cambios de contrato para un empleado existente en su empresa, asegúrese de verificar cuidadosamente las fechas del contrato en Factorial y Silae para evitar crear accidentalmente un nuevo registro de empleado en Silae.
Cómo crear una adenda o simplemente modificar un contrato
- Crear una Adenda: Cuando ocurre un cambio de contrato, si deseas crear un nuevo puesto de trabajo en Silae, ve a la pestaña Contrato en el perfil de tu empleado en Factorial , haz clic en Nuevas Condiciones e ingresa la fecha del cambio.
- Modificar un contrato: Si deseas realizar una modificación sin crear un nuevo trabajo en Silae, haz clic en los tres puntos y selecciona Corregir Condiciones .
Asegúrese de que la fecha de entrada en vigor coincida con la fecha del trabajo en Silae. De lo contrario, se creará automáticamente un nuevo trabajo en Silae:

Gestión de finalizaciones, prórrogas y sucesiones de contratos
¿Cuál es el flujo de trabajo correcto a seguir en Factorial ?
Si el empleado se va:
- Cierra el perfil del empleado en Factorial , ingresa la fecha de finalización y su motivo; el registro de terminación del contrato aparecerá en la sección “Actualizaciones” del módulo Nóminas.
El código de rescisión de contrato predeterminado en Silae es 008. Si necesita cambiarlo, deberá hacerlo manualmente en Silae.
Si el trabajador se reincorpora a la empresa:
- Reactiva el mismo perfil para crear la nueva condición .
.png)
Comportamientos del sistema según los diferentes escenarios de creación de empleados entre Factorial y Silae:
| Caso | Lo que sucede | Resultado en Silae | Motivo de empleo |
|---|---|---|---|
| 1. Creación de un nuevo empleado en Factorial (caso normal) | El empleado no existe en absoluto en Silae | Registro de empleado creado con datos del contrato | 001 – nuevo contrato |
| 2. Reenvío de información desde Factorial tras un error de entrada de datos durante la creación del perfil del empleado | El empleado aún no existe en Silae, reenviamos la información | Tratado como una nueva contratación | 001 – nuevo contrato |
| 3. Envío de incidencia de contrato, el empleado ya existe en Silae pero sin contrato | Silae tiene al empleado, pero no contrato | Tratado como una nueva contratación | 001 – nuevo contrato |
| 4. Envío de incidencia por cambio de contrato, el empleado existe con fecha de inicio de contrato similar en Silae y Factorial | Los datos son consistentes | Actualización de contrato simple | Sin cambios |
| 5. Envío de incidencia por cambio de contrato, el empleado existe pero la fecha de inicio de contrato difiere entre Factorial y Silae | Las fechas no coinciden → conflicto | Creación de un nuevo puesto de trabajo en Silae | 901 – cambio de situación |
| 6. Enviar con un ID de empleado mientras el empleado no existe | El ID del empleado es desconocido en Silae | La sincronización falla | Sin cambios |
Sincronización de ausencias
Cuando se aprueba la ausencia de un empleado en Factorial , se crea una actualización de nómina. Puede verificar que todos los datos sean correctos y marcar el incidente como "Completado" para sincronizar los datos con Silae.

Verifique que las ausencias que desea enviar estén habilitadas en la página de Configuración de actualizaciones de empleados y tengan el código Silae asignado en la página de Configuración de integración (solo con el código de 3 dígitos, sin incluir el 'AB-')
Tipos de ausencias que se pueden sincronizar
Se pueden sincronizar las ausencias de media jornada, jornada completa y por hora. Las ausencias que implican reglas complejas (como periodos de espera, prestaciones de la Seguridad Social, complementos del empleador o umbrales) se envían desde Factorial , pero se calculan en Silae , que en este caso actúa como sistema maestro . Silae determina tanto la duración de la compensación como los importes a pagar.
Otras ausencias, generalmente más simples, se gestionan directamente en Factorial , que actúa como sistema maestro , sin que sea necesario ningún procesamiento adicional por parte de Silae.
- Las vacaciones pagadas y el RTT siempre deben enviarse en días o medios días .
- Silae calcula la baja por enfermedad . Si se envía en días, se procesa automáticamente.
- Las ausencias horarias deberán tener sus contadores correctamente configurados en horas (por ejemplo: formación, baja por conversión, festivos, baja compensatoria, baja remunerada/no remunerada).
Si se envían varios días de ausencias por hora, es posible que el total de horas no se muestre inmediatamente , pero el cálculo se refleja con precisión en el recibo de pago .
Modificar y eliminar una ausencia sincronizada
Si ha enviado la ausencia de uno de sus empleados de Factorial a Silae y, mientras tanto, este la ha eliminado de su perfil, la incidencia se reabrirá con el mensaje: " La ausencia ha sido eliminada ". Al marcar esta incidencia como completada, la eliminación se enviará a Silae.
.png)
Ajuste de saldos de tiempo libre acumulado
La integración recupera los contadores de días de vacaciones acumulados de Silae a Factorial según sus necesidades, reflejando la acumulación de días de vacaciones. Los contadores se actualizan a través de la plataforma KLYR a principios del mes siguiente, una vez validadas sus nóminas. Tras esta actualización, los contadores de días de vacaciones pagados (PD) y días de vacaciones pagadas (RTT) se sincronizan automáticamente. En el caso de PD, esto incluye tanto los días acumulados del año anterior (N‑1) como los del año en curso (N).
Para la sincronización del saldo de licencias, los ID de los empleados de Silae deben estar presentes e idénticos en Factorial .
¿Cómo recuperar contadores de licencias acumuladas de SILAE a Factorial ?
- Antes de activar los contadores, debe establecer la base de días acumulados en sus políticas de vacaciones a 0 para desactivar el cálculo automático de acumulación de Factorial . Vaya a Configuración > Vacaciones y Ausencias > su política de vacaciones > Contador → establezca la base de días acumulados a 0.
.png)
ADVERTENCIA : Si desea conservar los días acumulados en sus contadores anteriores y reiniciar solo los dos contadores relacionados con el ciclo anterior (Cpn-1) y el ciclo actual (Cpn), comuníquese con su administrador de cuenta . Él se encargará de configurarlo.
- Introduzca el código del contador en Factorial , en Descubrir > Integración . Cada línea corresponde a un contador diferente vinculado a una política de ausencias.
.png)
- Tenga cuidado en la configuración de su Factorial de no permitir la transferencia de días no utilizados del año anterior, ya que el cálculo de vacaciones acumuladas de CP de Silae incluye los días transferidos.
- Una vez activado y completados los códigos de contador, los contadores Factorial acumulados y en proceso de acumulación se ajustarán según tus acciones en KLYR
¿Qué es KLYR y cómo funciona?
KLYR es la plataforma que se utiliza para sincronizar los contadores de ausencias de Silae con Factorial . Así funciona:
- Al final de cada mes , una vez validados tus nóminas, deberás seleccionar:
- El nombre de su empresa
- Las carpetas de nómina (entidades) que desea sincronizar
- Elija el mes correcto:
- Seleccione el mes anterior si va a realizar esta acción a principios del mes siguiente.
- Seleccione el mes actual si validó sus recibos de sueldo antes de fin de mes.
- Acceso a KLYR:
- Para dar acceso a alguien a KLYR, envíe las direcciones de correo electrónico de las personas que necesitan acceso a la siguiente dirección: support@fortifydigital.zendesk.com

Una vez realizado el ajuste, el usuario verá una nota en el contador Factorial que indica «Actualizado automáticamente por Silae + un código». Sin embargo, el empleado no recibirá ninguna notificación.
Si no desea ajustar el contador en Factorial , simplemente puede dejar el código en blanco en la página de Configuración de integración.
Silae apenas ha comenzado a calcular las nóminas, es normal que los contadores aún no se hayan actualizado. Los contadores mensuales solo se tienen en cuenta una vez que todas las nóminas se han validado e impreso.
Por ejemplo, si las nóminas se han calculado, pero aún no se han revisado ni impreso, la burbuja superior permanece amarilla. Una vez que la burbuja se vuelve verde, la información se actualizará correctamente.
Listado de contadores y sus códigos asociados en Silae:
| Código | Descripción |
|---|---|
| acervo del CPN | Número de días adquiridos el año anterior (N-1) y número de días que se están adquiriendo actualmente para este año (N) |
| rttAcquis | Nombre de RTT acquis |
Transmisión de componentes de nómina
Flujo de trabajo general
Paso 1 – Identificar los códigos EVP en Silae
Los elementos variables de nómina se transmiten mensualmente desde Factorial para su integración en Silae. Cada EVP en Silae corresponde a un código específico del cliente. Se pueden encontrar en Configuración > Variables de entrada. Los códigos EVP a utilizar se listan en la columna **“Nombre”**:
.png)
Asegúrese de que todos sus EVP aparezcan en este menú , con excepción de las horas*.
Este menú también nos permite realizar una comprobación adicional upstream para verificar que el código EVP enviado desde Factorial existe en Silae.
Paso 2 – Configurar códigos EVP en Factorial
En Factorial , estos EVP se ingresan en la misma ubicación que los códigos de ausencia, los números de archivo de empleado y los códigos de establecimiento, bajo los campos de “compensación adicional” :
.png)
Paso 3 – Enviar el EVP de Factorial a Silae
Los EVP se ingresan en Factorial y se enviarán manualmente (mediante un clic de botón) a través de la API:
.png)
Requisitos previos para la transmisión EVP
Para que la sincronización funcione, se deben cumplir los siguientes requisitos previos:
- ID del empleado en el perfil del empleado
- Número de expediente (codificado para la entidad jurídica en el marketplace de Factorial )
- Monto ingresado en el módulo de Compensación
- Código EVP en el marketplace de Factorial
Paso 4 – Verificar el estado de integración en Factorial
Una vez procesados los datos, el estado de integración regresa en Factorial :
La respuesta debe incluir el ID y el estado del procesamiento , que puede ser una de las siguientes tres opciones:
- éxito – si el VPE se sincronizó correctamente con Silae
- falló – si un error técnico impidió la sincronización
- no válido – si los datos enviados son incorrectos o faltan
| Caso de error de Silae | Mensaje de error visto | Estado para regresar | Explicación |
|---|---|---|---|
| Formato de datos no válido | Carácter inesperado al analizar el valor | inválido – Formato incorrecto | Los datos ingresados son incorrectos. Por favor, revise el formato. |
| Valor EVP vacío | Error al convertir el valor {null} | inválido – EmptyCode | El valor EVP no puede estar vacío. |
| ID de empleado faltante o incorrecto | Ningún empleado coincide con la identificación | inválido – MissingID | El ID del empleado de nómina falta o es incorrecto. |
| Número de archivo incorrecto | El valor en la lista de archivos es nulo o está vacío | Falló – WrongFile | El número de archivo de Silae es incorrecto. |
| El período VPE es demasiado antiguo | El período VPE es más antiguo que el período actual en el archivo | inválido – WrongPeriod | El VPE no coincide con el período actual en Silae. |
| Subclave no válida | Clave de suscripción no válida, acceso denegado | Falló – Subclave incorrecta | La clave de suscripción de Silae no es válida. |
| Secreto de cliente o ID de cliente no válidos | "error": "cliente inválido" | Falló – WrongAPIKey | El secreto o ID del cliente de Silae no es válido. |
| Código VPE no válido | N/A (comparar con la tabla de Silae) | inválido – Código EVPC incorrecto | El código VPE no existe en Silae. Por favor, corríjalo. |
Detalles adicionales sobre tipos de variables específicas
* Las Horas
Durante las horas, no es necesario ingresarlas en el menú “Variables de entrada” .
Solo necesitas asignar correctamente los códigos de hora de Silae apropiados en Factorial , dependiendo de las categorías utilizadas en tu configuración de nómina.
1. Horas nativas (códigos estándar de Silae)
Estas horas utilizan códigos Silae predefinidos:
- HN = horas regulares
- HM = horas con tarifa aumentada
- HC = horas complementarias
- HCNSTEPA = horas complementarias no sujetas a TEPA
- HS25 = horas extras al 25%
- HS50 = horas extras al 50%
- HS100 = horas extras al 100%
2. Horas con códigos Silae personalizados
Los siguientes códigos corresponden a horas que dependen de configuraciones personalizadas de Silae .
Si su configuración utiliza alguno de estos, asegúrese de reproducir el código exacto en Factorial :
| Código | Código | Código | Código |
|---|---|---|---|
| Teléfono | PHNE.1 | RUTA | RUTA DEL HÉROE |
| HMOD1 | HREG1 | PHNE25 | PHNE25.1 |
| PHNE50 | PHNE50.1 | PHE | HAC15 |
| HAC | HAC12 | HAC10 | HAC25 |
| HAC05 | HAC20 | HAC10R | HAC07 |
| HAC17 | HAC06 | HC-HT | HC-AS |
| HC05 | HC05-HT | HC25 | HC25-HT |
| HC15 | HC15-HT | HC10 | HC10-HT |
| HC11 | HC10-AS | HC25-AS | HC50-HT |
| HC12 | HC20 | HC20-HT | HC30 |
| HC30-HT | HC20-AS | HC17 | HC11-HT |
| HC12-HT | HC17-HT | HC50 | HC50-AS |
| HC100 | HC100-HT | ÉL | HE25 |
| H500 | H500RR | H500-HT | H500DP |
| H500DP-HT | H500-AS | H510 | H510R |
| H510RR | H510-HT | H512 | H510RX |
| H515 | H515RR | H515-HT | H515RX |
| H520 | H520R | H520RR | H520-HT |
| H520RX | H525 | H525RR | H525-HT |
| H530 | H530R | H530RR | H525-AS |
| H525R-HT | H525DP-HT | H525DP | H525R2 |
| H520-AS | H525R2-HT | H530-HT | H525RX |
| H530RX | H533RX | H533 | H533R |
| H533RR | H533-HT | H535 | H550 |
| H550R | H550RR | H550-HT | H550-AS |
| H550R2 | H550R2-HT | H550RX | H550DP |
| H550DP-HT | H550-D | H575 | HS100 |
Si tiene códigos personalizados adicionales no incluidos en esta lista, envíe una solicitud a:
Envío de un pago por adelantado
Si necesita enviar un pago por adelantado, deberá utilizar el código “acompte” en los datos de integración Factorial para que podamos identificar correctamente este tipo de VPE.
No existe un código correspondiente específico en Silae para pagos por adelantado.
Preguntas frecuentes
¿Cómo puedo confirmar si los datos se han sincronizado correctamente con Silae o si hubo un error?
Si se produce un error de sincronización, se enviará un informe de errores al cliente por correo electrónico. El cliente debe especificar la dirección de correo electrónico a la que desea que se le envíe el informe.
Estos informes proporcionarán un resumen detallado de todos los datos enviados a Silae, junto con el estado de su actualización, permitiendo al usuario:
- Verifique que todos los datos se hayan transmitido correctamente.
- Identifique y resuelva cualquier problema relacionado con los datos que no se transfirieron correctamente.
A continuación se muestra un ejemplo de un informe de error:
.png)
¿Qué pasa si una nueva contratación se sincroniza con una Matrícula específica que no existe en Silae?
La nueva contratación NO se sincronizará (dará un error).
¿Qué pasa si una nueva contratación se sincroniza con una Matrícula específica que ya existe en Silae?
Los datos de la nueva contratación en Factorial sobrescribirán los datos del empleado existente en Silae.
¿La integración es bidireccional?
La mayoría de los datos se sincronizan de Factorial a Silae. Sin embargo, hay dos puntos de datos específicos que se sincronizan de Silae a Factorial :
- Matrícula - se sincroniza con Factorial una vez creado el empleado en Silae
- Contadores de tiempo libre: se ajustan automáticamente en Factorial 5 días después del cálculo de la nómina en Silae
¿Qué sucede cuando un nuevo empleado no tiene un número de seguro social?
Para crear un empleado en Silae, es necesario completar su Número de Seguro Social (NSS). Si no lo tiene, debe crearse manualmente tanto en Silae como en Factorial . Una vez asignado el NSS temporal en Silae, deberá copiarlo y pegarlo en Factorial .
¿Cuales son los errores más frecuentes?
- Los datos de nacimiento y el número de Seguro Social no son coherentes
- Los códigos no se rellenan en la página de Factorial Marketplace.
- No hay acceso a la API para algunos expedientes de clientes.