Arges API

Arges API je REST API za integraciju Arges ERP-a s web trgovinama, poslovnim aplikacijama i drugim vanjskim sustavima.

Spojite Arges s drugim sustavima

Imate webshop koji svake noći proizvede 50 novih narudžbi. Treba ih sve pretvoriti u račune u Argesu, fiskalizirati i poslati kupcu PDF na mail. Ručno? Nikako. Tu ulijeće Arges API.

REST endpointovi. JSON unutra, JSON van. HTTPS. Cijela specifikacija živi u OpenAPI 3.1 formatu (službena OpenAPI 3.1.0 specifikacija održavana od OpenAPI Initiative ), a iz nje se iscrtavaju dva interaktivna sučelja: klasični Swagger UI i modernija Scalar API Reference .

Tipičan scenarij: ERP klijenta povlači partnere iz Argesa svako jutro u 6h. PoS sustav s 12 lokacija gura svaku transakciju u Arges u realnom vremenu. Aplikacija za predstavnike na terenu kreira ponude direktno iz iPada.

Konkretne brojke za konfiguraciju

Autentikacija ide u HTTP zaglavlje apiToken . Za pozive koji moraju znati s kojeg blagajničkog uređaja dolaze, dodate naplatniUredajId.

Resursi

Resursi nisu posloženi nasumice. Prate kako stvarno radite. Račun rijetko stoji sam. Uz njega vučete šifrarnik artikala , podatke o partneru, kontekst poslovnog prostora.

Računi i ponude

Računi imaju standardni CRUD plus puno više.

Standardni dio:

Dodatne radnje:

Iz prihvaćene ponude radite račun jednim pozivom. Korisno kad gradite aplikaciju za prodajne predstavnike koji terenski pretvaraju ponude u račune čim klijent kimne glavom.

Ponude prate isti obrazac. Popis, broj, jedan, kreiranje, uređivanje, brisanje otključanih, zaključavanje, fiskalizacija, mail, PDF.

Šifrarnici

Šifrarnici su gradivni elementi. Bez njih račun ne stoji.

Što povlačite:

Realna situacija: kad vam vjenčana lista artikala u Excelu prelazi 5000 redaka i dobavljač jednom mjesečno šalje novu cjeniku, jedini razuman put je sinkronizacija preko API-ja.

Skladište

Skladišnu stranu pokrivaju primke s troškovima , inventure , međuskladišnice , otpremnice , povratnice , nivelacije cijena . Plus dnevni prometi i PDF dokumenti gdje su izloženi.

Partneri, rabati, naplata

Partner je osnovni zapis. Ili zapis u kontekstu posebnih komercijalnih uvjeta.

Tipove partnera i opomene dohvaćate kao zaseban resurs. Ponavljajući računi pokrivaju pretplatničke modele, recimo mjesečnu naplatu hostinga ili softverskog licenciranja.

Akcije i rabate definirate po artiklu, usluzi ili grupi. Rabati partnera vežu se na istu razinu.

Lokacije, uređaji, ljudi

Tu spadaju poslovni prostori . Naplatni uređaji . Korisnici (s pregledom trenutno prijavljenog). Zaposlenici . Radna mjesta . Radne grupe .

eRačuni

Zaprimljeni eRačuni imaju vlastite operacije. Popis. Pojedinačni dokument. PDF. ZIP/XML paket. I dodatne resurse koji prate obradu eRačuna kroz sustav.

Tipičan workflow

Pet koraka. Vraćaju se u skoro svakoj integraciji.

  1. autentikacija preko apiToken
  2. provjera u Swaggeru ili Scalaru koji modeli i endpointovi pokrivaju vaš slučaj
  3. dohvat osnovnih resursa (artikli, partneri, prostori, uređaji)
  4. kreiranje ili izmjena dokumenta
  5. dodatna radnja nad dokumentom (zaključavanje, fiskalizacija, mail, PDF)

Standardni set za većinu resursa: popis, broj, jedan zapis, kreiranje, uređivanje. Posebne radnje (storno, fiskalizacija) idu samo tamo gdje imaju smisla.

Status kodovi

API vraća standardne HTTP kodove:

Token bearer mehanizam: ako vam dođe 401, prvo provjerite apiToken zaglavlje. Ako vam dođe 400, modeli iz dokumentacije vam pokazuju gdje ste pogriješili.

Gdje krenuti

Ako gradite integraciju prvi put, ovaj redoslijed štedi živce.

  1. otvorite Swagger ili Scalar i pogledajte zaglavlja po endpointima
  2. testirate autentikaciju na nekom bezopasnom GET pozivu, recimo dohvat poslovnih prostora
  3. povučete šifrarnike koji popunjavaju vanjski sustav (artikli, partneri)
  4. tek onda automatizirate dokumente

Jedna rečenica iz iskustva. Nemojte krenuti od računa. Krenite od artikala i partnera. Račun bez šifrarnika nigdje ne stigne.

Sučelja za pregled API-ja

Swagger UI i Scalar API Reference pokrivaju isto, samo različitim stilom. Oba čitaju istu OpenAPI 3.1 specifikaciju iz /swagger/swagger.json, pa nema razlike u sadržaju, samo u UX-u.

Kroz oba sučelja dobivate:

Swagger UI je standardna referenca, široko poznata i pokrivena u dokumentaciji raznih klijent generatora. Scalar je modernija alternativa s čišćim layoutom i dark modeom.

Za QA fazu integracije, oba su najbrži put. Provjerite ponašanje endpointa prije nego napišete liniju koda.

Trebate pomoć?

Naletite na nešto što dokumentacija ne pokriva? Javite se.

Često postavljana pitanja

Što je Arges API?
Arges API je REST API dokumentiran prema OpenAPI 3.1 specifikaciji. Za pregled dokumentacije i testiranje poziva dostupna su dva sučelja: klasični Swagger UI na https://api.arges.hr/swagger/ i moderni Scalar API Reference na https://api.arges.hr/scalar/ .
Kako ide autentikacija?
Autentikacija ide preko HTTP zaglavlja apiToken. Za dio dokumentnih operacija koristi se i zaglavlje naplatniUredajId.
Koje resurse API pokriva?
Račune. Artikle. Partnere. Ponude. Plus dodatne radnje: zaključavanje, fiskalizacija, slanje e-maila, storno, PDF download.
Gdje pregledati dokumentaciju i testirati pozive?
Klasični Swagger UI je na https://api.arges.hr/swagger/ . Modernija Scalar API Reference je na https://api.arges.hr/scalar/ . Oba sučelja čitaju istu OpenAPI 3.1 specifikaciju i pokazuju iste endpointove, zaglavlja i modele, biraj prema osobnoj preferenciji.

Posljednje ažurirano: 18.05.2026.