Hoe werkt RetailVista integratie naar Woocommerce met variant artikelen?

Variant artikelen in Woocommerce zijn artikelen waar meerdere 'varianten' van beschikbaar zijn. Voorbeeld van variant artikelen zijn kleuren/maten artikelen. Het artikel bljift hetzelfde maar is in een aantal verschillenden maten of kleuren beschikbaar. Uiteindelijk leidt elk variant artikel in Woocommerce tot een eigen uniek SKU nummer. Datzelfde nummer moet binnen RetailVista bestaan zodat deze de voorraad en prijs kan synchroniseren.

Helaas is het met de Woocommerce API technisch niet mogelijk om een variant artikel op SKU nummer te zoeken en bij te werken. De Woocommerce API vereist ook het SKU nummer van het hoofd artikel. Binnen RetailVista is van een variant artikel (gerelateerde artikel) het hoofd artikel echter niet bekend omdat dat meerdere kunnen zijn (een variant artikel kan onderdeel zijn van meerdere artikelen).

Om die reden is het helaas noodzakelik om in RetailVista het 'hoofd' artikel op te geven bij de SKU variant. In de praktijk komt het er op neer dat in het artikel zoektekst of externe code veld het variant SKU nummer uit Woocommerce opgegeven moet worden, gevolgd door een | symbool en dan het SKU nummer van het 'hoofd' artikel. Of het veld zoektekst of externe code gebruikt wordt, hangt af van de terugvall (fallback) instelling zoals ingesteld bij het webshop onderhoud.

Voorbeeld: 1234|5678 waarbij 1234 het variant SKU nummer is en 5678 het 'hoofd' artikelnummer in Woocommerce.

Als het artikel met deze zoektekst in aanmerking komt voor webshop synchronisatie (bijvoorbeeld omdat er iets gewijzigd is) dan zal gezocht worden in Woocommerce naar een variant artikel met SKU nummer 1234 die moet vallen onder een hoofd artikel met SKU nummer 5678. Als die combinatie gevonden wordt, dan zal de voorraad en prijs van het SKU variant artikel worden bijgewerkt.

Meer info over de bewuste REST API call (of het ontbreken daarvan is onder andere te vinden via

https://github.com/woocommerce/woocommerce/issues/31370