Што е е-Фактура?

е-Фактура (на латиница: e-Faktura, eFaktura) е системот на УЈП за електронска размена на фактури во Северна Македонија: проприетарен JSON формат, потпишан како JWS со квалификуван сертификат — не UBL/EN 16931.

Кога е задолжителна е-Фактура?

Законот сè уште не е донесен (октомври 2026), па доброволната фаза планирана за 01.10.2026 не започна. Предлог-законот предвидува задолжителна примена за ДДВ-обврзници од 01.04.2027, потоа поетапно до 01.01.2028 за сите; датумите може да се поместат.

Дали ми треба дигитален сертификат?

Да — квалификуван електронски потпис (QES) на ваше име. Merot Bridge го чува на вашето уредче и потпишува локално; клучот никогаш не заминува.

Дали работи на Mac?

Да. Merot Bridge работи на Windows, macOS и Linux подеднакво — повеќето алатки за потпишување се само за Windows.

Што се случува кога УЈП ќе ја промени спецификацијата?

Merot ја апсорбира промената зад API-то. Интеграцијата ви продолжува да работи; прекршувачки промени доаѓаат само во нова верзија, според политиката за верзионирање.

Дали постои бесплатен пробен период?

Нема бесплатни пробни периоди ниту бесплатни планови. Постои sandbox за тестирање, вклучен во секоја сметка.

Колку долго се чуваат фактурите?

10 години, во Франкфурт (ЕУ) или во Македонија — по ваш избор. УЈП самиот ги чува само 2 години.

Можам ли да сторнирам или коригирам фактура?

Да — со причина за сторно/корекција (docStorno 1/2) и референца на оригиналниот EUID, целосно вградено во API-то.

Дали цената зависи од бројот на клиент-компании?

Не по компанија — по документ, преку целата ваша сметка. Вендор-планот е наменет токму за тоа: многу клиент-компании под една сметка.

Дали е достапно SDK?

Да — официјални SDK-и за TypeScript и C#, плус примери на код на уште 4 јазици (cURL, Python, PHP, Java).

Достапно сега · За програмери и софтверски куќи

е-Фактура API за УЈП — издавајте и примајте е-фактури од секој софтвер

Изградете еднаш, останете усогласени. Кога УЈП ќе ја промени спецификацијата, форматите или правилата за е-Фактура, Merot ја апсорбира промената зад стабилно, верзионирано API — вашата интеграција продолжува да работи.

Започнете Добијте API клучеви

Sandbox за тестирање пред продукција.

POST /v1/einvoicesпример · песочник

curl https://api.efaktura.merot.com/v1/einvoices \
  -H "Authorization: Bearer $MEROT_API_KEY" \
  -H "Idempotency-Key: inv-2026-000481" \
  -H "Content-Type: application/json" \
  -d '{
  "clientReference": "inv-2026-000481",
  "documentType": "100",
  "buyer": {
    "taxNumber": "4012009123456",
    "name": "Купувач ДОО"
  }
}'

→ 202 Accepted

{
  "id": "einv_01J9Z4M2N3P4Q5R6S7T8U9V0",
  "status": "queued",
  "clientReference": "inv-2026-000481",
  "totals": {
    "net": "10000.00",
    "vat": "1800.00",
    "gross": "11800.00"
  }
}

Враќа 202 веднаш; следете статус преку GET /v1/einvoices/{id} или webhook-и додека УЈП не додели euid и QR-линк.

Windows · macOS · Linux

Архива 10 години

Франкфурт или Македонија — по избор

Поддршка MK / SQ / EN

Како функционира

Електронска фактура (е-Фактура) преку API — од вашиот софтвер до УЈП

01 · виеВашиот софтверPOST /v1/einvoices со едноставен JSON — заглавие, страни, ставки, ДДВ.

02Merot APIВалидира според УЈП правилата и регистарот на купувачи, пред да замине понатаму.

03Merot BridgeПотпишува локално со вашиот квалификуван сертификат — на Windows, macOS или Linux.

04УЈППрима, стои во ред при лимити, повторуваме при потреба — вие не го следите тоа.

05Архива + инбоксСекој документ, 10 години. Влезните фактури течат назад во истото API.

Влезна фактура од ваш добавувач? Прифатете или одбијте пред 10-ти од наредниот месец — по тоа се смета автоматски прифатена.

Придобивки

Изградено за да преживее секоја промена на УЈП

Изградете еднаш, останете усогласени

