Elektronische Meldungen¶
Einstellungen → Payroll → Steuern und Compliance → Elektronische Meldungen listet die periodischen Meldungen Ihres Compliance-Landes: die jetzt fällige Periode, die Frist, den erfassten Status, die Referenz der Behörde und die Bestätigung. Für Costa Rica erzeugt sie außerdem die CCSS-SICERE-Datei.
Kurz gesagt
Für: Lohnadministratoren und den Buchhalter, der bei der Behörde meldet.
Zeit: 5 Minuten pro Periode.
Ergebnis: offizielle Datei erzeugt, Meldung verfolgt und Bestätigung gespeichert.
Was die Konsole tut — und was nicht¶
Die Konsole arbeitet auf drei Ebenen, die pro Pflicht angegeben werden:
| Ebene | Bedeutung |
|---|---|
| API | Ein Connector meldet bei der Behörde und speichert die Bestätigung. Heute nutzt nur die Lohnabrechnung der costa-ricanischen INS dies. |
| Offizielle Datei | Die Konsole erzeugt die offizielle Datei, Sie laden sie im Portal der Behörde hoch und erfassen die Bestätigung. So funktioniert SICERE in Costa Rica. |
| Manuell | Die Konsole verfolgt Frist, Referenz und Nachweis; die Meldung erfolgt im Portal der Behörde. |
4Geeks meldet nicht in Ihrem Namen. Es gibt keine zwischengeschalteten Aggregatoren: Der Kunde stellt immer Zertifikat und Autorisierung bereit und lädt die Datei hoch (oder autorisiert die API-Verbindung, wenn es eine gibt). Der Link zur Bestätigung ist praktisch Pflicht: Er beweist die Meldung.
Der Meldekalender¶
Jede Pflicht hat eine Behörde, einen Umfang (Sozialversicherung, Einkommensteuer, sonstiges), eine Periodizität (monatlich, jährlich, ereignisbezogen), eine Lieferstufe und eine Fristregel. Die Konsole:
- berechnet die jetzt fällige Periode (bei monatlichen Pflichten der gerade beendete Monat);
- berechnet die Frist mit Wochenenden und Feiertagen des Landes;
- markiert sie als Überfällig, Bald fällig (innerhalb von 7 Tagen) oder Kommend;
- führt eine Zeitleiste jeder Statusänderung (
pending → generated → submitted → accepted/rejected) inpayroll_filing_events.
Eine Meldung erfassen¶
- Öffnen Sie die Pflicht in der Liste.
- Klicken Sie auf Erfassen (oder Aktualisieren).
- Wählen Sie den Status: Ausstehend, Erzeugt, Eingereicht, Akzeptiert oder Abgelehnt.
- Tragen Sie die Referenz (Folio oder Planillennummer der Behörde), die URL der Bestätigung und eine optionale Notiz ein.
- Speichern.
Die Zeile speichert, wer wann geändert hat; der Audit-Trail behält die Historie. Eine abgelehnte Meldung behält den Grund in der Notiz.
Costa Rica: die CCSS-SICERE-Datei¶
Der „Grandes Clientes“-Fluss der CCSS erhält eine ANSI-Datei mit fester Länge. Die Konsole baut sie aus den Lohndaten und der folgenden Konfiguration.
1. SICERE konfigurieren¶
Legen Sie in der Karte CCSS-SICERE-Datei fest:
| Feld | Format | Hinweise |
|---|---|---|
| Arbeitgebernummer | 18 Ziffern | Arbeitgebertyp, juristische ID, Segregado und Sektor, wie bei der CCSS registriert |
| Zweigstelle | 4 Ziffern | CCSS-Zweigstelle, der der Arbeitgeber zugeordnet ist |
| Segregado | 3 Ziffern, optional | Nur wenn der Arbeitgeber segregierte Nummern hat |
| Standard-Berufsschlüssel | 4 Ziffern | Wird verwendet, wenn der Mitarbeiter keinen eigenen Schlüssel hat |
| Standard-Ausweistyp | 0 national, 7 ausländisch | Wird verwendet, wenn der Mitarbeiter keinen eigenen Typ hat |
| Standard-Versicherungsklasse | C oder A | C = SEM, IVM und Banco Popular; A = Rentner (SEM und Banco Popular) |
| Standard-Arbeitszeitklasse und -stunden | EXT/ACU/DIU/MIX/NOC/VES/PAR + 2 Ziffern | Wird verwendet, wenn der Mitarbeiter keine eigene Arbeitszeit hat |
Die Standardwerte sind Rückfallwerte. Die echten Schlüssel gehören zu jedem Mitarbeiter: Im Mitarbeiterformular (nur Costa Rica) legen Sie den CCSS-Berufsschlüssel, den CCSS-Ausweistyp und die CCSS-Versicherungsklasse fest.
2. Datei erzeugen¶
- Wählen Sie die Periode (die Konsole schlägt den Vormonat vor).
- Klicken Sie auf SICERE-Datei erzeugen.
- Die Konsole prüft jeden Satz. Fehlt etwas (eine Cédula, ein Berufsschlüssel), listet sie das Problem und erzeugt die Datei nicht.
- Die Datei wird mit dem offiziellen Namen
pla_<patronal>[-<segregado>]_<MMAAAA>.txtin ANSI (Windows-1252) heruntergeladen. - Die Meldung wechselt zu Erzeugt und speichert den Dateinamen und seinen SHA-256.
3. Hochladen und Bestätigung erfassen¶
Laden Sie die Datei in der Oficina Virtual der CCSS hoch (Grandes Clientes → Validación y Carga de Archivos), warten Sie die offizielle Validierung ab und erfassen Sie Eingereicht oder Akzeptiert mit der CCSS-Referenz und dem Link zur Bestätigung.
Die CCSS validiert; die Konsole nicht
Eine erzeugte Datei ist keine akzeptierte Meldung. Das CCSS-LOG ist die letzte Instanz: Prüfen Sie es, korrigieren Sie die gemeldeten Punkte und laden Sie bei Bedarf erneut hoch.
Was die Datei enthält¶
Das Layout folgt dem Manual de Usuario Sistema de Grandes Clientes GF-DSCR-P004-M001 v2.04, Abschnitt 9:
| Satz | Länge | Inhalt |
|---|---|---|
| 25 | 30 (31 mit Sperre) | Arbeitgebernummer, Zweigstelle, Periode AAAAMM; ein S an Position 31 sperrt die Nummer |
| 35 | 174 | Einer pro Bewegung: Ausweistyp und -nummer, Nachnamen, Vorname, Beruf (4), Gehalt in Cent (15), Versicherungsklasse, Änderungstyp, Arbeitszeitstunden/-klasse, Änderungscode, Start- und Enddatum |
| 15 | 33 | Kontrolle: PAT, Erzeugungsdatum, Gesamtsätze 25 und Gesamtsätze 35 |
Bewegungstypen: IC Aufnahme, SA Gehaltsänderung, OC Berufsänderung, JO Arbeitszeitänderung, CS Versicherungsklassenwechsel, PE unbezahlter Urlaub, IN Arbeitsunfähigkeit/Freistellung, EX Austritt. Die Konsole leitet IC, SA, EX, IN und PE aus den Lohndaten ab; Berufs- und Arbeitszeitänderungen werden vom Generator unterstützt, bleiben aber manuell.
Ein Monat ohne Bewegungen ist gültig: Die Datei enthält Satz 25 und Kontrolle 15 mit null Sätzen 35.
Kanäle pro Land¶
| Land | Hauptbehörde | Kanal heute |
|---|---|---|
| Argentinien | ARCA (SICOSS/F931, Libro de Sueldos Digital) | Offizielle Datei; API mit Kundenzertifikat möglich |
| Bolivien | Gestora Pública / CNS / SIN | Datei oder Portal |
| Brasilien | eSocial / Receita Federal / FGTS Digital | API mit A1/A3-Zertifikat des Kunden (noch nicht implementiert) |
| Chile | Previred / SII | Previred-Datei; SII-API mit Zertifikat |
| Costa Rica | CCSS SICERE / INS / Hacienda | SICERE-Datei von der Konsole erzeugt; INS-API |
| Dominikanische Republik | TSS SUIR / DGII | Datei oder Portal |
| Ecuador | IESS / SRI | Datei (Batch) oder Portal |
| El Salvador | ISSS / AFP / MH | Datei oder Portal |
| Guatemala | IGSS / SAT | Datei oder Portal |
| Honduras | IHSS / SAR / DEI | Datei oder Portal |
| Kolumbien | PILA-Betreiber / DIAN | Datei oder Betreiberportal |
| Mexiko | IMSS-INFONAVIT (SUA/IDSE) / SAT | SUA-Datei und IDSE-Portal |
| Nicaragua | INSS / DGI | Manuell oder Datei |
| Panama | CSS (SIPE) / DGI | Datei oder Portal |
| Paraguay | IPS / SET | Datei oder Portal |
| Peru | SUNAT PLAME / AFPnet | Datei oder Portal |
| Uruguay | BPS / DGI | Portal |
| Venezuela | IVSS / SENIAT | Manuell |
Fehlerbehebung¶
| Symptom | Ursache und Lösung |
|---|---|
| „SICERE-Datei erzeugen“ erscheint nicht | Das Compliance-Land ist nicht Costa Rica oder SICERE ist noch nicht konfiguriert. |
| Die Datei wird nicht erzeugt und der Bildschirm listet Probleme | Eine Cédula, ein Berufsschlüssel oder eine Freistellung ohne Enddatum fehlt. Korrigieren Sie den Mitarbeiter oder die Freistellung und erzeugen Sie erneut. |
| „Keine Bewegungen“ | Der Monat hat keine Aufnahmen, Gehaltsänderungen, Austritte, Freistellungen oder Urlaube. Die Konsole erzeugt dennoch die Datei 25 + 15. |
| Die CCSS lehnt die Datei ab | Prüfen Sie den Dateinamen, dass sie ANSI ist und die Satzlängen; vergleichen Sie dann mit dem CCSS-LOG. Die Konsole meldet nicht bei der CCSS und validiert nicht. |
| Die Bestätigung wird nicht gespeichert | Die Nachweis-URL muss mit http:// oder https:// beginnen. |
Häufige Fragen¶
Lädt die Konsole die Datei bei der CCSS hoch?
Nein. Sie erzeugt die Datei, speichert den Hash und verfolgt den Status. Sie laden sie in der Oficina Virtual der CCSS hoch und erfassen die Bestätigung.
Kann ich einen Vermittler oder Aggregator nutzen?
Nein, per Produktentscheidung. Wo die Behörde keine öffentliche API hat, bleibt die Konsole bei offizieller Datei + Nachweis. Der Kunde stellt Zertifikat und Autorisierung für jede direkte API bereit.
Was passiert, wenn ich einen Satz nach der Dateierzeugung ändere?
Die Datei ist ein Snapshot: Sie ändert sich nicht. Wenn die Änderung die Periode betrifft, erzeugen Sie sie vor dem Hochladen neu; die neue Datei hat einen anderen Hash und die Meldung wird aktualisiert.
Wo wird der Nachweis gespeichert?
Die Bestätigung ist eine URL, die Sie in der Meldung erfassen; der Dateiname und sein SHA-256 stehen in der Zeile. Bewahren Sie die Datei in Ihrem eigenen Dokumentenarchiv auf.
Gilt die SICERE-Datei für die erste Lohnabrechnung?
Die erste Lohnabrechnung wird von der CCSS erzeugt. Die Datei der Konsole meldet Bewegungen ab den folgenden Perioden.
Verwandt¶
Noch Fragen? Frag uns auf Discord oder entdecke die Tutorials.