Merot Payroll API
Nje sherbim qendror qe llogarit pagen dhe gjeneron dosjet UJP MPIN dhe e-PDD per Maqedonine e Veriut. I njejti engine qe perdor Merot HRS — i disponueshem permes REST API per cdo instance ose klient.
Cfare ben sherbimi
Payroll API eshte sherbim HTTP stateless. Cdo kerkese mban te dhenat e veta — asnje klient ose kompani nuk ruhet ne server. Dy grupe endpoint-esh: llogaritje (bruto↔neto) dhe gjenerues dosjesh per UJP.
- Llogaritje page me tavan baze dhe inversion neto→bruto.
- MPIN XML dhe TXT, dhe e-PDD GI XML — sakte ne formatin qe UJP e pranon.
- Semundje, jashteorar, nate, festa dhe korrigjime.
- Cdo subjekt juridik dergohet ne kerkese — EDB, EMBS dhe pjesa tjeter.
URL baze dhe autentikim
Cdo kerkese mban header-in X-API-Key. Celesat leshohen per integrues — na kontaktoni per qasje.
Base URL https://api.payroll.merot.com Header X-API-Key: <your-key> Content application/jsonReferenca
| Metoda dhe rruga | Pershkrim |
|---|---|
| POST /api/v1/calculate | Llogaritje per nje punonjes — bruto ose targetNet (inversion). |
| POST /api/v1/calculate/batch | Llogaritje ne grup (deri 500). |
| POST /api/v1/generators/mk/mpin-xml | MPIN XML per UJP. |
| POST /api/v1/generators/mk/mpin-txt | MPIN TXT (pikepresje). |
| POST /api/v1/generators/mk/pddgi-xml | e-PDD GI XML (honorare / te ardhura personale). |
| GET /api/v1/generators | Lista e gjeneruesve sipas vendit. |
| GET /api/v1/rates | Normat aktuale dhe konfigurimi sipas vendit. |
Gjenero MPIN XML per cdo subjekt juridik
Subjekti juridik percaktohet ne bllokun employer — asgje nuk eshte e fiksuar per kompani. Duhet te vleje: bruto − kontribute − TP = neto.
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>)Fushat e semundjes (sickCompanyHours, sickCompanyRate, sickCompanyPay, sickFundHours, sickFundPay) jane per punonjes dhe hiqen kur s'ka mungese.
Doni nje celes API?
Leshojme celesa per integrues dhe ndihmojme ne lidhjen e instances suaj HRS ose sistemit.
Kontakt