Payroll API

Errors

Every error is application/problem+json (RFC 9457):

{
  "type": "https://developer.merot.com/payroll/errors#validation_failed",
  "title": "Validation failed",
  "status": 422,
  "detail": "grossSalary or targetNet is required.",
  "instance": "req_01J9Z6M2N3P4Q5R6S7T8U9V0",
  "code": "validation_failed",
  "errors": [
    { "path": "grossSalary", "message": "grossSalary or targetNet required" }
  ]
}

instance is the request id; include it when contacting support.

Codes

Code	Status	Meaning
`unauthenticated`	401	Missing or invalid API key.
`key_revoked`	401	The API key has been revoked.
`company_required`	400	`X-Company-Id` is required (the key has more than one employer company).
`validation_failed`	422	Field-level validation errors — most commonly a missing `grossSalary`/`targetNet`, or a malformed decimal string.
`mpin_validation_failed`	422	A МПИН file-generation call found blocking issues; the response lists them, or pass `force: true` to generate anyway.
`rate_limited`	429	Too many requests — see Rate limits.
`not_found`	404	No such resource for this company (e.g. an unknown country/rate key).