Doel: Deze gids helpt je bij het oplossen van problemen die kunnen optreden bij de integratie met WooCommerce V2.
Gerelateerde artikelen
→ Self-hosted shop systeem: Troubleshooten van integratie problemen
Foutmelding: API is niet actief bij het verbinden van WooCommerce webshop
Als je probeert je WooCommerce webshop te koppelen aan Sendcloud en je krijgt een melding dat de API niet actief is na het klikken op de knop Verbinden, komt dat waarschijnlijk door wijzigingen in de standaardinstellingen van WooCommerce.
In recente versies van WooCommerce is de Legacy API standaard niet meer ingeschakeld. Terwijl de vorige versie van de Sendcloud plugin afhankelijk was van deze API, gebruikt de nieuwste versie deze niet meer.
Je kunt de nieuwste versie van onze plugin hier downloaden.
Volg de onderstaande stappen om dit probleem op te lossen:
- Ga naar de pagina Instellingen > Integratie in je Sendcloud account.
- Controleer of er nieuwe WooCommerce integraties zijn aangemaakt. Zo ja, dan kun je deze veilig loskoppelen.
- Ga terug naar je WooCommerce webshop en deactiveer en verwijder volledig alle geïnstalleerde versies van de Sendcloud plugin.
- Installeer de plugin opnieuw via de bovenstaande link.
- Activeer de plugin en maak opnieuw verbinding met Sendcloud. De integratie zou nu zonder problemen moeten verlopen.
Importer werkt niet
Controleer in de WooCommerce omgeving of de permissions of permissies bij de API keys op lezen/schrijven staan. Dit is nodig om de data juist te importeren.
Controleer de instellingen voor de HPOS-modus in WooCommerce > Settings > Advanced > Features. Als de HPOS-modus is ingeschakeld, zorg er dan voor dat de compatibiliteitsmodus ook is ingeschakeld, anders kan Sendcloud geen bestellingen ophalen.
Orders worden geïmporteerd met vertraging
Zorg ervoor dat de Cache-Control HTTP header is geïmplementeerd met de no-cache Request Directives parameter wanneer je orders ophaalt, zoals beschreven in deze documentatie. Dit zal ervoor zorgen dat cache wordt genegeerd en het mogelijk maken om nieuwe orders op te halen.
Knop “Verbinden” is grijs op de Sendcloud-integratiepagina
Als de knop “Verbinden” op het scherm van de Sendcloud-integratie grijs is en je de verbinding niet kunt maken:
Controleer de permalink-instellingen in WordPress. Als de structuur is ingesteld op Plain, zal de verbinding niet werken.
Om dit op te lossen:
- Ga naar Instellingen > Permalinks in je WordPress-beheeromgeving.
- Selecteer een andere structuur dan “Plain”.
- Sla de wijzigingen op.
- Ga terug naar WooCommerce > Sendcloud en probeer opnieuw verbinding te maken.
Dit zou het probleem moeten oplossen en de knop “Verbinden” activeren.
WPML-plugincompatibiliteit (Ontbrekende meertalige bestellingen)
Als je de WPML-plugin gebruikt om meerdere talen te ondersteunen in je WooCommerce-winkel en je merkt dat sommige bestellingen (vooral die geplaatst in andere talen dan de standaardtaal) niet verschijnen in Sendcloud of ontbreken bij het synchroniseren, dan kan dit komen door de vertaalinstellingen van WPML voor het berichttype Order.
Volg deze stappen om compatibiliteit te garanderen:
- Ga in je WordPress-dashboard naar WPML > Instellingen
- Scroll naar het gedeelte Vertaling van berichttypen
- Zoek Orders (shop_order) in de lijst
- Stel dit in op Niet vertaalbaar (“Not translatable”)
- Klik op Opslaan
Nadat je deze instelling hebt aangepast, probeer dan opnieuw de bestellingen op te halen via je integratie of API-endpoint.
Alle bestellingen zouden nu correct moeten synchroniseren, ongeacht de taal die tijdens het afrekenen is gebruikt.
Nog steeds problemen? Maak een ticket aan en ons supportteam neemt zo snel mogelijk contact met je op!