Integracija WooCommerce prodavnice pomoću API-ja: kako izgleda u praksi

Kada dobavljač ima hiljade artikala, ručni unos u internet prodavnicu nije realna opcija. Cene se menjaju, artikli dolaze i odlaze, a svaka greška u unosu znači pogrešnu ponudu kupcu. Rešenje je da se prodavnica poveže direktno sa bazom dobavljača, tako da se artikli preuzimaju automatski.
Upravo tako smo uradili za firmu POINTCORP iz Beograda, distributera reklamnog materijala, čija prodavnica danas prikazuje više od 5.000 artikala preuzetih iz baze dobavljača (pogledajte projekat). U ovom tekstu objašnjavamo kako takva integracija izgleda korak po korak i šta treba da znate pre nego što krenete.
Šta je API integracija sa dobavljačem?
API je dogovoren način na koji dva sistema razmenjuju podatke. Kada dobavljač ima API ili redovno objavljuje datoteku sa artiklima, vaša WooCommerce prodavnica može sama da preuzima te podatke: nazive, opise, cene, slike, kategorije i stanje na lageru. Umesto da ih neko prekucava, prodavnica ih preuzima i ažurira automatski.
Korak 1: Tačno utvrditi šta dobavljač daje
Ovo je najvažniji korak i od njega zavisi sve ostalo. Pre bilo kakvog programiranja proveravamo:
- U kom obliku dobavljač daje podatke: preko API-ja ili kao datoteku (XML, CSV, JSON).
- Koja polja postoje: naziv, šifra, opis, cena, porez, slike, kategorije, varijante (boje, veličine), stanje na lageru.
- Koliko često se podaci menjaju i koliko često smemo da ih preuzimamo.
- Da li su slike dostupne u dobrom kvalitetu i pod kojim uslovima.
- Kakve su cene: nabavne, preporučene maloprodajne ili obe.
Česta je pretpostavka da dobavljač „ima sve“. U praksi podaci često imaju rupe: artikli bez slika, kategorije koje ne odgovaraju vašoj prodavnici, opisi na stranom jeziku. Bolje je to znati na početku nego otkriti posle objave.
Korak 2: Mapiranje polja
Podaci dobavljača retko su složeni na isti način kao u WooCommerce-u. Zato pravimo mapu: koje polje dobavljača ide u koje polje prodavnice. Na primer:
- šifra artikla dobavljača postaje šifra (SKU) u prodavnici i služi kao jedinstveni ključ, da se isti artikal nikad ne unese dva puta;
- kategorije dobavljača prevodimo u kategorije vaše prodavnice;
- dodatne osobine (materijal, dimenzije, boja) postaju atributi, po kojima kupac može da filtrira;
- varijante istog proizvoda spajamo u jedan artikal sa izborom, umesto desetina odvojenih.
Dobra mapa je razlika između prodavnice u kojoj se kupac snalazi i kataloga koji je samo spisak.
Korak 3: Aplikacija za upis podataka u WordPress
Kada znamo šta preuzimamo i gde to ide, pravimo dodatak koji podatke upisuje u prodavnicu. On mora da:
- prepozna nove artikle i doda ih;
- ažurira postojeće kada se promene cena, stanje ili opis;
- zna šta da radi sa artiklima koje dobavljač više nema (sakrije ih, ne briše odmah);
- preuzme i obradi slike, da ne opterete sajt;
- radi u manjim delovima i u zakazanim terminima, da veliki broj artikala ne uspori prodavnicu za kupce;
- beleži šta je urađeno i javi ako nešto ne prođe.
Samo preuzimanje ili i uređivanje pre objave?
Ovo je pitanje koje treba rešiti pre izrade, jer menja ceo način rada integracije.
Samo preuzimanje
Prodavnica prikazuje podatke tačno onako kako ih daje dobavljač i redovno ih osvežava. To je najjednostavnije i najbrže rešenje, dobro kada su podaci dobavljača kvalitetni i kada vam ne trebaju sopstvene cene.
Preuzimanje uz uređivanje
Vi pre objave ili u bilo kom trenutku menjate artikle: cene, slike, nazive, opise ili kategorije. Na primer, dodajete svoju maržu na nabavnu cenu, menjate slike boljim, ili prevodite opise. Ovde je ključno da integracija zna koja polja ste ručno menjali, kako sledeće preuzimanje ne bi pregazilo vaše izmene. Zato se za svako polje dogovara da li ga osvežava dobavljač ili ga vodite vi.
Moguće je i da artikli prvo stignu kao neobjavljeni, pa ih vi pregledate i objavite, što je korisno kada ne želite da se sve što dobavljač ima odmah pojavi u prodavnici.
Kako smo to rešili za POINTCORP
POINTCORP nije imao sajt, a asortiman od više hiljada artikala kupci su upoznavali preko telefona i ponuda. Napravili smo WooCommerce prodavnicu sa API dodatkom koji automatski preuzima artikle iz baze dobavljača, uz pretragu prilagođenu velikom broju artikala. Prodavnica radi kao katalog: umesto klasične kupovine, kupac šalje upit za ponudu direktno sa sajta. Već u prvoj sedmici posle objave krenule su posete i upiti, a kupci više ne moraju da zovu da bi saznali šta firma nudi. Više o projektu pročitajte u našem portfoliju.
Na šta obratiti pažnju pre početka
- Proverite sa dobavljačem da li dozvoljava automatsko preuzimanje i pod kojim uslovima.
- Odlučite da li vam trebaju sopstvene cene i ručne izmene.
- Računajte na to da kvalitet prodavnice zavisi od kvaliteta podataka koje dobijate.
- Integraciju treba održavati: dobavljači menjaju format podataka, pa je dobro da neko prati da li preuzimanje radi.
Dobro urađena integracija štedi sate ručnog rada svake nedelje i drži ponudu tačnom. Ako razmišljate o internet prodavnici povezanoj sa dobavljačem ili sa vašim ERP sistemom, pogledajte kako radimo internet prodavnice ili nam pošaljite upit.



