Razmjena podataka

Nema API-ja. Ima putova koji rade.

Javni REST API i webhookovi za trgovca još ne postoje — i nećemo ih prodavati dok ih nema. Ovo je popis načina na koje trgovina danas stvarno razmjenjuje podatke s vanjskim sustavima.

Recite što trebate spojiti Pogledajte cijene

Stalne adrese vaše trgovine GET

/feeds/cjenik.xml

Zakonski cjenik (ZZP) · svaki dan · svaki plan
/feeds/nabava.xml

Katalog za nabava.net · svaki dan
/feeds/jeftinije.xml

Katalog za jeftinije.hr · svaki dan
/sitemap.xml

Popis stranica za tražilice

Adrese se ne mijenjaju, pa ih primatelj podesi jednom.

Bez uvijanja: ovo radi, ovo ne postoji

Stranice o API-ju obično pišu o OAuth-u, SDK-ovima i sandboxu pa ispadne da postoji nešto što ne postoji. Kratka i točna verzija stoji ispod.

Radi danas

XML feedovi sa stalnim adresama

Cjenik po zakonu, katalog za nabava.net i jeftinije.hr. Osvježavaju se sami svaki dan.
Uvoz kataloga iz tablice

CSV ili Excel, s mapiranjem stupaca i probnim prolazom prije pravog uvoza.
Izvoz kataloga i izvještaja

Katalog u CSV-u i XLSX-u, izvještaji prodaje i proizvoda u CSV-u.
ERP šifra na proizvodu

Vlastita šifra iz vašeg sustava stoji na artiklu i po njoj se artikl pronalazi.
Proširenje po trgovini

Spoj s vašim sustavom izrađujemo i uključujemo samo vašoj trgovini.
Izlazne integracije

Dostavljači, pružatelji plaćanja i Porezna uprava — trgovina sama poziva njihove sustave.

Ne postoji

Javni REST API

Nema adresa koje bi vaš program zvao da čita ili mijenja proizvode, narudžbe i kupce.
API tokeni

Nema mjesta u panelu gdje bi se izdao ključ za pristup, jer nema čemu pristupiti.
Izlazni webhookovi

Trgovina ne javlja vašem sustavu da je pala narudžba ni da se status promijenio.
SDK-ovi i sandbox

Nema biblioteke za PHP ili JavaScript ni testnog okruženja za API.

Dok toga nema, ne naplaćujemo ga i ne obećavamo rok. Ako vam spoj treba sada, javite se — u većini slučajeva se rješava feedom, uvozom iz tablice ili proširenjem napravljenim za vašu trgovinu.

Opišite svoj sustav

Feed je najkraći put van

Umjesto da vanjski sustav poziva trgovinu, trgovina ostavi datoteku na stalnoj adresi i osvježava je sama. Za usporednike i za zakonsku obvezu to je sve što treba.

Tri feeda: zakonski cjenik, nabava.net i jeftinije.hr — svaki na svojoj adresi.
Osvježavaju se svaki dan rano ujutro; možete ih i ručno ponovno izgraditi iz panela.
Cjenik se vodi i arhivira jer je zakonska obveza — radi u svakom planu, i na Starteru.
Katalog za usporednike uključujete prekidačem; adresa se ispisuje u postavkama.
Cjenik nosi i najnižu cijenu u zadnjih 30 dana i sidrenu cijenu, kako propis traži.

Feeda za Google Shopping i Facebook katalog zasad nema. Ako o tome ovisi vaše oglašavanje, javite nam se prije nego otvorite trgovinu.

vasa-trgovina.hr/feeds/cjenik.xml

<proizvod>
  <NAZIV_PROIZVODA>Klima uređaj 3,5 kW</NAZIV_PROIZVODA>
  <SIFRA_PROIZVODA>SK-1042</SIFRA_PROIZVODA>
  <MARKA>Primjer</MARKA>
  <MALOPRODAJNA_CIJENA>549,00</MALOPRODAJNA_CIJENA>
  <NAJNIZA_CIJENA_ZADNJI_30_DANA>579,00</NAJNIZA_CIJENA_ZADNJI_30_DANA>
  <SIDRENA_CIJENA>599,00</SIDRENA_CIJENA>
  <EAN>3858888123456</EAN>
  <KATEGORIJA>Klima uređaji</KATEGORIJA>
