B2B API

Upute za spajanje na B2B web servis

U nastavku se nalazi kratak opis aktivacije i korištenja Šmit Electronic B2B web servisa.

B2B web servis namijenjen je registriranim i odobrenim B2B korisnicima te omogućuje preuzimanje podataka o proizvodima, kategorijama i dostupnosti artikala u XML i JSON formatu.

Aktivacija korisničkog računa

Za korištenje B2B web servisa potreban je aktivan korisnički račun na Šmit Electronic web shopu.

Ako vam je korisnički račun kreiran od strane Šmit Electronic tima, na e-mail ćete zaprimiti poveznicu za postavljanje lozinke. Klikom na poveznicu potrebno je postaviti lozinku i dovršiti aktivaciju korisničkog računa.

Ako se poveznica ne otvara, kopirajte adresu iz e-maila i zalijepite je u internetski preglednik.

Nakon postavljanja lozinke prijavite se na web shop svojim korisničkim podacima.

Aktivacija B2B API pristupa

Nakon prijave na web shop potrebno je aktivirati B2B API pristup unutar korisničkog profila.

B2B API pristup dostupan je na sljedećoj poveznici:

https://smit-electronic.hr/hr/b2b-api

Ako B2B API pristup još nije omogućen za vaš korisnički račun, na stranici će se prikazati poruka da pristup nije aktiviran. Za aktivaciju kliknite na gumb Enable B2B API access.

Nakon aktivacije potrebno je postaviti korisničko ime i lozinku za API pristup.

Ako ste već ranije koristili B2B API, možete ponovno postaviti iste pristupne podatke. U suprotnom postavite nove podatke prema vlastitom odabiru.

Nakon unosa podataka kliknite Spremi.

Podržani formati

B2B web servis podržava sljedeće formate:

• XML
• JSON

Dokumentacija

Molimo vas da prije korištenja servisa preuzmete i pregledate dokumentaciju.

Dokumentacija će se ažurirati prilikom svake eventualne izmjene servisa.

Korištenje servisa

U dokumentaciji je objašnjeno programsko spajanje na servis, kao i poziv putem URL-a.

Dostupni endpointi

Nakon aktivacije B2B API pristupa dostupni su endpointi za proizvode, dostupnost i kategorije.

Proizvodi

JSON endpoint:

/api/b2b/products

XML endpoint:

/api/b2b/products/xml

Putem ovih endpointa preuzimate podatke o artiklima.

Podaci mogu uključivati:

• preporučenu MPC cijenu;
• vašu nabavnu cijenu;
• slike artikala;
• opise artikala;
• ID artikla;
• ID grupe;
• stanje artikla.

Dostupnost / stanje artikala

JSON endpoint:

/api/b2b/availability

XML endpoint:

/api/b2b/availability/xml

Ovi endpointi prikazuju dostupnost artikala.

Preporučujemo da se podaci o dostupnosti automatski dohvaćaju najmanje jednom dnevno.

Kategorije

JSON endpoint:

/api/b2b/categories

XML endpoint:

/api/b2b/categories/xml

Ovi endpointi koriste se za preuzimanje grupa/kategorija artikala te za lakše povezivanje naših grupa artikala s vašim grupama.

Pristupni podaci

Za korištenje servisa potrebni su API pristupni podaci koje korisnik postavlja unutar korisničkog profila nakon aktivacije B2B API pristupa.

Pristup servisu omogućen je samo registriranim i odobrenim B2B korisnicima.

Kontakt

U slučaju dodatnih pitanja ili poteškoća sa spajanjem na B2B web servis, slobodno nas kontaktirajte putem e-maila:

kutina@smit-electronic.hr