Minimax integracija webshopa: Konektor unutar limita API-ja.

Povezujemo webshop po mjeri s Minimaxom preko Minimax API-ja: artikli, zalihe i stranke dolaze iz Minimaxa, a narudžbe ulaze kao primljene narudžbe, unutar objavljenog limita poziva.

Provjerimo vaš Minimax Kako radi ERP integracija

Pisana ponuda s cijenom, rokom i planom rada je besplatna i bez obveze.

Prvo pilot bez ijednog upisa u Minimax
Narudžba ulazi u Minimax kao primljena narudžba
Konektor po projektu, prema dokumentaciji

Zadnji put provjereno 25. 9. 2026.

Ukratko: Minimax integracija webshopa je konektor koji artikle, stanje zaliha i stranke čita iz Minimaxa preko njegova REST API-ja, a narudžbe s webshopa upisuje kao primljene narudžbe, s rasporedom poziva unutar objavljenog dnevnog limita. Namijenjena je malim i srednjim trgovcima koji knjigovodstvo i zalihe vode u Minimaxu.

Stanje: Konektor za Minimax još nismo isporučili u produkciji; pišemo ga po projektu prema javnoj dokumentaciji sustava. U produkciji radi naša veza s drugim ERP-om, na nostrimaris.hr: katalog i upis narudžbi kroz API koji taj ERP daje za webshop. Za Minimax zato krećemo pilotom samo za čitanje, a zaštitu od dvostrukog upisa i ponovni pokušaj gradimo u konektoru.
Gdje radi: Minimax radi u oblaku i ima REST API. Konektor radi na poslužitelju webshopa, prijavljuje se preko OAuth2 i raspoređuje pozive unutar dnevnog limita koji Minimax objavljuje po organizaciji.
Tipičan paket: Scale, 4.170 €: jedna dokumentirana integracija i jedno skladište. Više skladišta, više integracija ili više tržišta kao jedan sustav je Enterprise, od 8.900 €. Nadzor sinkronizacije nakon lansiranja pokriva plan Održavanje Scale (390 € mjesečno).
Prvi korak: Prvi korak je pilot samo za čitanje: konektor čita artikle, cijene i zalihe iz vaše probne baze ili kopije, bez ijednog upisa u ERP. Upis narudžbi uključujemo tek kad potvrdite da podaci odgovaraju.
Podaci i ugovori: Podaci su u EU-u (baza u Frankfurtu). NDA i ugovor o obradi podataka (GDPR čl. 28) potpisujemo na zahtjev. Tehnologija i sigurnost
Ako FIN STUDIO prestane poslovati: Dobivate izvorni kod s pravom da ga drugi izvođač održava i nadograđuje. Svakodnevno sve vodite sami u administraciji, a podatke izvozite kad želite. Da rad webshopa ne ovisi o nama, račune za hosting i bazu možete od prvog dana voditi na ime svoje tvrtke; to odaberete u ponudi.

PDV se ne obračunava.

Limit poziva oblikuje konektor

Minimax objavljuje granice svog API-ja. One odlučuju kako često webshop smije pitati za zalihe i koliko narudžbi može poslati, pa ih stavljamo na početak projekta.

API poziva u 24 sata po organizaciji: 1.000
API poziva mjesečno po organizaciji: 20.000
narudžbi mjesečno, volumen za koji je API projektiran: 1.000
izlaznih računa i predračuna mjesečno, isto: 1.000

Za usporedbu: čitanje zaliha svakih 15 minuta jednim zbirnim pozivom troši 96 poziva dnevno. Isto čitanje artikl po artikl za katalog od nekoliko stotina artikala prelazi limit već u prvom satu. Izvor: Minimax API: tehnička dokumentacija i ograničenja

Minimax API prema dokumentaciji

Sedam činjenica iz službene tehničke dokumentacije i centra pomoći. Uz svaku stoji izvor.

