Internet trgovina WooCommerce

Poglavlje opisuje kako aktivirati razmjenu podataka između aplikacije e-računi i internet trgovine na platformi WooCommerce.

Pravilno postavljena veza i izmjena podataka omogućuje stalnu sinkronizaciju narudžbi kupaca i zalihe između internet trgovine i e-računa. Veza je i uvjet za namještanje i rad WooCommerce plugina koji omogućuje uporabu naprednih funkcija unutar korisničkog sučelja WooCommerce (WooCommerce plugin).

Podržane su verzije od 2.4. do 3.6., odnosno sve sljedeće verzije koje budu podržavale "Legacy v3" API.

Postavke u WooCommerceu

Za aktivaciju razmjene podataka s WooCommerce potrebno je najprije aktivirati WooCommerce REST API. Kako to učiniti možete pogledati na sljedećoj poveznici:

https://docs.woothemes.com/document/woocommerce-rest-api/

Aktivacija razmjene podataka

Nakon aktivacije WooCommerce REST API, za razmjenu podataka je potrebno pripremiti sljedeće podatke:

URL adresu trgovine
u postavkama za API u WooComerce aplikaciji potrebno je generirati "consumer secret" i "consumer key"
Consumer secret
Consumer key

Ukoliko se koristi WooCommerce verzija 2.6 ili novija, potrebno je omogućiti "zastarjeli API". To je moguće kroz "Postavke->Napredno->Zastarjeli API->Omogući zastarjeli API".

U e-računima odredimo skladište i mjesto troška, na kojem će se voditi poslovanje u internet trgovini.

Postavke za internet trgovinu upišemo po uzoru na sljedeći primjer:

Slika 1: Postavke za sinkronizaciju za WooComerce

Ukoliko se koristi WooCommerce 3.6+, dovoljno je u URL poslužitelja upisati samo domenu internet trgovine u obliku https://www.testtrgovina.hr.

Dodatne sinkronizacije dostupne za WooCommerce i WooCommerce 3.6+

Za korisnike koji imaju aktiviranu sinkronizaciju za internet trgovinu WooCommerce je pored standardne sinkronizaciju moguća i automatska sinkronizacija stanja zalihe iz programa e-racuni u internet trgovinu te uvoz šifrarnika artikala iz internet trgovine u program e-racuni. Za platformu WooCommerce 3.6+ je dodatno moguće izvoziti šifrarnik artikala iz programa e-racuni u internet trgovinu, te uvoziti/izvoziti cjenik artikala.

Kada smo unijeli postavke sinkronizacije te istu aktivirali, navedene dodatne opcije su dostupne klikom na gumb:

Slika 2: Dodatne mogućnosti sinkronizacije

Dodatna mogućnost "Uvozi šifrarnik artikala iz internet trgovine" nudi mogućnost označavanja da se podaci artikla koji već postoje u programu e-racuni prepišu podacima artikala iz internet trgovine:

Dodatna obrada pri sinkronizaciji s internet trgovinom "Koje artikle sinkroniziramo" u WooCommerce 3.6+ izvozi sve artikle glede na odabran uvjet:

sve artikle (izvoz svih artikala iz šifrarnika artikala)
artikli vidljivi za online katalog/trgovinu (izvoz svih artikala koji su označeni kao vidljivi u online trgovini/katalogu)
artikle dodane u internetsku tržnicu (izvoz svih artikala koji su dodani u internetsku tržnicu pojedinačne internet trgovine)

Dodatno unutar postavki izvoza su još dvije opcije:

Dodan/izmjenjen artikl izvozi/ažuriraj s internet trgovinom - ukoliko je ta mogućnost označena, artikli koje izmjenimo ili dodamo u šifrarnik artikala će se automatski sinkronizirati u internet trgovinu (u roku ~10 minuta)
Izvozi akcijske cijene artikala - ukoliko je ta mogućnost označena, se bude za pojedinačni artikla prenijela akcijska cijena artikla koja je određena u modulu Prodaja->Prodajne akcije i popusti

Postavke u WooCommerceu: plugin za prijenos poreznog broja kupca

Podaci o kupcu (ime, prezime, adresa, kontakt) se samostalno prenesu s ostalim podacima s narudžbe kupca, no za prijenos poreznog broja je u WooCommerceu potrebno aktivirati plugin za prijenos. Upute za dodavanje plugina možete vidjeti na sljedećoj poveznici.

Uvoz narudžbi preko WebHooka

Nakon što uključite razmjenu podataka, narudžbe se u E-račune prenose približno svakih jedan sat. Ukoliko želite da se narudžbe prenose odmah nakon što su napravljene u internet trgovini, možete si uključiti sinkronizacijo preko webhookova.

Generirajte Unikatni identifikator "Web Hook URL" u postavkama internet trgovine u E-računima.
Dodajte webhook u internet trgovini. Postavke -> API -> Webhooki -> Dodaj webhook (slika 5). Upotrijebite sljedeće postavke:

Za kreirane narudžbe (slika 3)

Naziv: Upišite željeni naziv
Status: Aktivno
Tema: Narudžba kreirana
URL za dostavu: Generirani "Web Hook URL" iz postavki internet trgovine u E-računima (slika 2)
Secret: Vrijednost se generira automatski te ju nije potrebno mijenjati
Verzija API: Zastarjeli API v3 (kada imamo postavljenu platformu WooCommerce) ili WP REST API integracija v3 (kada imamo postavljenu platformu WooCommerce 3.6+)

Za ažurirane narudžbe (slika 4)

Naziv: Upišite željeni naziv
Status: Aktivan
Tema: Narudžba ažurirana
URL za dostavu: Generirani "Web Hook URL" iz postavki internet trgovine u E-računima (slika 2)
Secret: Vrijednost se generira automatski te ju nije potrebno mijenjati
Verzija API: Zastarjeli API v3 (kada imamo postavljenu platformu WooCommerce) ili WP REST API integracija v3 (kada imamo postavljenu platformu WooCommerce 3.6+)

Pri uključivanju webhooka se narudžbe sinkroniziraju odmah, te se zbog toga periodična sinkronizacija svakih sat vremena isključi. Sinkronizacija se napravi još jednaput na dan (kroz noć) kako bi se prenijele narudžbe koje nedostaju, koje se možda nisu prenijele zbog greške pri sinkronizaciji preko webhooka. Ukoliko webhook u WooCommerceu nije omogućen, narudžbe se ne budu sinkronizirale.

Pri prvom neuspješnom pokušaju sinkronizacije narudžbe preko webhooka, se on automatski isključi u Woocommerceu. Za promjenu navedenoga kontaktirajte administratora vaše internet trgovine. Kako napraviti promjene je opisano na sljedećoj poveznici:

https://wordpress.stackexchange.com/questions/214868/woocommerce-webhook-disabled-on-its-own/215482

Pri korištenju webhookova se sinkroniziraju i statusi, što znači da se pri promjeni statusa u internet trgovini isto promijeni i u E-računima.

Slika 6: Generirani "Web Hook URL" nakon klika na gumb "Generiraj"

Slika 7: Postavke za webhook kreiranu narudžbu u WooCommerceu

Slika 8: Postavke za webhook ažuriranu narudžbu u WooCommerceu