Vai al contenuto

🤖 Spiega con IA

Tasse e conformità

4Geeks Payroll applica le aliquote di un paese per workspace: quello scelto in Impostazioni → Azienda. Questa pagina spiega i pacchetti proposti, la firma del cliente che sblocca il pagamento e la checklist che il console verifica.

In breve

Per: amministratori della busta paga e chi firma le aliquote aziendali.
Tempo: 10 minuti per rivedere e firmare; modificare un’aliquota richiede un minuto.
Risultato: busta paga nel paese corretto, con le aliquote firmate dall’azienda.

Per chi
Titolare, amministratore del workspace e contabilità
Tempo
10 minuti
Livello
Intermedio
Risultato
Aliquote firmate e un paese di conformità valido

Il paese di conformità

Il console prende il paese da Impostazioni → Azienda (company_profiles.country) e lo replica nella configurazione della busta paga. Non c’è un selettore di paese separato in Tasse e conformità: quello che vedi è il paese di conformità.

  • Solo il titolare e gli amministratori del workspace possono cambiarlo.
  • Sono supportati 18 paesi dell’America Latina: Argentina, Bolivia, Brasile, Cile, Colombia, Costa Rica, Ecuador, El Salvador, Guatemala, Honduras, Messico, Nicaragua, Panama, Paraguay, Perù, Repubblica Dominicana, Uruguay e Venezuela.
  • Un paese fuori dall’America Latina lascia vuoto il paese di conformità. La busta paga mostra l’avviso “imposta il paese dell’azienda” e non può applicare aliquote.
  • I nuovi dipendenti ereditano il paese tramite trigger del database, incluse le importazioni CSV e le scritture API. I dipendenti esistenti non vengono riscritti in silenzio: il console mostra la differenza e offre Allinea N dipendenti, un’azione esplicita e tracciata.
  • Il cambio di paese è bloccato finché il workspace ha dipendenti, righe fiscali, tabelle dell’imposta sul reddito o bozze del paese precedente (PAYROLL_COMPLIANCE_COUNTRY_LOCKED, con i conteggi nel dettaglio). Allinea i dipendenti, rimuovi la configurazione del paese precedente (Tasse e conformità mostra le righe inattive) e salva di nuovo.

I pacchetti proposti

Ogni paese include un pacchetto proposto a regime generale. Le aliquote sono un punto di partenza che l’azienda rivede, modifica se necessario e firma; 4Geeks non le certifica.

Paese Dipendente Datore di lavoro Tabella imposta sul reddito
Argentina 17,00% 25,11% 2025
Bolivia 11,71% 6,71% 2025 (RC-IVA)
Brasile 7,5–14% (INSS, progressivo) 35,80% 2025
Cile 20,20% 10,30% 2025
Colombia 8,00% 30,02% 2025
Costa Rica 10,83% 26,83% 2026 (Hacienda)
Ecuador 7,20% 22,48% 2025
El Salvador 10,25% 9,75% 2025
Guatemala 4,83% 14,67% 2025
Honduras 3,50% 9,50% 2025
Messico 2,295% 18,275% 2025
Nicaragua 7,00% 23,50% 2025
Panama 9,00% 18,35% 2025
Paraguay 9,00% 23,80% 2025
Perù 12,50% 10,15% 2025
Repubblica Dominicana 5,91% 16,34% 2025
Uruguay 18,00% 14,50% 2025
Venezuela 5,50% 15,00% Manuale

Ogni pacchetto si scompone in righe individuali (per esempio CCSS/IVM in Costa Rica, IMSS/INFONAVIT in Messico, AFP/ISAPRE in Cile, INSS/FGTS in Brasile) che puoi rivedere, modificare o eliminare.

Tetti e contributi progressivi

Una riga può avere un tetto di contribuzione (max_base): il lordo sopra il tetto non contribuisce (Messico, Cile, Panama, Honduras, El Salvador, Repubblica Dominicana). L’INSS del dipendente in Brasile è progressivo: ogni aliquota si applica alla sua fascia. Entrambi i campi sono opzionali e restano vuoti in Costa Rica, quindi il calcolo non cambia.

Imposta sul reddito

Il console trattiene l’imposta sul reddito salariale quando il paese ha una tabella in vigore:

  • 17 tabelle incluse (Argentina, Bolivia, Brasile, Cile, Colombia, Costa Rica, Ecuador, El Salvador, Guatemala, Honduras, Messico, Nicaragua, Panama, Paraguay, Perù, Repubblica Dominicana, Uruguay). Il Venezuela non ha una proposta: aggiungi la tua e firmala.
  • Base dopo i contributi: nella maggior parte dei paesi la base è il lordo meno i contributi del dipendente dello stesso pagamento. La Costa Rica mantiene la base lorda.
  • Importi familiari: possono essere un credito d’imposta sull’imposta calcolata (Costa Rica) o una deduzione dalla base (Argentina).
  • Valuta: la tabella si applica solo quando la valuta coincide con quella della busta paga. La schermata avvisa quando differiscono (per esempio un workspace della Costa Rica che paga in USD) e l’imposta non viene trattenuta finché non coincidono.

Modifica o aggiungi una tabella in Tasse e conformità → Imposta sul reddito. Le nuove versioni mantengono la cronologia: una tabella si applica dalla sua data di decorrenza e non riscrive le buste paga precedenti.

