Prima di utilizzare l'integrazione con il tuo account live, ti consigliamo di testarla prima in un account demo. Se desideri farlo, chiedi al tuo punto di contatto in Factorial i passaggi successivi.
Per fare ciò, prima devi configurare l'integrazione nel tuo ambiente demo di Silae e condurre i test. Una volta confermato che l'integrazione funziona correttamente, verrà implementata nel tuo account live.
Passo dopo passo
1. Verifica la coerenza dei dati tra Factorial e Silae
Controlla che i dati provenienti da Factorial e Silae siano coerenti prima di attivare il connettore.
2. Installa l'integrazione di Silae nel Factorial Marketplace
Nel tuo menu laterale, vai su Scopri → Integrazione → Silae API Connector → Clicca su "Installa."

.png)
.png)
3. Completa le impostazioni, basandoti sulle informazioni che il tuo contabile ha condiviso da Silae:
I codici dei file (corrispondenti all'Entità Legale)
.png)
I codici degli stabilimenti (corrispondenti ai luoghi di lavoro)
.png)
I codici di assenza che l'utente desidera sincronizzare

I codici EVP che l'utente desidera sincronizzare

I codici dei contatori che l'utente desidera regolare in Factorial
cpnAcquis o rttAcquis
Una volta ricevuta la conferma dal tuo punto di contatto in Factorial, l'integrazione sarà pronta per essere utilizzata.
Qui è dove devi completare il codice attraverso le impostazioni:
.png)
I numeri di cartella e i codici di stabilimento sono obbligatori affinché l'integrazione funzioni.
4. Fornisci le informazioni richieste di Silae e Factorial
Per collegare le due piattaforme, avrai bisogno di due chiavi specifiche. Si prega di fare riferimento al nostro link della documentazione tecnica per trovarle:
- 3 chiavi API Silae
- 1 chiave API Factorial
Una volta ottenute le chiavi, devi compilare il nostro modulo di attivazione sicuro:
Dettagli importanti riguardo al modulo:
- Campi obbligatori: Tutti i campi devono essere completati per prevenire errori di integrazione.
- Validazione: Ti verrà chiesto di confermare che tutti i requisiti tecnici siano stati soddisfatti.
- Gestione degli errori: Se le informazioni fornite sono errate, ti verrà chiesto di reinviare o contattare support@fortifydigital.zendesk.com
Sicurezza dei Dati & Privacy
Prendiamo sul serio la sicurezza dei tuoi dati. Una volta inviato il modulo:
- Le tue chiavi vengono automaticamente spostate in un contenitore completamente sicuro.
- Tutti i dati sensibili vengono immediatamente eliminati dallo storage temporaneo (SharePoint).
- Fortify quindi configura l'interfaccia in modo sicuro per tuo conto.
Una volta completata la configurazione, verrà inviata una notifica automatica a:
- Te (il Cliente)
- Il tuo consulente per la busta paga
5. L'integrazione è pronta per essere utilizzata!
Una volta ricevuta la conferma dal tuo punto di contatto in Factorial, l'integrazione sarà pronta per essere utilizzata!
6. Passaggio da Test a Produzione su Silae: Come migrare il tuo ambiente (se non già fatto)
Hai terminato i tuoi test API e tutto funziona perfettamente? Congratulazioni! È ora di passare al tuo ambiente di produzione.
Ecco i passaggi chiave e le regole d'oro per una transizione di successo senza interruzione del servizio.
Caso n°1: Mantieni la stessa configurazione (Aggiornamento semplice)
Se desideri semplicemente sostituire i tuoi file di test con i tuoi file reali senza modificare le tue credenziali API.
- L'azione: Pulisci l'elenco dei file da integrare in produzione.
- La procedura:
- Vai su Silae.
- Vai su Impostazioni Busta Paga (Paramétrage Paie).
- Accedi alla Configurazione dell'account di Test.
- Clicca sulla "moulinette" (Configurazione dell'elenco file).
- Rimuovi/Elimina i file di test.
- Aggiungi i nuovi file di produzione.
- Impatto tecnico: L'ID cliente, il segreto cliente e la subchiave rimangono gli stessi. Non è necessario alcun cambiamento nel tuo codice o nelle tue impostazioni di connessione.
- Chi lo fa? L'integratore o il partner Silae.
Caso n°2: Creazione di una nuova configurazione
Alcuni partner preferiscono "separare" i loro flussi: una configurazione di test dedicata per tutti i loro clienti e una configurazione separata per la produzione.
- Impatto tecnico: In questo scenario, tutte le chiavi saranno diverse e devono essere trasmesse a Fortify tramite il Modulo
- Avviso: Una subchiave è collegata al tuo abbonamento e alle tue credenziali (ID cliente / Segreto cliente). La subchiave della tua configurazione di test non sarà più valida.
- Regola per gli esterni: Se gestisci più clienti, l'ID cliente e il segreto possono essere identici, ma ciascun gruppo di file deve avere la propria subchiave dedicata.
Come richiedere una modifica?
La procedura da seguire dipende dal tuo profilo:
- Sei un Partner/Integratore: Hai la possibilità di modificare i file nelle impostazioni della busta paga come indicato nel Caso n°1.
- Sei un Utente Silae: Devi compilare il modulo di richiesta ufficiale per qualsiasi aggiunta o modifica di una configurazione API.
Le 2 Regole d'Oro
Il passaggio alla produzione implica una comunicazione stretta con i tuoi partner tecnici per prevenire il blocco del connettore.
- Notifica Fortify di ogni cambiamento di chiave. Non appena rigeneri le chiavi o ottieni nuove informazioni di connessione (subchiave modificata, ecc.), è fondamentale informare immediatamente Fortify → support@fortifydigital.zendesk.com
- Dichiara i tuoi nuovi numeri di file. Se aggiungi un nuovo numero di file alla tua configurazione Silae, informa Fortify. Devono imperativamente aggiungere questi numeri al connettore affinché i dati fluiscano correttamente.
Quali dati vengono sincronizzati?
Processo generale per inviare dati a Silae
I dati vengono trasferiti da Factorial a Silae attraverso la nostra sezione "Aggiornamenti Busta Paga dei Dipendenti". Qualsiasi azione tu compia in Factorial che influisce sulla busta paga genererà un aggiornamento del dipendente.
Per garantire che gli aggiornamenti corretti siano sincronizzati, è importante attivare gli aggiornamenti dei dipendenti pertinenti in Factorial. Questi possono includere nuove assunzioni, cambi di contratto, aggiornamenti dei dati personali e assenze. Per fare ciò, vai su Impostazioni > Busta Paga > Aggiornamenti dei Dipendenti e abilita tutti gli aggiornamenti che desideri sincronizzare con Silae.

Quando viene generato un aggiornamento del dipendente, potrai rivederlo e invialo a Silae contrassegnando l'aggiornamento del dipendente come "Completato". I tempi di trasmissione possono variare a seconda del periodo. Ad esempio, se un gran numero di incidenti viene inviato alla fine del mese durante la chiusura della busta paga, l'elaborazione può richiedere fino a 5–10 minuti per essere completata.

Non sarai in grado di vedere in Factorial se i dati sono stati inviati correttamente a Silae. Per verificare, dovrai controllare il record del dipendente in Silae o controllare l'email giornaliera che riassume i dati inviati e identifica eventuali errori.
Sincronizzazione delle nuove assunzioni
Quando viene creato un nuovo dipendente in Factorial, viene creato un aggiornamento del dipendente. Puoi aprirlo e controllare che tutti i dati siano corretti, quindi contrassegnalo come "Completato" per sincronizzare la modifica con Silae.
Il numero di previdenza sociale (o l'indirizzo email per i lavoratori stranieri senza numero), nome, cognome, tipo di contratto e data di inizio sono campi obbligatori. Se questi sono mancanti, la nuova assunzione non sarà creata in Silae.
Altre cose importanti da considerare:
- Quando crei il dipendente e carichi le informazioni sul contratto, assicurati che la data del contratto (ingresso in azienda) e la data di assunzione (ultimo aggiornamento del contratto) siano le stesse in SILAE. Altrimenti, Silae creerà un nuovo contratto, risultando in duplicazione.
- Per i dipendenti senza un numero di previdenza sociale: Il record verrà comunque creato, ma la validazione si baserà sull'indirizzo email invece del numero di previdenza sociale. Pertanto, l'indirizzo email diventa un campo obbligatorio; altrimenti, il profilo del dipendente non può essere creato in Silae.
- La data di nascita e il genere forniti devono essere coerenti con il numero di previdenza sociale.
- Il nome da nubile è obbligatorio. Se lasciato vuoto, il cognome utilizzato sarà trattato come il nome da nubile per evitare di bloccare la creazione.
- Il matricule non deve essere aggiunto in Factorial. Quando la nuova assunzione viene sincronizzata, popoleremo automaticamente il campo matricule in Factorial. Puoi abilitare un'opzione in Silae per garantire l'unicità del numero di personale attraverso più file o gruppi di file se necessario.
- Il motivo di inizio lavoro verrà inviato per default come codice 001: Assunzione, inizio attività, reclutamento diretto o reclutamento tramite concorso (servizio pubblico), inizio distacco, inizio vita culturale (religioni). Puoi modificare questo in Silae, se necessario.
.png)
Il nuovo dipendente sarà aggiunto a Silae con un codice dipendente che segue sequenzialmente il codice più alto esistente nell'account Silae del cliente.
Campi inviati a Silae
-
Dati del dipendente
- Nome
- Cognome
- Numero di previdenza sociale (il cliente deve selezionare il numero di previdenza sociale nel campo numero di identificazione)
- Nome da nubile (se lasciato vuoto in Factorial, il nome verrà sincronizzato anche qui)
- Genere
- Email professionale
- Email personale (se lasciata vuota in Factorial, l'email personale sarà sostituita dall'email professionale)
- Telefono cellulare
- Indirizzo di casa (città, paese, stato, strada, numero e codice postale)
- Codice comune INSEE
- Data di nascita
- Dipartimento di nascita (lo prende dal numero di previdenza sociale e se è al di fuori della Francia, viene inviato come codice “99” e l'utente deve modificarlo manualmente in Silae)
- Codice paese di nascita (lo prende dal numero di previdenza sociale)
- Nazionalità
- IBAN
- BIC
-
Dati del contratto
- Data di ingresso (basata sul campo Data di inizio del contratto di Factorial)
- Data di inizio contratto (basata sulla Data efficace del contratto di Factorial)
- Data di inizio versione contratto (basata sulla Data efficace del contratto di Factorial)
- Data di fine
- Motivo di inizio (motivo sincronizzato per default: 001)
- Stabilimento
- Titolo di lavoro - sotto “altro titolo di lavoro”
- Codice contratto di lavoro (deve essere un tipo di contratto disponibile per default in Factorial)
- Stipendio base (deve essere su base mensile o annuale)
- Per i dipendenti orari → Ore lavorative nel contratto (deve essere su base mensile o settimanale). Popolerà i campi “Ore mensili normali” e “Ore mensili straordinarie” in Silae)
- Per i dipendenti con contratto giornaliero → Numero di giorni
Sincronizzazione delle modifiche ai dati del dipendente e del contratto
Quando i dati del profilo o del contratto di un/a dipendente vengono aggiornati in Factorial, viene creato un aggiornamento del dipendente. Puoi aprirlo e controllare che tutti i dati siano corretti, e poi contrassegnarlo come "Completato" per sincronizzare la modifica con Silae.
I seguenti campi genereranno un aggiornamento del dipendente che può essere sincronizzato con Silae:
- Dati del dipendente
- Cognome
- Nome
- Email professionale
- Telefono cellulare
- Indirizzo di casa (città, paese, stato, via, numero e codice postale)
- Nazionalità (solo il codice viene cambiato, il testo deve essere cambiato manualmente da Silae)
- IBAN
- BIC
- Dati del contratto
- Data di inizio del lavoro
- Data di inizio del contratto
- Data di ingresso
- Data di fine
- Stabilimento
- Qualifica (sotto "altra qualifica")
- Codice del contratto di lavoro (deve essere un tipo di contratto disponibile per impostazione predefinita in Factorial)
- Stipendio base (deve essere lo stipendio mensile o lo stipendio annuale)
- Per i dipendenti orari:
- Ore contrattuali - devono essere inserite le ore mensili o settimanali (queste popoleranno i campi “Ore mensili normali” e “Ore straordinarie mensili” in Silae)
- Per i dipendenti con contratto a giornata:
- Numero di giorni
Importante:
- Quando desideri inviare modifiche contrattuali per un/a dipendente esistente nella tua azienda, assicurati di controllare attentamente le date di inizio del contratto e di inizio del lavoro in Factorial e Silae per evitare di creare accidentalmente un nuovo record di dipendente in Silae
- Le azioni API riguardanti i contratti devono essere impostate rigorosamente nel presente o nel futuro. Nessuna data di contratto precedente deve essere inviata.
Fare ciò interromperà la sincronizzazione e attiverà un "bubble bianca" (stato non calcolato/errore) sui bollettini paga del/dei dipendente/i.
Se ciò accade, segui il processo di risoluzione esatto qui sotto:
-
Identificazione
- Individua il bolla rossa nell'ultimo mese che mostra bolle verdi.
- 🛑 AVVISO CRITICO: Non tentare mai di calcolare un bollettino che mostra una bolla rossa.
- Piano d'azione
Devi eliminare i contratti errati per ripristinare il sistema, segui questa specifica soluzione alternativa:
- La Regola: Un contratto può essere eliminato solo se è cronologicamente l'ultimo nella storia.
- La Soluzione Alternativa: Se il contratto che devi eliminare è bloccato "dietro" un altro, cambia temporaneamente la data del Contratto #1 per farlo diventare successivo al Contratto #2.
- La Cancellazione: Questo trucco spinge il Contratto #1 nella posizione finale, sbloccandolo in modo da poterlo eliminare con successo.
Come creare un'Addendum o semplicemente modificare un contratto
- Creare un'Addendum: Quando si verifica una modifica contrattuale, se desideri creare un nuovo lavoro in Silae, vai alla scheda Contratto nel profilo del tuo/a dipendente su Factorial, fai clic su Nuove Condizioni e inserisci la data della modifica.
- Modificare un contratto: Se desideri apportare una modifica senza creare un nuovo lavoro in Silae, fai clic sui tre punti e seleziona Correggi Condizioni.
Assicurati che la data effettiva corrisponda alla data del lavoro in Silae. Se non lo fa, un nuovo lavoro verrà creato automaticamente in Silae:

Gestire le cessazioni, le estensioni e le successioni dei contratti
Qual è il corretto flusso di lavoro da seguire in Factorial?
Se il dipendente sta lasciando:
- Chiudi il profilo del/dei dipendente/i in Factorial, inserisci la data di fine e il suo motivo; l'entrata di cessazione del contratto apparirà nella sezione "Aggiornamenti" del modulo Stipendi.
Il codice di cessazione del contratto predefinito è impostato automaticamente su 008 in Silae. Se devi cambiarlo, dovrai farlo manualmente in Silae.
Se il dipendente rientra in azienda:
- Riattiva lo stesso profilo per creare la nuova condizione.
.png)
Comportamenti del sistema secondo i diversi scenari di creazione di dipendenti tra Factorial e Silae:
| Caso | Cosa succede | Risultato in Silae | Motivo di assunzione |
|---|---|---|---|
| 1. Creazione di un nuovo dipendente in Factorial (caso normale) | Il dipendente non esiste affatto in Silae | Record del dipendente creato con i dati del contratto | 001 – nuovo contratto |
| 2. Reinviando informazioni da Factorial dopo un errore di inserimento dati durante la creazione del profilo del dipendente | Il dipendente non esiste ancora in Silae, reinviamo le informazioni | Trattato come una nuova assunzione | 001 – nuovo contratto |
| 3. Invio di un incidente contrattuale, il dipendente esiste già in Silae ma senza contratto | Silae ha il dipendente, ma nessun contratto | Trattato come una nuova assunzione | 001 – nuovo contratto |
| 4. Invio di un incidente per una modifica contrattuale, il dipendente esiste con una data di inizio contratto simile in Silae e Factorial | I dati sono coerenti | Aggiornamento semplice del contratto | Nessuna modifica |
| 5. Invio di un incidente per una modifica contrattuale, il dipendente esiste ma la data di inizio contratto differisce tra Factorial e Silae | Le date non corrispondono → conflitto | Creazione di un nuovo lavoro in Silae | 901 – cambio di situazione |
| 6. Invio con un ID dipendente mentre il dipendente non esiste | L'ID dipendente è sconosciuto in Silae | Sincronizzazione fallita | Nessuna modifica |
Sincronizzazione delle assenze
Quando l'assenza di un/a dipendente viene approvata in Factorial, viene creato un aggiornamento del dipendente per la busta paga. Puoi verificare che tutti i dati siano corretti, e poi contrassegnare l'incidente come “Completato” per sincronizzare i dati con Silae.

