Mokapenin opas

Shopify

Yhdistä Shopify-myymäläsi Mokapeniin tuodaksesi asiakkaat (yhteystiedot), tuotteet (variantteineen ja määrineen) ja myymälän tilaukset CRM:ään sekä viemään Mokapenissa luodut tai päivitetyt tuotteet Shopifyhin, kun synkronoinnin suunta sen sallii. Se auttaa yhdistämään verkkokaupan ja myynnin hallinnan: perustiedot, luettelo ja ostohistoria samassa työtilassa.

Yleiskatsaus: Integraatiot. Tuodut tilaukset muuttuvat Mokapenissa myyntitilauksiksi (Tilaukset-moduuli), eivät putken mahdollisuuksiksi.

Vaatimukset

• Aktiivinen Shopify-myymälä (URL päättyy .myshopify.com).
• Oikeus valtuuttaa Mokapen-sovellus Shopifyssa (OAuth) myymälän ylläpitäjätilillä.
• Sopiva Premium -Mokapen-tilaus verkkokauppaintegraatioille. Ilman tilausta yhdistä-painike avaa päivitysnäkymän; joissakin Shopify-virroissa sovellukseen liittyvä toistuva maksu voi myös tarjota.
• Mokapen-oikeudet yhteystietoihin, tuotteisiin ja tilauksiin organisaatiossasi (katso Roolit ja käyttöoikeudet).
• Pääsy Integraatiot-osioon (jäsen/ylläpitäjä riippuen white label -asetuksista ja organisaation roolista).

Shopify-myymälän yhdistäminen

1. Käyttäjävalikko → Integraatiot → Shopify.
2. Syötä myymälän nimi (kuten Shopify Adminissa; täydellinen URL päättyy myshopify.com). Jos et ole varma, avaa Shopify-hallintapaneeli ja tarkista selaimen osoitepalkki.
3. Käynnistä valtuutus: sinut ohjataan Shopifyhin hyväksymään oikeudet.
4. Hyväksy pyydetyt laajuudet (asiakkaiden ja tuotteiden luku/kirjoitus, tilausten luku — katso alla).
5. Palaa Mokapeniin: myymälä näkyy yhdistettynä. Jos saavut Shopify App Storesta, sinun on ehkä valittava Mokapen-organisaatio, johon yhteys asennetaan.

Jos et hyväksy Shopifyssa, tietoja ei synkronoida. Yhdistämisen jälkeen Mokapen rekisteröi webhookit myymälään: asiakkaiden, tuotteiden ja tilausten päivitykset voivat saapua reaaliajassa bulkkisynkronoinnin lisäksi.

Mitä Mokapen pyytää Shopifylta

OAuth-valtuutuksen aikana Mokapen pyytää tyypillisesti:

• read_customers / write_customers — Shopify-asiakkaiden lukeminen (ja mahdollinen kirjoitus).
• read_products / write_products — tuotteiden/varianttien lukeminen ja päivittäminen.
• read_orders — myymälän tilausten lukeminen.

Mokapen ei korvaa Shopify-paneelia kassalle, teemoille tai maksuille: se linjaa tiedot kohti (ja tuotteiden osalta myös Mokapenista) CRM:ää. Jos peruutat sovelluksen Shopifyssa tai token vanhenee, katkaise yhteys ja yhdistä uudelleen Mokapenista. Shopify vaatii myös GDPR-päätepisteet (data request / redact): Mokapen käsittelee ne webhookin kautta.

Mitä synkronoidaan

Kohti Mokapenia (tuonti / webhook)

• Asiakkaat → Yhteystiedot — Shopify-perustiedot tulevat osoitekirjaan; jos yritystietoja on, yritys voidaan myös luoda/linkittää. Webhookit asiakkaan luonnista/päivityksestä/poistosta.
• Tuotteet ja variantit → Tuotteet — luettelo varianteineen; Shopify-variantin varastomäärä kartoitetaan Mokapenin varianttimääräkenttään (ei erillistä varastomoduulia).
• Tilaukset → Tilaukset — Shopify-tilaukset muuttuvat Mokapenissa myyntitilauksiksi (rivillä), eivät putken diileiksi. Webhookit tilausten päivityksistä.
• Keskeytyneet kassat — synkronointi voi sisältää polun keskeytyneiden Shopify-kassojen tuontiin (tilauksina/liittyvinä tietoina). Omat raportit hylätyistä ostoskorista / verkkokaupan analytiikasta sivulla näkyvät vielä Coming soon -tekstillä: älä laske niitä vielä aktiivisiksi ominaisuuksiksi.

Kohti Shopifya (vienti)

• Tuotteet — synkronoinnin suunnalla «kohti Shopifya» tai «molemmat» Mokapen voi viedä/päivittää tuotteita myymälään (bulkkisynkronointi ja sync-out, kun tallennat linkitetyn tuotteen, jos integraatio on aktiivinen).
• Ulospäin menevät yhteystiedot ja tilaukset — huolimatta write_customers -laajuuksista, automaattinen «sync out» -vienti toteutettuna tänään koskee käytännössä tuotteita. Älä oleta yhteystietojen tai tilausten täyttä kaksisuuntaista vientiä: asiakkaat saapuvat pääasiassa Shopifysta Mokapeniin (tuonti + webhook). Jos markkinointiteksti mainitsee «kaksisuuntaiset yhteystiedot vain», varmista yhdistämisen jälkeen ympäristössäsi, mitä synkronointi oikeasti tekee.

