Može li se Parra spojiti s mojim sustavom?
Da, uz pomoć rest API moguće je Parru povezati s bilo kojim sustavom koji šalje HTTP zahtjeve.
Tko može koristiti API?
API je dostupan registriranim korisnicima čiji poslovni subjekt (business subject) ima aktivan pretplatnički paket koji uključuje API pristup (Biz ili Pro). API ključ se izdaje po poslovnom subjektu i omogućuje pristup isključivo podacima tog subjekta.
Trebam li tehničku osobu (developera)?
Za integraciju REST API-ja potrebna je stručna osoba s tehničkim znanjem i iskustvom. Tada je postavljanje relativno jednostavno.
Može li Parra tim napraviti integraciju za nas?
Parra tim ne nudi uslugu integracije API-ja sa sučeljima korisnika.
Može li se automatski izdati račun?
Da, moguće je izdati sve vrste računa te provesti fiskalizaciju.
Mogu li preuzeti PDF računa?
Da, API generira link za preuzimanje.
Može li se račun poslati emailom?
Da, putem share endpointa.
Imamo WooCommerce/Shopify, možemo li se spojiti i izdavati račune preko Parre?
Da, vaš developer može napraviti integraciju putem API-ja. Nakon narudžbe u web shopu, sustav poziva Parra API i automatski kreira fiskalizirani račun.
Za ove platforme ne postoji gotov plugin.
Mogu li koristiti isti API ključ za više poslovnih subjekata?
Ne. Svaki API ključ je vezan za točno jedan poslovni subjekt.
Što se dogodi ako mi API ključ istekne?
Svi zahtjevi s isteklim ključem vraćaju 401 Unauthorized. Morate kreirati novi ključ ili produžiti valjanost postojećeg.
Koliko API ključeva mogu imati?
Maksimalno 10 po poslovnom subjektu.
Mogu li imati ključeve s različitim pravima pristupa?
Trenutno svi ključevi imaju isti pristup svim endpointima za vaš poslovni subjekt.
Mogu li vidjeti API ključ u cijelosti nakon kreiranja?
Ne. API ključ se prikazuje samo jednom pri kreiranju. Nakon toga vidljiv je samo hint (zadnjih 8 znakova).
Što ako zaboravim svoj API ključ?
U tom slučaju je potrebno kreirati novi ključ prema uputi na linku.
Kako funkcionira rate limiting?
Svaki API ključ ima ograničen broj zahtjeva po satu (rate limit). Zadana vrijednost je 1000 zahtjeva po satu, ali može u iznimnim situacijama na zahtjev biti konfigurirana individualno za svaki ključ (raspon: 1 – 100.000).
Rate limiting koristi klizajući prozor od 1 sat - sustav prati vremenske oznake zahtjeva i odbacuje zahtjeve starije od 1 sat.
Mogu li povećati svoj rate limit?
Rate limit je konfiguriran po API ključu te ga nije moguće samostalno promijeniti. Kontaktirajte Parra podršku na [email protected] za promjenu.
Uključite referencu svog API ključa (ovo je identifikator vašeg API ključa, NE ključ u cijelosti), krajnju točku (endpoint) koju pozivate te detaljan opis problema. Podrška nikada neće tražiti vaš API ključ izravno; čuvajte ga sigurnim i nemojte ga dijeliti.
Dijele li svi moji API ključevi isti rate limit?
Ne. Svaki API ključ ima vlastiti, nezavisni rate limit.
Resetira li se rate limit odmah ili je klizajući prozor?
Koristi se klizajući prozor od 1 sat. Zahtjevi stariji od 1 sat automatski se odbacuju iz brojača.
Izgubio sam API ključ. Kako ga mogu vidjeti?
Nije moguće ponovno dobiti uvid u već generirani API ključ. API ključ se prikazuje samo jednom pri kreiranju, ukoliko ste ga izgubili potrebno je kreirati novi ključ.
Zašto moj ključ ne radi iako je aktivan?
Mogući razlozi:
Ključ je istekao (
expiresAtje prošao)Ključ je obrisan
IP adresa nije na whitelisti
Koristite krivi
businessSubjectIdu URL-u
Mogu li kreirati kupce ili stavke putem API-ja?
Trenutno API podržava samo čitanje kupaca i stavki (usluga i proizvoda). Kreiranje i uređivanje moguće je kroz Parra aplikaciju.
Mogu li kreirati poslovne prostore ili operatere putem API-ja?
Ne, postavke se konfiguriraju isključivo kroz Parra aplikaciju.
Mogu li filtrirati kupce i stavke?
API dohvaća sve kupce i stavke (usluge i proizvode). Filtriranje možete implementirati na svojoj strani.
Zašto dobivam InvoiceNumberMismatchWithFormatSettings?
Broj računa mora točno odgovarati formatu iz postavki. Uvijek koristite /next-invoice-number endpoint.
Mogu li kreirati račun u prošlosti?
Da, ali morate paziti na redoslijed - ne smije postojati račun s kasnijim datumom za isti poslovni prostor/naplatni uređaj.
Što znači draftInvoiceId query parameter?
Ako ste prethodno kreirali skicu (draft) računa, možete je finalizirati slanjem na isti endpoint s draftInvoiceId parametrom.
Što se dogodi ako fiskalizacija ne uspije za B2C račun?
Račun se kreira, ali fiskalizacija će se pokušati ponoviti automatski. Status fiskalizacije vidljiv je u fiscalizationStatus polju.
Mogu li ažurirati kreirani račun?
Ne putem Integration API-ja. Računi se nakon kreiranja mogu samo pregledavati. Za eventualne ispravke koristite Parra aplikaciju.
Što se dogodi s računima ako obrišem API ključ?
Ništa. Brisanje ključa utječe samo na pristup API-ju, ne na podatke.
Kako automatizirati obradu dolaznih eRačun?
Periodično pozivajte /unprocessed endpoint, procesirajte svaki eRačun i pozovite /send-to-accounting ili /reject.
Što znači unprocessed endpoint?
Ovaj endpoint odgovara s informacijom isključivo o eRačunima sa statusom Received - oni eRačuni koji čekaju vašu akciju (prihvat ili odbijanje).
Mogu li prihvatiti eRačun koji je već odbijen?
Ne, jednom odbijen eRačun ne može se prihvatiti niti putem API-ja niti direktno iz Parre.
Gdje mogu vidjeti XML datoteku eRačuna?
U detaljnom prikazu eRačuna polja fileId, fileName i fileSize sadrže informacije o XML datoteci.
Zašto API daje rezultat da je lista bankovnih računa prazna?
Endpoint vraća rezultat samo za aktivne bankovne račune. Provjerite u Parra aplikaciji da imate barem jedan aktivan bankovni račun.
Zašto naplatni uređaji vraćaju prazan rezultat?
Provjerite da koristite ispravan workspaceId. Svaki naplatni uređaj pripada jednom poslovnom prostoru.
Mogu li koristiti API iz browsera (JavaScript)?
Ovo nije preporučeno jer bi API ključ bi bio vidljiv u kodu. Koristite server-side integraciju.
Podržava li API webhook/callback notifikacije?
Trenutno ne. Koristite polling pristup za praćenje promjena.
Je li dostupna korisnička podrška za Parra API?
Za sva pitanja o Parra APIju i integraciji možete se obratiti našim agentima putem chata u donjem desnom uglu aplikacije ili na [email protected].
Ukoliko se radi o poteškoći ili pitanju vezanom uz specifičan API ključ, uključite referencu svog API ključa (ovo je identifikator vašeg API ključa, NE ključ u cijelosti), krajnju točku (endpoint) koju pozivate te detaljan opis problema. Podrška nikada neće tražiti vaš API ključ izravno; čuvajte ga sigurnim i nemojte ga dijeliti.