Zum Inhalt

🤖 Erklären mit KI

Steuern und Compliance

4Geeks Payroll wendet die Sätze eines Landes pro Workspace an: des Landes, das Sie unter Einstellungen → Unternehmen wählen. Diese Seite erklärt die vorgeschlagenen Pakete, die Kundenunterschrift, die die Zahlung freigibt, und die Checkliste, die die Konsole prüft.

Kurz gesagt

Für: Lohnadministratoren und die Person, die die Sätze der Firma unterschreibt.
Zeit: 10 Minuten zum Prüfen und Unterschreiben; eine Satzänderung dauert eine Minute.
Ergebnis: Lohnabrechnung im richtigen Land, mit den von der Firma unterschriebenen Sätzen.

Für wen
Inhaber, Workspace-Administrator und Buchhaltung
Zeit
10 Minuten
Niveau
Fortgeschritten
Ergebnis
Unterschriebene Sätze und ein gültiges Compliance-Land

Das Compliance-Land

Die Konsole übernimmt das Land aus Einstellungen → Unternehmen (company_profiles.country) und spiegelt es in die Lohneinstellungen. Es gibt keinen separaten Länderwähler unter Steuern und Compliance: Was Sie sehen, ist das Compliance-Land.

  • Nur der Inhaber und die Workspace-Administratoren können es ändern.
  • 18 lateinamerikanische Länder werden unterstützt: Argentinien, Bolivien, Brasilien, Chile, Costa Rica, Dominikanische Republik, Ecuador, El Salvador, Guatemala, Honduras, Mexiko, Nicaragua, Panama, Paraguay, Peru, Uruguay und Venezuela.
  • Ein Land außerhalb Lateinamerikas lässt das Compliance-Land leer. Die Lohnabrechnung zeigt den Hinweis „Land des Unternehmens festlegen“ und kann keine Sätze anwenden.
  • Neue Mitarbeiter erben das Land über einen Datenbank-Trigger, einschließlich CSV-Importen und API-Schreibvorgängen. Bestehende Mitarbeiter werden nicht still überschrieben: Die Konsole zeigt die Abweichung und bietet N Mitarbeiter ausrichten an, eine ausdrückliche und auditierte Aktion.
  • Der Länderwechsel ist gesperrt, solange der Workspace noch Mitarbeiter, Steuerzeilen, Einkommensteuertabellen oder Entwürfe des vorherigen Landes hat (PAYROLL_COMPLIANCE_COUNTRY_LOCKED, mit den Anzahlen im Detail). Richten Sie die Mitarbeiter aus, entfernen Sie die Konfiguration des vorherigen Landes (Steuern und Compliance zeigt die inaktiven Zeilen) und speichern Sie erneut.

Die vorgeschlagenen Pakete

Jedes Land bringt ein vorgeschlagenes Paket des allgemeinen Regimes mit. Die Sätze sind ein Ausgangspunkt, den die Firma prüft, bei Bedarf bearbeitet und unterschreibt; 4Geeks zertifiziert sie nicht.

Land Arbeitnehmer Arbeitgeber Einkommensteuertabelle
Argentinien 17,00 % 25,11 % 2025
Bolivien 11,71 % 6,71 % 2025 (RC-IVA)
Brasilien 7,5–14 % (INSS, progressiv) 35,80 % 2025
Chile 20,20 % 10,30 % 2025
Costa Rica 10,83 % 26,83 % 2026 (Hacienda)
Dominikanische Republik 5,91 % 16,34 % 2025
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
Kolumbien 8,00 % 30,02 % 2025
Mexiko 2,295 % 18,275 % 2025
Nicaragua 7,00 % 23,50 % 2025
Panama 9,00 % 18,35 % 2025
Paraguay 9,00 % 23,80 % 2025
Peru 12,50 % 10,15 % 2025
Uruguay 18,00 % 14,50 % 2025
Venezuela 5,50 % 15,00 % Manuell

Jedes Paket wird in einzelne Zeilen aufgeteilt (zum Beispiel CCSS/IVM in Costa Rica, IMSS/INFONAVIT in Mexiko, AFP/ISAPRE in Chile, INSS/FGTS in Brasilien), die Sie prüfen, bearbeiten oder löschen können.

Obergrenzen und progressive Beiträge

