ENDer erste API-Call in fünf Minuten
Quickstart für die Lohnica Payroll API: Authentifizierung, erster Request, Antwort in Millisekunden – dazu OpenAPI-Spec, Swagger-UI und MCP-Server.
Was Sie wissen müssen
- Basis-URL: https://app.lohnica.de/api/v1
- REST über HTTPS, Anfragen und Antworten als JSON
- Authentifizierung per API-Key (X-API-Key-Header) oder OAuth2
- Der Abrechnungsmonat steckt in der URL, z. B. /gross-net-calc/2026-09
- Berechnungen auch für vergangene und zukünftige Monate – mit den jeweils gültigen Werten
Ihr erster Aufruf
Eine Brutto-Netto-Berechnung für September 2026: 4.500 € brutto, Steuerklasse 1, Bayern, Techniker Krankenkasse. Die Antwort kommt in Millisekunden – hier um die Beitragssätze gekürzt, die Zahlen sind echt.
curl -X POST \ https://app.lohnica.de/api/v1/gross-net-calc/2026-09 \ -H "X-API-Key: <ihr-api-key>" \ -H "Content-Type: application/json" \ -d '{ "monthly-gross-income": 4500, "income-tax-class": "1", "state": "by", "age": 35, "church-tax": false, "health-insurance-company-number": "15027365" }'
{ "data": { "gross-income": 4500.0, "net-salary": 2874.31, "net-pay": 2874.31, "labor-cost": 5568.08, "employee": { "income-tax": 651.66, "health-insurance": 389.03, "nursing-care-insurance": 108.0, "pension-insurance": 418.5, "unemployment-insurance": 58.5, "insurance-total": 974.03 }, "employer": { "insurance-total": 1068.08 } } }
Gültige Kassen-Betriebsnummern liefert GET /health-insurances/ – tagesaktuell inklusive Zusatzbeiträgen.
Vier Rechenarten, ein Aufruf-Muster
Betriebliche Altersvorsorge und Firmenwagen sind in allen vier Rechenarten enthalten.
Brutto → Netto
Vom Bruttolohn zu Netto, Abgaben und Arbeitgeberkosten – der Klassiker.
Netto → Brutto
Vom Wunschnetto rückwärts zum nötigen Brutto – etwa für Gehaltsverhandlungen.
Lohnkosten → Netto
Vom Budget zum Gehalt: Welches Brutto und Netto stecken in X € Arbeitgeberkosten?
Probeabrechnung
Die komplette Lohnabrechnung mit vollständigen Stammdaten und großer Lohnarten-Auswahl – Benefits wie Erholungsbeihilfe, Deutschlandticket oder Essenschecks inklusive pauschaler Besteuerung und Abwälzung, dazu PDF-Export.
Lieber ganz ohne Code?
Alle Rechenarten stehen auch als MCP-Tools bereit: mcp.lohnica.de verbindet Claude, Cursor & Co. direkt mit der Lohnica API – ohne lokale Installation.
Häufige Fragen
Den schnellsten Eindruck gibt der Brutto-Netto-Rechner auf dieser Website – er nutzt dieselbe API. Für eigene Tests registrieren Sie sich im API-Portal und erstellen dort Ihren API-Key selbst – ohne Wartezeit, inklusive Nutzungsübersicht.
Fragen zur Integration?
Ihren API-Key erstellen Sie selbst im API-Portal. Bei allem anderen – Payroll-API, Volumina, Beratung – melden Sie sich gerne.