WooCommerce

WooCommerce praat via de REST API van WordPress. De sleutels maak je in WooCommerce zelf.

Wat je nodig hebt

1. WooCommerce → Settings → Advanced → REST API → Add key.
2. Gebruiker: een beheerder. Rechten: Read/Write.
3. Kopieer de Consumer key en de Consumer secret (één keer zichtbaar).
4. In Nexym: + Koppeling toevoegen → WooCommerce, vul de site-URL en beide sleutels in.

Veld	Voorbeeld
Site-URL	https://voorbeeldshop.nl
Consumer key	ck_…
Consumer secret	cs_…

Wat er over de lijn gaat

Entiteit	IN	OUT
Producten en varianten	ja	ja
Voorraad	ja	ja
Prijzen	ja	ja
Orders	ja	nee
Klanten	ja	ja

!

De REST API moet bereikbaar zijn over HTTPS. Staat er een firewall of een beveiligingsplug-in voor die /wp-json/ afschermt, dan mislukt de test met een 401 terwijl de sleutels kloppen. Zet het pad open voor het IP-adres van Nexym.

Alleen ingeschakelde producten of producten op voorraad importeren

Haal je producten uit WooCommerce, dan staan bij het potlood van Producten · IN op Wat synchroniseren twee vinkjes die los van elkaar werken. Een product dat nog niet in Nexym staat, komt alleen binnen als het voldoet aan elk vinkje dat aan staat.

• Alleen ingeschakelde producten importeren: alleen als het in WooCommerce gepubliceerd is (geen concept, pending, private of prullenbak). Bij een nieuwe koppeling staat dit aan.
• Alleen producten op voorraad importeren: alleen als de voorraadstatus Op voorraad of Nabestelling is; bij een variabel product telt de status die WooCommerce uit de variaties bijhoudt. Bij een nieuwe koppeling staat dit uit: WooCommerce meldt een product dat weer op voorraad komt niet apart, dus zo’n product komt pas binnen bij zijn volgende wijziging in WooCommerce, of bij een volledige import. Staat alleen dit vinkje aan, dan komt een product dat uit staat maar op voorraad is wel binnen; het staat in Nexym dan offline.

Wat al in Nexym staat, wordt altijd bijgewerkt en nooit verwijderd; een product dat later uit gaat, gaat in Nexym offline. Bij de eerste en een volledige import vraagt Nexym WooCommerce meteen alleen de ingeschakelde producten, als dat vinkje aan staat.

Goed om te weten

• De besteltijd komt uit het UTC-veld van WooCommerce (date_created_gmt), dus de tijdzone van je WordPress-site maakt niet uit en je hoeft er bij Instellingen geen te kiezen.
• Status en type worden vertaald naar de woorden van Nexym: publish wordt active, draft, pending en future worden draft, private en trash worden inactive. Een status die een plug-in toevoegt, wordt inactive, zodat een onbekende staat nooit een product in de verkoop zet. Het type variable heet in Nexym configurable, een external product is simple. Terug naar WooCommerce gaat het andersom.
• Upsells en cross-sells komen mee. WooCommerce noemt ze bij zijn eigen product-id’s; Nexym zoekt daar het product bij, ook als dat pas later wordt geïmporteerd. Je ziet ze in het productdetail op het tabblad Related.
• De gerelateerde producten van WooCommerce komen niet mee. WooCommerce kiest die zelf, bij elke opvraag opnieuw en in willekeurige volgorde, uit producten met dezelfde categorie of tag. Het is dus geen lijst die iemand heeft samengesteld.
• WooCommerce heeft standaard geen inkoopprijs, dus Nexym koppelt er vanzelf geen. Houdt een plug-in er een bij, zet dan onder Veldmapping (import) bij Cost price de expressie voor de sleutel van die plug-in: {{ meta_data | find:'key','_wc_cog_cost','value' | nullif:'' | float | ifempty:'' }}. Gangbare sleutels: _wc_cog_cost (WooCommerce Cost of Goods), _alg_wc_cog_cost (Cost of Goods for WooCommerce) en _purchase_price.
• Een inkoopprijs die als attribuut in Nexym staat (bijvoorbeeld uit Magento) gaat bij het aanmaken van een product niet mee naar WooCommerce.