Mokapenguiden

Shopify

Anslut din Shopify butik till Mokapen att ta med kunder (kontakter), produkter (med varianter och mängder), och lagra order in i CRM, och för att exportera produkter skapade eller uppdaterade i Mokapen till Shopify när synkroniseringsriktningen tillåter. Det hjälper till att förena e-handel och försäljningshantering: masterdata, katalog och köphistorik i samma arbetsyta.

Allmän översikt: Integrationer. Importerade beställningar blir försäljningsorder i Mokapen (Ordermodul), inte pipelinemöjligheter.

Krav

• Aktiv Shopify butik (URL som slutar på .myshopify.com).
• Tillstånd att auktorisera Mokapen-appen på Shopify (OAuth) med ett butiksadministratörskonto.
• En lämplig Premium Mokapen plan för e-handelsintegrationer. Utan en plan öppnar anslut-knappen uppgraderingsskärmen; i vissa Shopify-flöden kan en återkommande avgift kopplad till appen också erbjudas.
• Mokapen-behörigheter för kontakter, produkter och beställningar i din organisation (se Roller och behörigheter).
• Tillgång till integrationer (medlem/admin beroende på white-label och organisationsroll).

Anslut Shopify-butiken

1. Användarmeny → Integrationer → Shopify.
2. Ange butikens namn (som i Shopify Admin; hela webbadressen slutar med myshopify.com). Om du är osäker, öppna Shopify-instrumentpanelen och kontrollera webbläsarens adressfält.
3. Starta auktorisering: du omdirigeras till Shopify för att acceptera behörigheter.
4. Acceptera de begärda omfattningarna (läs/skriv kunder och produkter, läs beställningar — se nedan).
5. Tillbaka till Mokapen: butiken dyker upp ansluten. Om du kommer från Shopify App Store kan du behöva göra det välj Mokapen-organisationen som anslutningen ska installeras på.

Om du inte accepterar på Shopify synkroniseras ingen data. Efter anslutning registrerar Mokapen webhooks i butiken: så att uppdateringar av kunder, produkter och beställningar kan komma i realtid, utöver den bulksynkronisering du själv lanserar.

Vad Mokapen begär från Shopify

Under OAuth-auktorisering begär Mokapen vanligtvis:

• läs_kunder / skriv_kunder — läs (och eventuellt skriv) Shopify-kunder.
• läs_produkter / skrivprodukter — läsa och uppdatera produkter/varianter.
• läs_order — läsa butiksbeställningar.

Mokapen ersätter inte Shopify-panelen för kassan, teman eller betalningar: den anpassar data mot (och, för produkter, från) CRM. Om du återkallar appen från Shopify eller om token går ut, koppla ur och återanslut från Mokapen. Shopify kräver även GDPR-slutpunkter (databegäran/redact): Mokapen hanterar dessa via webhook.

Det som synkroniseras

Mot Mokapen (import / webhook)

• Kunder → Kontakter — Shopify-masterdata kommer in i adressboken; om företagsdata finns kan företaget också skapas/länkas. Webhooks på kund skapa/uppdatera/ta bort.
• Produkter och varianter → Produkter — katalog med varianter; Shopify-variantens lagermängd mappas till Mokapen-variantens kvantitetsfält (inte en separat lagermodul).
• Beställningar → Beställningar — Shopify-ordrar blir försäljningsorder i Mokapen (med artiklar), inte pipelineaffärer. Webhooks på orderuppdateringar.
• Övergivna kassor — synkronisering kan inkludera en sökväg för att importera övergivna Shopify-utcheckningar (som beställningar/relaterad data). Hängiven rapporterar för övergivna vagnar / e-handelsanalyser på sidan visas fortfarande som Kommer snart: räkna dem inte som en aktiv funktion än.

Mot Shopify (export)

• Produkter — med synkriktning «mot Shopify» eller «båda» kan Mokapen exportera/uppdatera produkter i butiken (bulksynkronisering och utsynkronisering när du sparar en länkad produkt, om integrationen är aktiv).
• Utgående kontakter och beställningar — trots skriv_kunder omfattningar, gäller den automatiska «synka ut»-exporten som implementeras idag i praktiken produkter. Anta inte fullständig dubbelriktad export av kontakter eller beställningar: kunderna kommer huvudsakligen från Shopify till Mokapen (import + webhook). Om marknadsföringstext nämner "endast dubbelriktade kontakter", verifiera i din miljö vad synkronisering faktiskt gör efter anslutning.