Кога УЈП ја менува спецификацијата, форматите или правилата, Merot ја апсорбира промената зад едно стабилно, верзионирано API. Прекршувачки промени доаѓаат само во нова верзија на API-то, никогаш неочекувано.

Секој тип документ

Сите типови електронски фактури на УЈП, вклучително сторно и корекција (docStorno 1/2), со причина и референца на оригиналот.

Валидација пред УЈП

Целосна проверка на УЈП правилата и регистарот на купувачи, пред документот воопшто да замине.

Инбокс со рокови

Влезни фактури на едно место, со предупредување пред рокот на 10-ти од наредниот месец.

Архива 10 години

УЈП ги чува документите 2 години; законот бара 10. Merot ги чува 10, вклучено во секој план.

Webhooks, sandbox, 6 јазици

Настани за статус и влезни документи, sandbox против УЈП тест системот, примери код на 6 јазици.

Вашиот сертификат, никогаш не заминува

Merot Bridge потпишува локално на вашиот уред — на Windows, macOS И Linux. Повеќето алатки се само за Windows.

Споредба

Градите сами наспроти Merot

Дел	Сами	Со Merot
УЈП JSON и типови документи	Ги следите сите промени на УЈП сами	Ажурирано зад едно верзионирано API
Квалификуван потпис (JWS)	PKCS#11/токен интеграција за секој ОС посебно	Merot Bridge — готово на сите три; сертификатот никогаш не заминува
Лимити и повторувања	Градите свој ред и логика за backoff	Обработено за вас
Сторно / корекција	Имплементирате docStorno правилата сами	Вградено, со кодови за причина
Рокови за влезни фактури	Го следите правилото 10-ти од месецот сами	Инбокс + предупредувања
Архива 10 години	Градите и одржувате WORM складирање	Вклучено во секој план, во Франкфурт или Македонија по избор

Регулатива

Според предлог-законот за е-фактурирање

Предлог-законот (ЕНЕР, август 2026) сè уште не е донесен, па доброволната фаза планирана за 01.10.2026 не започна; системот е во тест фаза. Датумите подолу се според нацртот и можат да се поместат во владината и собраниската постапка.

01.10.2026

Доброволна фаза (не започна)Планирана во нацртот, но законот не беше донесен навреме; нов датум не е објавен. Кога ќе започне, штом се регистрирате издавате исклучиво преку системот.

01.04.2027

Задолжително за ДДВ-обврзнициВклучувајќи јавни претпријатија и државни/општински компании.

01.07.2027

Задолжително за правни лица без ДДВСекое правно лице кое врши стопанска дејност.

01.10.2027

Задолжително за буџетски кориснициБуџетски корисници, државни/општински непрофитни субјекти, НБРСМ.

01.01.2028

Задолжително за ситеСекое лице кое врши промет мора да издава и прима преку системот.

Developer experience

Изградено за интегратори

Quickstart за 5 минути

Прв документ во sandbox со реален пример на код.

Прочитајте повеќе →

Sandbox за тестирање

Тестирате против симулатор или директно против УЈП тест системот, без вистински документи.

Прочитајте повеќе →

Webhooks

einvoice.submitted/accepted/rejected, inbox.received и рок-предупредувања — потпишани и со повторување.

Прочитајте повеќе →

OpenAPI + SDK-и

Целосна OpenAPI спецификација; официјални SDK-и за TypeScript и C#.

Прочитајте повеќе →

cURLNode.jsPythonPHPC#Java

Верзионирање →

Добијте ги вашите API клучеви

Изградете со е-Фактура API еднаш. Кога УЈП ќе се промени, ние го носиме товарот наместо вас.

е-Фактура API за УЈП — издавајте и примајте е-фактури од секој софтвер

Електронска фактура (е-Фактура) преку API — од вашиот софтвер до УЈП

Изградено за да преживее секоја промена на УЈП

Изградете еднаш, останете усогласени

Секој тип документ

Валидација пред УЈП

Инбокс со рокови

Архива 10 години

Webhooks, sandbox, 6 јазици

Вашиот сертификат, никогаш не заминува

Градите сами наспроти Merot

Според предлог-законот за е-фактурирање

Изградено за интегратори

Quickstart за 5 минути

Sandbox за тестирање

Webhooks

OpenAPI + SDK-и

Цени по документ, за секој обем

Директно до тимот на Merot

Е-пошта

Контакт формулар

Јазици

Најчести прашања

За контекст околу е-Фактура

Добијте ги вашите API клучеви