WooCommerce koppelen aan APIcenter

Je koppelt WooCommerce aan APIcenter door het adres van je webshop in te vullen en APIcenter in WooCommerce toegang te geven. WooCommerce maakt daarbij zelf de REST API-sleutels aan. Je hoeft ze niet over te typen. Je doet dit één keer. Daarna gebruik je WooCommerce in al je integraties.

Wat je nodig hebt

• Het adres van je webshop.
• Een WordPress-gebruiker met toegang tot WooCommerce, waarmee je toegang geeft. De sleutels volgen de rechten van die gebruiker. Wordt de gebruiker verwijderd, dan werken de sleutels niet meer.
• WooCommerce 3.5 of nieuwer en WordPress 4.4 of nieuwer.
• Permalinks die niet op Plain staan. Je stelt dit in bij Settings > Permalinks in WordPress. De standaard permalinks werken niet met de REST API.
• Bij voorkeur HTTPS op je webshop. WooCommerce raadt dit aan.

Welke toegang APIcenter vraagt

APIcenter vraagt lees- en schrijftoegang tot je webshop (read_write). Dat is nodig om gegevens op te halen en om producten, voorraad, klanten en orders aan te maken of bij te werken.

Zo koppel je WooCommerce

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies WooCommerce.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je webshop.
3. Vul bij API url het adres van je webshop in, zonder https:// en zonder slash aan het einde. Bijvoorbeeld mywebshop.com, of mywebshop.com/staging als je webshop in een submap staat.
4. Laat Authentication Method op Authorization header staan, tenzij je server dat niet ondersteunt. Zie "Als het niet lukt".
5. Klik op Opslaan.
6. Klik op Autoriseren. Je gaat naar je webshop. Log daar in en geef APIcenter toegang. WooCommerce stuurt de sleutels daarna naar APIcenter en APIcenter bewaart ze.
7. Klik op Testverbinding. Zie je "Verbinding is goed!", dan is WooCommerce klaar voor gebruik.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Toegang bekijken of intrekken in WooCommerce

Je ziet de sleutels van je webshop in WooCommerce bij WooCommerce > Settings > Advanced > REST API. Daar kun je een sleutel ook intrekken met Revoke Key. Doe je dat voor APIcenter, dan werkt de koppeling niet meer tot je opnieuw op Autoriseren klikt.

Als het niet lukt

• Consumer key is missing: sommige servers geven de Authorization-header niet goed door. Kies dan bij Authentication Method de optie Query parameters. APIcenter stuurt de sleutels dan mee in het adres van het verzoek.
• 501 Method Not Implemented terwijl je ModSecurity gebruikt: WooCommerce beschrijft dit probleem in de documentatie van de REST API.
• De test mislukt of de API geeft niets terug: controleer of de permalinks niet op Plain staan.
• De koppeling werkte, maar stopt: de gebruiker waarmee je toegang gaf, is verwijderd of de sleutel is ingetrokken. Klik op Autoriseren en geef opnieuw toegang. Zie Verbinding of inloggen mislukt.

Meer informatie van WooCommerce zelf staat in WooCommerce REST API en in de documentatie van de REST API.

Volgende stappen

Maak een integratie met WooCommerce en controleer de instellingen. Zie WooCommerce verbindings- en integratie-instellingen.