Controlla che le assenze che desideri inviare siano abilitate nella pagina delle Impostazioni Aggiornamenti Dipendenti e abbiano il codice Silae mappato nella pagina delle Impostazioni di Integrazione (con il solo codice di 3 cifre, senza includere il ‘AB-’)
Tipo di assenze che possono essere sincronizzate
Assenze a mezza giornata, a giornata intera e orarie possono essere sincronizzate. Le assenze che comportano regole complesse (come periodi di attesa, indennità di sicurezza sociale, integrazioni del datore di lavoro o soglie) sono inviate da Factorial ma calcolate in Silae, che in questo caso funge da sistema principale. Silae determina sia la durata compensata che gli importi da pagare.
Altre assenze, generalmente più semplici, sono gestite direttamente in Factorial, che funge da sistema principale — non è necessaria ulteriore elaborazione da parte di Silae.
- Permesso retribuito e RTT devono sempre essere inviati in giorni o mezze giornate.
- Malattia è calcolata da Silae. Se inviata in giorni, viene elaborata automaticamente.
- Assenze orarie devono avere i loro contatori configurati correttamente in ore (es. formazione, permesso di conversione, festività, permesso compensativo, permesso retribuito/non retribuito).
Se vengono inviate più giorni di assenze orarie, il totale delle ore potrebbe non essere visualizzato immediatamente, ma il calcolo è accuratamente riflesso nella busta paga.
Modificare & Eliminare un'assenza sincronizzata
Se hai inviato un'assenza per uno/a dei tuoi/e dipendenti da Factorial a Silae, e nel frattempo il tuo/a dipendente ha eliminato questa assenza dal proprio profilo, l'incidente di assenza verrà riaperto con il messaggio: “L'assenza è stata eliminata”. Contrassegnando questo incidente come completato, l'eliminazione verrà inviata a Silae:
.png)
Trasmissione dei componenti della busta paga
Flusso di lavoro generale
Passo 1 – Identificare i codici EVP in Silae
Elementi variabili della busta paga vengono trasmessi ogni mese da Factorial per l'integrazione in Silae. Ogni EVP in Silae corrisponde a un codice specifico per il cliente. Possono essere trovati sotto Impostazioni > Variabili di Input. I codici EVP da utilizzare sono elencati nella colonna **“Nome”**:
.png)
Assicurati che tutti i tuoi EVP siano elencati in questo menu, ad eccezione delle ore native*.
Questo menu consente anche di eseguire un controllo aggiuntivo a monte per verificare che il codice EVP inviato da Factorial esista in Silae.
Passo 2 – Configurare i codici EVP in Factorial
In Factorial, questi EVP vengono inseriti nello stesso luogo dei codici di assenza, dei numeri di file dei dipendenti e dei codici di stabilimento, sotto i campi “compensazione aggiuntiva”:
.png)
Passo 3 – Inviare l'EVP da Factorial a Silae
Gli EVP vengono inseriti in Factorial e verranno inviati manualmente (tramite un clic su un pulsante) attraverso l'API:
.png)
Requisiti per la Trasmissione EVP
Affinché la sincronizzazione funzioni, devono essere soddisfatti i seguenti requisiti:
- ID dipendente nel profilo del/dei dipendente/i
- Numero di file (codificato per l'entità legale nel marketplace di Factorial)
- Importo inserito nel modulo Compensazione
- Codice EVP nel marketplace di Factorial
Passo 4 – Controllare lo stato dell'integrazione in Factorial
Una volta che i dati sono stati elaborati, lo stato dell'integrazione torna in Factorial:
La risposta deve includere l'ID e lo stato di elaborazione, che può essere una delle seguenti tre opzioni:
- successo – se l'EVP è stato sincronizzato con successo con Silae
- fallito – se un errore tecnico ha impedito la sincronizzazione
- non valido – se i dati inviati sono errati o mancanti
| Caso di Errore Silae | Messaggio di Errore visualizzato | Stato da Restituire | Spiegazione |
|---|---|---|---|
| Formato Dati Non Valido | Carattere inaspettato durante l'analisi del valore | non valido – WrongFormat | I dati inseriti non sono corretti. Controlla il formato. |
| Valore EVP Vuoto | Errore nella conversione del valore {null} | non valido – EmptyCode | Il valore EVP non può essere vuoto. |
| ID Dipendente Mancante o Errato | Nessun dipendente corrisponde all'ID | non valido – MissingID | L'ID del dipendente per la busta paga è mancante o errato. |
| Numero di File Errato | Il valore nell'elenco dei file è nullo o vuoto | fallito – WrongFile | Il numero di file Silae è errato. |
| Periodo VPE Troppo Vecchio | Il periodo VPE è più vecchio del periodo attuale nel file | non valido – WrongPeriod | Il VPE non corrisponde al periodo attuale in Silae. |
| Sottocodice Non Valido | SubscriptionKeyInvalid, Accesso negato | fallito – WrongSubkey | La chiave di sottoscrizione Silae non è valida. |
| Client Secret o Client ID Non Valido | "errore": "invalid_client" | fallito – WrongAPIKey | Il client secret o l'ID del client Silae non sono validi. |
| Codice VPE Non Valido | N/A (confronta con la tabella di Silae) | non valido – WrongEVPCode | Il codice VPE non esiste in Silae. Correggilo. |
Dettagli Aggiuntivi su Tipi Variabili Specifici
*Le ore native
Per le ore, non è necessario inserirle nel menu “Variabili di Input”.
Devi solo assegnare correttamente i codici delle ore Silae in Factorial, a seconda delle categorie utilizzate nella tua configurazione della busta paga.
1. Ore native (codici standard Silae)
Queste ore utilizzano codici Silae predefiniti:
- HN = ore regolari
- HM = ore a tariffa aumentata
- HC = ore complementari
- HCNSTEPA = ore complementari non soggette a TEPA
- HS25 = straordinari al 25%
- HS50 = straordinari al 50%
- HS100 = straordinari al 100%
2. Ore con codici Silae personalizzati
I seguenti codici corrispondono a ore che si basano su configurazioni Silae personalizzate.
Se la tua configurazione utilizza uno di questi, assicurati di riprodurre il codice esatto in Factorial:
| Codice | Codice | Codice | Codice |
|---|---|---|---|
| PHNE | PHNE.1 | HROUTE | HEROUTE |
| 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 | HE | 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 |
Se hai codici personalizzati aggiuntivi non inclusi in questo elenco, ti preghiamo di inviare una richiesta a:
3. EVP mancanti dal menu "Variabili da inserire" di Silae
Affinché le tue variabili possano essere recuperate tramite l'interfaccia, è necessario che siano inserite nel menu “variabili da inserire”.
Le EVP che non sono presenti in questa finestra non possono essere interfacciate.
- Esempio per i buoni ristorante:
Prerequisito: I buoni ristorante devono essere configurati "Numero di buoni ristorante da inserire”:.png)
Passaggi su Silae:
1- Vai su Impostazioni / Variabili da inserire
.png)
2- Controlla se la variabile è presente nella tabella
3- Se la variabile non è presente, fai clic su "Crea una variabile"
.png)
4- Aggiungi la variabile nella parte inferiore della pagina (es.: NbTicket) :
.png)
5- Salva la nuova variabile, sarà visibile nella tabella:
.png)
6- Inserisci il nome della variabile in Factorial nelle Impostazioni di Integrazione Silae (connettore API):
.png)
7- La tua variabile è ora pronta per essere interfacciata tramite il modulo Compensazione
Invio di un Pagamento Anticipato
Se hai bisogno di inviare un pagamento anticipato, devi utilizzare il codice “acompte” nei dati di integrazione di Factorial in modo che possiamo identificare correttamente questo tipo di VPE.
Non esiste nessun codice corrispondente specifico in Silae per i pagamenti anticipati.
Come possono essere recuperati i saldi di ferie maturate da SILAE in Factorial?
L'integrazione recupera i contatori di ferie accumulate da Silae a Factorial secondo le tue necessità, riflettendo le ferie accumulate. I contatori vengono aggiornati tramite la piattaforma KLYR all'inizio del mese successivo, una volta che le tue buste paga sono state validate. Dopo questo aggiornamento, i contatori di ferie pagate (CP) e RTT vengono automaticamente sincronizzati. Per CP, questo include sia i giorni già accumulati nell'anno precedente (N‑1) sia i giorni attualmente accumulati per l'anno corrente (N).
Per la sincronizzazione del saldo ferie, gli ID dipendenti di Silae devono essere presenti e identici in Factorial.
Come recuperare i contatori di ferie accumulate da SILAE a Factorial?
- Prima di attivare i contatori, devi impostare la base dei giorni cumulativi nelle tue politiche di ferie a 0 per disabilitare il calcolo automatico dell'accumulo da parte di Factorial. Vai su Impostazioni > Ferie e Assenze > la tua politica di ferie > Contatore → imposta la Base Giorni Cumulativi a 0.
.png)
ATTENZIONE: Se desideri mantenere i giorni già accumulati nei tuoi contatori precedenti e resettare solo i due contatori relativi al ciclo precedente (Cpn‑1) e al ciclo corrente (Cpn), ti preghiamo di contattare il tuo account manager. Saranno loro a configurarlo per te.
- Inserisci il codice del contatore in Factorial sotto Scopri > Integrazione. Ogni riga corrisponde a un contatore diverso collegato a una politica di ferie.
.png)
- Fai attenzione nelle impostazioni di Factorial a non consentire il riporto dei giorni non utilizzati dall'anno precedente, poiché il calcolo delle ferie accumulate di Silae include i giorni riportati.
- Una volta attivati e completati i codici dei contatori, i contatori accumulati e attualmente in accumulo di Factorial verranno regolati dalle tue azioni su KLYR
Cos'è KLYR e come funziona?
KLYR è la piattaforma utilizzata per sincronizzare i tuoi contatori di ferie da Silae a Factorial. Ecco come funziona:
-
Alla fine di ogni mese, una volta che le tue buste paga sono state validate, devi selezionare:
- Il nome della tua azienda
- Le cartelle paga (entità) che desideri sincronizzare
-
Scegli il mese corretto:
- Seleziona il mese precedente se stai eseguendo questa azione all'inizio del mese successivo.
- Seleziona il mese corrente se hai convalidato le tue buste paga prima della fine del mese.
-
Accesso a KLYR:
- Per dare accesso a qualcuno a KLYR, invia gli indirizzi email delle persone che necessitano di accesso al seguente indirizzo: support@fortifydigital.zendesk.com

