е-Фактура API
v1 Водичи EN Започнете

е-Фактура API

Sandbox

Две околини, избрани според клучот

Клуч mfk_test_... или sandbox OAuth клиент секогаш комуницира само со тест системот на УЈП (efakturatest.ujp.gov.mk) или со симулаторот на Merot — никогаш со продукција. Клуч mfk_live_... секогаш комуницира само со продукција, и само откако вашата сметка ќе има активен платен план.

Сметки за развивачи

Sandbox-сметка само за развивачи не бара плаќање и може да создава sandbox клучеви, но никогаш не може да создаде продукциски клуч ниту да овозможи продукција за компанија. Ова е единствениот тип сметка што е бесплатен; секоја продукциска употреба бара платен план (Merot нема бесплатни пробни периоди ниту бесплатни планови за продукција). Регистрирајте сметка за развивачи на developer.merot.com/console/signup — самостојно, активна веднаш.

Симулаторот

Ако вашата компанија сè уште нема тест сертификат од УЈП, поставете го нејзиниот sandbox backend на симулаторот наместо на вистинскиот тест систем на УЈП. Симулаторот:

  • Прифаќа само-потпишани тест сертификати што ги генерирате самите, за да не ви треба вистински токен за да го испробате API-то од почеток до крај.
  • Доделува EUID-и и ги придвижува документите низ статусни промени на барање (POST /v1/sandbox/einvoices/{id}/simulate) наместо да чека на УЈП.
  • Може да внесе симулирана влезна е-фактура (POST /v1/sandbox/inbox), за да можете да го изградите и тестирате прифаќањето влезни документи без вистински деловен партнер.

Документите од симулаторот секогаш се означени со environment: "sandbox" и никогаш не се достапни со live клуч.

Забелешка

Штом добиете вистински КИБС или Телеком тест сертификат, префрлете го sandbox backend-от на компанијата на вистинскиот тест систем на УЈП, за да проверите наспроти вистинските правила на УЈП пред да преминете во продукција.