Vzpostavitev povezave za izmenjavo / sinhronizacijo


Integracija spletne trgovine Woocommerce omogoča prenose naročil, sinhronizacijo artiklov, zaloge in cen. Za prenešena naročila se izdelajo in potrdijo na FURSu računi za prodano blago brez prepisovanja in dodatnih vnosov.


Za vzpostavitev povezave z Woocommerce trgovino je potrebno iz Woocommerce trgovine pridobiti naslednje podatke :


Postopek pridobivanja teh podatkov je prikazan v nadaljevanju,  





Zgornje podatke kopirajte saj jih boste potrebovali pri dodajanju povezave v MetaKocki, 


Po prijavi v MetaKocko v Nastavitve/ Povezave dodajte novo povezavo kot prikazano na spodnji sliki:



Pod artikel za dostavo izberite artikel, ki ste ga pred tem vnesli v MetaKocko ( navodilo)


V primeru uspešne povezave boste po kliku na Test povezave dobili potrditev, v primeru da bi bile težave/ napake pa se lahko poslužite orodja/ programa za testiranje povezave ( v spodnjem delu navodil najdete link do programa). 


V primeru vključitve "Skladišče za sinhronizacijo zaloge" se bo izvajala avtomatična sinhronizacija zaloge. To pomeni, da MK vsake 5 minut preveri, če se je spremenila zaloga za artikle. Pri tistih, kjer je prišlo do spremembe, se podatki pošljejo v spletno trgovino.


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


Sinhronizacija artiklov ( Spletna trgovina <> MetaKocka ) 


Vkolikor imate v MetaKocki in WooC že artikle, jih lahko povežete med seboj. Povezava je potrebna v primeru, ko želite sinhronizacijo zaloge, to je aktualno stanje zaloge prikazano tudi v spletni trgovini. Če prenašate samo naročila iz spletne trgovine v MK, potem povezava artiklov ni potrebna. Za vse nove artikle, ki se bodo prenesli iz WooC v MK preko naročila, se bo povezava avtomatično vzpostavila. Prevzeti identifikator za povezavo artiklov je Šifra (MetaKocka) - SKU koda (WooCommerce). 


Za izvedbo sinhronizacije in vzpostavitev povezave pritisnite na gumb "Sinhroniziraj" kot kaže spodnja slika. Po izvedbi se čisto spodaj izpiše status za posamezni artikel. 



Ostala vprašanja :

  1. Ali sinhronizacija karkoli spremeni artikel v spletni trgovini?
    Ne. Vse spremembe se nanašajo v podatke v MK.
  2. Ali sinhronizacija karkoli spremeni artikel v MK?
    Ne. Vsi vidni atributi (naziv, šifra, enota mere, cene na cenikih, zaloga, itd) ostanejo nespremenjeni. Edina vidna sprememba na artiklu je vključitev možnostu "Izmenjava s spletno trgovino". 
  3. Kaj se bo zgodilo s artikli, ki so v MK, ne prodajamo pa jih v spletni trgovini?
    Nič. Ker se sinhronizacija izvede enostransko - prenos se zgodi v smeri spletna trgovina >> MetaKocka.
  4. Kaj se zgodi s artikli, ki so v trgovini in jih ni v MK?
    Artikli se bodo prenesli v MetaKocko če kliknete na gumb za sinhronizacijo Artiklov. 
  5. Je mogoče še kakšni drugačen način ujemanja artiklov?
    Privzeto se ujemanje naredi s pomočjo Woocommerce SKU <> MK Šifra. Lahko se nastavi tudi MK barkoda - WooC SKU ali MK naziv; WooC Naziv. 


Variacije artiklov ( npr barve, velikosti, dolžina) 

 

Vkolikor v spletni trgovini prodajate artikle, ki imajo variacije, je potrebno vsakemu artiklu določiti SKU kodo, ki je enaka šifri artikla v MetaKocki. Primer je prikazan na spodnjih slikah. V tem primeru se bo naročilo variacije artikla ustrezno preslikalo v MetaKocka artikel.



























Preslikava specifičnih polj države

V določenih državah so pomembne dodatne oznake v naslovih (predvsem province), zato so spodaj vpisane pravila, kako mora biti naslov zapisan v WC, da se pravilno preslika v MK naslove. 


Država
Oznaka v naslovu
Pričakovan podatek v JSON
Romunija
Judet
{billing / shipping}.state

Localitate
{billing / shipping}.city
Italija
Province code
{billing / shipping}.state


Preslikava davčne številke podjetja

Vkolikor v spletni trgovini omogočate izdajo računov tudi podjetjem in posledično imate polje za vnos davčne številke, lahko iz spletne trgovine te podatke prenesete v MK preko JSON "meta_data" podatkov. Veljajo naslednja pravila :

  • buyer_tax_id / receiver_tax_id - davčna številak za kupca oz. prejemnika. Če je podana vrednost, potem partner avtomatično v MK postane "podjetje" in "davčni zavezanec"
  • buyer_tax_payer / receiver_tax_payer - če vsebuje vrednost "false", potem se v MK podjetje označi kot da ni davčni zavezanec. Kot pravi zgodnja točka - če vrednost ni podana, potem se podjetje avtomatično označi kot davčni zavezanec. 


