API · Za programere

eFaktura.me API

REST API koji povezuje vašu aplikaciju, softver ili web sajt sa fiskalnim sistemom Crne Gore - upravljajte kupcima, proizvodima, uslugama i računima, i fiskalizujte gotovinske i bezgotovinske račune direktno preko SEP portala (Samouslužni EFI Portal) Poreske uprave.

✓ REST + JSON · ✓ HMAC autentikacija · ✓ Fiskalizacija preko SEP-a

API · JSON
POST fiskalizuj račun
{
  "kupac": { "pib": "02XXXXXX" },
  "stavke": [
    { "naziv": "Usluga", "cijena": 120 }
  ],
  "placanje": "KARTICA"
}
● 200 OK
{
  "ikof":   "9A3F…C1",
  "jikr":   "b7c2…4e",
  "status": "fiskalizovano"
}
Pregled

Šta je eFaktura.me API

API je most između vašeg sistema i eFaktura.me. Razmjena je JSON preko HTTPS-a, a svaki zahtjev je potpisan tako da samo vi možete koristiti svoj ključ. Ključ je vezan za jednu firmu i vidi samo njene podatke.

API vraća finalne fiskalne podatke (JIKR / IKOF / QR) - izgled i PDF računa pravite sami, tačno onako kako želite. Zato je API idealan za POS softvere, web prodavnice, mobilne aplikacije i back-office integracije.

Mogućnosti

Šta možeš da radiš kroz API

Kupci

Kreiranje i upravljanje kupcima, uz IRMS import preko PIB-a.

Proizvodi i usluge

Katalog proizvoda i usluga sa kategorijama, cijenama i porezima.

Računi + fiskalizacija

Kreiranje gotovinskih i bezgotovinskih računa i fiskalizacija u realnom vremenu preko SEP-a.

Porezi i vrste plaćanja

Čitanje poreskih stopa, kategorija i načina plaćanja koje definiše administrator.

Poslovne jedinice i operateri

Više lokacija i operatera - fiskalizacija po jedinici i kasiru.

Pregledi i šifarnici

Šifarnici (kategorije, porezi, vrste plaćanja) dostupni kao samo-čitanje.

Kako radi

Od ključa do fiskalnog računa u 4 koraka

1

Dobijaš ključ

Izdajemo client_id i client_secret, podešavamo IP allowlist i scopes.

2

Potpišeš zahtjev

Svaki zahtjev se potpisuje HMAC-om pomoću tvog secret-a - koji se nikad ne šalje.

3

Šalješ JSON

Zoveš endpointe preko HTTPS-a sa JSON tijelom i X-Api-Key headerom.

4

Dobiješ fiskalne podatke

Odgovor vraća JIKR / IKOF / QR - spremno za tvoj izgled računa.

Alati za programere

Sve što ti treba za integraciju

Swagger UI

Interaktivni pregled svih endpointa i šema.

OpenAPI 3.1

Specifikacija za generatore koda i alate.

Postman kolekcija

Živo testiranje sa ugrađenim HMAC potpisivanjem.

PHP primjeri

Gotov klijent i primjeri po operaciji.

Sigurnost

Napravljen za bezbjedne integracije

  • HMAC potpis zahtjeva - secret nikad ne putuje mrežom
  • IP allowlist - API odgovara samo sa tvojih adresa
  • Scopes (customers:*, invoices:*, fiscalization:*) - minimalne dozvole
  • Isključivo HTTPS, ključ vezan za jednu firmu

Spreman za integraciju?

Pošalji upit i dostavljamo pristupne podatke, dokumentaciju i cijenu prilagođenu tvom slučaju.

Zatraži API pristup →