Ako prodajete preko vlastitog web shopa i kupci plaćaju karticom, računi se moraju fiskalizirati. Đurđa za to ima REST API: vaš web shop nakon naplate pošalje podatke računa, Đurđa ga potpiše vašim FINA certifikatom, pošalje Poreznoj upravi i vrati JIR, ZKI i QR kod koje web shop ispiše na potvrdi kupcu.
Radi s bilo kojim sustavom koji zna poslati HTTPS zahtjev — PHP, WordPress ili nešto treće.
Kako to radi
- U Đurđi, pod API pristup, generirate ključ: javni identifikator (
pk_live_…ilipk_test_…) i tajni ključ (sk_…). - Tajni ključ spremite na poslužitelj web shopa. Đurđa ga prikazuje samo jednom.
- Web shop nakon uspješne naplate pošalje račun na API Đurđe.
- Đurđa račun potpiše vašim certifikatom, fiskalizira ga i vrati JIR, ZKI i QR kod.
Najbolje je da Đurđa sama dodjeljuje broj računa — tako nema rupa u nizu, a ponovljeni zahtjevi su sigurni. Gotov PHP kod i primjer za WordPress nalaze se u dokumentaciji unutar Đurđe.
Postupak korak po korak: Povezivanje web shopa preko API-ja.
Sve na jednom mjestu
Računi iz web shopa nisu "sa strane". Vide se u Đurđi pod API računima, s mogućnošću ispisa računa, ulaze u knjigu prometa i u brojke na nadzornoj ploči. Fiskalizacije preko API-ja broje se u isti mjesečni broj dokumenata kao i računi iz Đurđe.
Sigurnost
- Tajni ključ nikad ne napušta vaš poslužitelj i ne šalje se u zahtjevu — koristi se samo za potpis.
- Ključ možete ograničiti na IP adrese (IPv4, IPv6 i CIDR rasponi). Za live ključ to snažno preporučujemo.
- Ključ koji je procurio odmah opozovete i generirate novi.
Testni ključevi rade samo ako u Đurđi imate učitan demo FINA certifikat. Demo i produkcijski certifikati su odvojeni i jedan ne radi u okolini drugoga.
Nemate web shop?
Đurđa nudi i besplatnu web trgovinu koja je unaprijed povezana s ovim API-jem — vidi Web trgovina.