Vzpostavitev povezave za izmenjavo / sinhronizacijo


Integracija spletne trgovine postavljeni na PrestaShop platformi z MetaKocko omogoča:

- avtomatske prenose naročil z vsemi podatki kupca ( prejemnik, plačnik, vrsto plačila, popusti in naročenimi artikli) 

- sinhronizacijo artiklov ( artikle se lahko iz spletne trgovine prenese v MetaKocko z vsemi podatki, ki ste jih že vnesli v spletni trgovini)

- avtomatsko sinhronizacijo zalog


Računi, ki se brez dodatnega dela generirajo na podlagi avtomatsko prenešenih naročil se za zakonsko določena plačilna sredstva tudi potrdijo na FURS-u, za izdano blago pa se ustrezno zniža zaloga blaga in osveži zalogo tudi v spletni trgovini ( če je tako nastavljeno).


Pridobitev API ključev


Za vzpostavitev povezave s PrestaShop spletno trgovino je potrebno iz le-te pridobiti naslednje podatke:

  • Spletni naslov trgovine
  • Ključ za dostop do spletnega servisa (PrestaShop WebService Key)

Ključ za dostop do spletnega servisa velja do preklica.


Potek opisan po korakih:

1. Prijavimo se v nadzorno ploščo spletne trgovine PrestaShop in v levem meniju pod kategorijo Configure izberemo Advanced Parameters

2. Ko se nam meni razširi izberemo Webservice



3. Na tej strani zgoraj desno izberemo opcijo Add new webservice key



4. Odpre se nam stran za dodajanje novega ključa za dostop do spletnega servisa

5. Key je obvezni parameter in ga lahko vpišemo sami, ali pa za avtomatsko generiranje kliknemo gumb »Generate«(priporočljiva opcija)

6. Key description je naš lastni opis, kamor lahko zapišemo čemu je ključ namenjen (v tem primeru bi lahko bil opis »Povezava z MetaKocka storitvijo«

7. Kot tretje moramo izbrati Status novega ključa. Lahko je omogočen (Yes) ali pa onemogočen (No). V primeru povezave z MetaKocko moramo ključ aktivirati, v nasprotnem primeru povezava ne bo delovala

8. Zadnji korak dodajanja novega ključa za dostop do spletnega servisa PrestaShop trgovine je izbira pravic (Permissions), ki jih bo MetaKocka imela. V našem primeru je dovolj, če se izbere vse View (GET) in Modify (PUT) opcije



9. Po končani izbiri kliknemo gumb Save, ki nam nastavitve shrani in aktivira ključ



10. Naslov spletne trgovine ter pravkar kreirani ključ (Key) nato vnesemo v Metakocka spletnem vmesniku.


Pojdite v Nastavitve/povezave (1), dodajte povezavo za Prestashop (2), vpišete URL vaše spletne trgovine (3), vnesete ključ, ki ste ga pridobili v spletni trgovini (4) ter shranite (5). Po shranitvi kliknit test povezave, da preverite ali povezava deluje



Preslikava artiklov po šifrah

Za šifro artikla se uporablja polje Reference.




Sinhronizacija artiklov ( Spletna trgovina <> MetaKocka ) 

Prenesejo se samo aktivni artikli.


Več informacij o delovanju si preberite tukaj.


Težave pri povezovanju

401 Unauthorized error

V koliko dobite napako "401 Unauthorized error", potem je potrebno narediti ustrezno spremembo v Apache konfiguraciji. Opis težave in rešitev je na spodnjih povezavah :



Hitri odgovor :

Spremembe je potrebno narediti v .htaccess datoteki v root imeniku od spletne strani.

Prej:


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule ^api$ api/ [L]


Potem (boldana vrstica je bila dodana):


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteRule ^api$ api/ [L]


Napačni ključ vs. težave pri dostopu do API

V primeru, da Apache na trgovini ni pravilno nastavljen, boste dobili napako : 401 Unauthorized


Če pa bo ključ napačen, bo odgovor tudi 401, vendar z vsebino : {"errors":[{"code":20,"message":"Authentification key is not active"},{"code":21,"message":"No permission for this authentication key"}]}


Simulacija klica preko REST client

Delovanje preko REST client lahko preverite na naslednji način :

  1. recimo, da imate spletno trgovino na naslovu http://18.196.116.84, ter da ima Key vrednost "1234".
  2. sestavite URL naslov za test povezave : http://18.196.116.84/api/configurations/?display=full&output_format=JSON
  3. Pretvorite ključ v Base64 (https://www.base64encode.org/) in ga vpišete pod "Authorization" header z vrednostjo "Basic NEY2VjgzVDFLRURSQkpLWEkxWlVaRQ=".
  4. Izvedete klic in bi morali dobiti odgovor s podatki.

Primer delovanja na spodnji sliki :


Še niste uporabnik MetaKocke? Registrirajte se in 30 dni brezplačno testirajte delovanje!!