Elektronska trgovina WooCommerce

Poglavje opisuje kako vklopimo izmenjavo podatkov med e-računi in spletno trgovino na platformi WooCommerce. Pravilno nastavljena povezava in delujoča izmenjava podatkov zagotavlja stalno sinhronizacijo naročil kupcev in zaloge med spletno trgovino in e-računi. Delujoča povezava je tudi predpogoj za namestitev in delovanje Woocommerce plugina, ki omogoča uporabo naprednih funkcij znotraj uporabniškega vmesnika Woocommerce (glej navodila za namestitev Woocommerce plugina).

Celotni postopek povezave Woocommerce z vsemi opisanimi koraki v nadaljevanju, je na voljo na naslednjem video posnetku:

e-racuni.com - Sinhronizacija z WooCommerce

Nastavitve v WooCommerce

Za vklop izmenjave podatkov z WooCommerce je potrebno najprej aktivirati WooCommerce REST API. Kako se to naredi je razvidno na naslednji povezavi:

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

Vklop izmenjave podatkov

Ko je aktiviran WooCommerce REST API moramo za izmenjavo podatkov pripraviti naslednje podatke:

URL naslov trgovine oz. administracijskega vmesnika
v nastavitvah za API v WooCommerce aplikaciji je potrebno generirati "consumer secret" in "consumer key"
Consumer secret
Consumer key

Znotraj e-računov pa določimo skladišče in stroškovno mesto na katerem se bo vodilo poslovanje v elektronski trgovini.

Nastavitve za elektronsko trgovino vnesemo po zgledu spodnjega primera. Levo so podatki iz uporabniškega vmesnika WooCommerce, katere vnesemo v našo spletno aplikacijo, kot prikazuje desna stran:

Slika 1: Nastavitve za izmenjavo podatkov za WooComerce

V kolikor uporabljamo WooCommerce 3.6+ je dovolj, da v polje za URL naslov strežnika vpišemo samo domeno trgovine v obliki https://www.sivalni-stroji.si

Dodatne sinhronizacije, ki so na voljo za platformo WooCommerce in WooCommerce 3.6+

Za uporabnike, ki imajo sinhronizacijo aktivirano za spletno platformo WooCommerce je poleg standardne sinhronizacije na voljo tudi takojšnja sinhronizacija stanja zaloge iz programa e-racuni v spletno trgovino in uvoz šifranta artiklov iz spletne trgovine v program e-racuni.com. Za platformo WooCommerce 3.6+ pa dodatno še izvoz šifranta artiklov iz programa e-racuni v spletno trgovino.

Ko smo vnesli nastavitve sinhronizacije in smo sinhronizacijo aktivirali bodo te dodatne sinhronizacije na voljo s klikom na gumb, kot kaže slika:

Slika 2: Dodatne možnosti sinhronizacije podatkov

Dodatna možnost "Uvozi šifrant artiklov iz spletne trgovine" ponuja še možnost, kjer si lahko obkljukamo ali želimo, da se podatki artikla, ki so trenutno v spletni aplikaciji e-racuni.com prepišejo z uvoženimi podatki iz trgovine (obkljukamo to možnost) ali ne (je ne obkljukamo)

Dodatna obdelava pri sinhronizaciji s spletno trgovino: "Katere artikle sinhroniziramo" v WooCommerce 3.6+ izvozi vse aktivne artikle pod določenim pogojem:

vse artikle (izvoz vseh aktivnih artiklov)
artikle, vidne v online trgovini/katalogu (izvoz artiklov, ki so označeni kot vidni v online trgovini/katalogu)
artikle, dodane v spletno tržnico (izvoz artiklov, ki so dodani v spletno tržnico za posamezno spletno trgovino )

Dodatno pa imamo v tem sklopu izvoza artiklov še dve opciji:

"Dodan oz. spremenjen artikel izvozi/posodobi s spletno trgovino" - če označimo to možnost, se bodo artikli, ki jih spremenimo oz. dodamo v šifrantu artiklov avtomatsko v roku 10 minut posodobili s spletno trgovino
"Izvozi akcijske cene artikla" - če izberemo to možnost, se bo za posamezni artikel v spletno trgovino prenesla tudi akcijska cena artikla, ki jo določimo v meniju "Prodaja"->"Prodajne akcije in popusti"

