Mokapen-guiden

Shopify

Forbind din Shopify-butik til Mokapen for at hente kunder (kontakter), produkter (med varianter og mængder) og butikkens ordrer ind i CRM’et, og for at eksportere produkter oprettet eller opdateret i Mokapen til Shopify, når synkroniseringsretningen tillader det. Det hjælper med at samle e-handel og salgsstyring: stamdata, katalog og købshistorik i samme arbejdsområde.

Generelt overblik: Integrationer. Importerede ordrer bliver salgsordrer i Mokapen (modulet Ordrer), ikke pipeline-muligheder.

Krav

• Aktiv Shopify-butik (URL der slutter på .myshopify.com).
• Tilladelse til at godkende Mokapen-appen på Shopify (OAuth) med en butiksadmin-konto.
• En passende Premium-Mokapen-plan til e-handelsintegrationer. Uden plan åbner forbind-knappen opgraderingsskærmen; i nogle Shopify-flows kan der også tilbydes et tilbagevendende gebyr knyttet til appen.
• Mokapen-tilladelser til kontakter, produkter og ordrer i din organisation (se Roller og tilladelser).
• Adgang til Integrationer (medlem/admin afhængigt af white-label og org-rolle).

Forbind Shopify-butikken

1. Brugermenu → Integrationer → Shopify.
2. Indtast butiksnavnet (som i Shopify Admin; den fulde URL slutter med myshopify.com). Er du i tvivl, åbn Shopify-dashboardet og tjek browserens adresselinje.
3. Start godkendelse: du omdirigeres til Shopify for at acceptere tilladelser.
4. Acceptér de anmodede scopes (læs/skriv kunder og produkter, læs ordrer — se nedenfor).
5. Vend tilbage til Mokapen: butikken vises som forbundet. Kommer du fra Shopify App Store, skal du måske vælge Mokapen-organisationen, som forbindelsen skal installeres på.

Hvis du ikke accepterer på Shopify, synkroniseres ingen data. Efter forbindelse registrerer Mokapen webhooks i butikken: opdateringer af kunder, produkter og ordrer kan dermed ankomme i realtid, ud over den masse-synkronisering, du selv starter.

Hvad Mokapen anmoder om fra Shopify

Under OAuth-godkendelse anmoder Mokapen typisk om:

• read_customers / write_customers — læs (og potentielt skriv) Shopify-kunder.
• read_products / write_products — læs og opdater produkter/varianter.
• read_orders — læs butiksordrer.

Mokapen erstatter ikke Shopify-panelet til checkout, temaer eller betalinger: det afstemmer data mod (og for produkter, fra) CRM’et. Hvis du tilbagekalder appen fra Shopify, eller token udløber, skal du afbryde og forbinde igen fra Mokapen. Shopify kræver også GDPR-endpoints (data request / redact): Mokapen håndterer disse via webhook.

Hvad synkroniseres

Mod Mokapen (import / webhook)

• Kunder → Kontakter — Shopify-stamdata kommer i adressebogen; hvis virksomhedsdata findes, kan virksomheden også oprettes/knyttes. Webhooks ved oprettelse/opdatering/sletning af kunde.
• Produkter og varianter → Produkter — katalog med varianter; Shopify-variantlager mappes til Mokapen-variantmængdefeltet (ikke et separat lagermodul).
• Ordrer → Ordrer — Shopify-ordrer bliver salgsordrer i Mokapen (med linjer), ikke pipeline-deals. Webhooks ved ordreopdateringer.
• Forladte checkouts — synk kan inkludere en sti til import af forladte Shopify-checkouts (som ordrer/relaterede data). Dedikerede rapporter for forladte kurve / e-handelsanalyse på siden vises stadig som Kommer snart: tæl dem endnu ikke som en aktiv funktion.

Mod Shopify (eksport)

• Produkter — med synkroniseringsretning «mod Shopify» eller «begge» kan Mokapen eksportere/opdatere produkter i butikken (masse-synk og sync-out, når du gemmer et tilknyttet produkt, hvis integrationen er aktiv).
• Udgående kontakter og ordrer — på trods af write_customers-scopes gælder den automatiske «sync out»-eksport i praksis i dag for produkter. Antag ikke fuld tovejs eksport af kontakter eller ordrer: kunder kommer hovedsageligt fra Shopify til Mokapen (import + webhook). Hvis marketingtekst nævner «tovejs kun kontakter», verificér i dit miljø, hvad synk faktisk gør efter forbindelse.