Eine Zeile kann eine Beitragsobergrenze haben (max_base): Brutto darüber ist beitragsfrei (Mexiko, Chile, Panama, Honduras, El Salvador, Dominikanische Republik). Das Arbeitnehmer-INSS in Brasilien ist progressiv: Jeder Satz gilt für seine Stufe. Beide Felder sind optional und bleiben in Costa Rica leer, sodass sich die Berechnung nicht ändert.

Einkommensteuer

Die Konsole behält Lohnsteuer ein, wenn das Land eine gültige Tabelle hat:

  • 17 mitgelieferte Tabellen (Argentinien, Bolivien, Brasilien, Chile, Costa Rica, Dominikanische Republik, Ecuador, El Salvador, Guatemala, Honduras, Kolumbien, Mexiko, Nicaragua, Panama, Paraguay, Peru, Uruguay). Venezuela hat keinen Vorschlag: Fügen Sie Ihre eigene Tabelle hinzu und unterschreiben Sie sie.
  • Basis nach Sozialabgaben: In den meisten Ländern ist die Basis das Brutto minus die Arbeitnehmerbeiträge derselben Zahlung. Costa Rica behält die Bruttobasis.
  • Familienbeträge: Sie können eine Steuergutschrift auf die berechnete Steuer (Costa Rica) oder ein Abzug von der Bemessungsgrundlage (Argentinien) sein.
  • Währung: Die Tabelle gilt nur, wenn ihre Währung mit der Lohnwährung übereinstimmt. Der Bildschirm warnt bei Abweichung (zum Beispiel ein costa-ricanischer Workspace, der in USD zahlt) und die Steuer wird nicht einbehalten, bis sie übereinstimmen.

Bearbeiten oder fügen Sie eine Tabelle unter Steuern und Compliance → Einkommensteuer hinzu. Neue Versionen behalten die Historie: Eine Tabelle gilt ab ihrem Gültigkeitsdatum und schreibt frühere Abrechnungen nicht um.

Paket installieren oder wiederherstellen

Wenn Sie das Land des Unternehmens festlegen oder ändern, installiert die Konsole das vorgeschlagene Paket automatisch: Sozialabgaben, Einkommensteuertabelle und Feiertage des Jahres. Vorhandene Zeilen für dieses Land werden nie überschrieben.

Wenn Sie die Zeilen bearbeitet haben und den Vorschlag zurück wollen, verwenden Sie Vorgeschlagene Sätze wiederherstellen. Die Länderkarte zeigt die Paketversion, die öffentlichen Quellen und den Referenzmindestlohn.

Der Kunde unterschreibt die Sätze

Die Zahlung bleibt gesperrt, bis die Firma die Sätze unterschreibt, die sie verwenden wird.

  1. Klicken Sie auf Prüfen und unterschreiben.
  2. Prüfen Sie jeden Satz, jede Obergrenze, jede progressive Stufe und die Einkommensteuertabelle.
  3. Geben Sie den vollständigen Namen der unterzeichnenden Person ein, fügen Sie optional eine Notiz hinzu und bestätigen Sie die Verantwortungserklärung.
  4. Die Konsole speichert die Unterschrift mit dem serverseitig berechneten Hash der genauen Zeilen, dem Namen, dem Benutzer, der E-Mail, der Rolle und dem Datum. Sie erscheint auch im Audit-Trail.

Ändert sich danach ein Satz oder eine Tabelle, wird die Unterschrift veraltet und die Konsole verlangt eine neue. Der Hash wird von der Datenbank (payroll_compliance_config_hash) berechnet, nie vom Browser, sodass die Unterschrift genau das abdeckt, was die Lohnabrechnung verwendet.

Zahlungssperre

Ein Lauf kann ohne Unterschrift Entwurf sein oder zur Genehmigung eingereicht werden, aber er kann nicht genehmigt, auf Processing/Completed gesetzt oder bezahlt werden — und eine Abrechnung kann nicht als Bezahlt markiert werden — bis die Unterschrift zu den aktuellen Sätzen passt (PAYROLL_COMPLIANCE_NOT_SIGNED).

Die Compliance-Checkliste

