Vai al contenuto principale

Per i DSP che utilizzano Deel: scaricare la busta paga e inviarla a Deel

Scritto da Franzi Schuetzer

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:

  1. Vai su Buste paga > Impostazioni buste paga.

  2. Nella sezione Informazioni sul fornitore di buste paga, inserisci nel campo Token di accesso il token copiato dal tuo centro sviluppatori Deel.

  3. 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.

Hai ricevuto la risposta alla tua domanda?