WooCommerce-integratie

Met de WooCommerce-integratie kunt u uw WooCommerce online winkel koppelen aan Gem Logic. Eenmaal verbonden kunt u producten vanuit Gem Logic naar uw WooCommerce winkel pushen en orders vanuit WooCommerce naar Gem Logic ophalen. Zo blijven uw productcatalogus en orderbeheer gesynchroniseerd over beide platformen.

Configuratie

API-sleutels genereren in WooCommerce

Voordat u WooCommerce met Gem Logic kunt verbinden, moet u API-sleutels genereren in uw WooCommerce winkel.

  1. Log in op uw WordPress beheerpaneel.

  2. Navigeer naar WooCommerce ‣ Instellingen ‣ Geavanceerd ‣ REST API.

  3. Klik op Sleutel toevoegen.

  4. Vul de gegevens in:

    • Description: voer een naam in om deze sleutel te identificeren (bijv. Gem Logic Integratie).

    • User: selecteer de WordPress-gebruiker die voor de API-verbinding zal worden gebruikt.

    • Permissions: selecteer Read/Write. Dit is vereist zodat Gem Logic zowel bestellingen kan lezen als producten in uw winkel kan aanmaken/bijwerken.

  5. Klik op Generate API key.

  6. Kopieer de Consumer key en Consumer secret. Deze worden slechts eenmaal getoond, dus zorg ervoor dat u ze op een veilige locatie opslaat.

Belangrijk

Het consumer secret wordt slechts eenmaal weergegeven. Als u het verliest, moet u de sleutel intrekken en een nieuwe genereren.