Die Checkliste wird aus den Workspace-Daten berechnet, nicht fest verdrahtet. Sie markiert:

  • das Compliance-Land fehlt oder wird nicht unterstützt;
  • das Paket ist nicht installiert oder hat keine Arbeitnehmer-/Arbeitgeberzeilen;
  • keine Einkommensteuertabelle für das Land;
  • die Währung der Einkommensteuertabelle passt nicht zur Lohnwährung;
  • aktive Mitarbeiter aus einem anderen Land (mit der Aktion Ausrichten);
  • Feiertage des Jahres nicht geladen;
  • Sätze nicht unterschrieben oder Unterschrift veraltet.

Fehler sperren die Zahlung; Warnungen sind Empfehlungen. Beheben Sie sie, bevor Sie die Lohnabrechnung starten.

Elektronische Meldungen

Derselbe Bildschirm listet die periodischen Meldungen des Landes: Fristen, Status, Referenz der Behörde und Bestätigung. Die CCSS-SICERE-Datei von Costa Rica wird von der Konsole erzeugt (Sätze 25, 35 und 15) und die INS hat einen API-Connector. Siehe Elektronische Meldungen für die Schritt-für-Schritt-Anleitung und den Kanal pro Land.

Fehlerbehebung

Symptom Ursache und Lösung
PAYROLL_COMPLIANCE_COUNTRY_LOCKED Es verbleiben Mitarbeiter, Steuerzeilen, Einkommensteuertabellen oder Entwürfe des vorherigen Landes. Richten Sie die Mitarbeiter aus, entfernen Sie die vorherige Konfiguration und speichern Sie das Land erneut.
PAYROLL_COMPLIANCE_NOT_SIGNED Die Sätze wurden nie unterschrieben oder haben sich nach der Unterschrift geändert. Öffnen Sie Prüfen und unterschreiben und unterschreiben Sie erneut.
PAYROLL_COMPLIANCE_COUNTRY_FORBIDDEN Nur der Inhaber und die Workspace-Administratoren können das Land ändern.
Die Länderkarte sagt „nicht konfiguriert“ Das Land des Unternehmens ist leer oder kein lateinamerikanisches Land. Legen Sie es unter Einstellungen → Unternehmen fest.
Einkommensteuer wird nicht einbehalten Keine Tabelle für das Land, die Währung der Tabelle passt nicht zur Lohnwährung oder die Gehälter liegen unter der ersten Stufe.
„Keine Arbeitnehmer-/Arbeitgeberbeiträge“ Das Paket ist nicht installiert oder alle Zeilen wurden gelöscht. Installieren oder stellen Sie das vorgeschlagene Paket wieder her.

Häufige Fragen

Kann ich Mitarbeiter in mehreren Ländern in einem Workspace haben?

Nein. Die Lohnabrechnung hat ein Compliance-Land pro Workspace, wie die eine Lohnwährung. Mitarbeiter eines anderen Landes müssen ausgerichtet werden (oder in ihren eigenen Workspace wechseln), bevor gezahlt wird.

Kann ich das Land später ändern?

Ja, wenn der Workspace keine Mitarbeiter, Steuerzeilen, Einkommensteuertabellen oder Entwürfe des vorherigen Landes mehr hat. Frühere Abrechnungen behalten ihren Snapshot; die Änderung betrifft nur das, was folgt.

Sind die vorgeschlagenen Sätze offiziell?

Es ist der Vorschlag des allgemeinen Regimes, den die Konsole mitliefert, mit öffentlichen Quellen. Die Firma prüft und unterschreibt sie; Sonderregime (SIMPLES, Monotributo, häusliche Arbeit, Tarifverträge) und gesetzliche Meldungen liegen außerhalb des Umfangs.

Meldet 4Geeks bei der Behörde für mich?

Nein. Die Konsole erzeugt die offizielle Datei und speichert den Nachweis; der Kunde lädt sie hoch und erfasst die Bestätigung. Die einzige direkte API ist heute die INS von Costa Rica, und der Kunde stellt immer Zertifikat und Autorisierung bereit.

Warum ist meine Unterschrift veraltet?

Jede Änderung an einem Satz, einer Obergrenze, einer progressiven Stufe oder der Einkommensteuertabelle ändert den Hash. Das ist beabsichtigt: Die Unterschrift deckt die genauen Werte ab, die die Lohnabrechnung verwendet.

Verwandt


Noch Fragen? Frag uns auf Discord oder entdecke die Tutorials.