Minimax API je RESTful internet usluga. Prijava ide protokolom OAuth2 s grant_type=password: pristupne podatke developera (ClientID i ClientSecret) izdaje korisnička podrška Minimaxa, a korisničko ime i lozinku za API korisnik sam definira u Minimax korisničkom računu.
Izvor: Minimax HR: API, upute za programere
Iz internet trgovine podaci u Minimax idu preko API-ja ili uvozom XML datoteke. Što se prenosi ovisi o tome izdaje li webshop račune i vodi li zalihe.
Izvor: Minimax HR: Prijenosi podataka iz internet trgovine
Artikle (Item) API može dodavati, mijenjati i brisati; artikl nosi šifru, EAN, cijenu i stopu PDV-a.
Izvor: Minimax HR: Item (Artikl)
Stanje zaliha (Stock) API izlaže za pregled: GetStocks vraća stanje za sve artikle, s filtrom po artiklu, skladištu ili tipu artikla.
Izvor: Minimax HR: Stock (Stanje zaliha)
Narudžbe (Order) se mogu dodavati, mijenjati, potvrđivati i kopirati u izlazni račun; primljena narudžba mora imati stranku.
Izvor: Minimax HR: Order (Narudžbe)
Stranka (Customer) nosi OIB, rabat u postotku, dane dospijeća i način izdavanja e-računa: preko posrednika ili e-poštom.
Izvor: Minimax HR: Customer (Stranka)
Na popisu modula API dokumentacije nalaze se, među ostalim, Item, Stock, StockEntry, Warehouse, Order, Customer i IssuedInvoice. Zasebnog modula za cjenike na tom popisu nema.
Izvor: Minimax API: tehnička dokumentacija i ograničenja

Dokumentacija provjerena 25. rujna 2026. Sučelja se mijenjaju s verzijama, pa prije procjene opsega provjeravamo verziju koju vi koristite.

Artikli, zalihe i narudžbe po modulima

Svaki red odgovara modulu Minimax API-ja. Gdje API nešto ne izlaže, to kažemo i predlažemo tko je vlasnik podatka.

Artikli: Minimax → webshop; Šifra, EAN, naziv, cijena i stopa PDV-a iz Minimaxa. API zna i upisivati artikle, pa smjer biramo prema tome gdje se artikl otvara prvi put.
Cijene i rabati: Minimax → webshop; Cijena je polje artikla, a rabat u postotku polje stranke. Cjenike po kupcu složenije od jednog postotka vodi webshop, jer ih popis modula API-ja ne navodi.
Zalihe: Minimax → webshop; Zbirno, metodom GetStocks, jednim čitanjem za sve artikle umjesto poziva po artiklu. Tako raspored osvježavanja ostaje unutar dnevnog limita.
Narudžbe: webshop → Minimax; Primljena narudžba sa strankom, stavkama i valutom. U Minimaxu se potvrđuje i, ako tako radite, kopira u izlazni račun.
Kupci i B2B uvjeti: Minimax ↔ webshop; Stranka s OIB-om, rabatom, danima dospijeća i načinom izdavanja e-računa. Nova B2B stranka se prije upisa traži po OIB-u, da ne nastane dvaput.
Dokumenti: ovisi o procesu; Izlazni računi i ponude (IssuedInvoice) te izdavanje zalihe s otpremnicom (StockEntry). Koji put vrijedi, ovisi o tome tko izdaje račun.

Tko izdaje račun, webshop ili Minimax?

Minimax sam razlikuje četiri slučaja. Svaki traži drugi prijenos, pa je ovo prvo pitanje koje postavljamo.

Webshop samo skuplja narudžbe: Prenose se narudžbe sa svim podacima (stranke, artikli, cijene, količine), a u Minimaxu se kopiraju u ponudu ili račun.
Webshop izdaje račune: Prenose se samo podaci za knjigovodstvene i porezne evidencije.
Webshop vodi zalihe: U Minimax se prenose izdavanja.
Webshop ne vodi zalihe: Zalihe se rasknjiže u Minimaxu, a trenutno stanje prenosi se u webshop.

Prema: Minimax HR: Prijenosi podataka iz internet trgovine

Standard ili dogovor po projektu

Lijevo je ono što svaki Minimax konektor dobiva. Desno su odluke koje ovise o vašem procesu i volumenu.

Standardno u konektoru

OAuth2 prijava s pristupnim podacima developera i API korisnika
Brojač poziva po organizaciji, s rezervom ispod dnevnog limita
Zbirno čitanje zaliha umjesto poziva po artiklu
Red čekanja za narudžbe, da vršna prodaja ne potroši limit odjednom
Traženje stranke po OIB-u prije upisa nove
Zapis svakog prijenosa i upozorenje kad sinkronizacija izostane

Dogovara se po projektu

Tko izdaje račun: webshop ili Minimax
Tko vodi zalihe i kako se knjiže izdavanja
Gdje se artikl otvara prvi put
B2B cjenici po kupcu složeniji od rabata u postotku
Način izdavanja e-računa po stranci
Raspored osvježavanja prema broju artikala i narudžbi

Gdje Minimax integracija zapne

Četiri stvari koje se isplati riješiti na papiru, prije konektora.

