Quando perdi le scadenze per inviare le buste paga a Deel, segui questi passaggi per scaricare il file e inviarlo manualmente.
Preparazione: capire come funziona il token di accesso Deel
Kenjo e Deel sono collegati tramite un'API (interfaccia di programmazione). Il trasferimento automatico della tua busta paga passa attraverso questa connessione.
Perché il trasferimento funzioni, il token di accesso deve essere inserito correttamente nelle impostazioni della busta paga.
Nota: ricevi il token di accesso durante l'onboarding con Deel, non da Kenjo. Per domande sul token, contatta direttamente Deel.
Ecco come inserire il token di accesso in Kenjo:
Vai su Buste paga > Impostazioni buste paga.
Nella sezione Informazioni sul fornitore di buste paga, inserisci nel campo Token di accesso il token copiato dal tuo centro sviluppatori Deel.
Clicca su SALVA.
Preparare il file da inviare
Clicca su INVIA PAYROLL
Vedrai una piccola x rossa a destra della lente con il testo Busta paga inviata
Clicca sul link Visualizza dettagli
Vedrai un’altra piccola X rossa con testo
Clicca sul link che termina con .xlsx per scaricare
Al momento i messaggi di errore sono disponibili solo in inglese.
Verificare le cause degli errori nel file
Apri il file
Cerca la colonna status e filtra per failed
Il campo failed indica che per uno o più dipendenti non è stato possibile inviare il file delle buste paga al provider
Un messaggio di errore a destra della colonna status spiegherà il motivo del fallimento. A seconda dell’errore, esegui il passaggio corrispondente:
Interpretare i messaggi di errore e le soluzioni
Ecco una panoramica dei possibili codici di errore e delle azioni necessarie:
Status Error message | Significato e cosa fare |
Delayed submission is not allowed. Payroll cycle is already closed. | Stai tentando di inviare questa busta paga dopo l’ultimo giorno possibile. Invia semplicemente questo file a Deel manualmente. |
Invalid request body | Il formato di alcuni contenuti non è corretto. Assicurati di non aver modificato accidentalmente il file. |
data.shifts.0.external_id: String must contain at most 48 character(s) | L’ID turno non può superare 48 caratteri. |
data.shifts.0.summary.total_payable_hours: Number must be greater than 0 | Per questo dipendente Kenjo tenta di inviare un tipo di retribuzione con valore 0 o negativo per questo periodo, cosa non consentita. |
Shift Rate not found | Il tasso turno/tipo di retribuzione è mancante su Deel. Deve essere creato. |
Contract with id XXXX not found | L’ID contratto non è stato trovato. Potrebbe essere errato oppure non ancora creato in Deel. |
Shift with external id XXXXX not found | I dati del tipo di retribuzione integrati in precedenza non sono stati trovati. I dati sono stati eliminati su Deel. |
The following external IDs are not unique: XXXXXXXXXXXX | I dati del tipo di retribuzione per quel periodo esistono già. Devi effettuare un aggiornamento invece di una creazione. |
Inviare il file al fornitore delle buste paga
Una volta scaricato il file, invia il download dei dati a Deel tramite un Payroll Ticket o via e-mail.