Konfiguraatiossa integraatio listaa myös palvelut, mutta erillistä verkkokaupan palvelusynkronointia kuten tuotteille ei ole: käytä Tuotteet-myymäläluetteloon.

Asetukset yhdistämisen jälkeen

Shopify-sivulla, myymälän ollessa yhdistettynä, määrität tyypillisesti:

Synkronoinnin suunta

• Vain kohti Mokapenia — tiedot kulkevat Shopifysta CRM:ään.
• Molemmat — tuonti + vienti (missä tuettu; tänään pääasiassa ulospäin menevät tuotteet).
• Vain kohti Shopifya — työntö Mokapenista myymälään (tuotteet).

Entiteetit

Yhteystiedot, tilaukset ja tuotteet näkyvät synkronointilaajuutena (usein jo valittuna eikä muokattavissa käyttöliittymästä). Historiasynkronointi ja webhookit kattavat nämä kolme lohkoa.

Synkronoinnin jakaminen

Myymälän yhdistänyt henkilö voi antaa muiden jäsenten käyttää samaa yhteyttä (koko organisaatio tai valitut käyttäjät), joten kaikkien ei tarvitse toistaa OAuthia.

Kaksoiskappaleet ja ristiriidat

• Vältä kaksoiskappaleita — tyypillinen vaihtoehto: yhteystiedot tunnistetaan sähköpostilla osoitekirjan kaksoiskappaleiden välttämiseksi.
• Ristiriitatilanteessa — valitse, voittaako Shopify vai Mokapen, kun sama tietue on muokattu molemmilla puolilla.

Automaattinen vs. manuaalinen synkronointi

Automaattisen synkronoinnin ollessa päällä päivitykset (ja webhookit) pitävät tiedot linjassa; voit silti käynnistää manuaalisen synkronoinnin ensimmäiseen historialataukseen. Ennen synkronointia tarkista sivulla vaadittu tietojenkäsittely-/jakamisvaltuutus.

Suositeltu kulku

1. Yhdistä myymälä ja varmista Yhdistetty tili.
2. Aseta synkronoinnin suunta (useimmissa tapauksissa: Vain kohti Mokapenia tai Molemmat, jos haluat päivittää Shopify-tuotteita Mokapenista).
3. Määritä kaksoiskappaleet/ristiriidat ja jakaminen.
4. Valtuuta ja käynnistä ensimmäinen synkronointi (isoissa luetteloissa voi kestää).
5. Tarkista Mokapenissa: Yhteystiedot, Tuotteet (variantit/määrät), Tilaukset.
6. Pidä webhookit aktiivisina: uudet tilaukset ja asiakas-/tuotepäivitykset saapuvat ilman, että käynnistät kaiken uudelleen joka kerta.

Yhteyden katkaisu

Integraatiot → Shopify → katkaise yhteys. Modaalissa voit valita, säilytetäänkö Mokapeniin jo tuodut yhteystiedot, tilaukset ja tuotteet, tai käsitelläänkö ne tarjottujen vaihtoehtojen mukaan. Katkaisun jälkeen webhookit eivät enää päivitä; CRM:ään jäänyt data pysyy, jos valitsit säilytyksen. Voit myös peruuttaa sovelluksen Shopify-paneelista.

Yleisiä ongelmia

• Virheellinen myymälän nimi — käytä *.myshopify.com -aliverkkotunnusta, ei pelkkää mukautettua vitriinidomainia.
• Painike estetty / päivitys — verkkokauppaan sopiva Premium-tilaus vaaditaan.
• Tilaukset eivät ole Mahdollisuuksissa — se on oikein: ne menevät Tilaukset-moduuliin. Avaa Myynti → Tilaukset.
• Tuotemäärä — tulee Shopify-variantin määrästä; ei täyttä WMS:ää.
• Ostoskoriraportit / analytiikka — jos sivulla lukee «Coming soon», ne eivät ole vielä käytössä.
• Token vanhentunut / synkronointi pysähtynyt — katkaise yhteys ja yhdistä uudelleen; varmista, ettei sovellusta poistettu Shopifysta.

Usein kysytyt kysymykset

K: Mistä löydän myymälän URL:n?

V: Shopify Admin -hallintapaneelin osoitepalkista: se päättyy myshopify.com.

K: Muuttuvatko Shopify-tilaukset mahdollisuuksiksi?

V: Ei. Mokapenissa ne muuttuvat myyntitilauksiksi (rivillä). Teksti, joka viittaa «mahdollisuuksiin», ei vastaa nykyistä toimintaa.

K: Voinko päivittää Shopify-tuotteita Mokapenista?

V: Kyllä, synkronoinnin suunnalla, joka sisältää viennin, ja integraation ollessa aktiivinen: tuotteet (variantit) voidaan lähettää/päivittää myymälään.

K: Päivittyvätkö yhteystiedot myös Mokapenista Shopifyhin?

V: Tuonti ja webhookit tuovat Shopify-asiakkaat CRM:ään. Automaattinen yhteystietojen vienti ei ole tänään pääpolku (toisin kuin tuotteilla): varmista tilauksessasi/ympäristössäsi yhdistämisen jälkeen.

K: Tarvitsenko WooCommercen Shopifyn rinnalle?

V: Ei: ne ovat kaksi vaihtoehtoista verkkokauppaintegraatiota. Käytä Shopifya, jos myymäläsi on Shopifyssa; katso WooCommerce-opas, jos käytät WordPress/Wooa.