Connect e-Faktura

Connect your company to e-Faktura on one settings page: enter the identity values UJP gave you, upload the certificate, verify, and switch the module on. Have the values from Before you start at hand.

Open Settings > e-Faktura. The page is there only for Macedonian companies, and you need the Manage settings and certificate permission to change it (owners, admins and accountants have it).

The Connection card shows whether e-Faktura is verified and switched on, the environment and when the certificate expires.

Enter the e-UJP user id that the e-Faktura portal shows on its profile screen.

Check the company tax number. It is prefilled from General settings and must have exactly 13 digits.

The certificate serial and signer name fill in from the certificate when you upload it.

Choose the UJP test or production system. Until the live connection exists, both run on the simulator.

Save the identity and the other settings on this page.

Next, upload the company's .pfx or .p12 certificate with its password, then verify the connection.

Next

Done

That is everything. You can replay it any time.

Start over

1. The Connection card shows whether e-Faktura is verified and switched on, the environment and when the certificate expires.

2. Enter the e-UJP user id that the e-Faktura portal shows on its profile screen.

3. Check the company tax number. It is prefilled from General settings and must have exactly 13 digits.

4. The certificate serial and signer name fill in from the certificate when you upload it.

5. Choose the UJP test or production system. Until the live connection exists, both run on the simulator.

6. Save the identity and the other settings on this page.

7. Next, upload the company's .pfx or .p12 certificate with its password, then verify the connection.

1. Step 1: The Connection card shows whether e-Faktura is verified and switched on, the environment and when the certificate expires.
2. Step 2: Enter the e-UJP user id that the e-Faktura portal shows on its profile screen.
3. Step 3: Check the company tax number. It is prefilled from General settings and must have exactly 13 digits.
4. Step 4: The certificate serial and signer name fill in from the certificate when you upload it.
5. Step 5: Choose the UJP test or production system. Until the live connection exists, both run on the simulator.
6. Step 6: Save the identity and the other settings on this page.
7. Step 7: Next, upload the company's .pfx or .p12 certificate with its password, then verify the connection.

1. Fill in the UJP identity#

1. In the UJP identity card, enter e-УЈП user id (X-EUJP-ID) from the profile screen of the e-Faktura portal.
2. Check Tax number (X-EDB), 13 digits. Bilify prefills it from the company tax number under Settings > General; it must be exactly 13 digits.
3. Leave Certificate serial (X-SERIAL-NUMBER) empty for now if you have not uploaded the certificate: Bilify fills it from the file. If UJP's certificate screen shows the serial in another form, type UJP's value here after the upload.
4. Signer name is also filled from the certificate. Correct it if needed.
5. Choose the Environment: UJP test system or UJP production system.
6. Click Save.

2. Upload the certificate#

The Qualified certificate card is a separate form, so picking a file never saves the other settings.

1. Under Certificate file (.pfx / .p12), choose the file. Only .pfx and .p12 files up to 64 KB are accepted.
2. Enter the Certificate password.
3. Click Upload.

Bilify opens the file with the password and stores the certificate encrypted. It is used only to sign requests to UJP and is never shown again or sent to your browser. After a successful upload the card shows:

• Certificate subject: the name and identifiers the certificate was issued to.
• Expires: the last day it is valid.
• The Connection card shows Valid until with the same date, and Certificate serial (X-SERIAL-NUMBER) and Signer name are filled from the new certificate. Uploading a replacement always takes the serial and signer of the new file.

If the file cannot be opened you see: The file could not be opened with that password. Check that it is a .pfx/.p12 bundle and the password is correct.

3. Verify the connection#

Upload the certificate first: verification signs a request with it, so it does not run without one.

Click Verify connection in the Connection card. Bilify first saves the identity fields on screen, then:

1. reads UJP's server time,
2. looks up your tax number in UJP's taxpayer register,
3. sends a request signed with your certificate.

On success the status becomes Verified, Last verified shows the time and UJP registry name shows your company's name as UJP has it. On failure the status becomes Error and a red box shows the reason with UJP's error code. See Troubleshooting.

4. Switch e-Faktura on#

1. In the Activation card, turn on e-Faktura is switched on for this company.
2. Click Save.

Switching on needs an uploaded certificate; without one you see Upload a certificate before switching e-Faktura on. Once it is on, the Connection card shows Switched on, the e-Faktura card appears on issued invoices and e-Faktura > Received invoices appears in the menu.

Statuses on the Connection card#

Remove the certificate or disconnect#

• Remove certificate (under the certificate details) deletes the stored certificate together with its serial and signer name, and switches e-Faktura off. Sending stops until you upload a new one. Use it when the certificate is replaced or compromised.
• Disconnect removes the whole e-Faktura connection, including the identity values, automation choices and the certificate. The e-Faktura card, the inbox and the menu entry disappear. Invoices already registered keep their EUID and status in Bilify.

Both ask for confirmation first.

Connecting, uploading or removing a certificate, verifying and disconnecting are all recorded in the activity log, with who did it and when.