Arges fiskalna blagajna API je moćan i pouzdan REST API namijenjen integraciji Arges ERP blagajne s vanjskim poslovnim i tehničkim sustavima. Svrha mu je omogućiti automatizirano izdavanje svih vrsta računa, upravljanje artiklima i zalihama, dohvat prometa te povezivanje blagajničkog poslovanja s webshopovima, ERP-ovima, mobilnim aplikacijama i drugim platformama.
API je izgrađen u skladu s OpenAPI 3.1.0 specifikacijom, a više o ovom standardu pročitajte na službenim OpenAPI stranicama.
API koristi JSON za razmjenu podataka te omogućuje:
Bilo da želite izdavati račune automatski iz web trgovine, sinkronizirati zalihe iz internog sustava ili omogućiti izdavanje računa s mobilnog uređaja – Arges API je konstruiran da to omogući brzo, pouzdano i u skladu sa zakonodavstvom.
Izgrađen prema REST principima, API koristi standardne HTTP metode (GET, POST, PUT, DELETE), podatke razmjenjuje u JSON formatu i osigurava komunikaciju preko sigurnog HTTPS protokola. Integracija se može realizirati iz bilo kojeg programskog jezika ili platforme koja podržava rad s RESTful servisima
Korištenje Arges API-ja rezultira bržim i točnijim poslovanjem, bez potrebe za ručnim unosom ili dupliciranjem podataka.
Namijenjen je:
Za pristup Arges API-ju potrebno je zadovoljiti određene preduvjete. Prije svega, morate imati aktivan korisnički račun u Arges ERP sustavu, odnosno biti korisnik Arges fiskalne blagajne. Kako biste ostvarili pristup API-ju, potrebno je izravno zatražiti izdavanje vjerodajnica od našeg tehničkog tima.
Po zaprimljenom zahtjevu, korisniku se dodjeljuju sljedeći podaci:
Ove vjerodajnice obavezne su za svaku interakciju s API-jem i moraju se dostavljati u HTTP zaglavlju svakog zahtjeva. Zahtjev za izdavanje vjerodajnica možete uputiti putem e-maila na adresu arges@arges.hr, uz obavezno navođenje OIB-a i naziva tvrtke za koju se traži pristup.
API komunikacija odvija se putem:
Preporučena praksa pri integraciji:
Tehnički zahtjevi:
Za integraciju je potrebno osnovno znanje o slanju HTTP zahtjeva i radu s JSON-om.
Preporučeno je koristiti najnovije TLS protokole za sigurnu komunikaciju.
Također, provjerite dokumentaciju vašeg programskog jezika ili platforme za rad s web servisima kako biste ispravno oblikovali pozive.
Ako koristite postojeće Arges biblioteke ili primjere, slijedite upute za autentikaciju s tokenom i TVRTKA ID-om. Nakon što ste ispravno konfigurirali vjerodajnice, možete početi koristiti API u svom razvojnom okruženju.
Napomena:
Za pristup zaštićenim metodama (npr. kreiranje računa), nužno je koristiti token dodijeljen od strane Arges tima. Ako vam je potreban token za testiranje, obratite se podršci!
Arges REST API za fiskalnu blagajnu pokriva ključne funkcionalnosti potrebne za integraciju poslovnih procesa fiskalizacije i upravljanja podacima. U nastavku su opisane neke od osnovnih mogućnosti:
API omogućuje programsko kreiranje:
Računi sadrže:
API vam vraća potvrdu o izdanom računu sa svim relevantnim podacima (broj računa, status, datum, ukupni iznos).
Putem API-ja možete:
Ovo omogućuje potpunu kontrolu nad katalogom proizvoda iz bilo kojeg povezanog sustava, a korisno je za:
Moguće je dohvatiti:
Pogodno za poslovnu analitiku, izvještavanje i integraciju s računovodstvenim softverom.
Kreiranje računa (POST)
curl -X POST "https://api.arges.hr/api/v1/racun" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "naplatniUredajId: YOUR_DEVICE_ID" \
-H "Content-Type: application/json" \
-d '{
"tvrtka_id": "12345"
"kupac": {"ime": "Marko","oib": "12345678901"},
"stavke": [ { "artikl_id": 100, "kolicina": 2, "cijena": 99.99 } ], "nacin_placanja": "KARTICA"}'
Dohvat artikala (GET)
curl -X GET "https://api.arges.hr/api/v1/artikli?tvrtka_id=12345" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "naplatniUredajId: YOUR_DEVICE_ID"
Odgovori sadrže JSON podatke s nazivima artikala, šiframa, cijenama, stanjima zaliha i drugim metapodacima.
Detaljna tehnička dokumentacija Arges API-ja dostupna je putem Swagger sučelja.
Swagger dokumentacija pruža interaktivan pregled svih dostupnih API endpointa, modela podataka i mogućih odgovora.
Možete je pronaći na sljedećoj poveznici: Swagger UI –Arges API dokumentacija
Unutar Swagger sučelja možete:
Preporučujemo developerima da se prvo upoznaju s ovom dokumentacijom prije izrade integracije.
Arges API najčešće se koristi za:
Povezivanjem svojih postojećih sustava s Arges ERP-om putem API-ja, smanjujete potrebu za ručnim unosom, povećavate točnost podataka i ubrzavate radne procese.
(Napomena: Moguće je da će vam za pristup Swagger sučelju trebati valjani API token za autorizaciju određenih operacija. Unutar Swagger UI sučelja možete unijeti svoj token kako biste isprobali zaštićene endpointe.)
Imate li pitanja ili trebate pomoć oko Arges API integracije?
Tehnička podrška Arges tima rado će vam pomoći oko bilo kakvih nejasnoća, savjeta za implementaciju ili rješavanja poteškoća. Slobodno nas kontaktirajte putem emaila arges@arges.hr ili telefonom na +385 (0)99 309 2121. Također, možete ispuniti kontakt obrazac na našoj web stranici (Arges - Kontakt) i opisati vaš upit – naši stručnjaci će vam se javiti u najkraćem roku.
Za razvojne inženjere, preporuka je da pripremite što konkretnija pitanja (npr. primjer JSON zahtjeva/odgovora, opis greške ili naziv end-pointa) kako bismo vam učinkovitije pomogli.
Bilo da trebate pojašnjenja oko korištenja Arges fiskalna blagajna API sustava, asistenciju u testnom okruženju ili želite prijaviti bug, tu smo za vas.
Kontaktiranjem tehničke podrške osigurat ćete da vaša integracija fiskalne blagajne teče glatko i sigurno, uz punu podršku razvojnog tima Arges ERP-a.
