Merot Payroll API
Еден централен сервис што ја пресметува платата и ги генерира УЈП МПИН и е-ПДД датотеките за Северна Македонија. Истиот engine што го користи Merot HRS — достапен преку REST API за секоја инстанца или клиент.
Што прави сервисот
Payroll API е stateless HTTP сервис. Секое барање носи свои податоци — ниту еден клиент или компанија не се чуваат на серверот. Две групи endpoint-и: пресметка (бруто↔нето) и генератори на датотеки за поднесување во УЈП.
- Пресметка на плата со капа на основицата и инверзија нето→бруто.
- МПИН XML и TXT, и е-ПДД ГИ XML — точно во форматот што УЈП го прифаќа.
- Боледување, прекувремено, ноќна, празници и корекции.
- Секоја правна единица се праќа во барањето — ЕДБ, ЕМБС и остатокот.
Основен URL и автентикација
Секое барање носи X-API-Key заглавие. Клучевите се издаваат по интегратор — контактирајте нè за пристап.
Base URL https://api.payroll.merot.com Header X-API-Key: <your-key> Content application/jsonРеференца
| Метод и патека | Опис |
|---|---|
| POST /api/v1/calculate | Пресметка за еден вработен — бруто или targetNet (инверзија). |
| POST /api/v1/calculate/batch | Пакетна пресметка (до 500). |
| POST /api/v1/generators/mk/mpin-xml | МПИН XML за УЈП. |
| POST /api/v1/generators/mk/mpin-txt | МПИН TXT (точка-запирка). |
| POST /api/v1/generators/mk/pddgi-xml | е-ПДД ГИ XML (хонорари / друг личен доход). |
| GET /api/v1/generators | Листа на достапни генератори по земја. |
| GET /api/v1/rates | Тековни стапки и конфигурација по земја. |
Генерирај МПИН XML за која било правна единица
Правната единица се дефинира во employer блокот — ништо не е фиксирано на компанија. Мора да важи: бруто − придонеси − ПДД = нето.
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>)Полиња за боледување (sickCompanyHours, sickCompanyRate, sickCompanyPay, sickFundHours, sickFundPay) се по вработен и се изоставаат кога нема отсуство.
Сакате API клуч?
Издаваме клучеви по интегратор и помагаме при поврзување на вашата HRS инстанца или систем.
Контакт