Invii elettronici¶
Impostazioni → Payroll → Tasse e conformità → Invii elettronici elenca gli invii periodici del tuo paese di conformità: il periodo in scadenza, la data limite, lo stato registrato, il riferimento dell’ente e la ricevuta. Per la Costa Rica genera anche il file CCSS SICERE.
In breve
Per: amministratori della busta paga e il commercialista che invia all’ente.
Tempo: 5 minuti per periodo.
Risultato: file ufficiale generato, invio monitorato e ricevuta conservata.
Cosa fa il console — e cosa non fa¶
Il console lavora su tre livelli, dichiarati per obbligo:
| Livello | Cosa significa |
|---|---|
| API | Un connettore invia all’ente e conserva la ricevuta. Oggi lo usa solo la busta paga dell’INS della Costa Rica. |
| File ufficiale | Il console genera il file ufficiale, tu lo carichi nel portale dell’ente e registri la ricevuta. Il SICERE della Costa Rica funziona così. |
| Manuale | Il console monitora la scadenza, il riferimento e l’evidenza; l’invio si fa nel portale dell’ente. |
4Geeks non invia per tuo conto. Non ci sono aggregatori intermediari: il cliente fornisce sempre certificato e autorizzazione, e carica il file (o autorizza la connessione API quando esiste). Il link della ricevuta è obbligatorio in pratica: è ciò che prova l’invio.
Il calendario degli invii¶
Ogni obbligo ha ente, ambito (previdenza, imposta sul reddito, altro), periodicità (mensile, annuale, evento), livello di consegna e regola di scadenza. Il console:
- calcola il periodo in scadenza (il mese appena terminato per gli obblighi mensili);
- calcola la data limite con fine settimana e festività del paese;
- lo segna Scaduto, In scadenza (entro 7 giorni) o Prossimo;
- conserva una cronologia di ogni cambio di stato (
pending → generated → submitted → accepted/rejected) inpayroll_filing_events.
Registrare un invio¶
- Apri l’obbligo nell’elenco.
- Clicca Registra (o Aggiorna).
- Scegli lo stato: In attesa, Generato, Inviato, Accettato o Rifiutato.
- Compila il riferimento (folio o numero della planilla dell’ente), l’URL della ricevuta e una nota opzionale.
- Salva.
La riga conserva chi ha modificato e quando; l’audit mantiene la cronologia. Un invio rifiutato conserva il motivo nella nota.
Costa Rica: il file CCSS SICERE¶
Il flusso “Grandes Clientes” della CCSS riceve un file ANSI a lunghezza fissa. Il console lo costruisce dai dati della busta paga e dalla configurazione seguente.
1. Configurare il SICERE¶
Nella scheda File CCSS SICERE, imposta:
| Campo | Formato | Note |
|---|---|---|
| Numero patronale | 18 cifre | Tipo di datore, identificazione legale, segregato e settore, come registrato alla CCSS |
| Filiale | 4 cifre | Filiale CCSS a cui è collegato il datore |
| Segregato | 3 cifre, opzionale | Solo se il datore ha numeri segregati |
| Codice occupazione predefinito | 4 cifre | Usato quando il dipendente non ha un codice specifico |
| Tipo di identificazione predefinito | 0 nazionale, 7 straniero | Usato quando il dipendente non ha un tipo specifico |
| Classe assicurativa predefinita | C o A | C = SEM, IVM e Banco Popular; A = pensionato (SEM e Banco Popular) |
| Classe e ore di giornata predefinite | EXT/ACU/DIU/MIX/NOC/VES/PAR + 2 cifre | Usato quando il dipendente non ha una giornata specifica |
I valori predefiniti sono un fallback. I codici reali sono di ogni dipendente: nel modulo del dipendente (solo Costa Rica) imposta il codice occupazione CCSS, il tipo di identificazione CCSS e la classe assicurativa CCSS.
2. Generare il file¶
- Seleziona il periodo (il console propone il mese precedente).
- Clicca Genera file SICERE.
- Il console valida ogni record. Se manca qualcosa (una cédula, un codice occupazione), elenca il problema e non genera il file.
- Il file viene scaricato con il nome ufficiale
pla_<patronal>[-<segregado>]_<MMAAAA>.txt, in ANSI (Windows-1252). - L’invio passa a Generato e conserva il nome del file e il suo SHA-256.
3. Caricare e registrare la ricevuta¶
Carica il file nella Oficina Virtual della CCSS (Grandes Clientes → Validación y Carga de Archivos), attendi la validazione ufficiale e registra Inviato o Accettato con il riferimento CCSS e il link della ricevuta.
La CCSS valida; il console no
Un file generato non è un invio accettato. Il LOG della CCSS è l’autorità finale: controllalo, correggi ciò che indica e carica di nuovo se necessario.
Cosa contiene il file¶
Il layout segue il Manual de Usuario Sistema de Grandes Clientes GF-DSCR-P004-M001 v2.04, sezione 9:
| Record | Lunghezza | Contenuto |
|---|---|---|
| 25 | 30 (31 con sospensione) | Numero patronale, filiale, periodo AAAAMM; una S nella posizione 31 sospende il numero |
| 35 | 174 | Uno per movimento: tipo e numero di identificazione, cognomi, nome, occupazione (4), salario in centesimi (15), classe assicurativa, tipo di cambio, ore e classe di giornata, codice di cambio, date di inizio e fine |
| 15 | 33 | Controllo: PAT, data di generazione, totale record 25 e totale record 35 |
Tipi di movimento: IC inclusione, SA cambio salario, OC cambio occupazione, JO cambio giornata, CS cambio classe assicurativa, PE permesso non retribuito, IN incapacità/licenza, EX esclusione. Il console deriva IC, SA, EX, IN e PE dai dati della busta paga; i cambi di occupazione e giornata sono supportati dal generatore ma restano manuali.
Un mese senza movimenti è valido: il file contiene il record 25 e il controllo 15 con zero record 35.
Canali per paese¶
| Paese | Ente principale | Canale oggi |
|---|---|---|
| Argentina | ARCA (SICOSS/F931, Libro de Sueldos Digital) | File ufficiale; API con certificato del cliente è possibile |
| Bolivia | Gestora Pública / CNS / SIN | File o portale |
| Brasile | eSocial / Receita Federal / FGTS Digital | API con certificato A1/A3 del cliente (non ancora implementata) |
| Cile | Previred / SII | File Previred; API SII con certificato |
| Colombia | Operatore PILA / DIAN | File o portale dell’operatore |
| Costa Rica | CCSS SICERE / INS / Hacienda | File SICERE generato dal console; API INS |
| Ecuador | IESS / SRI | File (batch) o portale |
| El Salvador | ISSS / AFP / MH | File o portale |
| Guatemala | IGSS / SAT | File o portale |
| Honduras | IHSS / SAR / DEI | File o portale |
| Messico | IMSS-INFONAVIT (SUA/IDSE) / SAT | File SUA e portale IDSE |
| Nicaragua | INSS / DGI | Manuale o file |
| Panama | CSS (SIPE) / DGI | File o portale |
| Paraguay | IPS / SET | File o portale |
| Perù | SUNAT PLAME / AFPnet | File o portale |
| Repubblica Dominicana | TSS SUIR / DGII | File o portale |
| Uruguay | BPS / DGI | Portale |
| Venezuela | IVSS / SENIAT | Manuale |
Risoluzione dei problemi¶
| Sintomo | Causa e soluzione |
|---|---|
| “Genera file SICERE” non appare | Il paese di conformità non è la Costa Rica o il SICERE non è ancora configurato. |
| Il file non viene generato e la schermata elenca problemi | Manca una cédula, un codice occupazione o una licenza senza data di fine. Correggi il dipendente o la licenza e genera di nuovo. |
| “Nessun movimento” | Il mese non ha inclusioni, cambi salario, esclusioni, licenze o permessi. Il console genera comunque il file 25 + 15. |
| La CCSS rifiuta il file | Controlla il nome del file, che sia ANSI e le lunghezze dei record; poi confronta con il LOG della CCSS. Il console non invia né valida alla CCSS. |
| La ricevuta non viene salvata | L’URL dell’evidenza deve iniziare con http:// o https://. |
Domande frequenti¶
Il console carica il file alla CCSS?
No. Genera il file, conserva l’hash e monitora lo stato. Lo carichi tu nella Oficina Virtual della CCSS e registri la ricevuta.
Posso usare un intermediario o aggregatore?
No, per decisione di prodotto. Dove l’ente non ha un’API pubblica, il console resta su file ufficiale + evidenza. Il cliente fornisce certificato e autorizzazione per qualsiasi API diretta.
Cosa succede se cambio un’aliquota dopo aver generato il file?
Il file è uno snapshot: non cambia. Se la modifica riguarda il periodo, generalo di nuovo prima di caricarlo; il nuovo file ha un altro hash e l’invio viene aggiornato.
Dove viene conservata l’evidenza?
La ricevuta è un URL registrato nell’invio; il nome del file generato e il suo SHA-256 sono nella riga. Conserva il file nel tuo archivio documentale.
Il file SICERE vale per la prima busta paga?
La prima busta paga è generata dalla CCSS. Il file del console riporta i movimenti dai periodi successivi.
Correlati¶
Hai ancora domande? Chiedi su Discord o esplora i tutoriali.