Integrare il welfare con Zucchetti Paghe Project: guida passo-passo per il vostro reparto IT

Quasi tutte le PMI italiane che gestiscono internamente le paghe usano Zucchetti Paghe Project, in una delle sue varianti. Quando arriva il welfare aziendale (i flexible benefit, in particolare), però, si scopre che 'integrato con Zucchetti' può voler dire tre cose molto diverse. Cosa significa davvero, cosa serve fare lato IT, e come evitare la doppia digitazione che fa impazzire payroll e HR.

Una delle prime domande che ci fanno i nuovi clienti — soprattutto quelli con un payroll interno o uno studio paghe in outsourcing — è sempre la stessa: "siete integrati con Zucchetti?".

La risposta corretta è: sì, ma "integrato con Zucchetti" può voler dire tre cose molto diverse, e vale la pena sapere quale state ottenendo prima di firmare. Questo vale per qualsiasi piattaforma di welfare aziendale, non solo Cipay: quando un fornitore dice "integrato" andate a chiedere come.

Questo articolo è pensato per chi gestisce l'integrazione lato IT o payroll dei piani di welfare aziendale (in particolare flexible benefit: rimborsi sanitari, formazione, trasporti, asili, mutuo). Se invece volete una panoramica di alto livello sul welfare modulare, questo articolo è un buon punto di partenza.

I tre livelli di integrazione

Livello 1 — Export CSV manuale. Scarichi un CSV dalla piattaforma di welfare aziendale e lo importi a mano in Zucchetti. Effort lato IT: basso ma ricorrente. Doppia digitazione: sì, ogni mese.

Livello 2 — Export cedolino-ready. Il file viene generato nel formato nativo Zucchetti, importabile con un click. Effort lato IT: medio (setup una tantum). Doppia digitazione: no.

Livello 3 — Sync API in tempo reale. Le voci entrano automaticamente nel cedolino via API o webhook. Effort lato IT: alto (setup). Doppia digitazione: no, mai.

Il livello 1 è quello che vendono in tanti, ma è un workaround, non un'integrazione. Il livello 2 è il minimo accettabile per una PMI con più di 20 dipendenti. Il livello 3 è quello che dovreste pretendere se siete un'azienda strutturata o un gruppo.

Cosa serve sapere prima di iniziare

Prima ancora di parlare di formati e tracciati, ci sono cinque informazioni che chiunque imposti l'integrazione deve avere sotto mano.

1. Quale variante di Zucchetti state usando: Paghe Project, Paghe Web, HR Zucchetti, ZWelfare, Project HR. Hanno tracciati e flussi diversi.

2. Chi gestisce il payroll: studio esterno, ufficio interno, payroll provider in cloud. Cambia chi può importare i file e come.

3. Codice voce cedolino che userete per le erogazioni di flexible benefit: serve concordarlo con il consulente del lavoro, perché è quella voce che andrà a movimentare il netto e la base contributiva.

4. Frequenza di erogazione: mensile, trimestrale, annuale. Dipende dal tipo di benefit e dalla policy aziendale.

5. Modalità di chiusura cedolino: in che giorno del mese chiudete? Il file welfare deve essere pronto almeno 3-5 giorni prima.

Senza questi cinque punti chiari non si parte. Qualunque integratore vi dica il contrario, sta saltando passaggi.

I cinque passi dell'integrazione

1. Mapping delle voci

La piattaforma di welfare aziendale e Zucchetti devono parlare la stessa lingua. Per ogni tipologia di benefit (flexible benefit, fringe benefit, premio convertito in welfare) si concorda un codice voce univoco. Tre o quattro codici tipicamente bastano. Si fa una volta, si congela, si documenta.

2. Definizione del tracciato

Zucchetti accetta file in formato a tracciato fisso o CSV con colonne specifiche. Il tracciato cedolino-ready Cipay segue le specifiche standard di Zucchetti Paghe Project: codice fiscale, codice voce, importo, periodo di competenza, eventuale centro di costo. Niente conversioni manuali, niente macro Excel.

3. Configurazione del centro di costo (CDC)

Se l'azienda è una sola ragione sociale con un unico CDC, questo passo è banale. Se invece avete più sedi o più ragioni sociali, è qui che la maggior parte delle integrazioni si rompe. La piattaforma di welfare aziendale deve sapere a quale CDC allocare ogni singolo dipendente, e l'export deve riportare correttamente l'allocazione. Ne parliamo in dettaglio nell'articolo su welfare multi-CDC.

4. Test su un cedolino di prova

Prima di andare in produzione si fa sempre un dry run su 2-3 dipendenti, su un cedolino di prova. Si verifica che le voci entrino correttamente, che gli importi corrispondano, che la base contributiva venga calcolata bene e che il netto sia quello atteso. Se qualcosa stona, si corregge prima di estendere a tutta l'azienda.

5. Schedulazione

Una volta validato, l'export viene schedulato in automatico nei giorni concordati con il payroll. Su Cipay si imposta dalla dashboard senza scrivere codice. Per chi vuole integrare via API c'è la possibilità di richiedere il file pronto via endpoint dedicato (verifica con il team Cipay le opzioni disponibili sulla vostra configurazione).

Errori che vediamo spesso

Non concordare il codice voce con il consulente del lavoro prima di iniziare. Significa rifare il mapping due o tre volte, e non è gratis in termini di tempo.

Saltare il test su cedolino di prova perché "tanto è solo un import". Non è solo un import: sono erogazioni reali nei cedolini, e gli errori si vedono solo dopo che il dipendente ha aperto la busta paga.

Allocare tutto al CDC della holding quando in realtà i dipendenti sono divisi su 4 controllate. Risultato: i report di controllo di gestione sono inutili e qualcuno deve riallocare a mano dopo.

Ignorare il timing: il file di welfare aziendale è pronto il 28 del mese ma il payroll chiude il 25. Bisogna anticipare il flusso di una settimana.

Quanto tempo serve davvero

Un'integrazione standard Cipay ↔ Zucchetti Paghe Project, con 1 ragione sociale e 1 CDC, è operativa in 2-3 giornate-uomo lato vostro, distribuite su circa una settimana di calendario. La maggior parte del tempo non è codice — è allineamento col consulente del lavoro e test sul cedolino di prova.

Per configurazioni multi-CDC o multi-ragione sociale, il tempo sale ma non esplode: tipicamente 1-2 settimane di calendario. Ne abbiamo fatte decine, il processo è collaudato.

Se volete capire come potrebbe funzionare nel vostro contesto specifico — quale variante di Zucchetti usate, quante ragioni sociali, che tracciato — parliamone direttamente. Una mezz'ora con il nostro account manager basta a capire se l'integrazione è banale, media o complessa, e a darvi una stima realistica.