Vai al contenuto

🤖 Spiega con IA

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.

Per chi
Titolare, amministratore del workspace e contabilità
Tempo
5 minuti per periodo
Livello
Intermedio
Risultato
Invio monitorato con la sua evidenza

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) in payroll_filing_events.

Registrare un invio

  1. Apri l’obbligo nell’elenco.
  2. Clicca Registra (o Aggiorna).
  3. Scegli lo stato: In attesa, Generato, Inviato, Accettato o Rifiutato.
  4. Compila il riferimento (folio o numero della planilla dell’ente), l’URL della ricevuta e una nota opzionale.
  5. 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

  1. Seleziona il periodo (il console propone il mese precedente).
  2. Clicca Genera file SICERE.
  3. Il console valida ogni record. Se manca qualcosa (una cédula, un codice occupazione), elenca il problema e non genera il file.
  4. Il file viene scaricato con il nome ufficiale pla_<patronal>[-<segregado>]_<MMAAAA>.txt, in ANSI (Windows-1252).
  5. 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.