Parra API je programsko sučelje (REST API) koje omogućava povezivanje s drugim aplikacijama i automatiziranu razmjenu podataka između sustava (Parra aplikacije i sustava po vašem izboru).
Putem API-ja možete dohvaćati, kreirati i upravljati poslovnim podacima kao što su računi, popis stavki (usluga i proizvoda), kupci, ulaznim eRačunima i šifrarnicima. Drugim riječima Parra API omogućava izdavanje računa direktno u vašem sustavu koji u pozadini "komunicira" s Parrom i na taj način automatski izrađuje, fiskalizira i šalje račune.
Parra API podržava sve tipove računa: B2C (fiskalizirani račun u krajnjoj potrošnji, prema fizičkim osobama), B2B eRačun (fiskalizirani račun prema poduzećima/pravnim subjektima u Hrvatskoj), B2G eRačun (fiskalizirani račun prema tijelima javne vlasti tj. obveznicima javne nabave), običan B2B račun (nefiskalizirani račun prema pravnim subjektima u inozemstvu ili u Hrvatskoj ukoliko ovaj račun izdaje obveznik izvan sustava PDVa).
Kome je dostupan API?
API je dostupan registriranim korisnicima čiji poslovni subjekt ima aktivan pretplatnički paket koji uključuje API pristup (Biz ili Pro paket). API ključ se izdaje po poslovnom subjektu tj. OIBu i omogućuje pristup isključivo podacima tog subjekta.
Kratak pregled svih mogućnosti Parra API-ja:
kreiranje i fiskalizaciju B2C računa
kreiranje i fiskalizaciju B2B eRačuna
kreiranje i fiskalizaciju B2G eRačuna
dohvat ulaznih eRačuna
dohvat detalja postojećeg računa
dohvat podatka o sljedećem broju računa
slanje računa emailom
generiranje linka za preuzimanje PDF-a računa
generiranje linka za preuzimanje XML datoteke eRačuna
preuzimanje pratećih dokumenata priloženih uz račun
dohvat podataka sa popisa stavki ili kupaca pohranjenih u Parri
dohvat podataka o operateru, poslovnom prostoru i naplatnom uređaju
dohvat osnovnih podataka o bankovnim računima
Primjeri primjene Parra API-ja
Željeno područje primjene | Kako funkcionira |
Web shop (WooCommerce, Shopify, itd.) | Vaš kupac naruči proizvod u web shopu > web shop poziva Parra API > Parra kreira i fiskalizira B2C račun > račun se šalje kupcu emailom |
Interni ERP i slični sustavi | ERP šalje podatke o prodaji na Parra API > Parra kreira i fiskalizira račun (B2C, B2B, B2G) > Parra šalje poruku potvrde prem ERP |
CRM sustav | Nakon zaključenog ugovora o prodaji > CRM poziva API za automatsko izdavanje B2B eRačuna > Parra kreira i fiskalizira B2B eRačun |
Sustav za rezervacije (smještaj, termini i sl.) | Po završetku rezervacije booking sustav poziva Parra API > Parra kreira i fiskalizira B2C račun > račun se šalje kupcu emailom |
Vlastita mobilna ili web aplikacija | Vaša aplikacije koristi Parra API kako bi se u pozadini izradili i fiskalizirali svi tipovi računa |
Automatske periodične fakture | Vaš sustav periodično poziva Parra API za izradu računa za primjerice mjesečne pretplate, najam i sl. |
Javna nabava (B2G) | Sustav automatski kreira račune prema tijelima javne vlasti putem B2G endpointa. |
Ograničenja Parra API mogućnosti
Registracija korisničkog računa - korisnički profil se mora kreirati direktno na Parra web stranici.
Konfiguriranje postavki poduzeća - sve informacije o poduzeću te bankovni računi i postavke računa moraju biti unesene direktno u Parra aplikaciju.
Dodavanje poslovnih prostora i naplatnih uređaja - poslovni prostori i naplatni uređaji moraju biti dodani u Parra aplikaciji.
Učitavanje certifikata za fiskalizaciju - fiskalizacija će se ispravno provoditi isključivo ako je certifikat učitan u Parra aplikaciju.
Kreiranje novih kupaca - za sada je moguće samo dohvaćati podatke o kupcu, ne i kreirati kupce putem API-ja.
Uređivanje kataloga - katalog stavki (proizvoda i usluga) se samo čita putem API-ja.
Upravljanje korisnicima - dodavanje korisnika i dodjela uloga je moguća isključivo kroz Parru.