Mokapen-guiden

WooCommerce

Forbind din WooCommerce-butik (WordPress) til Mokapen for at hente kunder (kontakter), produkter (med variationer og lager) og butikkens ordrer ind i CRM’et, og for at eksportere produkter oprettet eller opdateret i Mokapen til WooCommerce, når synkroniseringsretningen tillader det. Samme mål som Shopify: samle e-handel og salgsstyring i samme arbejdsområde.

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

Krav

• WordPress-site med aktiv WooCommerce, tilgængelig via HTTPS.
• Tilladelse til at godkende Mokapen via WC Auth-flowet (WordPress / WooCommerce-administrator).
• En passende Premium-Mokapen-plan til e-handelsintegrationer. Uden plan åbner forbind-knappen opgraderingsskærmen.
• 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 WooCommerce-butikken

1. Brugermenu → Integrationer → WooCommerce.
2. Indtast butikkens webadresse (site-URL, f.eks. https://yourdomain.com). Du finder den i adresselinjen, når du er i WordPress-backend / WooCommerce-butikken.
3. Start godkendelse: du omdirigeres til WordPress/WooCommerce til WC Auth-siden (/wc-auth/v1/authorize) med read_write-scope.
4. Acceptér generering af API-nøgler til Mokapen (consumer key / secret gemmes krypteret i Mokapen — der er ikke et manuelt «indsæt API-nøgle»-skema).
5. Vend tilbage til Mokapen: butikken er forbundet. Mokapen registrerer WooCommerce webhooks (/wp-json/wc/v3/webhooks) for at modtage opdateringer i realtid.

Hvis du ikke accepterer godkendelsen, synkroniseres ingen data. URL’en skal være gyldig og HTTPS: ellers fejler valideringen.

Hvad Mokapen anmoder om fra WooCommerce

WC Auth-flowet giver Mokapen læse/skrive-adgang til de WooCommerce REST API’er, der skal bruges til kunder, produkter (og variationer), ordrer og webhooks. Mokapen erstatter ikke WooCommerce/WordPress-panelet til temaer, betalinger eller plugins: det afstemmer data mod (og for produkter, fra) CRM’et.

Hvis du tilbagekalder nøgler eller fjerner godkendelse på WordPress-siden, skal du afbryde og forbinde igen fra Mokapen.

Hvad synkroniseres

Mod Mokapen (import / webhook)

• Kunder → Kontakter — WooCommerce-kunder i adressebogen (og virksomhed, hvis data tillader det). Opdateringer også via webhook.
• Produkter og variationer → Produkter — katalog med variationer; WooCommerce lager (stock_quantity) mappes til Mokapen-variantmængde.
• Ordrer → Ordrer — WooCommerce-ordrer bliver salgsordrer i Mokapen (med linjer), ikke pipeline-deals. Webhooks ved opdateringer.
• Forladte kurve / rapporter — marketingomtaler eller «Kommer snart»-poster i UI’et svarer ikke til en aktiv import af kurvrapportering som andre flows: tæl dem ikke som en komplet funktion, hvis de stadig vises som kommer snart på siden.

Mod WooCommerce (eksport)

• Produkter — med synkroniseringsretning «mod WooCommerce» eller «begge» kan Mokapen eksportere/opdatere produkter i butikken (masse-synk og sync-out ved gem af produkt, hvis integrationen er aktiv).
• Udgående kontakter og ordrer — som med Shopify gælder den automatiske «sync out»-eksport i praksis i dag for produkter. Kunder kommer hovedsageligt fra WooCommerce til Mokapen (import + webhook). Antag ikke fuld tovejs kontakteksportering, bare fordi kommerciel tekst antyder det: verificér efter forbindelse.

Konfigurationen viser også services, men der er ingen dedikeret service-synk: brug Produkter til butikkens katalog.

Indstillinger efter forbindelse

På WooCommerce-siden, med butikken forbundet:

Synkroniseringsretning

• Kun mod Mokapen — WooCommerce → CRM.
• Begge — import + eksport (hvor understøttet; i dag hovedsageligt udgående produkter).
• Kun mod WooCommerce — Mokapen → butik (produkter).

Entiteter

Kontakter, ordrer og produkter er synkroniseringsomfanget (ofte forvalgt og ikke redigerbart fra UI’et).

Del synkronisering

Den der forbandt, kan dele forbindelsen med hele organisationen eller udvalgte brugere.

Dubletter og konflikter

• Undgå dubletter — typisk kontaktgenkendelse via e-mail.
• Ved konflikt — WooCommerce eller Mokapen vinder.

Privatliv (WooCommerce)

I modsætning til Shopify kan du på WooCommerce-siden også finde privatliv og kontroller for samarbejdspartnere/stakeholders relateret til, hvordan synkroniserede data er synlige i org’en. Sæt dem, hvis teamet ikke skal se hele det importerede katalog/kunder på samme måde.

Automatisk vs. manuel synkronisering

Aktivér automatisk synkronisering for løbende opdateringer (sammen med webhooks); brug manuel synkronisering til historisk indlæsning. Tjek datagodkendelsen på siden før synkronisering.

Anbefalet flow

1. Verificér HTTPS og opdateret WooCommerce på sitet.
2. Forbind butikken fra Integrationer → WooCommerce og fuldfør WC Auth.
3. Sæt synkroniseringsretning, dubletter, konflikter, privatliv (hvis relevant) og deling.
4. Godkend og start den første synkronisering.
5. Tjek Kontakter, Produkter (variationer/lager), Ordrer i Mokapen.
6. Hold webhooks aktive for nye hændelser uden at genstarte alt hver gang.

Afbryd forbindelse

Fra Integrationer → WooCommerce → afbryd. I modalvinduet vælg, om du vil beholde kontakter, ordrer og produkter allerede importeret i Mokapen. Efter afbrydelse opdaterer webhooks ikke længere; data i CRM’et forbliver, hvis du beholdt dem. Du kan også tilbagekalde nøgler/godkendelser fra WordPress-panelet.

Almindelige problemer

• Ugyldig URL / ikke HTTPS — brug den fulde siteadresse med https://.
• Godkendelse mislykkedes — en WordPress-admin er påkrævet; verificér at WooCommerce og REST-permalinks virker (firewall/sikkerhedsplugins kan blokere WC Auth eller webhooks).
• 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 (Salg → Ordrer).
• Lager / mængde — kommer fra variation stock_quantity; ikke et fuldt WMS.
• Webhooks ankommer ikke — sitet skal være tilgængeligt fra internettet; lokale miljøer eller basic-auth modtager ofte ikke WooCommerce-notifikationer.

Ofte stillede spørgsmål

Sp: Skal jeg generere API-nøgler manuelt i WooCommerce?

Sv: Nej. Brug WC Auth-flowet fra Mokapen Integrationer-siden: nøgler oprettes og gemmes, når du vender tilbage fra godkendelse.

Sp: Bliver WooCommerce-ordrer til muligheder?

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

Sp: Kan jeg opdatere WooCommerce-produkter fra Mokapen?

Sv: Ja, med en synkroniseringsretning, der inkluderer eksport, og integrationen aktiv.

Sp: Forskel fra Shopify?

Sv: Samme datamodel (kontakter, produkter, ordrer) og samme e-handels-Premium-logik. Forbindelsen er forskellig: Shopify bruger OAuth på Shopify-appen; WooCommerce bruger WC Auth på din WordPress-site-URL. Se også Shopify-guiden.

Sp: Er HTTPS påkrævet?

Sv: Ja. Uden HTTPS er forbindelse og webhooks ikke pålidelige (og URL-validering kan fejle).