Webshop ↔ Pantheon.
U stvarnom vremenu.
Standardizirano REST API sučelje za integraciju webshopa, mobilnih aplikacija i drugih sustava s Pantheon ERP-om.
Većina webshop integracija pukne na istom mjestu: FTP datoteke, polusatne cron sinkronizacije i kupac na webu vidi staro stanje zaliha. Kad konačno proda artikl koji više nije na zalihi, problem nasljeđuje korisnička podrška.
AQI PA API rješava to direktno — moderan REST API s JWT sigurnošću, JSON in/out, audit log i 20+ gotovih metoda za sve glavne procese. Webshop pita Pantheon, Pantheon odgovara u sekundi.
Podržani izvori eRačuna: Webshop platforme | Mobilne aplikacije | B2B portali | Vanjski WMS sustavi | CRM sustavi | Marketing alati
Što dobivate?
Funkcionalnosti koje vaši blagajnici i voditelji prodaje osjete već prvi dan rada.
Real-time sinkronizacija
Stanje zaliha, cijene, novi artikli — u trenutku kad se promijene u Pantheonu, dostupni su API-jem. Kraj polusatnih cron-ova i "učenja iz prošlog sata".
JWT sigurnost na razini metode
RSA-2048 potpisani Bearer tokeni, ~4h valjanost, autorizacija po metodi i korisniku. Svaki sustav vidi samo ono što smije vidjeti — ni manje ni više.
JSON in / JSON out
Sve metode primaju i vraćaju standardni JSON. Integracija s bilo kojim programskim jezikom — PHP, Node, Python, .NET, Java — bez egzotičnih formata.
Potpuni audit log
Svaki API poziv automatski se logira u bazu — tko, što, kada, s kakvim podacima i kakvim odgovorom. Kad nešto pukne, znate točno gdje gledati.
Multi-tenant arhitektura
Jedan servis, više kompanija. Svaki klijent ima vlastitu Pantheon bazu, svoju autentikaciju, svoje korisnike. Centralna MDDB baza za routing.
Postman & Swagger od prvog dana
Interaktivna API dokumentacija — Swagger UI za pregled, Postman kolekcija za testiranje. Vaši developeri nemaju isprike za "ne razumijem što vraća".
Prilagodbe bez izmjena servisa
Svaki klijent ima specifične potrebe. Prilagodbe se rade kao SQL stored procedure — C# servis se ne dira. Brža implementacija, manji rizik, neovisan razvoj.
20+ standardnih metoda u cijeni
Šifranici, subjekti, zalihe, narudžbe, načini plaćanja, tarife — sve uključeno. Za 80% scenarija nije potrebna nijedna prilagodba.
5 standardnih modula. U cijeni.
Svaka implementacija uključuje skup standardnih metoda koje pokrivaju najvažnije poslovne procese — bez dodatnih prilagodbi za većinu integracija.
MODUL 1 — ŠIFRANICI
Artikli, kategorije, tipovi
Dohvat i upis artikala s filtrom po šifri, EAN-u, tipu i datumu promjene. Kategorije i tipovi artikala u istom paketu.
| METODA | TIP |
|---|---|
| GetItems | GET |
| GetItemCateg | GET |
| GetItemType | GET |
| PostItem | POST |
| PostItemCateg | POST |
MODUL 2 — SUBJEKTI
Kupci i dobavljači
Sinkronizacija subjekata između sustava — naziv, adresa, OIB, PDV broj, način prodaje, kontaktne osobe. Vremenski pečat za inkrementalnu sinkronizaciju.
| METODA | TIP |
|---|---|
| GetSubject | GET |
| PostSubj | POST |
| PostSubjContact | POST |
MODUL 3 — ZALIHE
Skladišta i stanje
Lista skladišta i stanje zalihe po skladištu — s filtrom po artiklu, EAN listi ili vremenskom pečatu. Kraj statičnih CSV uvoza.
| METODA | TIP |
|---|---|
| GetWarehouses | GET |
| GetStockForWhs | GET |
MODUL 4 — NARUDŽBE
Dokumenti i nalozi
Kreiranje cijelog naloga (glava + stavke) u jednom pozivu, ažuriranje stavki, postavljanje rezervacija. Sve što treba za webshop checkout proces.
| METODA | TIP |
|---|---|
| GetOrderList | GET |
| PostOrder | POST |
| PostOrderHead | POST |
| PostOrderItem | POST |
| PostOrderReserve | POST |
MODUL 5 — PLAĆANJA
Načini plaćanja, porezi, tarife
Šifranici načina plaćanja, poreznih kodova, carinskih i cjenovnih tarifa. Plus dohvat Pantheon korisnika za audit potrebe.
| METODA | TIP |
|---|---|
| GetPayMethods | GET |
| GetTaxCode | GET |
| GetCustTariff | GET | PostItemCateg | GET |
Tehnička arhitektura
Moderna .NET 8 platforma na temelju SQL Server stored procedura — sva poslovna logika u bazi, servis tanki sloj.
SERVIS
- ASP.NET Core 8.0 (C#)
- JWT Bearer, RSA-2048
- Serilog logiranje
- Swagger / OpenAPI
BAZA PODATAKA
- Microsoft SQL Server
- Microsoft.Data.SqlClient 5.x
- Stored procedure (logika)
- ExtID mapping tablice
INFRASTRUKTURA
- IIS (Windows Server)
- prod-api.aqi.hr (HTTPS)
- Centralna MDDB baza
- Multi-tenant routing
KLJUČNI PRINCIPI
- Multi-tenant arhitektura
- Audit log svakog poziva
- Autorizacija po metodi
- Timeout 900s (dugotrajne)
Prilagodbe iz stvarne prakse
Kad standardni moduli nisu dovoljni — prilagodbe se rade kao klijent-specifične SQL stored procedure. Bez izmjena C# servisa, brže i sigurnije.
WEBSHOP
Webshop integracija — 18 prilagođenih metoda
Prošireni set: dostava, paketomati, promotori, storno, otpremnica s lokacijom, ispis dokumenata. Realizirano za izdavački webshop.
B2B
B2B narudžbenice
Specifičan format naloga, prilagođeni šifarnici. Realizirano za platformu za upravljanje narudžbama prema poslovnim kupcima.
WMS
Skladišni sustav (WMS)
Dohvat zalihe po EAN listi, ažuriranje linka na nalogu, specifičan format artikla. Realizirano za vanjski sustav upravljanja skladištem.
EDI
e-razmjena dokumenata + fiskalizacija
Dohvat dokumenata s adresama stranaka, ažuriranje statusa, fiskalni računi (Predujam, Račun, POS). Realizirano za distribucijsku kompaniju.
CRM
Sinkronizacija subjekata iz vanjskog CRM-a
Upis subjekata i kontakata iz vanjskog CRM/ERP sustava s mapiranjem vanjskih ID-eva (ExtID tablica). Realizirano za sustav upravljanja kupcima.
EDU
Upravljanje školovanjem
Studenti kao subjekti, ugovori i aneksi, modeli plaćanja, predračuni, konto kartica. Realizirano za obrazovnu ustanovu.
Klasična integracija vs. AQI PA API
Razlika između "skidamo CSV svako pola sata" i "pita pa odgovara u sekundi".
| KLASIČNA INTEGRACIJA | AQI PA API |
|---|---|
| FTP CSV/XML datoteke s polusatnom cron sinkronizacijom | ✓ Webshop pita Pantheon u trenutku, vraća točno stanje |
| Webshop pokazuje stanje od prije 30 minuta | ✓ JWT Bearer (RSA-2048), audit log svakog poziva |
| Sigurnost: VPN tunel ili share folder, bez audita | ✓ Prilagodbe kroz SQL stored procedure, bez dodira C# koda |
| Svaka prilagodba mijenja servis, čeka deploy ciklus | ✓ Standardni JSON, validacije, primjeri u Swagger UI |
| Format artikla u XML-u "kako tko ima" | ✓ Autorizacija na razini metode i korisnika |
| Bez ovlasti po metodi — tko ima pristup, sve može | ✓ Audit log: tko, što, kada, s kakvim payload-om i odgovorom |
| "Nije moglo skinuti" — nemamo pojma što se dogodilo | ✓ Audit log: tko, što, kada, s kakvim payload-om i odgovorom |
| Nova kompanija = novi servis na novom serveru | ✓ Multi-tenant — jedan servis, sve kompanije, izolirane baze |
Implementacija u 5 koraka
Strukturiran proces — od analize zahtjeva do produkcije, jasno definirane točke.
1 — ANALIZA
Front blagajne
Brzi unos artikala, tri vrste računa, automatska fiskalizacija s nadzorom, višekorisnički rad s ovlastima, prikaz više otvorenih računa istovremeno (idealno za stolove u ugostiteljstvu), ispis na POS ili standardni printer, export u PDF.
2 — POSTAVKA
Servis i pristupi
Registracija klijenta u MDDB bazi, kreiranje API korisnika i dodjela prava na metode. Generiranje pristupnih ključeva.
3 — SQL
Stored procedures
Instalacija standardnih SQL procedura na vašu PA bazu. Za prilagodbe: razvoj i testiranje klijent-specifičnih procedura.
4 — TEST
Swagger + Postman
Testiranje putem Swagger UI i Postman kolekcija. Svaka metoda ima primjere poziva u SQL dokumentaciji.
5 — PROD
Predaja u rad
Predaja pristupnih podataka (URL, API korisnik, lozinka, company). Vaš tim integrira API u svoj sustav.
Ono štostvarno dobivate
Konkretni brojevi i karakteristike platforme — ne marketing.
20+
10+
.NET 8
RSA-2048
Aliquantum idea — Datalab Premium Pantheon partner. AQI PA API je naša integracijska platforma — multi-tenant, .NET 8, SQL stored procedures, JWT sigurnost. 10+ aktivnih integracija u produkciji za webshop platforme, B2B portale, vanjske WMS sustave i CRM rješenja.
Spremni za demo?
Pokažite nam svoj webshop ili sustav koji integrirate s Pantheonom — pripremit ćemo procjenu pokrivenosti standardnim metodama i prijedlog implementacije.
- Telefon +385 (01) 6442 100
- Prodaja [email protected]
- Helpdesk [email protected]