Dnevni limit u prvom satu
Konektor koji zalihe čita artikl po artikl potroši 1.000 dnevnih poziva u nekoliko osvježavanja. Zato čitamo zbirno i brojimo svaki poziv, a narudžbe šaljemo kroz red.
Cjenik po kupcu nema kamo
API izlaže cijenu artikla i rabat stranke, a zasebnog modula za cjenike na popisu modula nema. Ugovorene cijene po B2B partneru zato žive u webshopu, s jasnim vlasnikom tog podatka.
Isti račun dvaput
Ako račun izdaje i webshop i Minimax, isti promet se evidentira dvaput. Minimax za ta dva slučaja opisuje različite prijenose, pa se to odlučuje prije prvog retka koda.
Volumen iznad projektiranog
Minimax navodi da je API projektiran za volumen do 1.000 narudžbi mjesečno. Ako očekujete više, razgovaramo o uvozu XML datoteke ili o drugom sustavu prije nego se konektor napiše.

Minimax i sam spominje rješenja koja su već povezana s njim, poput dodataka za webshop platforme. Ako takav dodatak pokriva vaš proces i volumen, to je brži početak od konektora po mjeri. Konektor po mjeri ima smisla kad webshop mora voditi B2B cijene, zalihe i račune drukčije nego što to dodatak predviđa.

Pitanja o Minimax integraciji

Koliko API poziva Minimax dopušta?

Minimax objavljuje 1.000 API poziva u 24 sata i 20.000 mjesečno po organizaciji, a API je projektiran za volumen do 1.000 narudžbi mjesečno. Zalihe zato čitamo zbirno, metodom GetStocks: čitanje svakih 15 minuta jednim pozivom troši 96 poziva dnevno, dok čitanje artikl po artikl za katalog od nekoliko stotina artikala prelazi limit već u prvom satu.

Tko izdaje račun: webshop ili Minimax?

To odlučujemo prije prvog retka koda, jer Minimax za svaki slučaj opisuje drugi prijenos. Ako webshop samo skuplja narudžbe, u Minimax idu narudžbe sa svim podacima i tamo se kopiraju u ponudu ili račun. Ako webshop izdaje račune, prenose se samo podaci za knjigovodstvene i porezne evidencije. Isti promet nikad se ne evidentira u oba sustava.

Može li Minimax voditi cjenike po kupcu?

Djelomično. API izlaže cijenu artikla i rabat stranke u postotku, a zasebnog modula za cjenike na popisu modula API dokumentacije nema. Ugovorene cijene po B2B partneru složenije od jednog postotka zato vodi webshop, s jasno određenim vlasnikom tog podatka.

Kako izgleda pilot s Minimaxom?

Konektor za Minimax još nismo isporučili u produkciji; pišemo ga po projektu prema Minimaxovoj dokumentaciji, a u produkciji radi naša veza s drugim ERP-om, na nostrimaris.hr. Pilot zato samo čita artikle, zalihe i stranke iz Minimaxa, bez ijednog upisa. Narudžbe se počinju upisivati tek kad potvrdite da podaci odgovaraju. Za prijavu trebaju pristupni podaci developera, koje izdaje korisnička podrška Minimaxa, i API korisnik kojeg definirate u svom Minimax računu.

Minimax dokumentacija

Sve tvrdnje o Minimax API-ju na ovoj stranici dolaze iz tehničke dokumentacije i centra pomoći proizvođača.

Sve poveznice otvorene i provjerene 25. rujna 2026.

Povezano

ERP integracija webshopaSmjerovi sinkronizacije, API ili datoteke i što u praksi puca, za bilo koji ERP.B2B webshopCjenici i rabati po kupcu, plaćanje na račun i narudžbe koje ulaze ravno u ERP.Cijena izrade webshopaPaketi, što ulazi u opseg integracije i što plaćate mjesečno.Luceed webshop integracijaLuceed API · REST · JSON Pantheon webshop integracijaPAWS · Ident · Order · Stock · DBObjects SAP Business One webshop integracijaService Layer · OData v4

Recite nam koliko narudžbi mjesečno očekujete

Broj narudžbi i artikala određuje raspored poziva prema Minimaxu. Pošaljite ga uz dva odgovora: tko izdaje račun i tko vodi zalihe. Iz toga slijedi opseg konektora i fiksna cijena za dogovoreni opseg.

Provjerimo vaš Minimax

Odgovor unutar 24 sata radnim danom. Bez obveze. Ako integracija nije isplativa, reći ćemo vam to.