е-Фактура API
Sandbox
Две околини, избрани според клучот
Клуч mfk_test_... или sandbox OAuth клиент секогаш комуницира само со тест системот на УЈП
(efakturatest.ujp.gov.mk) или со симулаторот на Merot — никогаш со продукција. Клуч
mfk_live_... секогаш комуницира само со продукција, и само откако вашата сметка ќе има активен
платен план.
Сметки за развивачи
Sandbox-сметка само за развивачи не бара плаќање и може да создава sandbox клучеви, но никогаш не може да создаде продукциски клуч ниту да овозможи продукција за компанија. Ова е единствениот тип сметка што е бесплатен; секоја продукциска употреба бара платен план (Merot нема бесплатни пробни периоди ниту бесплатни планови за продукција). Самостојната регистрација за sandbox-сметки наскоро стигнува на овој сајт — до тогаш, и ние ќе ви подготвиме сметка.
Симулаторот
Ако вашата компанија сè уште нема тест сертификат од УЈП, поставете го нејзиниот sandbox backend на симулаторот наместо на вистинскиот тест систем на УЈП. Симулаторот:
- Прифаќа само-потпишани тест сертификати што ги генерирате самите, за да не ви треба вистински токен за да го испробате API-то од почеток до крај.
- Доделува EUID-и и ги придвижува документите низ статусни промени на барање
(
POST /v1/sandbox/einvoices/{id}/simulate) наместо да чека на УЈП. - Може да внесе симулирана влезна е-фактура (
POST /v1/sandbox/inbox), за да можете да го изградите и тестирате прифаќањето влезни документи без вистински деловен партнер.
Документите од симулаторот секогаш се означени со environment: "sandbox" и никогаш не се
достапни со live клуч.
Забелешка
Штом добиете вистински КИБС или Телеком тест сертификат, префрлете го sandbox backend-от на компанијата на вистинскиот тест систем на УЈП, за да проверите наспроти вистинските правила на УЈП пред да преминете во продукција.