WooCommerce verbinden met Gem Logic

  1. Ga in Gem Logic naar Configuration ‣ Sales channels.

  2. Open het verkoopkanaal dat u met WooCommerce wilt verbinden, of maak een nieuw kanaal aan.

  3. Vink het selectievakje WooCommerce aan.

  4. Vul de volgende velden in:

    • URL: de volledige URL van uw WooCommerce-winkel (bijv. https://www.uwwinkel.com). Voeg geen afsluitende schuine streep toe.

    • WooCommerce Key: plak de Consumer key die u eerder hebt gegenereerd.

    • WooCommerce Secret: plak het Consumer secret dat u eerder hebt gegenereerd.

  5. Als u de Perfect WooCommerce Brands-plugin in uw WooCommerce-winkel gebruikt, vink dan het selectievakje WooCommerce brands plugin aan. Hierdoor kan Gem Logic productmerken synchroniseren met WooCommerce.

  6. Sla het verkoopkanaal op.

Tip

Zorg ervoor dat uw WooCommerce-winkel HTTPS gebruikt. De API-inloggegevens worden versleuteld en veilig opgeslagen in Gem Logic.

Producten toewijzen aan het verkoopkanaal

Om producten naar WooCommerce te pushen, moeten ze worden toegewezen aan het WooCommerce-verkoopkanaal.

  1. Ga naar Products.

  2. Open een product en ga naar de sectie sales channels.

  3. Voeg het WooCommerce-verkoopkanaal toe aan het product.

  4. Zorg ervoor dat het product een pricing rule heeft geconfigureerd voor dat verkoopkanaal, zodat het een prijs heeft wanneer het naar WooCommerce wordt gepusht.

Producten pushen

U kunt producten vanuit Gem Logic naar uw WooCommerce-winkel pushen. Dit maakt producten aan of werkt producten bij in WooCommerce op basis van de gegevens in Gem Logic.

Eén enkel product pushen

Om één enkel product te pushen, opent u het product in Gem Logic en gebruikt u de pushactie vanuit de sectie verkoopkanalen van het product. Het product wordt in WooCommerce aangemaakt als het nog niet bestaat, of bijgewerkt als het al een WooCommerce-ID heeft.

Alle producten pushen

Om alle producten die aan een WooCommerce-verkoopkanaal zijn toegewezen in één keer te pushen:

  1. Ga naar Configuration ‣ Sales channels.

  2. Open het WooCommerce-verkoopkanaal.

  3. Klik op Push alle producten naar WooCommerce.

Dit wordt uitgevoerd als een achtergrondtaak. U kunt de voortgang volgen op de pagina push geschiedenis.

Wat wordt gepusht

Wanneer een product naar WooCommerce wordt gepusht, worden de volgende gegevens gesynchroniseerd:

  • SKU (gebruikt om producten tussen de twee systemen te matchen)

  • Naam en beschrijving (gebaseerd op de taal van het verkoopkanaal)

  • Normale prijs en actieprijs (uit de prijsregel voor dat verkoopkanaal)

  • Afbeeldingen (alleen opnieuw geüpload als er wijzigingen zijn)

  • Categorieën en collecties (aangemaakt in WooCommerce als ze niet bestaan)

  • Attributen (aangemaakt als globale WooCommerce attributen)

  • Tags

  • Voorraadhoeveelheid

  • Merken (als de WooCommerce brands plugin is ingeschakeld)

  • Producttype: eenvoudig of variabel (met varianten)

Variabele producten en varianten

Als een product in Gem Logic is gemarkeerd als een bovenliggend product, wordt het gepusht als een variabel product in WooCommerce. Alle onderliggende producten (varianten) worden gepusht als productvariaties. Elke variant bevat zijn eigen prijs, SKU, afbeelding en attribuutwaarden (bijv. maat, kleur).

Productdeactivering

U kunt een product in WooCommerce deactiveren vanuit Gem Logic. Dit stelt de productstatus in op concept in WooCommerce, waardoor het onzichtbaar wordt op de webwinkel zonder het te verwijderen.

Push geschiedenis

Elke push-operatie wordt vastgelegd. U kunt de push geschiedenis bekijken vanaf de detailpagina van het verkoopkanaal. Elke geschiedenisrecord toont:

  • Start- en eindtijd

  • Status (gestart, voltooid, mislukt of gedeeltelijk geslaagd)

  • Totaal aantal producten, geslaagde en mislukte aantallen

  • Succespercentage en duur

  • Gedetailleerde resultaten per product (klik op Details bekijken om te zien welke producten zijn geslaagd of mislukt)

Producten ophalen

U kunt producten uit uw WooCommerce winkel naar Gem Logic ophalen. Dit is handig voor de eerste import wanneer u uw winkel voor het eerst verbindt.

  1. Ga naar Configuration ‣ Sales channels.

  2. Open het WooCommerce-verkoopkanaal.

  3. Klik op Producten ophalen van WooCommerce.

Dit wordt uitgevoerd als een achtergrondtaak en importeert de volgende gegevens voor elk product:

  • SKU, naam en beschrijving

  • Normale prijs en actieprijs

  • Categorieën en merken

  • Afbeeldingen (gedownload en opgeslagen in Gem Logic)

  • Tags

  • Voorraadhoeveelheden

  • Attributen en metalen

  • Productvarianten (voor variabele producten)

Notitie

Producten die al bestaan in Gem Logic (gekoppeld op WooCommerce ID of SKU) worden overgeslagen tijdens de import. Alleen nieuwe producten worden aangemaakt.

Bestellingen ophalen

U kunt voltooide bestellingen uit WooCommerce naar Gem Logic ophalen.

Bestellingen handmatig ophalen

  1. Ga naar Configuration ‣ Sales channels.

  2. Open het WooCommerce-verkoopkanaal.

  3. Klik op Bestellingen ophalen uit WooCommerce.

Dit wordt uitgevoerd als achtergrondtaak. U wordt doorgestuurd naar de pagina ophalengeschiedenis waar u de voortgang in realtime kunt volgen.

Automatisch bestellingen ophalen

Bestellingen kunnen ook automatisch volgens een schema worden opgehaald met behulp van het achtergrondtaaksysteem. Dit zorgt ervoor dat nieuwe voltooide bestellingen regelmatig zonder handmatige actie worden geïmporteerd.

Wat wordt geïmporteerd

Wanneer bestellingen uit WooCommerce worden opgehaald, worden de volgende gegevens geïmporteerd:

  • Bestellingssleutel (gebruikt als unieke bestellingsidentificatie)

  • Klantcontactgegevens (naam, adres, e-mail, telefoon) — een contact wordt aangemaakt of bijgewerkt in de CRM

  • Besteldatum en valuta

  • Regelitems: elke bestelregel bevat het product (gekoppeld op WooCommerce ID of SKU), hoeveelheid, prijzen (excl. en incl. BTW) en BTW-tarief

  • Voorraadaftrek: voorraad wordt automatisch afgetrokken voor elk regelitem

Notitie

Alleen bestellingen met de status voltooid worden geïmporteerd. Bestellingen met andere statussen (bijv. in behandeling, in de wacht, wachtend) worden overgeslagen.

Notitie

Bestellingen die al zijn geïmporteerd (gekoppeld op bestellingssleutel) worden overgeslagen om duplicaten te vermijden.

Ophalengeschiedenis

Elke ophalenactie wordt geregistreerd. U kunt de ophalengeschiedenis bekijken vanaf de detailpagina van het verkoopkanaal. Elk geschiedenisrecord toont:

  • Start- en eindtijd

  • Status (gestart, voltooid, mislukt of gedeeltelijk geslaagd)

  • Totaal aantal verwerkte bestellingen, nieuwe aangemaakte bestellingen, overgeslagen en mislukte aantallen

  • Duur en eventuele foutmeldingen