Hoe start ik een integratie tussen RetailVista ERP en een Woocommerce webshop?

Prev Next

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?.

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'

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?.

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?.

Welke gegevens worden uitgewisseld

Alleen artikelen die aan de webshop zijn toegevoegd, gaan naar WooCommerce (zie 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?. 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.

© 2025 NedFox | Alle rechten voorbehouden.