Kako biste mogli napraviti integraciju s vašim sustavom putem Parra API-ja, potrebno je zadovoljiti nekoliko preduvjeta.
Registracija u Parra aplikaciju - nužno je otvoriti korisnički profil i kreirati poduzeće za koje će se izdavati računi.
Postavke poduzeća - moraju biti uneseni svi podaci o poduzeću i konfigurirane sve osnove postavke za izdavanje računa, to su sljedeće sekcije Postavki:
Postavke fiskalizacije i eRačuna - kako bi se računi (B2C i eRačuni) mogli fiskalizirati, potrebno je učitati certifikat za fiskalizaciju i/ili ugovoriti uslugu informacijskog posrednika.
Tehnička osoba - API integraciju je potrebno implementirati samostalno ili uz pomoć stručne tehničke osobe koja će prethodno testirati, a nakon implementacije i održavati integraciju. Parra tim ne nudi uslugu integracije API-ja.
API ključ - kako biste započeli integraciju potrebno je preuzeti API ključ iz Parra aplikacije i sigurno ga pohraniti. Iz sigurnosnih razloga API ključ će se prikazati samo jednom prilikom generiranja u Parra aplikaciji.
Kako preuzeti API ključ?
API ključ je moguće preuzeti samostalno direktno u Parra aplikaciji u Postavkama za vaše željeno poduzeće. Naziv poduzeća za koje generirate API ključ uvijek možete vidjeti u vrhu ekrana.
API ključ mogu generirati isključivo:
poduzeća koja koriste Parra Biz ili Pro paket,
korisnici s ulogom vlasnika (owner) ili administratora (admin) koji imaju pristup poduzeću u Parri. Ova opcija neće biti vidljiva korisnicima s drugim ulogama bez obzira što imaju pristup vašem poduzeću u Parri.
Ako u Parra aplikaciji imate pristup više poduzeća, potrebno je iz padajućeg izbornika u gornjem lijevom uglu prvo odabrati poduzeće za koje želite generirati API ključ.
Ovaj ključ može generirati vlasnik poduzeća (owner) i potom ga na siguran način proslijediti tehničkoj osobi koja će izvršiti API integraciji te voditi održavanja.
ILI
Možete tehničku osobu dodati kao novog korisnika u Parri s ulogom administratora (admin) te će oni sami generirati API ključ. Novog korisnika možete dodati prema ovoj uputi: Korisnici | Parra Help Center
Na traci izbornika otvorite "Postavke"
U sekciji API pristup na traci izbornika odaberite "Upravljanje ključevima"
Otvorit će se sekcija u kojoj možete generirati te ažurirati vaše API ključeve. Kako biste generirali ključ kliknite na "Dodaj API ključ"
U novootvorenom prozoru unesite:
Naziv ključa - ovaj naziv je proizvoljan i može naznačiti primjenu API ključa (npr. Web shop integracija, ERP integracija i sl.)
Email za notifikacije - unesite email adresu na koju će stizati obavijesti vezane uz API ključ (npr. neuspješna isporuka eRačuna ili neuspješna fiskalizacija).
Datum isteka - ako želite ograničiti važenje API ključa unesite datum po želji ili odaberite iz kalendara. Ukoliko želite da je ključ trajno aktivan, ostavite ovo polje prazno.
Kako bi se API ključ generirao kliknite "+ Kreiraj" u donjem desnom uglu.
Kada je API ključ uspješno generiran u novom prozoru će se prikazati naziv, API ključ, referenca ključa (zadnjih 8 znamenki koje služe kao identifikator) te datum isteka.
Važna napomena: U ovom koraku je ključno kopirati i sigurno pohraniti generirani API ključ jer je ovo jedini trenutak kada će se isti prikazati u cijelosti. U slučaju da ne spremite vaš API ključ, iz sigurnosnih razloga ga nećete moći ponovno vidjeti u Parri. U tom slučaju je potrebno generirati novi API ključ.
Nakon što ste pohranili svoj API ključ na sigurno mjesto kliknite "Razumijem, sačuvao/la sam ključ"
Podaci o generiranom API ključu zajedno s njegovom referencom će biti vidljivi na popisu sekcije 'Upravljanje ključevima'.
Na email adresu korisnika koji je generirao API ključ stići će email sa svim podacima o API ključu te linkovima na:
tehničku dokumentaciju
Parra sandbox okruženje za testiranje API integracije
upute za postavke testnog okruženja
Parra Help stranicu sa općenitim uputama o Parra API-ju
API dokumentaciju koja je potrebna za tehničku implementaciju možete pronaći na ovom linku: Parra - API Documentation. U ovoj dokumentaciji se nalaze sve tehničke upute za stručnu osobu koja će osposobiti i potom održavati API.
Kako biste mogli testirati API integraciju dostupna je Parra Sandbox okolina na ovom linku. Upute za postavljanje Parra Sandbox okoline su dostupne ovdje.
Kako urediti podatke API ključa?
Ako trebate urediti naziv API ključa, datum isteka ili aktivirati/deaktivirati API ključ to možete učiniti u Postavkama > API pristup > Upravljanje ključevima.
Kako biste uredili podatke kliknite na ikonu olovčice pored željenog ključa.
2. Izmijenite naziv ili datum isteka unosom drugog podatka u ta polja.
Za deaktivaciju ili ponovnu aktivaciju API ključa kliknite u kvadratić pored "Aktivan".
Deaktiviran ključ prestaje raditi odmah te će svi zahtjevi s deaktiviranim ključem vratiti rezultat 401 Unauthorized. Ključ se može ponovno aktivirati.
3. Za pohranu promjene kliknite "Spremi".
Zatim će se na popisu u sekciji 'Upravljanje ključevima' vidjeti ažurirani podaci kao što je status (Aktivan ili Neaktivan), novi datum važenja i ostali promijenjeni podaci.
Nije moguće promijeniti:
Sam API ključ (hash) - ako ste ga zaboravili ili izgubili potrebno je kreirati novi.
Rate limit - ovo konfigurira Parra tim, javite se na [email protected] sa zahtjevom.
IP whitelist - ovo konfigurira Parra tim, javite se na [email protected] sa zahtjevom.
Kako obrisati API ključ?
Ako želite obrisati API ključ to možete učiniti u Postavkama > API pristup > Upravljanje ključevima.
Kliknite na ikonu koša za smeće pored željenog ključa.
2. Označite kvadratić pored "Potvrđujem da želim trajno obrisati odabrani API ključ". Ovime potvrđujete da ste svjesni da će sve integracije koje koriste ovaj ključ prestati raditi.
3. Kliknite "Obriši" u donjem desnom uglu kako bi se API ključ trajno obrisao.
Obrisani ključ ne može se ponovno aktivirati. Prije brisanja provjerite ako se radi o ispravnom API ključu jer će brisanjem sve integracije koje koriste ovaj ključ prestati raditi.