I konfigurationen listes integrationen også services, men der er ingen dedikeret e-handels-service-synk som for produkter: brug Produkter til butikkens katalog.

Indstillinger efter forbindelse

På Shopify-siden, med butikken forbundet, konfigurerer du typisk:

Synkroniseringsretning

• Kun mod Mokapen — data flyder fra Shopify ind i CRM’et.
• Begge — import + eksport (hvor understøttet; i dag hovedsageligt udgående produkter).
• Kun mod Shopify — push fra Mokapen til butikken (produkter).

Entiteter

Kontakter, ordrer og produkter vises som synkroniseringsomfang (ofte allerede valgt og ikke redigerbart fra UI’et). Historisk synk og webhooks dækker disse tre blokke.

Del synkronisering

Den der forbandt butikken, kan lade andre medlemmer bruge samme forbindelse (hele organisationen eller udvalgte brugere), så ikke alle skal gentage OAuth.

Dubletter og konflikter

• Undgå dubletter — typisk mulighed: kontakter genkendt via e-mail for at undgå dubletter i adressebogen.
• Ved konflikt — vælg om Shopify eller Mokapen vinder, når samme post er ændret på begge sider.

Automatisk vs. manuel synkronisering

Med automatisk synk aktiv holder opdateringer (og webhooks) data afstemt; du kan stadig starte en manuel synkronisering til det første historiske indlæs. Før synk: tjek den datagodkendelse, der kræves på siden.

Anbefalet flow

1. Forbind butikken og verificér Forbundet konto.
2. Sæt synkroniseringsretning (for de fleste: Kun mod Mokapen eller Begge, hvis du vil opdatere Shopify-produkter fra Mokapen).
3. Konfigurer dubletter/konflikter og deling.
4. Godkend og start den første synkronisering (kan tage tid ved store kataloger).
5. Tjek i Mokapen: Kontakter, Produkter (varianter/mængde), Ordrer.
6. Hold webhooks aktive: nye ordrer og opdateringer af kunde/produkt ankommer uden at genstarte alt hver gang.

Afbryd forbindelse

Fra Integrationer → Shopify → afbryd. I modalvinduet kan du vælge, om du vil beholde kontakter, ordrer og produkter allerede importeret i Mokapen, eller håndtere dem efter de tilbudte muligheder. Efter afbrydelse stopper webhooks med at opdatere; data i CRM’et forbliver, hvis du valgte at beholde dem. Du kan også tilbagekalde appen fra Shopify-panelet.

Almindelige problemer

• Ugyldigt butiksnavn — brug *.myshopify.com-subdomænet, ikke kun det tilpassede butiksdomæne.
• Knap blokeret / opgradering — en passende Premium-plan til e-handel er påkrævet.
• Ordrer ikke i Muligheder — det er korrekt: de går i Ordrer. Åbn Salg → Ordrer.
• Produktmængde — kommer fra Shopify-variantmængde; ikke et fuldt WMS.
• Kurvrapporter / analyse — hvis de viser «Kommer snart» på siden, er de endnu ikke i drift.
• Udløbet token / synk stoppet — afbryd og forbind igen; verificér at appen ikke blev afinstalleret fra Shopify.

Ofte stillede spørgsmål

Sp: Hvor finder jeg butikkens URL?

Sv: I Shopify Admin-dashboardets adresselinje: den slutter med myshopify.com.

Sp: Bliver Shopify-ordrer til muligheder?

Sv: Nej. I Mokapen bliver de salgsordrer (med linjer). Tekst, der henviser til «muligheder», er unøjagtig i forhold til nuværende adfærd.

Sp: Kan jeg opdatere Shopify-produkter fra Mokapen?

Sv: Ja, med en synkroniseringsretning, der inkluderer eksport, og integrationen aktiv: produkter (varianter) kan sendes/opdateres i butikken.

Sp: Opdateres kontakter også fra Mokapen til Shopify?

Sv: Import og webhooks bringer Shopify-kunder ind i CRM’et. Automatisk kontakteksportering er ikke hovedstien i dag (modsat produkter): verificér på din plan/miljø efter forbindelse.

Sp: Skal jeg have WooCommerce ved siden af Shopify?

Sv: Nej: de er to alternative e-handelsintegrationer. Brug Shopify, hvis din butik er på Shopify; se WooCommerce-guiden, hvis du bruger WordPress/Woo.