Public API

Public API je javno dostupno sučelje usluge Klik Račun za izradu i obradu eRačuna. Iza usluge Klik Račun nalazi se IIProxy, temeljni informacijski posrednički sustav kojem integracije pristupaju putem Public API-ja. Svaki je pristup ograničen na organizaciju povezanu s vjerodajnicom. API je namijenjen ERP-ovima, blagajnama i drugim poslužiteljskim integracijama.

API podržava:

• izradu računa iz strukturiranog JSON-a ili izvornog UBL 2.1/HR-CIUS XML-a;
• validaciju bez izdavanja te automatsko ili naknadno izdavanje;
• AS4 dostavu, fiskalizaciju i eIzvještavanje prema odluci autoritativnog usmjeravanja;
• zaštićene ispravke, potpuna storna i obračun avansa;
• evidenciju i poništenje naplate na izlaznoj i ulaznoj strani;
• odobravanje i odbijanje ulaznih računa;
• jedinstveni status za jednostavno praćenje i zasebne tehničke dimenzije za dijagnostiku.

Osnovna adresa

Produkcijski pozivi koriste https://iiproxy.sekkun.co/public/v1. Dokumentacija je odvojena od samog API-ja i ne dijeli njegove vjerodajnice.

Sigurnosni model

Klijent se na poslužitelju veže uz jedan profil izdavatelja, njegov OIB, dopuštene ovlasti i zadani konto prodaje. OIB dobavljača iz tijela zahtjeva nije autorizacijski podatak i ne može promijeniti organizaciju.

Svaka promjena zahtijeva Idempotency-Key. Dugotrajne radnje vraćaju zapis operacije, a ne neprovjerenu pretpostavku da je vanjski sustav prihvatio dokument.

Izvorni XML i FIS XML nisu isto

Vanjski klijent šalje poslovni UBL Invoice/CreditNote. IIProxy iz njega izvodi fiskalizacijski zahtjev, potpisuje ga vlastitim ovlaštenjem i šalje ga Poreznoj upravi. Public API nikada ne prihvaća gotov FIS authority XML od klijenta.

Sljedeće: Brzi početak.