--- title: "Hoe start ik een integratie tussen RetailVista ERP en een Woocommerce webshop?" slug: "hoe-start-ik-een-integratie-tussen-retailvista-erp-en-een-woocommerce-webshop" description: "Inrichting van de WooCommerce-koppeling: API-sleutel en gebruiker in WooCommerce, webshop in RetailVista en welke gegevens worden uitgewisseld." tags: ["QA834"] updated: 2026-10-30T11:29:09Z published: 2026-10-30T11:29:09Z canonical: "docs.retailvista.net/hoe-start-ik-een-integratie-tussen-retailvista-erp-en-een-woocommerce-webshop" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.retailvista.net/llms.txt > Use this file to discover all available pages before exploring further. # Hoe start ik een integratie tussen RetailVista ERP en een Woocommerce webshop? Met de WooCommerce-koppeling stuurt RetailVista de prijs en de voorraad van webshopartikelen naar een WooCommerce-webshop en haalt het orders op. Dit artikel beschrijft de inrichting en welke gegevens er worden uitgewisseld. Hoe artikelen met varianten (maten, kleuren) werken, staat in [Hoe werkt RetailVista integratie naar Woocommerce met variant artikelen?](/docs/hoe-werkt-retailvista-integratie-naar-woocommerce-met-variant-artikelen). ## Overzicht | Onderdeel | Waarvoor | | --- | --- | | Gebruiker en API-sleutel in WooCommerce | Toegang van RetailVista tot de WooCommerce REST API. | | Webshop in RetailVista | Adres en sleutel van de webshop, en wat er verstuurd en opgehaald wordt. | | Taakplanner | Periodiek artikelen versturen en orders ophalen. | | Webshopartikelen | Bepalen welke artikelen naar de webshop gaan. | ## Gebruiker en API-sleutel in WooCommerce RetailVista werkt met de rechten van de WordPress-gebruiker waaraan de API-sleutel gekoppeld is. 1. Kies of maak in WordPress een gebruiker met de rol 'Winkelmanager' (Shop manager). Een beheerder kan ook, maar is niet nodig. 2. Maak in WooCommerce bij 'WooCommerce > Instellingen > Geavanceerd > REST API' een sleutel aan met: - omschrijving 'RetailVista ERP'; - als gebruiker de gebruiker uit stap 1; - rechten 'Lezen/Schrijven'. 3. Bewaar de consumer key en de consumer secret. WooCommerce toont de secret maar één keer. Wordt een eigen rol gebruikt in plaats van 'Winkelmanager', dan heeft die rol minimaal deze rechten nodig: | Recht | Waarvoor | | --- | --- | | `read_private_products` | Artikelen opzoeken op SKU | | `publish_products` | Nieuwe artikelen aanmaken | | `edit_products`, `edit_published_products`, `edit_others_products` | Prijs, voorraad en zichtbaarheid bijwerken | | `read_private_shop_orders` | Orders ophalen, alleen als RetailVista orders ophaalt | > **Let op:** Rollen als 'Redacteur' en 'Auteur' hebben geen rechten op WooCommerce-artikelen. Met een sleutel van zo'n gebruiker geeft de webshop 'Forbidden' terug en wordt er niets bijgewerkt. ## Webshop in RetailVista Maak in 'Webshop onderhoud' een webshop aan met 'Webshop type' 'WooCommerce'. ### Tab 'Integratie' ![](https://cdn.document360.io/9cfe1b80-9c32-4b2a-9328-1df667cdd950/Images/Documentation/image-1707938651882.png?sv=2026-02-06&spr=https&st=2026-11-20T07%3A53%3A54Z&se=2026-11-20T08%3A53%3A54Z&sr=b&sp=r&sig=d0nrmeqPcRaVQo%2BI%2B4nQg%2FhERchtankJaPi99zNaS6o%3D) | Veld | Waarde | | --- | --- | | 'API Url' | Het adres van de WordPress-site, bijvoorbeeld `https://www.voorbeeld.nl/`. Niet het adres van de winkelpagina (zoals `https://www.voorbeeld.nl/shop/`): RetailVista zet er zelf `wp-json/wc/v2/` achter. Wie dit adres met `wp-json/` erachter in een browser opent, krijgt een JSON-tekst te zien. | | 'Gebruikersnaam' | De consumer key (begint met `ck_`). | | 'Wachtwoord' | De consumer secret (begint met `cs_`). | | 'Artikel terugval' | Optioneel. Het gegeven waarop RetailVista een artikel in WooCommerce zoekt als zoeken op barcode niets oplevert (zie hieronder bij 'Artikelen opzoeken in WooCommerce'). | ### Tab 'Export' | Veld | Werking bij WooCommerce | | --- | --- | | 'Verstuur artikel data naar webshop' | Verstuurt de verkoopprijs. | | 'Verstuur voorraad naar webshop' | Verstuurt de voorraad. | | 'Verstuur pakket info naar webshop' | Niet ondersteund bij WooCommerce. | | 'Send alternate stock data to webshop' | Niet ondersteund bij WooCommerce. | | 'Opnieuw versturen vanaf datum' | Verstuurt bij de volgende run alle webshopartikelen opnieuw die sinds deze datum gewijzigd zijn. | ### Tab 'Orders' Vink 'Opvragen orders uit webshop' aan als RetailVista orders uit WooCommerce moet ophalen, en kies het 'Verkooporder scenario'. De verdere verwerking van een order staat in [Hoe werkt de afhandeling van een webshop order?](/docs/hoe-werkt-de-afhandeling-van-een-webshop-order). ## Taakplanner | Taak | Waarvoor | | --- | --- | | 'Synchroniseer webshop artikelen' | Verstuurt de gewijzigde webshopartikelen naar de webshops van de vestiging. | | 'Synchroniseer webshop bestellingen' | Haalt de orders op. Alleen nodig als orders worden opgehaald. | Controleer of voor beide taken een taakplanning bestaat. Wat een taak heeft gedaan, staat in het taaklog, zie [Waar kan ik de voortgang van een taak zien in RetailVista?](/docs/waar-kan-ik-de-voortgang-van-een-taak-zien-in-retailvista). ## Welke gegevens worden uitgewisseld Alleen artikelen die aan de webshop zijn toegevoegd, gaan naar WooCommerce (zie [Artikelen aan de webshop toevoegen](/docs/artikelen-aan-de-webshop-toevoegen)). Bij elke run verstuurt RetailVista de webshopartikelen die sinds 'Laatste artikel sync' gewijzigd zijn: het artikel zelf, de voorraad of een afbeelding. ### Artikelen opzoeken in WooCommerce RetailVista zoekt elk artikel in WooCommerce op SKU, in deze volgorde: 1. de hoofdbarcode; 2. de overige barcodes van het artikel; 3. het gegeven uit 'Artikel terugval', als dat is ingevuld. Wordt het artikel niet gevonden, dan maakt RetailVista het aan in WooCommerce. Een artikel zonder hoofdbarcode wordt overgeslagen. ### Velden | Veld in WooCommerce | Waarde uit RetailVista | Nieuw artikel | Bestaand artikel | | --- | --- | --- | --- | | Naam | Omschrijving van het artikel | Ja | Nee | | SKU | Hoofdbarcode | Ja | Nee | | Reguliere prijs | Verkoopprijs van het artikel, als 'Verstuur artikel data naar webshop' aan staat | Ja | Ja | | Voorraad (met voorraadbeheer aan) | Vrije voorraad in de vestiging van de webshop, min de veiligheidsvoorraad uit `SafetyStockQty` en nooit lager dan 0. Alleen als 'Verstuur voorraad naar webshop' aan staat en het artikel 'Voorraadadministratie' heeft. | Ja | Ja | | Zichtbaarheid in de catalogus | Zichtbaar, of verborgen als het artikel uit de webshop gehaald is | Ja | Ja | De naam en de SKU van een bestaand artikel blijven ongewijzigd: een aangepaste omschrijving in RetailVista komt niet in WooCommerce. Afbeeldingen, categorieën, merk, beschrijvingen, kortingen en de voorraad van andere vestigingen worden niet uitgewisseld. Een nieuw artikel is direct zichtbaar in de webshop; afbeeldingen, categorieën en teksten worden daarna in WooCommerce aangevuld. Een afwijkende internetprijs en de 'Prijs verhoging %' en 'Prijs verhoging waarde' van de webshop worden bij WooCommerce niet toegepast: de reguliere prijs is altijd de verkoopprijs van het artikel. ### Artikelen die uit de webshop gehaald zijn Een artikel dat uit de webshop gehaald is, krijgt in WooCommerce de zichtbaarheid verborgen. Met de geavanceerde instellingen `SyncDeletedProducts`, `AddDeletedProducts` en `SetStatusDraftForDeletedProducts` is dat aan te passen. ## Orders ophalen - WooCommerce kan orders alleen filteren op de aanmaakdatum, en een order ontstaat al terwijl de klant nog aan het bestellen is. RetailVista vraagt daarom de orders op die vanaf 48 uur vóór de laatste ophaalronde zijn aangemaakt. - De orderregels worden aan artikelen gekoppeld via de SKU als barcode, en anders via 'Artikel terugval'. - WooCommerce geeft per order alleen een betaaldatum door, geen betaald bedrag. Is de betaaldatum gevuld, dan geldt het hele orderbedrag als betaald, met de betaalmethode en het transactienummer uit WooCommerce. ## Geavanceerde instellingen Geavanceerde instellingen staan in het veld 'Geavanceerde instellingen' van de webshop, één per regel in de vorm `Naam=waarde`. De instellingen die voor alle webshopkoppelingen gelden, staan in [Welke algemene geavanceerde instellingen zijn er beschikbaar in een webshop integratie?](/docs/welke-algemene-geavanceerde-instellingen-zijn-er-beschikbaar-in-een-webshop-integratie). Voor WooCommerce zijn er daarnaast: | Instelling | Werking | | --- | --- | | `SafetyStockQty=<aantal>` | Veiligheidsvoorraad: dit aantal (een geheel getal) gaat van de vrije voorraad af voordat die naar WooCommerce gaat. Zo blijft er ruimte voor voorraadverschillen en winkelverkopen. | | `SyncDeletedProducts=0` | Artikelen die uit de webshop gehaald zijn, worden niet meer naar WooCommerce gestuurd, ook niet om ze te verbergen. | | `AddDeletedProducts=0` | Een artikel dat uit de webshop gehaald is en niet in WooCommerce bestaat, wordt niet aangemaakt. Zonder deze instelling wordt het verborgen aangemaakt. | | `SetStatusDraftForDeletedProducts=1` | Een artikel dat uit de webshop gehaald is, krijgt in WooCommerce de status concept in plaats van de zichtbaarheid verborgen. | | `ProductIdentifierPrefix=<tekst>` | Alleen bij 'Artikel terugval': deze voorloop wordt van het gegeven uit RetailVista afgehaald voordat op SKU gezocht wordt. Met `ProductIdentifierPrefix=WC` wordt de zoektekst `WC1234` gezocht als SKU `1234`. | | `County-<code>=<naam>` | Orders: zet een provinciecode uit WooCommerce om naar de volledige naam, bijvoorbeeld `County-OV=Overijssel`. Eén regel per code. | ## Problemen oplossen | Situatie | Oorzaak en oplossing | | --- | --- | | Het taaklog meldt `Forbidden` | De gebruiker van de API-sleutel heeft te weinig rechten. Geef de gebruiker de rol 'Winkelmanager' of de rechten uit de tabel hierboven. | | Het taaklog meldt `Unauthorized` | De consumer key of secret in 'Gebruikersnaam' of 'Wachtwoord' klopt niet, of de sleutel is ingetrokken. | | Het taaklog meldt `NotFound` of `InternalServerError` met een HTML-pagina | 'API Url' wijst niet naar de hoofdmap van de WordPress-site. | | Het taaklog meldt dat de verbinding is verbroken of niet tot stand kwam | De hosting of een beveiligingsplugin van de webshop weigert de verbinding. Laat het IP-adres van de server waarop de taakplanner van RetailVista draait toestaan. | | Het taaklog meldt `Productnumber ... has no barcode so it will not be synchronized with the webshop` | Het artikel heeft geen hoofdbarcode. | | Een gewijzigde omschrijving, afbeelding of categorie komt niet in de webshop | Die gegevens worden niet uitgewisseld. Pas ze in WooCommerce aan. | ## Testen 1. Open het adres uit 'API Url' met `wp-json/` erachter in een browser en controleer dat er een JSON-tekst verschijnt. 2. Zet in 'Geavanceerde instellingen' tijdelijk `SyncProductNumber=<artikelnummer>` van één webshopartikel, zodat alleen dat artikel verstuurd wordt. 3. Laat de taak 'Synchroniseer webshop artikelen' lopen en controleer het taaklog. 4. Controleer in WooCommerce de prijs, de voorraad en de zichtbaarheid van het artikel. 5. Haal `SyncProductNumber` weer weg.