Merot Payroll API
Ein zentraler Dienst, der Lohn berechnet und die UJP-МПИН- und e-PDD-Dateien fur Nordmazedonien erzeugt. Dieselbe Engine wie Merot HRS — als REST-API fur jede Instanz oder jeden Kunden.
Was der Dienst tut
Die Payroll-API ist ein zustandsloser HTTP-Dienst. Jede Anfrage tragt ihre eigenen Daten — kein Kunde oder Unternehmen wird auf dem Server gespeichert. Zwei Endpunktgruppen: Berechnung (brutto↔netto) und Dateigeneratoren fur die UJP.
- Lohnberechnung mit Beitragsbemessungsgrenze und Netto→Brutto-Inversion.
- МПИН-XML und -TXT sowie e-PDD-GI-XML — genau im von der UJP akzeptierten Format.
- Krankheit, Uberstunden, Nacht-, Feiertagsstunden und Korrekturen.
- Jede juristische Person wird in der Anfrage ubergeben — ЕДБ, ЕМБС und weitere.
Basis-URL und Authentifizierung
Jede Anfrage tragt einen X-API-Key-Header. Schlussel werden pro Integrator ausgegeben — kontaktieren Sie uns fur Zugang.
Base URL https://api.payroll.merot.com Header X-API-Key: <your-key> Content application/jsonReferenz
| Methode & Pfad | Beschreibung |
|---|---|
| POST /api/v1/calculate | Berechnung fur einen Mitarbeiter — grossSalary oder targetNet (invers). |
| POST /api/v1/calculate/batch | Stapelberechnung (bis 500). |
| POST /api/v1/generators/mk/mpin-xml | МПИН-XML fur die UJP. |
| POST /api/v1/generators/mk/mpin-txt | МПИН-TXT (Semikolon). |
| POST /api/v1/generators/mk/pddgi-xml | e-PDD-GI-XML (Honorare / sonstiges Einkommen). |
| GET /api/v1/generators | Verfugbare Generatoren je Land. |
| GET /api/v1/rates | Aktuelle Satze und Konfiguration je Land. |
МПИН-XML fur jede juristische Person erzeugen
Die juristische Person wird im employer-Block definiert — nichts ist unternehmensspezifisch fest verdrahtet. Es muss gelten: Brutto − Beitrage − Steuer = Netto.
POST /api/v1/generators/mk/mpin-xml X-API-Key: <your-key> { "periodMonth": 6, "periodYear": 2026, "vidObvrska": "110", "workingHours": 176, "employer": { "taxId": "4030007636033", "registrationNumber": "7609230", "name": "ПРИМЕР ДООЕЛ", "vidObvrznik": "101", "address": "Партизанска 5", "city": "Скопје", "municipalityCode": "040", "postalCode": "1230", "phone": "023246899", "email": "info@primer.mk" }, "records": [ { "embg": "2403980410018", "firstName": "Александар", "lastName": "Ацев", "grossSalary": 65000, "netSalary": 47268, "pension": 12220, "health": 4875, "additionalHealth": 325, "employmentContrib": 780, "pit": 3680, "personalAllowance": 10932, "totalContributions": 18200, "workingHours": 176, "bankAccount": "210501611620323", "municipalityCode": "103" } ] } → 200 application/xml (<MpinCalculation> … </MpinCalculation>)Krankheitsfelder (sickCompanyHours, sickCompanyRate, sickCompanyPay, sickFundHours, sickFundPay) sind pro Mitarbeiter und entfallen ohne Abwesenheit.
API-Schlussel gewunscht?
Wir vergeben Schlussel pro Integrator und unterstutzen die Anbindung Ihrer HRS-Instanz oder Ihres Systems.
Kontakt