Senza scrivere codice
Import dei dipendenti
Dall'export anagrafico di Zucchetti, TeamSystem, INAZ o altri: le colonne si riconoscono dal nome, l'associazione resta salvata, l'anteprima mostra cosa cambia.
Export per il cedolino
Voci variabili nel tracciato del vostro software paghe: schemi di partenza per Zucchetti, TeamSystem, INAZ, Sistemi, Wolters Kluwer B.Point, Passepartout, Datev Koinos e Buffetti; colonne, separatore, codifica (anche Latin-1), codice azienda e codici voce configurabili; chiusura del mese.
Presenze
Import delle presenze mensili in CSV per i bonus presenza e sicurezza.
API JSON
Una chiave per azienda (la crea l'amministratore in Impostazioni → Chiavi API) o per studio paghe (vale su tutti i clienti). Tutto in HTTPS; ogni chiamata resta nel registro delle attività dell'azienda.
curl -H "Authorization: Bearer LA_TUA_CHIAVE" \ "https://peoplewelfare.it/api.php?r=voci&periodo=2026-10"
Con la chiave dello studio si aggiunge &azienda_id=ID del cliente.
| Metodo | Risorsa | Cosa fa |
|---|---|---|
GET | api.php?r=ping | Verifica la chiave e restituisce l'azienda. |
GET | api.php?r=dipendenti | Anagrafica dei dipendenti (stesse colonne dell'import). Filtro facoltativo stato=attivo|sospeso|cessato. |
POST | api.php?r=dipendenti | Crea o aggiorna i dipendenti per matricola, con le regole dell'import CSV (date italiane e importi con la virgola vanno bene). Serve una chiave "lettura e scrittura". |
GET | api.php?r=crediti | Credito welfare per dipendente sui piani attivi: assegnato, impegnato, utilizzato, disponibile. |
GET | api.php?r=richieste | Richieste con stato e importi. Filtri facoltativi stato= e dal=AAAA-MM-GG (aggiornate da quella data). |
GET | api.php?r=voci | Voci per il cedolino del periodo periodo=AAAA-MM, con i codici voce configurati per il software paghe e lo stato di chiusura del mese. |
GET | api.php?r=chiusure | I mesi chiusi e consegnati al software paghe. |
GET | api.php?r=fondi | Adesioni ai fondi di previdenza complementare e sanità integrativa con quote, TFR e stato: per impostare le trattenute nel software paghe. Filtro stato=richiesta|attiva|cessata. |
GET | api.php?r=formazione | Corsi e iscrizioni con ore svolte, completamenti e codice dell'attestato (per il registro formazione e la sicurezza). Filtro anno=. |
GET | api.php?r=prevenzione | Campagne di prevenzione e prenotazioni (chi si è prenotato a cosa, senza dati sanitari). |
GET | api.php?r=volontariato | Attività di volontariato d'impresa e partecipazioni con le ore, per il bilancio di sostenibilità. |
Esempio: aggiornare l'anagrafica dal software paghe
curl -X POST -H "Authorization: Bearer LA_TUA_CHIAVE" -H "Content-Type: application/json" \
"https://peoplewelfare.it/api.php?r=dipendenti" -d '{"dipendenti": [
{"matricola": "0042", "nome": "Sara", "cognome": "Ricci", "codice_fiscale": "RCCSRA90E51F205Z",
"data_assunzione": "04/02/2019", "livello_inquadramento": "2° livello", "ral_annua": "31.000,00", "percentuale_part_time": "80"}
]}'
I campi accettati sono quelli dell'import: matricola, nome, cognome, codice_fiscale, email_aziendale, data_nascita, data_assunzione, data_cessazione, tipo_contratto, ccnl, livello_inquadramento, qualifica, percentuale_part_time, ore_settimanali, ral_annua, reparto, sede, categoria_omogenea, stato; vanno bene anche le intestazioni del software paghe (es. "Cod. dipendente", "Retribuzione annua lorda"), riconosciute come nell'import.
Risposta: quanti creati, aggiornati, invariati e gli eventuali errori riga per riga. Le variazioni (livello, part-time, RAL, cessazioni) finiscono nello storico del dipendente; una cessazione avvia il percorso di uscita.
Regole
- Risposte in JSON UTF-8; errori con codice HTTP (401 chiave non valida, 403 chiave di sola lettura, 400 parametri, 404 risorsa).
- Al massimo 2.000 dipendenti per chiamata POST e 5 MB di corpo.
- Le chiavi si revocano in qualsiasi momento; solo l'impronta della chiave è conservata.
- Nessun dato sanitario esce dall'API: i giustificativi e lo sportello caregiver non sono esposti.
Serve un tracciato specifico?
Se il vostro software paghe ha un formato particolare, scriveteci: lo aggiungiamo agli schemi di export.