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 contatto in Factorial quali sono i prossimi passi.
Per fare ciò, prima devi configurare l'integrazione nel tuo ambiente demo Silae e condurre i test. Una volta confermato che l'integrazione funziona correttamente, sarà 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 sidebar, vai su Scopri → Integrazione → Connettore API Silae → Clicca su "Installa."

.png)
.png)
3. Completa le impostazioni, basandoti sulle informazioni che il tuo commercialista ha condiviso da Silae:
I codici file (corrispondenti all'Entità Legale)
.png)
I codici di stabilimento (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 contatto in Factorial, l'integrazione sarà pronta per essere utilizzata.
Qui è dove devi completare il codice attraverso le impostazioni:
.png)
I numeri delle cartelle 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 consultare il nostro link alla 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 trasferite in un contenitore completamente sicuro.
- Tutti i dati sensibili vengono immediatamente eliminati dalla memoria temporanea (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 paghe
5. L'integrazione è pronta per essere utilizzata!
Una volta ricevuta la conferma dal tuo 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 completato 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 cambiare le tue credenziali API.
- L'azione: Pulisci l'elenco dei file da integrare in produzione.
- La procedura:
- Vai su Silae.
- Vai su Impostazioni Paghe (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 è necessaria alcuna modifica nel tuo codice o nelle impostazioni di connessione.
- Chi lo fa? L'integratore o il partner Silae.
Caso n°2: Creare una nuova configurazione
Alcuni partner preferiscono "dividere" 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
- Attenzione: 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 esterni: Se gestisci più clienti, l'ID cliente e il segreto possono essere identici, ma ogni 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 paghe 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 modifica delle chiavi. 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 assolutamente 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 Stipendi dei Dipendenti". Qualsiasi azione che intraprendi in Factorial che influisce sulle paghe genererà un aggiornamento del dipendente.
Per garantire che gli aggiornamenti corretti siano sincronizzati, è importante attivare gli aggiornamenti dei dipendenti rilevanti in Factorial. Questi possono includere nuove assunzioni, modifiche contrattuali, aggiornamenti dei dati personali e assenze. Per fare ciò, vai su Impostazioni > Paghe > Aggiornamenti Dipendenti, e abilita tutti gli aggiornamenti che desideri sincronizzare con Silae.

Quando viene generato un aggiornamento del dipendente, potrai esaminarlo e inviarlo 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 delle paghe, l'elaborazione può richiedere fino a 5–10 minuti per completarsi.

Non potrai 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 un nuovo dipendente viene creato 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.
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 verrà creata in Silae.
Altre cose importanti da considerare:
- Quando crei il dipendente e carichi le informazioni contrattuali, assicurati che la data del contratto (entrata in azienda) e la data di assunzione (ultimo aggiornamento del contratto) siano le stesse in SILAE. Altrimenti, Silae creerà un nuovo contratto, risultando in duplicazioni.
- Per i dipendenti senza numero di previdenza sociale: Il record verrà comunque creato, ma la validazione sarà basata 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 di nascita è obbligatorio. Se viene lasciato vuoto, il cognome utilizzato sarà trattato come il nome di nascita per evitare di bloccare la creazione.
- Il matricola non deve essere aggiunto in Factorial. Quando la nuova assunzione viene sincronizzata, popoleremo automaticamente il campo matricola 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 sarà inviato per impostazione predefinita come codice 001: Assunzione, inizio attività, reclutamento diretto o reclutamento tramite concorso (pubblica amministrazione), inizio distacco, inizio vita culturale (religioni). Puoi modificarlo 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 identificativo)
- Nome da nubile (se lasciato vuoto in Factorial, il nome verrà sincronizzato anche qui)
- Genere
- Email professionale
- Email personale (se lasciato vuoto 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 & 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 contrattuali
- Data di ingresso (basata sul campo Data di inizio del contratto di Factorial)
- Data di inizio contratto (basata sulla Data effettiva del contratto di Factorial)
- Data di inizio versione contratto (basata sulla Data effettiva del contratto di Factorial)
- Data di fine
- Motivo di inizio (per impostazione predefinita motivo sincronizzato: 001)
- Stabilimento
- Qualifica lavorativa - sotto “altra qualifica lavorativa”
- Codice contratto di lavoro (deve essere un tipo di contratto disponibile per impostazione predefinita 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 straordinarie mensili” in Silae)
- Per i dipendenti con contratto a giornata → 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 per il/la dipendente. Puoi aprirlo e controllare che tutti i dati siano corretti, e poi segnarlo come "Completato" per sincronizzare la modifica con Silae.
I seguenti campi genereranno un aggiornamento per il/la dipendente che può essere sincronizzato con Silae:
- Dati del/della dipendente
- Cognome
- Nome
- Email professionale
- Telefono cellulare
- Indirizzo di casa (città, paese, stato, strada, numero e codice postale)
- Nazionalità (solo il codice viene cambiato, il testo deve essere modificato manualmente da Silae)
- IBAN
- BIC
- Dati del contratto
- Data di inizio del rapporto di lavoro
- Data di inizio del contratto
- Data di ingresso
- Data di fine
- Stabilimento
- Qualifica (sotto "altra qualifica")
- Codice 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/le dipendenti a ore:
- Ore contrattuali - devono essere inserite le ore mensili o settimanali (queste popoleranno i campi “Ore normali mensili” e “Ore straordinarie mensili” in Silae)
- Per i/le dipendenti con contratto a giornata:
- Numero di giorni
Importante:
- Quando desideri inviare modifiche al contratto per un/a dipendente esistente nella tua azienda, assicurati di controllare attentamente le date di inizio del contratto e di inizio del rapporto di 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. Non deve essere inviata alcuna data di contratto precedente.
Fare ciò interromperà la sincronizzazione e attiverà un "bubble bianca" (stato non calcolato/errore) sui bollettini paga del/della dipendente.
Se ciò accade, segui esattamente il processo di risoluzione riportato di seguito:
-
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 di Contratto #1 per farla diventare successiva a Contratto #2.
- L'Eliminazione: 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 del contratto, se desideri creare un nuovo lavoro in Silae, vai alla scheda Contratto nel profilo del/della tuo/a dipendente su Factorial, fai clic su Nuove Condizioni e inserisci la data della modifica.
- Modificare un contratto: Se desideri effettuare una modifica senza creare un nuovo lavoro in Silae, fai clic sui tre puntini e seleziona Correggi Condizioni.
Assicurati che la data di efficacia corrisponda alla data del lavoro in Silae. Se non lo fa, verrà automaticamente creato un nuovo lavoro in Silae:

Gestire le conclusioni, le estensioni e le successioni dei contratti
Qual è il corretto flusso di lavoro da seguire in Factorial?
Se il/la dipendente sta lasciando:
- Chiudi il profilo del/della dipendente in Factorial, inserisci la data di fine e il 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 hai bisogno di cambiarlo, dovrai farlo manualmente in Silae.
Se il/la dipendente rientra in azienda:
- Riattiva lo stesso profilo per creare la nuova condizione.
.png)
Comportamenti del sistema secondo i diversi scenari di creazione dei/dei dipendenti tra Factorial e Silae:
| Caso | Cosa succede | Risultato in Silae | Motivo di assunzione |
|---|---|---|---|
| 1. Creazione di un nuovo/a dipendente in Factorial (caso normale) | Il/la dipendente non esiste affatto in Silae | Record del/della 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/della dipendente | Il/la dipendente non esiste ancora in Silae, reinviamo le informazioni | Trattato come una nuova assunzione | 001 – nuovo contratto |
| 3. Invio di un incidente di contratto, il/la dipendente esiste già in Silae ma senza contratto | Silae ha il/la dipendente, ma nessun contratto | Trattato come una nuova assunzione | 001 – nuovo contratto |
| 4. Invio di un incidente per una modifica del contratto, il/la 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 del contratto, il/la dipendente esiste ma la data di inizio del 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/la dipendente non esiste | L'ID del/dei dipendente/i è 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 della busta paga del/della dipendente. Puoi verificare che tutti i dati siano corretti, e poi segnare l'incidente come “Completato” per sincronizzare i dati con Silae.

Controlla che le assenze che desideri inviare siano abilitate nella pagina Impostazioni Aggiornamenti Dipendenti e abbiano il codice Silae mappato nella pagina Impostazioni Integrazione (con solo il codice a 3 cifre, senza includere 'AB-')
Tipo di assenze che possono essere sincronizzate
Le assenze a mezza giornata, a giornata intera e orarie possono essere sincronizzate. Le assenze che coinvolgono regole complesse (come periodi di attesa, indennità di sicurezza sociale, integrazioni del datore di lavoro o soglie) sono invitate 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.
- Permessi retribuiti 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 e eliminare un'assenza sincronizzata
Se hai inviato un'assenza per uno/a dei tuoi/e dipendenti da Factorial a Silae, e nel frattempo il/la tuo/a dipendente ha eliminato questa assenza dal proprio profilo, l'incidente di assenza verrà riaperto con il messaggio: “L'assenza è stata eliminata”. Segnando 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
Gli 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 ulteriore controllo 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 sono inseriti nello stesso luogo dei codici di assenza, numeri di file dei/dei dipendenti e codici di stabilimento, sotto i campi “compensazione aggiuntiva”:
.png)
Passo 3 – Inviare l'EVP da Factorial a Silae
Gli EVP sono inseriti in Factorial e verranno inviati manualmente (tramite un clic su un pulsante) tramite 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 ritorna 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 imprevisto durante l'analisi del valore | non valido – WrongFormat | I dati inseriti sono errati. 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/dei dipendente/i della busta paga è mancante o errato. |
| Numero di File Errato | Il valore nella lista dei file è nullo o vuoto | fallito – WrongFile | Il numero di file Silae è errato. |
| Periodo EVP Troppo Vechio | Il periodo EVP è più vecchio del periodo attuale nel file | non valido – WrongPeriod | L'EVP non corrisponde al periodo attuale in Silae. |
| Sottocchiave Non Valida | 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 il client ID Silae non sono validi. |
| Codice EVP Non Valido | N/A (confronta con la tabella Silae) | non valido – WrongEVPCode | Il codice EVP non esiste in Silae. Si prega di correggerlo. |
Dettagli Aggiuntivi su Tipi di Variabili Specifici
*Le ore native
Per le ore, non è necessario inserirle nel menu “Variabili di Input”.
È necessario solo assegnare correttamente i codici di ora Silae in Factorial, a seconda delle categorie utilizzate nella configurazione della tua busta paga.
1. Ore native (codici Silae standard)
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 = straordinario al 25%
- HS50 = straordinario al 50%
- HS100 = straordinario 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 esattamente il codice 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. Un EVP mascherato da ore regolari
Ecco alcuni esempi - Queste sono variabili di busta paga (spesso collegate a profili di premio o indennità) per le quali è essenziale inserire il codice nel menu specifico Silae “variabili da inserire”:
- Ore di Festività Pubblica: il numero di ore funge da moltiplicatore per un premio o aumento.
- Ore di Pronto Intervento: Che siano pagate a tariffa fissa o oraria, Silae richiede un codice di pagamento variabile (spesso il numero di ore di pronto intervento) per attivare l'indennità.
- Ore di Turno Notturno: Il volume di ore trasmesso funge esclusivamente da attivatore per l'elemento di pagamento del premio per il turno notturno.
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 permesso maturati da SILAE in Factorial?
L'integrazione recupera i contatori di ferie maturate da Silae a Factorial secondo le tue esigenze, 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à maturati nell'anno precedente (N‑1) sia i giorni attualmente maturati per l'anno in corso (N).
Per la sincronizzazione del saldo delle ferie, gli ID dei dipendenti Silae devono essere presenti e identici in Factorial.
Come recuperare i contatori di ferie maturate 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 della maturazione da parte di Factorial. Vai a 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à maturati nei tuoi contatori precedenti e resettare solo i due contatori relativi al ciclo precedente (Cpn‑1) e al ciclo attuale (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 diverso contatore collegato a una politica di ferie.
.png)
- Fai attenzione nelle impostazioni di Factorial a non consentire il riporto di giorni non utilizzati dall'anno precedente, poiché il calcolo delle ferie maturate di Silae include i giorni riportati.
- Una volta attivati e completati i codici del contatore, i contatori maturati e attualmente in fase di maturazione di Factorial verranno regolati in base alle 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 revisionate 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, un rapporto di errore verrà inviato al cliente via email. Il cliente deve specificare l'indirizzo email a cui desidera che il rapporto sia inviato.
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 matricola 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 matricola 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:
- Matricola - sincronizzata a Factorial una volta che il dipendente è creato in Silae
- Contatori di tempo libero - regolati automaticamente in Factorial 5 giorni dopo il calcolo della busta paga in Silae
Cosa succede quando un nuovo dipendente non ha un numero di previdenza sociale?
Affinché un dipendente possa essere creato in Silae, il numero di previdenza sociale (SSN) deve essere compilato. Se un dipendente non ce l'ha, deve essere creato manualmente sia in Silae che in Factorial. Una volta assegnato il numero di previdenza sociale 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 compilati nella pagina Marketplace di Factorial.
- Nessun accesso API per alcuni dossier clienti.
Hai bisogno di aiuto?
Per qualsiasi supporto o aiuto riguardo a un bug relativo a Factorial: Ti preghiamo di accedere al portale di supporto qui: Factorial Assistenza Clienti .
Se tutto funziona su Factorial ma non stai ricevendo 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.