Nastavitve v WooCommerce: vtičnik za prenos davčne številke kupca

Podatki o kupcu (ime, priimek, naslov, mail, tel.) se nam samodejno prenesejo s podaki na naročilu kupca. Medtem, ko je potrebno za prenos davčne številke kupca, v WooCommerce akitivirati vtičnik za prenos. Vsa navodila za dodajanje vtičnika so dosegljiva na naslednji povezavi.

Uvoz naročil preko Webhookov

Po tem ko vklopite izmenjavo podatkov, se naročila v E-račune prenesejo na približno vsako 1 uro. Če želite, da se naročila v E-račune prenesejo takoj, ko so oddana v spletni trgovini, si lahko vključite sinhronizacijo preko webhookov.

Zgenerirajte Unikatni identifikator "Web Hook URL" v nastavitvah spletne trgovine v E-računih.
Dodajte webhooka v spletni trgovini. Nastavitve -> API -> Webhooki -> Dodaj webhook. (Slika 5) Uporabite spodnje nastavitve:

Za ustvarjena naročila (slika 3)

Naziv: Vpišite poljuben naziv
Status: Aktivni
Tema: Naročilo je ustvarjeno
URL poizvedbe: Zgeneriran "Web Hook URL" iz nastavitev spletne trgovine v E-računih (slika 2)
Secret: Vrednost se zgenerira avtomatsko in je ni potrebno spreminjati
Različia API: Legacy API v3 (v primeru, ko imamo nastavljeno, da trgovino poganja WooCommerce) oz. WP REST API integracija v3 (v primeru, ko imamo nastavljeno, da trgovino poganja WooCommerce 3.6+)

Za posodobljena naročila (slika 4)

Naziv: Vpišite poljuben naziv
Status: Aktivni
Tema: Naročilo je posodobljeno
URL poizvedbe: Zgeneriran "Web Hook URL" iz nastavitev spletne trgovine v E-računih (slika 2)
Secret: Vrednost se zgenerira avtomatsko in je ni potrebno spreminjati
Različia API: Zastarel API v3 (v primeru, ko imamo nastavljeno, da trgovino poganja WooCommerce) oz. WP REST API integracija v3 (v primeru, ko imamo nastavljeno, da trgovino poganja WooCommerce 3.6+)

Ker se ob vklopu webhookov naročila preneseje takoj, se periodična sinhronizacija na 1 uro izklopi. Izvede se le še enkrat na dan (ponoči), da se lahko prenesejo manjkajoča naročila, ki se mogoče niso prenesla zaradi napake pri prenosu preko webhookov. Če webhooki v WooCommercu niso omogočeni, se naročila ne bodo prenašala.

Ob prvem neuspelem poskusu prenosa naročila preko webhooka, se v WooCommercu webhook onemogoči. To je mogoče spremeniti v programski kodi WooCommerca. Za ureditev spremembe povprašajte skrbnika vaše spletne trgovine. Kako je možno izvesti spremembe je opisano na sledeči povezavi:

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

Pri uporabi webhookov se sinhronizirajo tudi statusi. Tako se naročilom ob spremembi statusa v spletni trgovini ta takoj spremeni tudi v E-računih.

Slika 3: Zgeneriran "Web hook URL" po kliku na gumb "Generiraj"

V kolikor smo v nastavitvah sinhronizacije v programu izbrali, da trgovino poganja WooCommerce:

Slika 4: Nastavitve za webhook za ustvarjeno naročilo v WooCommerce

Slika 5: Nastavitve za webhook za posodobljeno naročilo v WoocCommerce

V kolikor smo v nastavitvah sinhronizacije v programu izbrali, da trgovino poganja WooCommerce 3.6+:

Slika 6: Nastavitve za webhook za ustvarjeno naročilo v WooCommerce 3.6+

Slika 7: Nastavitve za webhook za posodobljeno naročilo v WooCommerce 3.6+