[{
     "id": 24777,
     "parent_id": 0,
     "status": "completed",
     "order_key": "wc_order_5b1e09c34a158",
     "number": "25386",
     ...........
     "billing": {
          ...........
          "first_name": "Gabriela",
          "last_name": "Birz",
          "country": "RO",
      },
      "shipping": {
          .............
          "first_name": "Gabriela",
          "last_name": "Birz",
     },
    .............
    "meta_data": [{
        "key": "buyer_tax_id",
        "value": "SI100200300"
    }, {
        "key": "buyer_tax_payer",
        "value": "true"
    }, {
        "key": "receiver_tax_id",
        "value": "SI100200300"
    }, {
        "key": "receiver_tax_payer",
        "value": "false"
    }
    ]}
}]


V primeru težave/ izpisa napak pri testu povezave - testiranje povezave Woocoomerce trgovine in MetaKocke


Ker je vsaka postavitev WC svoja ločena postavitev, lahko pride do težav pri komunikaciji med MetaKocka in WC. V primeru težave je dobro na začetku stestirati, ali je vmesnik na WC pravilno nastavljen. Priporočamo uporabo programa Postman.


Pregled naročil


Najprej gradimo ustrezni URL naslov za seznam naročil, ki ima obliko [osnovni URL spletne trgovine] + /wp-json/wc/v1/orders?per_page=1&amp;order=desc. Primer : https://mystore.com/wp-json/wc/v1/orders?per_page=1&order=desc


V kolikor spletna trgovina podpora HTTPS, uporabimo Basic authentication. Drugače pa OAuth. Spodnje slike prikazujejo oba primera. Na koncu mora kot rezultat priti JSON s naročili.


Uporabne povezave :




Posodobitev zaloge artikla


Tip : POST

Primer klica : http://[moja trgovina]/wp-json/wc/v1/products/batch

Vsebina (3982 mora biti id artikla v spletni trgovini) :


{
  "update" : [
    {
      "id" : 3982,
      "stock_quantity" : 15000
    }
  ]
}


Odgovor je izpis podatkov o artiklu, ki vsebuje "stock_quantity" : 15000


Pregled artikla in njegove zaloge


Tip : POST

Primer klica : http://[moja trgovina]/wp-json/wc/v1/products/3982

Vsebina : brez


Odgovor je izpis podatkov o artiklu, ki vsebuje "stock_quantity" s ustrezno vrednostjo.


Privzeti statusi plačilnih inštrumentov

Ko v WC pride naročilo, se glede na različne plačilne inštrumente nastavi naslednji status :


Oznaka
Plačilni inštrument
Začetni status
paypal
PayPal
Pending - naročilo izvedeno, vendar še ni plačano.
Processing - plačilo je bilo izvedeno
bacs
Direct bank transfer
On hold
cheque
Check payments
On hold
cod
Cash on delivery
Processing


Nastavitev predpone za naročila

V primeru, da imate več spletnih trgovin, si lahko način nastavitve predpone pred posamezno naročilo ogledate v članku https://www.tychesoftwares.com/how-to-add-prefix-or-suffix-to-woocommerce-order-number/

V JSON zgradbi naročila obstajata dva polja za oznako naročila :

  • "Id" - številka, ki jo interno uporabimo za ugotavljanje podvojenih naročil oz. spreminjanje podatkov naročila v WC trgovini
  • "number" - oznaka, ki se prikazuje na vseh mestih v MetaKocka oz. Order Management.

"Id" se nikoli ne spreminja, saj se samo povečuje. Na drugi strani pa "number" lahko poljubno spremenite (npr. iz "1001" v "SLO-1001") in ne bo prišlo do podvajanja naročil. Edina omejitev je, da to velja za spletne trgovine, ki so bile v MK dodane od 1.1.2018 naprej. V kolikor je bila trgovina dodana že pred tem, je potrebno povprašati na MK podpori, da preverijo stanje preko parametra "useInternalIdForOrderId". 



Podpora za Up-sell

V kolikor ob nakupu stranki omogočate izvedbo upsell artikla, je potrebno zagotoviti naslednje :

  • up-sell mora biti časovno omejen - recimo 12 ur. Vmes le tega naročila ne smete odpremiti, ker mora počakati na možnost upsell. 
  • naročilo ne sme dobiti statusa "processing", ker bo potem odšel v odpremo. Mora imeti nek vmesni status (npr. "waiting-upsell") in potrebno je na strani WC zagotoviti (razviti funkcionalnost), da bo spremenila status naročila v "processing" po določenem času. 
  • nujno se mora v primeru spremembe statusa izvesti tudi update preko webhook. 


Določanje Lot številke 

V primeru, da za artikel vodite lot številke v MetaKocki (npr. prodaja živil) in da spletna trgovine ne vsebuje podpore za vnos lot številk, bo MetaKocka avtomatično določila Lot številko ob prenosu naročila. Postopek je naslednji :

  • Lot številka se samodejno določijo samo v primeru prenosa na račun,
  • artikel mora biti označen, da se na njem vodijo Lot številke,
  • računu se samodejno določi skladišče glede na nastavitve podjetja,
  • za artikel z lot številko se na skladišču računa preveri, ali obstaja zaloga. Če obstaja, se izbere lot številka z največjo količino na skladišču.

Če se artiklu ne določi lot številka, se bo ob prenosu naročil izpisala napaka in naročilo se ne bo preneslo. Primer napake : 3952 - Janez Novak : Artikel 56 - m2 - Divji kostanj mazilo 100 ml mora imeti določen Lot


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