Ova uputa je za vlasnika web shopa ili njegova programera. Dokumentacija s gotovim PHP kodom i primjerom za WordPress nalazi se u Đurđi, u kartici API pristup.
Prije nego krenete
- Đurđa s učitanim FINA certifikatom na poslužitelju (ne lokalno),
- za testiranje: učitan demo FINA certifikat,
- pristup poslužitelju web shopa (za spremanje tajnog ključa).
Korak po korak
- U Đurđi otvorite API pristup i kliknite Generiraj novi ključ.
- Odaberite način Test. Testni ključ (
pk_test_…) šalje račune na demo okolinu Porezne uprave. - Kopirajte javni identifikator i tajni ključ i spremite ih na poslužitelj web shopa. Tajni ključ prikazuje se samo jednom.
- Po želji ograničite ključ na IP adresu poslužitelja web shopa.
- Ugradite poziv API-ja u web shop prema dokumentaciji (gotov PHP kod). Svaki zahtjev potpisuje se tajnim ključem.
- Napravite probnu narudžbu i provjerite je li web shop dobio JIR, ZKI i QR kod.
- Kad sve radi, generirajte Live ključ (
pk_live_…), po mogućnosti s IP ograničenjem, i zamijenite testni ključ u web shopu. - Prvi stvarni račun provjerite u Đurđi, u pregledu API računa.
Svaki live poziv je stvaran račun. Live ključevi idu na pravu fiskalizaciju. Testirajte isključivo testnim ključem.
Savjeti za pouzdan rad
- Neka Đurđa dodjeljuje broj računa. Tako nema rupa u nizu, a ponovljeni zahtjevi su sigurni.
- Koristite jedinstveni ID narudžbe u svakom zahtjevu. Ako web shop pošalje isti račun ponovno, dobije isti JIR — ništa se ne fiskalizira dvaput.
- Tajni ključ nikad u preglednik. Poziv API-ja uvijek ide s poslužitelja web shopa, nikad iz JavaScripta u pregledniku kupca.
Ograničenja
Fiskalizacije preko API-ja broje se u isti mjesečni broj dokumenata kao računi iz Đurđe. Broj aktivnih API ključeva ovisi o paketu. Kad je limit dosegnut, Đurđa to jasno javi, a vi nadogradite paket ili opozovete ključeve koje ne koristite.