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.
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à.
- Clicca Rivedi e firma.
- Controlla ogni aliquota, tetto, fascia progressiva e la tabella dell’imposta sul reddito.
- Digita il nome completo di chi firma, aggiungi una nota opzionale e conferma la dichiarazione di responsabilità.
- 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.