Documentatie — GoedGeplaatst Connector

Documentatie — GoedGeplaatst Connector

Volledige handleiding voor het installeren en gebruiken van de GoStockr GoedGeplaatst Connector.

Andere plugin? Bekijk de Bol.com Sync documentatie.

Vereisten

• WordPress 5.8 of hoger
• WooCommerce 7.0 of hoger
• PHP 7.4 of hoger
• Een actief GoedGeplaatst.nl verkopersaccount
• GoedGeplaatst API-credentials

Stap 1: Plugin installeren

1. Download het zip-bestand na aankoop.
2. Ga in WordPress naar Plugins → Nieuwe plugin → Plugin uploaden.
3. Upload het zip-bestand en klik op Nu installeren → Activeren.

Stap 2: Licentie activeren

1. Na activatie verschijnt een melding bovenaan de adminpagina. Klik op Instellingen.
2. Voer je licentiesleutel in en klik op Activeren.

Stap 3: GoedGeplaatst API koppelen

1. Log in op je GoedGeplaatst.nl account.
2. Ga naar je accountinstellingen en zoek de API-sectie.
3. Genereer of kopieer je API-key en User ID.
4. Ga in WordPress naar GoedGeplaatst → Instellingen.
5. Vul de API-key en User ID in.
6. Klik op Verbinding testen.

Productsynchronisatie

De connector synchroniseert WooCommerce-producten naar GoedGeplaatst.nl. Dit is eenrichtingsverkeer: WooCommerce is de bron, GoedGeplaatst ontvangt de data.

Wat wordt gesynchroniseerd?

• Titel — de WooCommerce-productnaam
• Beschrijving — de volledige productbeschrijving
• Prijs — de verkoopprijs inclusief BTW
• Afbeeldingen — productafbeeldingen worden automatisch meegestuurd
• EAN-code — het EAN-nummer (SKU in WooCommerce)
• Merk — via de ingebouwde merk-taxonomie
• Hoofdgroep en rubriek — de GoedGeplaatst-categorisatie
• Kenmerken — productattributen die je koppelt aan GoedGeplaatst-kenmerken

Hoofdgroep en rubriek instellen

GoedGeplaatst gebruikt een eigen categorisatiesysteem met hoofdgroepen en rubrieken. Je koppelt deze per product of per WooCommerce-categorie:

1. Ga naar een product bewerken in WooCommerce.
2. Scroll naar het GoedGeplaatst-paneel onder de productgegevens.
3. Kies de juiste hoofdgroep (bijv. Elektronica, Huis & Tuin).
4. Kies de bijbehorende rubriek (bijv. Smartphones, Tuingereedschap).
5. Sla het product op.

Dynamische kenmerken

Sommige rubrieken op GoedGeplaatst hebben specifieke kenmerken (kleur, maat, materiaal, etc.). De connector laadt deze dynamisch op basis van de gekozen rubriek:

1. Kies eerst de hoofdgroep en rubriek.
2. De beschikbare kenmerken verschijnen automatisch.
3. Vul de relevante kenmerken in.
4. Hoe meer kenmerken je invult, hoe beter je product vindbaar is op GoedGeplaatst.

Merk-taxonomie

De connector voegt een Merk-taxonomie toe aan WooCommerce. Zo stel je het in:

1. Ga naar Producten → Merken in het WordPress-menu.
2. Voeg merken toe (bijv. Samsung, Philips, Apple).
3. Wijs een merk toe aan je producten bij het bewerken.
4. Het merk wordt automatisch meegesynchroniseerd naar GoedGeplaatst.

EAN-validatie

De connector valideert EAN-codes voordat ze naar GoedGeplaatst worden gestuurd. Ongeldige EAN-codes worden gemarkeerd zodat je ze kunt corrigeren. Een geldig EAN-nummer is 8 of 13 cijfers en voldoet aan de checksum-berekening.

Bulk synchronisatie

1. Ga naar GoedGeplaatst → Synchronisatie.
2. Klik op Alle producten synchroniseren.
3. De plugin verwerkt producten in batches op de achtergrond.
4. Bij grote catalogi kan de eerste sync enkele minuten duren.
5. Daarna worden wijzigingen automatisch doorgevoerd.

Recovery systeem

Als een synchronisatie mislukt (API-timeout, netwerkstooring, ongeldig product), slaat de connector het product op voor een automatische herpoging. Ga naar GoedGeplaatst → Recovery om mislukte syncs te bekijken en handmatig opnieuw te proberen.

Producten verwijderen

Als je een product uit WooCommerce verwijdert of op Concept zet, wordt het automatisch verwijderd van GoedGeplaatst bij de volgende sync.

Veelgestelde problemen

Product verschijnt niet op GoedGeplaatst
Controleer of het product gepubliceerd is in WooCommerce. Controleer of de hoofdgroep en rubriek zijn ingevuld. Controleer of het EAN-nummer geldig is. Bekijk het recovery-overzicht voor foutmeldingen.

Kenmerken worden niet getoond
Kenmerken zijn rubriek-afhankelijk. Kies eerst de juiste hoofdgroep en rubriek, dan verschijnen de beschikbare kenmerken automatisch.

Afbeeldingen worden niet gesynchroniseerd
Controleer of je productafbeeldingen hebt toegevoegd in WooCommerce. Afbeeldingen moeten publiek bereikbaar zijn (geen watermark-plugins die URLs blokkeren).

API-verbinding mislukt
Controleer of je API-key en User ID correct zijn. Controleer of je GoedGeplaatst-account actief is. Probeer de verbinding opnieuw te testen.

Bulk sync loopt vast
Bij zeer grote catalogi (5000+ producten) kan de sync langer duren. Controleer of je hosting genoeg PHP-geheugen heeft (minimaal 256MB). Verhoog eventueel het PHP-geheugen via je hostingprovider.