Una volta effettuata la regolazione, l'utente vedrà una nota nel contatore di Factorial che dice “Aggiornato automaticamente da Silae + un codice.” Tuttavia, il dipendente non riceverà alcuna notifica.
Se non desideri regolare il contatore in Factorial, puoi semplicemente lasciare il codice vuoto nella pagina delle Impostazioni di Integrazione.
Se Silae ha appena iniziato a calcolare le buste paga, è normale che i contatori non siano stati ancora aggiornati. I contatori mensili vengono presi in considerazione solo una volta che tutte le buste paga sono state validate e stampate.
Ad esempio, se le buste paga sono state calcolate ma non ancora esaminate o stampate, la bolla in alto rimane gialla. Una volta che la bolla diventa verde, le informazioni saranno correttamente aggiornate.
Elenco dei contatori e dei loro codici associati in Silae:
| Codice | Descrizione |
|---|---|
| cpnAcquis | Numero di giorni acquisiti nell'anno precedente (N-1) e numero di giorni attualmente in fase di acquisizione per quest'anno (N) |
| rttAcquis | Numero di RTT acquisiti |
Domande Frequenti
Come puoi confermare se i dati sono stati sincronizzati correttamente con Silae o se c'è stato un errore?
Se si verifica un errore di sincronizzazione, verrà inviato un rapporto di errore al cliente via email. Il cliente deve specificare l'indirizzo email a cui desidera che venga inviato il rapporto.
Questi rapporti forniranno un riepilogo dettagliato di tutti i dati inviati a Silae, insieme allo stato del loro aggiornamento, consentendo all'utente di:
- Verificare che tutti i dati siano stati trasmessi correttamente.
- Identificare e risolvere eventuali problemi riguardanti i dati che non sono stati trasferiti con successo.
Ecco un esempio di un rapporto di errore:
.png)
Cosa succede se un nuovo assunto viene sincronizzato con un Matricule specifico che non esiste in Silae?
Il nuovo assunto NON verrà sincronizzato (verrà restituito un errore).
Cosa succede se un nuovo assunto viene sincronizzato con un Matricule specifico che esiste già in Silae?
I dati del nuovo assunto in Factorial sovrascriveranno i dati del dipendente esistente in Silae.
L'integrazione è bidirezionale?
La maggior parte dei dati viene sincronizzata da Factorial a Silae. Tuttavia, ci sono 2 punti dati specifici che vengono sincronizzati da Silae a Factorial:
- Matricule - sincronizzato a Factorial una volta che il dipendente è creato in Silae
- Contatori di assenze - da aggiornare tramite Klyr in Factorial dopo il calcolo della busta paga in Silae
Cosa succede quando un nuovo dipendente non ha un numero di previdenza sociale?
Affinché un dipendente venga creato in Silae, il numero di previdenza sociale (SSN) deve essere compilato. Se un dipendente non lo ha, deve essere creato manualmente sia in Silae che in Factorial. Una volta assegnato il SSN temporaneo in Silae, dovrai copiarlo e incollarlo in Factorial.
Quali sono gli errori più frequenti?
- I dati di nascita e il numero di previdenza sociale non sono coerenti
- I codici non sono stati compilati nella pagina Marketplace di Factorial.
- Nessun accesso API per alcuni dossier clienti.
Hai bisogno di aiuto?
Per qualsiasi supporto o aiuto riguardante un bug relativo a Factorial: Accedi al portale di supporto qui: Factorial .
Se tutto funziona su Factorial ma non ricevi i dati correttamente su Silae, ti preghiamo di inviare un ticket inviando un'email a support@fortifydigital.zendesk.com.
Se si tratta di un problema o di una modifica riguardo le chiavi API: ti preghiamo di compilare questo modulo: Compila | Creazione API FACTORIAL - SILAE .
Non dimenticare di CC payroll-consultant@factorial.co per garantire che la tua richiesta venga tracciata dai nostri team.