Pređi na glavni sadržaj

Kako povezati?

1. Preduvjeti

Prije nego što krenete sa stvarnim povezivanjem, provjerite sljedeće:

  • Provjerite da imate aktivan korisnički nalog u eDestileriji i da su svi potrebni podaci sistema ažurirani (firma, PI‑B, bankovni račun, …)

  • Provjerite da imate pristup sistemu eSef: korisničko ime/lozinka, eventualno API‑ključ, dokumentacija za API.

    Na sajtu sistema za e‑fakture je dostupno „Sistem elektronskih faktura (SEF) – Upustvo za povezivanje na SEF putem API‑ja“. efaktura.gov.rs+1

  • Dogovorite se sa timom koji održava eDestilerija (ili sami ako ste vi) da:

    • definirate koji podaci iz eDestilerije trebaju da se šalju u eSef

    • definirate tokove: kada se šalje (na fakturi, na dokumentu, periodično)

    • omogućite testno okruženje (sandbox) ako sistem eSef ili eDestilerija to podržavaju

2. Konfiguracija u eDestileriji

  1. Ulogujte se u eDestilerija.

  2. Idite u „Podešavanja“ → „Integracije / Eksterni sistemi“ (ili slično) – ako postoji modul za „eSef“ ili općenito za elektronske evidencije.

  3. Unesite sledeće podatke za povezivanje:

    • URL endpoint‑a za eSef API (testnu i/ili produkcijsku)

    • API ključ / token / autentifikacione podatke

    • Firma / subjekt koji šalje podatke (PIB, matični broj)

    • Vrstu dokumenta koji će se slati (npr. faktura, ulazna faktura, zaliha, izvještaj)

  4. Postavite automatsko slanje – npr: „nakon kreiranja fakture, sistem će automatski poslati XML/JSON u eSef“.

  5. Omogućite logovanje poslova i grešaka – dobro je imati da se greške evidentiraju za kasniju analizu.

  6. Po želji, izvršite probno slanje (na test okolinu) i provjerite da li je dokument primljen i prihvaćen od strane eSef.

3. Priprema dokumenta i slanje

  1. Provjerite da dokument koji šaljete ispunjava format koji zahtijeva eSef – primjerice XML po UBL 2.1 ili JSON‑format. efaktura.gov.rs+1

  2. Osigurajte da svi obavezni podaci budu popunjeni: datum, broj fakture, iznos, valuta, porez itd.

  3. U testnoj fazi: pošaljite jednu dokumentaciju za test, provjerite odgovor od eSef API‑ja (status uspjeha / greška).

  4. U slučaju greške: provjerite logove u eDestileriji, vratite se na dokumentaciju eSef‑a i prilagodite polja.

  5. Nakon što je testiranje uspješno, prebacite integraciju na produkciju (promijenite URL, koristite produkcijski API‑ključ).

4. Pokretanje u produkciju i verifikacija

  • Aktivirajte automatsko slanje u eDestileriji za sve buduće dokumente koji moraju biti slani.

  • Redovno provjeravajte logove i status prihvata u eSef‑u.

  • Napravite proceduru za greške: ako dokument nije prihvaćen, sistem treba da obavijesti korisnika/administrator.

  • Dokumentujte interne procese (ko je odgovoran, kada se provjerava, kako se reaguje).

  • Obavijestite tim u kompaniji da su uslovi integracije zadovoljeni i da je sistem funkcionalan.

5. Česta pitanja i savjeti

  • Šta ako dokumenti ne prolaze?
        Provjerite format (XML/JSON), obavezna polja, da li API ključ ima pravo pristupa, da li je endpoint pravilno unet.

  • Kako pratiti greške?
        U eDestileriji omogućite logovanje integracijskih poziva. Pratite poruke koje vraća eSef API.

  • Promjena formata / novih polja?
        Povremeno provjeravajte dokumentaciju eSef‑a za promjene standarda.

  • Koristiti testno vs produkcijsko okruženje?
        Uvijek prvo u testnom, pa tek kada je sve stabilno, prebacite u produkciju.

Nazad na vrh