Uspostavljanje veze za razmjenu / sinkronizaciju


Integracija online trgovine postavljene na PrestaShop platformi s MetaKockom omogućava:

- automatske prijenose narudžbi sa svim podacima kupca (primatelj, platitelj, vrsta plaćanja, popusti i naručeni proizvodi)

- sinkronizaciju proizvoda (proizvodi se iz online trgovine mogu prenijeti u MetaKocku sa svim podacima, koje ste već unijeli u online trgovini)

- automatsku sinkronizaciju zaliha


Računi koji se bez dodatnog rada generiraju na temelju automatski prenesenih narudžbi se za zakonski određena platna sredstva takođe fiskalno provjeravaju na FURS-u, dok se u skladu s tim za izdanu robu snižuju zalihe robe i osvježuju zalihe u online trgovini (ako je tako podešeno). 



Pribavljanje API ključeva


Za uspostavljanje veze sa PrestaShop online trgovinom potrebno je iz iste pribaviti sljedeće podatke: 

  • Adresu online trgovine
  • Ključ za pristup online servisu (PrestaShop WebService Key)

Ključ za pristup online servisu važi do otkazivanja.


Postupak opisan po koracima:

1. Prijavimo se u upravljačku ploču online trgovine PrestaShop i u lijevom meniju pod kategorijom Configure odaberemo Advanced Parameters

2. Kada nam se opcije otvore odaberemo WebService



3. Na toj strani gore desno odaberemo opciju Add new webservice key



4. Otvori nam se strana za dodavanje novog ključa za pristup online servisu

5. Key je obavezni parametar i možemo ga sami upisati, dok za automatsko generiranje kliknemo na gumb »Generate«(preporučljiva opcija)

6. Key description je naš vlastiti opis, gde možemo da zapišemo čemu je ključ namjenjen (u tom slučaju bi opis mogao biti - »Link s MetaKocka uslugom«

7. Kao treće, moramo odabrati Status novog ključa. Može biti omogućen (Yes) ili onemogućen (No). U slučaju povezivanja s MetaKockom ključ moramo aktivirati, u suprotnom povezivanje neće funkcionirati

8. Posljednji korak dodavanja novog ključa za pristup online servisu PrestaShop trgovine je odabir ovlasti (Permissions), koje će MetaKocka imati. U našem slučaju je dovoljno, ako se odaberu sve View (GET) i Modify (PUT) opcije


9. Nakon završenog odabira kliknemo na gumb Save, koji će nam spremiti postavke i aktivirati ključ



10. Adresu online trgovine i upravo kreirani ključ (Key) potom unesemo u MetaKocka web sučelje.


Idite u Postavke/Linkovi (1), dodajte l za PrestaShop (2), upišite URL Vaše online trgovine (3), unesite ključ, koji ste pribavili u online trgovini (4) i spremite (5). Nakon spremanja, kliknite na test veze, da provjerite uspješnost iste.



Preslikavanje proizvoda po šiframa

Za šifru proizvoda se koristi polje Reference.




Sinkronizacija proizvoda ( Online trgovina <> MetaKocka ) 

Prenose se samo aktivni proizvodi.


Više informacija o funkcioniranju pročitajte ovde.


Problemi pri povezivanju

401 Unauthorized error

Ukoliko dobijete grešku  "401 Unauthorized error", potom je potrebno napraviti odgovarajuću promjenu u Apache konfiguraciji. Opis problema i rješenje je dostupno na linkovima ispod: 



Brzi odgovor :

Promjene je potrebno napraviti u .htaccess datoteci u root imeniku online trgovine.

Prije:


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule ^api$ api/ [L]


Poslije (boldani redak je dodan):


RewriteRule . - [E=REWRITEBASE:/]

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

RewriteRule ^api$ api/ [L]


Pogrešni ključ vs. problemi prilikom pristupa API

U slučaju, da Apache nije pravilno podešen u trgovini, dobit ćete sljedeću pogrešku : 401 Unauthorized


Ako ključ bude pogrešan, odgovor će također biti 401, ali sa sadržajem : {"errors":[{"code":20,"message":"Authentification key is not active"},{"code":21,"message":"No permission for this authentication key"}]}


Simulacija poziva preko REST client

Funkcioniranje preko REST client možete provjeriti na sljedeći način :

  1. recimo, da imate online trgovinu na adresi http://18.196.116.84, i da ima Key vrijednost "1234".
  2. sastavite URL adresu za test veze : http://18.196.116.84/api/configurations/?display=full&output_format=JSON
  3. pretvorite ključ u Base64 (https://www.base64encode.org/) i upišite ga pod "Authorization" header s vrijednošću "Basic NEY2VjgzVDFLRURSQkpLWEkxWlVaRQ=".
  4. Izvedite poziv i morali biste dobiti odgovor sa podacima.

Primer funkcioniranja na sliki ispod :


Još niste korisnik MetaKocke? Registrirajte se i 30 dana besplatno testirajte funkcioniranje!!