Before you start with e-Faktura

Before Bilify can sign and send invoices for your company, a few things have to exist on UJP's side and with a certificate provider. None of them can be done from Bilify. Use this checklist, then continue with Connect e-Faktura.

What you need#

1. Choose the signer#

Pick the person whose certificate will sign requests to UJP, usually an owner, a director or the accountant who handles e-Faktura. That person needs an e-UJP account, the e-Faktura privileges, and access to the certificate file and its password.

2. Get e-UJP access and e-Faktura privileges#

1. The signer registers as a user of UJP's e-services (е-УЈП) if they are not one yet.
2. In their own e-UJP account, under Мој Профил, the signer ticks Дозволи овластување од други обврзници (allow authorisation by other taxpayers). Without it the company cannot grant them anything.
3. The company's e-UJP administrator signs in and opens Дадени овластувања > Додели овластувања, chooses the signer (by ЕМБГ and username, or an accounting firm by its ЕДБ) and selects the e-Faktura privileges. They are the ones prefixed (е-Фактура), for example (е-Фактура) Креирање/Праќање на фактури, (е-Фактура) Креирање на сторно документи, (е-Фактура) Прифаќање/одбивање на документи, (е-Фактура) Преглед на примени фактури, (е-Фактура) Преглед на испратени документи and (е-Фактура) Превземање на ПДФ.
4. The signer receives an email and accepts the authorisation.

3. Get a qualified certificate file#

UJP accepts valid qualified certificates issued by qualified trust service providers in North Macedonia. KIBS (KIBSTrust) is one such provider; check the current list of qualified providers before you order.

For Bilify you need a software certificate exported as a .pfx or .p12 file, including its private key, with a password. Bilify signs on its servers, so it cannot use a certificate that lives only on a USB token or smart card. Ask your provider for a software certificate if you only have a token.

The certificate must belong to your company: UJP rejects signatures from a certificate issued to another taxpayer. Bilify warns you after upload when the certificate subject does not contain the company tax number.

4. Register the certificate in the e-Faktura web app#

1. On the signer's Windows computer, install UJP's NativeApp and the e-Faktura browser extension (Chrome or Firefox). The download links are on the "browser-extension" page of the e-Faktura wiki.
2. Install the certificate on that computer, with its intermediate and root certificates.
3. Sign in to the e-Faktura web app with the e-UJP username and password. If no certificate is registered for you and the company, the app opens the certificate registration screen; select the certificate and register it.

5. Write down the identity values#

In the e-Faktura web app:

• The profile screen shows the eUJP ID and the tax number.
• The certificate screen shows the certificate serial number.

These three values are sent with every request as the X-EUJP-ID, X-EDB and X-SERIAL-NUMBER headers. You will type them into Bilify.

6. Check your data in Bilify#

UJP compares the seller and buyer details with its taxpayer register. Before your first send:

• Under Settings > General, make sure the company has its Legal name, Tax number (EDB) (13 digits), Street, Number, Postal code and City, written exactly as in UJP's register.
• For every Macedonian company client, fill in the Tax number (EDB) and the address (Street, Postal code, City). Foreign clients need Foreign tax id (non-residents). Individual clients need an address.

UJP support for e-Faktura questions: Kontakt.eFaktura@ujp.gov.mk. UJP asks you to include the email you registered with, the eUJP ID, the tax number and the certificate serial number.