Installare o ripristinare il pacchetto

Quando imposti o cambi il paese dell’azienda, il console installa automaticamente il pacchetto proposto: righe contributive, tabella dell’imposta sul reddito e festività dell’anno. Non sovrascrive mai righe già esistenti per quel paese.

Se hai modificato le righe e vuoi la proposta, usa Ripristina aliquote proposte. La scheda del paese mostra la versione del pacchetto, le fonti pubbliche e il salario minimo di riferimento.

Il cliente firma le aliquote

Il pagamento resta bloccato finché l’azienda non firma le aliquote che userà.

  1. Clicca Rivedi e firma.
  2. Controlla ogni aliquota, tetto, fascia progressiva e la tabella dell’imposta sul reddito.
  3. Digita il nome completo di chi firma, aggiungi una nota opzionale e conferma la dichiarazione di responsabilità.
  4. Il console salva la firma con l’hash calcolato dal server delle righe esatte, il nome, l’utente, l’email, il ruolo e la data. Compare anche nell’audit.

Se qualsiasi aliquota o tabella cambia dopo, la firma diventa obsoleta e il console ne chiede una nuova. L’hash è calcolato dal database (payroll_compliance_config_hash), mai dal browser, quindi la firma copre esattamente ciò che usa la busta paga.

Blocco del pagamento

Un’esecuzione può essere bozza o inviata per approvazione senza firma, ma non può essere approvata, passare a Processing/Completed né essere pagata — e una busta paga non può essere segnata Pagata — finché la firma corrisponde alle aliquote vigenti (PAYROLL_COMPLIANCE_NOT_SIGNED).

La checklist di conformità

La checklist è calcolata dai dati del workspace, non è fissa. Segnala:

  • il paese di conformità mancante o non supportato;
  • il pacchetto non installato, o senza righe dipendente/datore;
  • nessuna tabella dell’imposta sul reddito per il paese;
  • la valuta della tabella non corrisponde a quella della busta paga;
  • dipendenti attivi di un altro paese (con l’azione Allinea);
  • festività dell’anno non caricate;
  • aliquote non firmate o firma obsoleta.

Gli errori bloccano il pagamento; gli avvisi sono raccomandazioni. Risolvili prima di eseguire la busta paga.

Invii elettronici

La stessa schermata elenca gli invii periodici del paese: scadenze, stato, riferimento dell’ente e ricevuta. Il file CCSS SICERE della Costa Rica è generato dal console (record 25, 35 e 15) e l’INS ha un connettore API. Vedi Invii elettronici per la procedura e il canale per paese.

Risoluzione dei problemi

Sintomo Causa e soluzione
PAYROLL_COMPLIANCE_COUNTRY_LOCKED Restano dipendenti, righe fiscali, tabelle dell’imposta sul reddito o bozze del paese precedente. Allinea i dipendenti, rimuovi la configurazione precedente e salva di nuovo il paese.
PAYROLL_COMPLIANCE_NOT_SIGNED Le aliquote non sono mai state firmate o sono cambiate dopo la firma. Apri Rivedi e firma e firma di nuovo.
PAYROLL_COMPLIANCE_COUNTRY_FORBIDDEN Solo il titolare e gli amministratori del workspace possono cambiare il paese.
La scheda del paese dice “non configurato” Il paese dell’azienda è vuoto o non è in America Latina. Impostalo in Impostazioni → Azienda.
L’imposta sul reddito non viene trattenuta Non c’è una tabella per il paese, la valuta della tabella non corrisponde a quella della busta paga o gli stipendi sono sotto la prima fascia.
“Nessun contributo dipendente/datore” Il pacchetto non è installato o tutte le righe sono state eliminate. Installa o ripristina il pacchetto proposto.

Domande frequenti

Posso avere dipendenti in più paesi nello stesso workspace?

No. La busta paga ha un paese di conformità per workspace, come la valuta unica. I dipendenti di un altro paese devono essere allineati (o passare al proprio workspace) prima del pagamento.

Posso cambiare il paese in seguito?

Sì, quando il workspace non ha dipendenti, righe fiscali, tabelle dell’imposta sul reddito o bozze del paese precedente. Le buste paga passate mantengono il proprio snapshot; il cambio influisce solo su ciò che viene dopo.

Le aliquote proposte sono ufficiali?

Sono la proposta a regime generale inclusa nel console, con fonti pubbliche. L’azienda le rivede e le firma; i regimi speciali (SIMPLES, monotributo, lavoro domestico, contratti collettivi) e gli invii legali restano fuori dall’ambito.

4Geeks presenta all’ente per me?

No. Il console genera il file ufficiale e ne conserva l’evidenza; il cliente lo carica e registra la ricevuta. L’unica API diretta oggi è l’INS della Costa Rica, e il cliente fornisce sempre certificato e autorizzazione.

Perché la mia firma è diventata obsoleta?

Qualsiasi modifica a un’aliquota, a un tetto, a una fascia progressiva o alla tabella dell’imposta sul reddito cambia l’hash. È deliberato: la firma copre i valori esatti usati dalla busta paga.

Correlati


Hai ancora domande? Chiedi su Discord o esplora i tutoriali.