1. Vzpostavitev povezave

V Nastavitve > Spletne povezave si dodate novo "Spletno trgovino". 

Vnesete URL za API klice ter vaš token (API token - ključ dobite v svoji Shopamine trgovini pod Nastavitve > Integracija > API avtentikacija).

Sami pa morate določiti privzeto skladišče ter cenik, po katerem se bo posodabljala zaloga in cena v Shopamine trgovini.
V Metakocki je potrebno tudi ustvariti nov artikel, ki bo služil kot strošek za poštnino, če jo imate.

2. Sinhronizacija artiklov

S klikom na gumb "Sinhronizacija artiklov" se bodo sinhronizirali vsi artikli iz Shopamine trgovine v Metakocko in obratno, če so v Metakocki tako nastavljeni - na artiklu mora biti označen za izmenjavo. 

Funkcija "Osveži obstoječe artikle" posodobi samo osnovne informacije o že sinhroniziranih artiklih.

Artikli, ki se bodo ujeli preko sinhronizacije (ali s sinhronizacijo artiklov ali preko novih naročil) bodo avtomatsko postali označeni za izmenjavo - "Spletna trg.".

Zaloga se samodejno sinhronizira po 15 minutnem intervalu, lahko pa jo tudi sprožite ročno z gumbom "Sihronizacija zaloge".

5. Sinhronizacija cen

Cene se nastavijo z uvozom artiklov ali pa z ročno sinhronizacijo "Sihronizacija cen".

6. Ročni prenos računov

Račune lahko tudi ročno prenesete, prej le nastavite mejni datum in nastavitve shranite.

Nato pa izvedite operacijo "Sihronizacija računov"

Prenesli se bodo vi računi do mejnega datuma, razen tisti ki so se že prenesli preko sistema.

Pozor!, če ste račune ročno vnašali se bodo podvojili.

7. Nastavitev dodatnih parametrov

• Privzeta dobavljivost: izpiše se na artiklih, ki nimajo več zaloge
• Privzeti davek id: vnesite 1 za 22%, 2 za 9,5% ali 3 za 0%
• Vedno tuj račun: nova naročila prenese pod Prodaja > Računi > Tuji
• Ne upoštevaj status računa: prenesejo se tudi naročila ki še niso bila potrjena ali zaključena
• Začetni datum za račune: Mejni datum pri sinhronizaciji naročil
• Cenik: Cenik za sinhronizacijo cen s spletno trgovino
  
• Glavno skladišče: Skladišče za sinhronizacijo zaloge s spletno trgovino
• Poštnina: privzeti artikel, ki se bo dodal na račun kot poštnina (njegova cena se prenese s samega naročila)
• Tip plačila za ponudbe: imena plačil, katere prenesejo spletna naročila v ponudbe
• Uporabnik brez cenika - uporabi prevzeti cenik - v primeru da spletna trgovina bere cene iz MK in ne obstaja povezava na partnerja preko email naslova, se lahko vrne cena iz izbranega cenika.

Ko vse nastavite nas obvestite, da podjetju Shopamine javimo identifikacijsko številko vašega podjetja.

8. Postopek brana cen artiklov

Preden Shopamine prikaže cene uporabniku, pokliče MK za morebitne cene iz cenika.

Branje cen iz Shopamine v MK se izvede na naslednji način :

1. shopamine pošlje klic getUserPrices, kjer poda email naslov uporabnika in seznam artiklov v kombinaciji (MetaKocka Id Artika - količina)
2. v MK uporabimo email, da poiščemo kontakt s tem email -> povezan naslov -> iz naslova izbrani prevzeti cenik. Tako dobimo cenik
3. iz cenika se prebere cena artikla in pri tem se upošteva :
   1. podano količino, če je na ceniku določena cenovna lestvica
   2. dodatni popust, če je le ta nastavljen na partnerju.

Če točka (2) ni izpolnjena, potem MK ne vrne cene in v spletni trgovini se prikaže prevzeta cena iz spletne trgovine (MK na to nima vpliva). Če želimo, da se v tem primeru prebere cena iz prevzeta cenika (izbran pod "Cenik"), lahko to vključimo preko nastavitve "Uporabnik brez cenika - uporabi prevzeti cenik".

9. Reševanje težave podvojenih SKU številk

Če v spletni trgovini obstaja več artiklov s enako SKU številko, potem se artikel ne bo prenesek v trgovino kot novi artikel.

Kateri so to artikli najlažje ugotovimo tako, da :

• izvedemo Sinhronizacijo artiklov,
• v Nastavitve aplikaciji poiščemo niz "Prišlo je do napake pri dodajanju artikla".

S pritiskom na gumb "Rq" dobimo poslani zahtevek.

{
  "avail_in_days": 15,
  "tax_class_id": 3,
  "sku": "1366",
  "unit_of_sale": {
    "__": "kos"
  },
  "shipping_dimensions": {},
  "stock_amount": 2,
  "prices": {
    "p1": 29.0000000000
  },
  "name": {
    "__": "Eko 2-delni komplet za dojenčka - Čebelica 3-6 m"
  },
  "type": "physical",
  "external_id": "1350"
}

Pritisk na gumb "Rs" pa izpiše opis napaka. V tem primeru je Item with this user code already exists.

Če sedaj iščemo po SKU številki - v našem primeru 1366, bomo dobili dva zadetka :

Zahtevek s sporočilom "read list data items / list" vsebuje seznam vseh artiklov v spletni trgovini. Ob kliku na gumb "Rs" dobimo podatke s strukturirani obliki JSON. Če sedaj poiščamo sku številko "1366", bomo videli s katerim artikom se v trgovini prekriva. 

Rešitev težave : 

• za Shopamine je pomembno, da sta edinstvena tako id artikla (Shopamine JSON struktura - id ; MK - Id artikla) kot šifra artikla (Shopamine JSON struktura - external_id ; MK - Šifra artikla)
• zato je potrebno za artikel določiti novi Id artikla (v MK to preko izbire artikla - glej sliko spodaj)  ali novo šifro artikla (samo spremenimo na artiklu). Za obe novi vrednosti predhodno preverimo, ali se že nahajata v Shopamine. Najbolje tako, da preverimo zgornjo JSON strukturo.