WooCommerce koppelen

Met de WooCommerce-koppeling haalt Stockhub de bestellingen uit je webshop op. Stockhub stuurt de voorraad en de track & trace terug naar WooCommerce. In dit artikel maak je eerst een API-sleutel in WooCommerce en daarna de koppeling in Stockhub.

Wat je nodig hebt

• Toegang tot het WordPress-dashboard van je webshop met een beheerdersaccount.
• Het adres van je webshop, bijvoorbeeld https://www.jouwwebshop.nl.
• Permalinks die niet op Plain staan. De REST API van WooCommerce werkt alleen met andere permalinks. Je stelt dit in WordPress in onder Settings > Permalinks.

API-sleutel aanmaken in WooCommerce

1. Log in op het WordPress-dashboard van je webshop.
2. Ga naar WooCommerce > Settings > Advanced > REST API.
3. Klik op Add key of Create an API key.
4. Vul bij Description een herkenbare naam in, bijvoorbeeld Stockhub.
5. Kies bij User een gebruiker met beheerdersrechten.
6. Kies bij Permissions voor Read/Write. Stockhub moet de voorraad en de status van bestellingen kunnen aanpassen.
7. Klik op Generate API key.
8. Kopieer de Consumer key en de Consumer secret. WooCommerce toont de Consumer secret maar één keer.

Staat je WordPress in het Nederlands, dan heten de menu's anders, bijvoorbeeld WooCommerce > Instellingen > Geavanceerd > REST API.

Meer uitleg vind je in de handleiding van WooCommerce: https://woocommerce.com/document/woocommerce-rest-api/

Koppeling aanmaken in Stockhub

1. Ga in het menu naar Integraties > Verkoopkanalen.
2. Klik op de tab Verkoopkanalen op Nieuw verkoopkanaal. Het venster Verkoopkanaal toevoegen opent.
3. Kies Woocommerce.
4. Vul de velden in:
   • Omschrijving: een herkenbare naam voor de koppeling, bijvoorbeeld de naam van je webshop.
   • Afzendernaam: de naam op het verzendlabel. Laat je dit leeg, dan gebruikt Stockhub je bedrijfsnaam.
   • URL: het volledige adres van je webshop met https://, bijvoorbeeld https://www.jouwwebshop.nl. Zet er geen /wp-json achter.
   • Consumer key en Consumer secret: de sleutels uit WooCommerce.

5. Klik op Test verbinding. Zie je Verbonden, dan kan Stockhub je webshop bereiken. Zie je Verbinding mislukt, controleer dan de URL en de sleutels.
6. Klik op Volgende.
7. Kies welke gegevens Stockhub uitwisselt. Zet elke instelling op Actief of Inactief:
   • Importeer bestellingen: haal bestellingen op uit WooCommerce.
   • Alle producten bijwerken en Nieuwe producten importeren: deze zie je alleen als het fulfilmentbedrijf dit heeft aangezet.
   • Voorraad bijwerken naar kanaal: stuur de voorraad uit Stockhub naar WooCommerce.
   • Synchroniseer een virtuele voorraad hoeveelheid: deze hoeveelheid telt Stockhub op bij de voorraad die naar WooCommerce gaat.
   • Track & trace e-mail versturen: deze zie je alleen als het fulfilmentbedrijf dit heeft aangezet.
8. Klik op Opslaan.

Je ziet daarna de melding Activatie verkoopkanaal in behandeling. Het kanaal staat in conceptstatus tot het fulfilmentbedrijf het activeert. Pas dan starten de synchronisaties.

Zo werkt de koppeling met WooCommerce

• Stockhub haalt bestellingen op met de status Processing (in het Nederlands: In behandeling). Staat On-hold B2B-bestellingen importeren aan, dan haalt Stockhub ook bestellingen met de status On hold (In de wacht) op, als het metaveld b2b-bestelling de waarde ja of yes heeft. Zo kun je B2B-bestellingen verzenden voordat ze betaald zijn.
• Stockhub herkent producten aan de SKU. Geef elk product en elke variant in WooCommerce een SKU. Varianten zonder SKU slaat Stockhub over.
• Staat Meld bestellingen af (met tracking) aan, dan zet Stockhub een verzonden bestelling in WooCommerce op Completed (Afgerond). De track & trace komt als notitie voor de klant bij de bestelling.
• Met Voorraad bijwerken naar kanaal stuurt Stockhub de voorraad per product naar WooCommerce. WooCommerce gebruikt die alleen bij producten waarvoor voorraadbeheer (Manage stock) aan staat.

Instellingen die bij WooCommerce horen

Open het kanaal via Integraties > Verkoopkanalen. Naast de algemene instellingen vind je daar:

• Op de tab Gegevens: Webshop URL, Webshop consumer key en Webshop consumer secret. Hier vul je nieuwe sleutels in als je in WooCommerce een nieuwe sleutel hebt gemaakt. Bij Meta-data veld servicepunt vul je het metadataveld in waarin je webshop de vervoerder bewaart als een bestelling naar een afhaalpunt gaat.
• Op de tab Synchroniseren: Plaats de klantopmerking in het opmerkingveld van de bestelling, Bestellingen automatisch annuleren en Kassabestellingen met het Metaveld kassabestelling en On-hold B2B-bestellingen importeren.
• Onder Aangepaste product velden: bij HS code, Land van oorsprong en Barcode vul je in uit welk metaveld van je producten Stockhub die waarde haalt.
• Op de tab Verzendopties: verzendopties in de checkout van je webshop via de Stockhub-plugin. Deze tab zie je alleen als het fulfilmentbedrijf verzendopties heeft aangezet.

Zie ook Verkoopkanalen beheren voor alle instellingen, de bestellingen van het kanaal en het verwijderen van een kanaal.