Integracije i automatizacija provjere posrednika

Praktične preporuke za integraciju provjere informacijskog posrednika za eRačun u ERP, računovodstveni softver ili vlastitu web aplikaciju.

API ključ + domena

Developerski API radi samo uz važeći API ključ. Ključ je zaključan na domenu koju upišeš u panelu, što smanjuje rizik od zloupotrebe.

Kvote i stabilnost

Uvedene su kvote i zaštita od prečestih poziva. Preporuka je cache rezultat i izbjegavati provjeru istog OIB-a više puta u kratkom periodu.

UX preporuke

Korisniku pokaži jasnu poruku (npr. “certificiran”, “nije pronađeno”, “privremeno nedostupno”) i ponudi sljedeći korak: kontakt ili ručna provjera popisa.

Najčešći integracijski scenariji

ERP / računovodstveni sustav

Provjera posrednika se radi pri inicijalnom povezivanju kupca/dobavljača (unos partnera). Rezultat se sprema uz partnera i periodično osvježava (npr. jednom tjedno).

Preporuka: validiraj OIB, pošalji API zahtjev, spremi status i usluge, te prikaži “certificiran” oznaku u sučelju.
Web shop / B2B portal

Provjera se koristi u onboarding procesu dobavljača ili kupca: nakon unosa OIB-a, sustav predlaže preporučeni tok (npr. kontakt posrednika ili aktivacija eRačuna).

UX: pokaži rezultat u realnom vremenu, ali s jasnom napomenom da rezultat može biti osvježen periodično.
Interni compliance / nabava

Provjera se radi prije ugovaranja ili obnove ugovora. Sustav generira izvještaj s osnovnim statusom i popisom podržanih usluga.

Preporuka: export u PDF/CSV iz internog sustava (ne iz API-ja), uz audit trag unutar tvog sustava.
Integracijski middleware

Ako koristiš posrednički layer (npr. integracijski servis), provjeru radi centralno i dijeli rezultat prema internim aplikacijama (cache + TTL).

Preporuka: koristi jedan ključ po domeni/projektu radi lakše kontrole kvota.

Preporučeni tok (tehnički)

  1. Validacija: provjeri format OIB/GLN prije slanja.
  2. Poziv: pošalji zahtjev developerskom API-ju s API ključem.
  3. Obrada: razlikuj 200/404 (nije pronađeno) od 429 (previše zahtjeva) i 401/403 (autorizacija/domena).
  4. Cache: spremi rezultat i osvježi ga periodično (npr. 24h–7 dana ovisno o kontekstu).
  5. UX: korisniku pokaži razumljivu poruku i sljedeći korak (kontakt, vodič, provjera popisa).

Spreman za implementaciju?

Detaljne parametre i primjere poziva pronađi u API dokumentaciji. Za krajnje korisnike preporučujemo vodič i FAQ.

API dokumentacija Blog