Vodnik po Mokapenu

WooCommerce

Povežite svojo trgovino WooCommerce (WordPress) z Mokapenom, da v CRM prenesete stranke (stike), izdelke (z variacijami in zalogo) in naročila trgovine ter da v WooCommerce izvozite izdelke, ustvarjene ali posodobljene v Mokapenu, kadar to smer sinhronizacije dopušča. Enak cilj kot pri Shopify: združiti e-trgovino in prodajno upravljanje v istem delovnem okolju.

Splošen pregled: Integracije. Uvožena naročila postanejo v Mokapenu prodajna naročila (modul Naročila), ne priložnosti v prodajnem lijaku.

Zahteve

• Spletno mesto WordPress z aktivnim WooCommerce in dostopnim prek HTTPS.
• Dovoljenje za avtorizacijo Mokapena prek poteka WC Auth (skrbnik WordPress / WooCommerce).
• Mokapen paket ustrezen Premium za integracije e-trgovine. Brez paketa gumb za povezavo odpre nadgradnjo.
• Mokapen dovoljenja za stike, izdelke in naročila v vaši organizaciji (glejte Vloge in dovoljenja).
• Dostop do Integracij (član/admin glede na white-label in vlogo v organizaciji).

Povezava trgovine WooCommerce

1. Uporabniški meni → Integracije → WooCommerce.
2. Vnesite spletni naslov trgovine (URL spletnega mesta, npr. https://vasadomena.com). Najdete ga v naslovni vrstici, ko ste v WordPress backendu / WooCommerce vitrini.
3. Zaženite avtorizacijo: preusmerjeni boste na WordPress/WooCommerce na stran WC Auth (/wc-auth/v1/authorize) s scope read_write.
4. Sprejmite generiranje API ključev za Mokapen (consumer key / secret se shranita šifrirano v Mokapen — ni ročnega obrazca «prilepi API ključ»).
5. Vrnite se v Mokapen: trgovina je povezana. Mokapen registrira webhook WooCommerce (/wp-json/wc/v3/webhooks) za prejemanje posodobitev v realnem času.

Če ne sprejmete avtorizacije, se nobeni podatki ne sinhronizirajo. URL mora biti veljaven in v HTTPS: sicer validacija ne uspe.

Kaj Mokapen zahteva od WooCommerce

Potek WC Auth Mokapenu omogoča dostop za branje/pisanje do REST API WooCommerce, potrebnih za stranke, izdelke (in variacije), naročila in webhook. Mokapen ne nadomešča WooCommerce/WordPress nadzorne plošče za teme, plačila ali vtičnike: podatke usklajuje proti CRM-ju (in za izdelke tudi iz CRM-ja).

Če prekličete ključe ali odstranite avtorizacijo v WordPressu, odklopite in znova povežite iz Mokapena.

Kaj se sinhronizira

Proti Mokapenu (uvoz / webhook)

• Stranke → Stiki — WooCommerce stranke v imenik (in podjetje, če podatki to dopuščajo). Posodobitve tudi prek webhookov.
• Izdelki in variacije → Izdelki — katalog z variacijami; WooCommerce zalogo (stock_quantity) se preslika na količino variacije Mokapen.
• Naročila → Naročila — WooCommerce naročila postanejo v Mokapenu prodajna naročila (s postavkami), ne posli v prodajnem lijaku. Webhook ob posodobitvah.
• Opustene košarice / poročila — morebitne marketinške omembe ali vnosi «Kmalu na voljo» v vmesniku ne pomenijo že aktivnega uvoza poročil o košaricah kot pri drugih potekih: ne štejte jih za popolno funkcijo, če so na strani še označena kot kmalu na voljo.

Proti WooCommerce (izvoz)

• Izdelki — s smerjo sinhronizacije «proti WooCommerce» ali «oboje» lahko Mokapen izvozi/posodobi izdelke v trgovini (množična sinhronizacija in sync-out ob shranjevanju izdelka, če je integracija aktivna).
• Stiki in naročila v izhodu — kot pri Shopify se avtomatski «sync out» izvoz danes v praksi nanaša predvsem na izdelke. Stranke prispejo predvsem iz WooCommerce v Mokapen (uvoz + webhook). Ne jemljite za samoumeven popoln dvosmerni izvoz stikov samo zato, ker to predlaga komercialno besedilo: preverite po povezavi.

V konfiguraciji se prikažejo tudi storitve, vendar ni namenske sinhronizacije storitev: za katalog trgovine uporabite Izdelke.

Nastavitve po povezavi

Na strani WooCommerce, s povezano trgovino:

Smer sinhronizacije

• Samo proti Mokapenu — WooCommerce → CRM.
• Oboje — uvoz + izvoz (kjer je podprto; danes predvsem izdelki v izhodu).
• Samo proti WooCommerce — Mokapen → trgovina (izdelki).

Entitete

Stiki, naročila in izdelki so področja sinhronizacije (pogosto vnaprej izbrani in nespremenljivi v vmesniku).

Skupna raba sinhronizacije

Kdor je povezal, lahko povezavo deli z celotno organizacijo ali izbranimi uporabniki.

Podvojitve in konflikti

• Izogibajte se podvojitvam — običajno prepoznavanje stikov po e-pošti.
• Ob konfliktu — zmaga WooCommerce ali Mokapen.

Zasebnost (WooCommerce)

V primerjavi s Shopify na strani WooCommerce najdete tudi kontrolnike zasebnosti in sodelavcev/deležnikov, povezane s tem, kako so sinhronizirani podatki vidni v organizaciji. Nastavite jih, če ekipa ne sme videti celotnega uvoženega kataloga/strank enako.

Samodejna vs ročna sinhronizacija

Aktivirajte samodejno sinhronizacijo za neprekinjene posodobitve (skupaj z webhooki); uporabite ročno sinhronizacijo za zgodovinsko obremenitev. Pred sinhronizacijo potrdite pooblastilo za podatke na strani.

Priporočen potek

1. Preverite HTTPS in posodobljen WooCommerce na spletnem mestu.
2. Povežite trgovino iz Integracij → WooCommerce in dokončajte WC Auth.
3. Nastavite smer sinhronizacije, podvojitve, konflikte, zasebnost (če je prisotna) in skupno rabo.
4. Pooblastite in zaženite prvo sinhronizacijo.
5. Preverite Stike, Izdelke (variacije/zalogo), Naročila v Mokapenu.
6. Pustite webhook aktivne za nove dogodke brez ponovnega zaganjanja vsega.

Odklop

Iz Integracij → WooCommerce → odklop. V modalnem oknu izberete, ali obdržati v Mokapenu že uvožene stike, naročila in izdelke. Po odklopu webhooki ne posodabljajo več; podatki v CRM ostanejo, če ste jih obdržali. Ključe/avtorizacije lahko prekličete tudi v WordPress nadzorni plošči.

Pogosti problemi

• Neveljaven URL / brez HTTPS — uporabite celoten naslov spletnega mesta s https://.
• Avtorizacija ni uspela — potreben je WordPress admin; preverite, da WooCommerce in REST permalinki delujejo (požarni zid/varnostni vtičniki lahko blokirajo WC Auth ali webhook).
• Onemogobljen gumb / nadgradnja — potreben je ustrezen Premium paket za e-trgovino.
• Naročila ne v Priložnostih — to je pravilno: gredo v Naročila (Prodaja → Naročila).
• Zaloga / količina — prihaja iz stock_quantity variacij; ni popoln WMS.
• Webhooki ne prihajajo — spletno mesto mora biti dostopno z interneta; lokalna okolja ali z basic auth pogosto ne prejmejo WooCommerce obvestil.

Pogosta vprašanja

V: Ali moram ročno generirati API ključe v WooCommerce?

O: Ne. Uporabite potek WC Auth s strani Integracije Mokapen: ključi se ustvarijo in shranijo ob vrnitvi iz avtorizacije.

V: Ali WooCommerce naročila postanejo priložnosti?

O: Ne. V Mokapenu postanejo prodajna naročila. Morebitna besedila o «priložnostih» niso natančna glede na trenutno obnašanje.

V: Ali lahko posodabljam WooCommerce izdelke iz Mokapena?

O: Da, s smerjo sinhronizacije, ki vključuje izvoz, in aktivno integracijo.

V: Kakšna je razlika s Shopify?

O: Enak podatkovni model (stiki, izdelki, naročila) in ista logika Premium e-trgovine. Razlikuje se povezava: Shopify uporablja OAuth v aplikaciji Shopify; WooCommerce uporablja WC Auth na URL-ju vašega WordPress spletnega mesta. Glejte tudi vodnik Shopify.

V: Ali je potreben HTTPS?

O: Da. Brez HTTPS povezava in webhooki niso zanesljivi (in validacija URL-ja lahko ne uspe).