МПИН is the file (XML/TXT) an employer uses to report per-employee contributions and personal income tax to UJP. You generate and validate it through the API, then file it yourself.

How is gross converted to net salary?

Contributions (pension, health) are deducted from gross, then personal income tax applies to what remains after the personal allowance.

Does the Payroll API file the МПИН with UJP?

No. The API generates and validates the file; you upload it to UJP yourself.

Is there a free trial?

There are no free trials or free plans. There is a sandbox for testing, included with every account.

A personal income tax filing for payments outside regular payroll (for example, a contractor fee). The API also supports grossing up from a given net amount.

Do you support net-first calculations?

Yes — pass targetNet instead of grossSalary and the API calculates the gross that produces that net.

Do you store employee data?

Not beyond what the request itself needs. Only metering hashes and an audit trail are kept, per data-protection minimisation.

Do rates apply to past periods too?

Yes — through the rate-history endpoint, a past period recalculates with the rate in force on that date, not today's.

What languages are payslips available in?

Macedonian, Albanian and English, as a PDF from one endpoint.

Does it work for Kosovo or Serbia too?

Not in this version — the API is North Macedonia only. The engine supports other markets; that is a decision for later.

Available now · North Macedonia

Payroll API for North Macedonia — gross-to-net, МПИН and е-ППД files

Always compliant, with zero maintenance. When contribution rates, personal income tax rules or the МПИН / е-ППД formats change, Merot updates the engine. Your calculations and files are compliant from the effective date — no code change on your side.

Get started Get API keys

A sandbox is included for testing before production.

POST /v1/calculationsexample · gross-first

curl https://api.payroll.merot.com/v1/calculations \
  -H "Authorization: Bearer $MEROT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "grossSalary": "45000",
    "workingHours": 176,
    "overtimeHours": 8,
    "nightHours": 4
  }'

→ 200 OK

{
  "salaryGross": "49142",
  "totalContributions": "13760",
  "pit": "2445",
  "salaryNet": "32937",
  "netPaid": "32937"
}

Gross-first example; pass targetNet instead of grossSalary to invert net→gross. Money is exact to the denar, as decimal strings.

МПИН · е-ППД · ПДД-ГИ

Date-effective rates

Payslips in MK/SQ/EN

Powers Merot HRS in production

How it works

From your HR system to UJP files

01 · youYour HR systemPOST with gross or net salary, hours, seniority and bonus for the period.

02Merot Payroll APICalculates contributions, personal income tax and net pay, using the rates in force on the payment date.

03Net pay + payslipA result exact to the denar, and a PDF payslip in MK/SQ/EN.

04МПИН / е-ППД filesGenerated and validated — you upload them to UJP yourself.

Important: the API never files МПИН or е-ППД with UJP on your behalf — you upload the generated files yourself.

Benefits

Built to survive every rate change

Always compliant, with zero maintenance

When contributions, personal income tax or the МПИН/е-ППД formats change, Merot updates the engine. Your calculations and files are correct from the effective date — with no code change on your side.

Date-effective rates

Rates apply on the payment date, so past periods recalculate correctly through the rate-history endpoint.

МПИН is validated before you upload

XML and TXT files are checked with UJP-style rules before you generate them.

Powers Merot HRS in production

The same engine that calculates payroll for Merot HRS employees — not new, untested code.

Exact to the denar

Every amount is a decimal string — no float rounding surprises in your code.

Payslips in MK/SQ/EN

PDF payslips in three languages, from one endpoint.

No employee data stored

Nothing is retained beyond the request itself, except metering hashes and audit logs.

Comparison

Build it yourself vs. Merot

Area	Build it yourself	With Merot
Contribution & PIT rates	You track UJP/МПИН rate changes yourself	Date-effective, updated automatically
МПИН / е-ППД / ПДД-ГИ formats	Build and validate the XML/TXT yourself	Generated and validated, before you download them
Gross↔net, proration	Build the inversion math yourself	One endpoint, both directions
Leave accrual/carry-over/cash-out	Build MK labour-law leave rules yourself	Included, via dedicated endpoints
Payslip PDFs	Build a PDF renderer in 3 languages	MK/SQ/EN from one endpoint

Developer experience

Built for integrators

5-minute quickstart

Your first calculation in the sandbox, with a real code example.

A sandbox for testing

Test calculations and files before production, without real employees.

Batch up to 500 employees

One call for the whole batch — results come back in the same order.

OpenAPI + SDKs

A full OpenAPI specification; official SDKs for TypeScript and C#.

cURLNode.jsPythonPHPC#Java

Versioning →

Payroll API for North Macedonia — gross-to-net, МПИН and е-ППД files

From your HR system to UJP files

Built to survive every rate change

Always compliant, with zero maintenance

Date-effective rates

МПИН is validated before you upload

Powers Merot HRS in production

Exact to the denar

Payslips in MK/SQ/EN

No employee data stored

Build it yourself vs. Merot

Built for integrators

5-minute quickstart

A sandbox for testing

Batch up to 500 employees

OpenAPI + SDKs

Per-employee pricing, at any volume

Directly to the Merot team

Email

Contact form

Languages

Frequently asked questions

For context around payroll and МПИН

Get your API keys