Payroll API

Overview

The Merot Payroll API lets any software — HR systems, accounting packages, ERPs, in-house tools — calculate North Macedonian payroll correctly and produce the files UJP expects, without maintaining contribution rates, personal income tax rules or the МПИН (MPIN) and е-ППД (e-PPD) formats yourselves. It’s built on the same calculation engine already running in production for Merot HRS and Merot ERP.

Public v1 is North Macedonia only.

What it covers

• Calculations — single and batch, gross-first and net-first, proration for partial months, and date-effective statutory rates.
• Leave — annual-leave accrual, year-end carry-over and termination cash-out, per MK labour law.
• UJP files — МПИН XML/TXT (single, combined and validate-only), ПДД-ГИ XML for contractor payments, and standalone е-ППД XML.
• Payslips — PDF payslips in MK, SQ and EN.

Not in v1: e-submission to UJP (see below), Kosovo and Serbia payroll (the engine supports them; a public decision to expose them hasn’t been made), ledger posting, and time-tracking session endpoints — those stay internal.

What this API never does

Merot never submits a МПИН, е-ППД or ПДД-ГИ filing to UJP on your behalf. Every file-generation endpoint hands you back a file; uploading it to UJP’s own portal is always something you or your accountant does yourselves. See МПИН, е-ППД and ПДД-ГИ files.

No side effects

Unlike the e-Faktura API, this API stores nothing. Every endpoint is a pure calculation over the data you send — the same input always produces the same output, and there’s no server-side state to keep in sync. See Idempotency.

Pricing

Per-employee monthly plans, metered by distinct employees calculated per calendar month, plus a per-employee vendor plan for accounting firms and software vendors running payroll for many employers. See Payroll API pricing. Sandbox developer accounts are free; production use needs a paid plan.