I config listar integrationen också tjänster, men det finns ingen dedikerad synkronisering av e-handelstjänster som för produkter: använd Produkter för butikskatalogen.

Inställningar efter anslutning

På Shopify-sidan, med butiken ansluten, konfigurerar du vanligtvis:

Synkroniseringsriktning

• Endast mot Mokapen — dataflöden från Shopify till CRM.
• Både — Import + export (där stöds; idag huvudsakligen utgående produkter).
• Endast mot Shopify — tryck från Mokapen till butiken (produkter).

Entiteter

Kontakter, beställningar och produkter visas som synkroniseringsomfång (ofta redan valda och inte redigerbara från användargränssnittet). Historisk synkronisering och webhooks täcker dessa tre block.

Dela synk

Den som anslutit butiken kan låta andra medlemmar använda samma anslutning (hela organisationen eller utvalda användare), så alla behöver inte upprepa OAuth.

Dubletter och konflikter

• Undvik dubbletter — typiskt alternativ: kontakter som känns igen via e-post, för att undvika dubbletter i adressboken.
• Vid konflikt — välj om Shopify eller Mokapen vinner när samma rekord ändrades på båda sidor.

Automatisk vs manuell synkronisering

Med automatisk synkronisering aktiv håller uppdateringar (och webhooks) data i linje; du kan fortfarande starta en manual synkronisering för den initiala historiska belastningen. Innan du synkroniserar, kontrollera databehandlingen/delningen tillstånd krävs på sidan.

Rekommenderat flöde

1. Anslut butiken och verifiera det anslutna kontot.
2. Ställ in synkroniseringsriktning (för de flesta fall: Endast mot Mokapen eller Både om du vill uppdatera Shopify-produkter från Mokapen).
3. Konfigurera dubbletter/konflikter och delning.
4. Auktorisera och starta första synkroniseringen (kan ta tid på stora kataloger).
5. Checka in Mokapen: Kontakter, Produkter (varianter/antal), Order.
6. Håll webhooks aktiva: nya beställningar och kund-/produktuppdateringar kommer utan att återstarta allt varje gång.

Koppla från

Från integrationer → Shopify → koppla från. I modalen kan du välja om du vill hålla kontakter, beställningar och produkter som redan importerats i Mokapen, eller hantera dem enligt de alternativ som erbjuds. Efter frånkoppling slutar webhooks att uppdateras; data som redan finns i CRM finns kvar om du väljer att behålla den. Du kan också återkalla appen från Shopify-panelen.

Vanliga frågor

• Ogiltigt butiksnamn — använd *.myshopify.com underdomän, inte bara den anpassade skyltfönsterdomänen.
• Knapp blockerad/uppgradera — En lämplig Premium-plan för e-handel krävs.
• Beställningar som inte finns i Opportunities — det stämmer: de går in Order. Öppna Försäljning → Order.
• Produktkvantitet — kommer från Shopify variant kvantitet; inte ett fullständigt WMS.
• Varukorgsrapporter/analyser — om de visar «Kommer snart» på sidan är de inte i drift ännu.
• Utgånget token/synkronisering stoppades — koppla ur och återanslut; verifiera att appen inte avinstallerades från Shopify.

Vanliga frågor

F: Var hittar jag butikens URL?

S: I Shopify Admin-instrumentpanelens adressfält: slutar det med myshopify.com.

F: Blir Shopify-beställningar möjligheter?

S: Nej. I Mokapen blir de försäljningsorder (med rader). Varje text som hänvisar till "möjligheter" är felaktig i förhållande till nuvarande beteende.

F: Kan jag uppdatera Shopify-produkter från Mokapen?

S: Ja, med en synkroniseringsriktning som inkluderar export och integrationen aktiv: produkter (varianter) kan skickas/uppdateras i butiken.

F: Uppdaterar kontakter också från Mokapen till Shopify?

S: Import och webhooks tar Shopify-kunder in i CRM. Automatisk kontaktexport är inte huvudvägen idag (till skillnad från produkter): verifiera din plan/miljö efter anslutning.

F: Behöver jag WooCommerce tillsammans med Shopify?

S: Nej: de är två alternativa e-handelsintegrationer. Använd Shopify om din butik finns på Shopify; se WooCommerce guide om du använder WordPress/Woo.