</proizvod>

Jedna stavka cjenika, skraćeno. Feedovi za usporednike imaju svoja polja (cijena bez PDV-a, dostupnost, rok i cijena dostave, slika, poveznica).

Tablica je i dalje najčešći „API"

Većina prijenosa u praksi ide kroz Excel: dobavljač pošalje cjenik, knjigovođa traži izvoz. Zato uvoz nije čarobnjak koji pretpostavlja vaše stupce, nego ih vi sami spojite.

Uvoz kataloga

Učitate CSV ili Excel, pokažete koji stupac je što, i prvo pokrenete probni prolaz — pokaže što bi se dogodilo, bez ijedne izmjene u katalogu.

Vaš stupac → polje u trgovini

Artikl name
Kat. broj sku
VPC wholesale_price
Stanje quantity
Barkod ean13

Artikli se pronalaze po šifri, pa ponovni uvoz osvježava postojeće, a ne stvara duplikate.

Uvoz je dostupan od plana Business.

Izvoz

Katalog izlazi u CSV-u i u Excelu, izvještaji prodaje i proizvoda u CSV-u, a pojedina narudžba i račun kao PDF.

Katalog proizvoda CSV · XLSX
Izvještaj prodaje CSV
Izvještaj proizvoda CSV
Narudžba, račun PDF
Popis narudžbi i kupaca još ne

Izvoz kataloga i izvještaja radi u svakom planu. Više o izvještajima na stranici o analitici.

Kad vam treba spoj s vlastitim sustavom

Umjesto da čekate općeniti API, spoj napravimo za vašu trgovinu i uključimo samo njoj. Kod stoji u zajedničkoj platformi, pa se održava i nadograđuje s ostatkom.

ERP šifra na artiklu

Svaki proizvod nosi i šifru iz vašeg sustava, uz naziv i vlastitu šifru. Po njoj se artikl pronalazi pri svakom sljedećem prijenosu, pa se ne veže po nazivu.

products.erp_code

Primjer koji radi: M SAN

Za trgovine koje prodaju robu distributera M SAN postoji spoj na njihov B2B sustav: katalog, cjenik i dostupnost po odabranim kategorijama, uvoz po rasporedu, pristup vašim certifikatom.

Slanje narudžbi distributeru je izrađeno, ali čeka njegovo odobrenje — zato ga ne nudimo u sučelju.

Proširenje samo za vašu trgovinu

Spoj se uključuje kao proširenje vezano na jednu trgovinu. Druge ga ne vide i ne mogu ga uključiti — ovlast dajemo mi, a njegove tajne (ključevi, certifikati) stoje u postavkama vaše trgovine.

Pitajte za procjenu

Sustavi koje trgovina poziva sama

Za ovo vam ne treba nikakav API: trgovina već razgovara s njima, vi samo upišete svoje pristupne podatke i uključite ih.

Dostavljači

Pet dostavljača: izrada pošiljke, naljepnica, otkaz i praćenje iz panela. Svaki poziv ostaje zapisan.

Od plana Business

Detaljno

Pružatelji plaćanja

Pet kartičnih pružatelja i PayPal, uz pouzeće i virman bez provizije.

Kartice od Businessa

Detaljno

Porezna uprava

Fiskalizacija računa vašim certifikatom, sa ZKI-jem i JIR-om na svakom računu.

U svakom planu

Detaljno

Analitičke oznake

Google Analytics i Meta Pixel — oznake upišete u postavke, učitaju se uz privolu posjetitelja.

U svakom planu

Detaljno

Pitanja o spajanju

Opišite sustav s kojim se treba spojiti i što treba putovati u kojem smjeru — pišite nam i reći ćemo je li to feed, uvoz ili proširenje.

Recite nam s čime se trgovina mora spojiti

Feed, uvoz iz tablice ili proširenje po mjeri — odgovorit ćemo što je izvedivo i kako, bez obećanja API-ja kojeg nema.

Otvorite trgovinu Pogledajte cijene

Feedovi i izvoz rade u svakom planu; uvoz kataloga i dostavljači od plana Business.