Doel: Dit artikel helpt je bij het oplossen van problemen en het correct instellen van je configuratie, zodat je een betrouwbare verbinding met Sendcloud kunt garanderen. Dit geldt voor een self-hosted e-commerceplatform, zoals WooCommerce, Magento of PrestaShop, dat op je eigen server is geïnstalleerd. Door de onderstaande stappen te volgen, zorg je voor een soepele orderimport, verzendverwerking en tracking-updates tussen je shop en Sendcloud.
Het verschil begrijpen: Cloud-gebaseerde vs. Self-hosted platforms
Sendcloud integreert met zowel cloud-gebaseerde als self-hosted e-commerceplatforms om verzending te automatiseren en te vereenvoudigen.
- Cloud-gebaseerde systemen (bijv. Shopify): Deze systemen worden volledig gehost en beheerd door de platformaanbieder, inclusief alle beveiligingsinstellingen. Je hoeft meestal geen technische wijzigingen door te voeren om ze met Sendcloud te verbinden.
- Self-hosted systemen (bijv. WooCommerce, Magento, PrestaShop geïnstalleerd op je eigen server): Jij bent verantwoordelijk voor het beheer van de beveiliging van je server. Hierdoor kunnen bepaalde instellingen de communicatie tussen Sendcloud en je shop blokkeren, tenzij ze correct zijn geconfigureerd.
Vereisten voor self-hosted shopsystemen
Om een soepele en ononderbroken integratie te garanderen, zorg ervoor dat de volgende configuraties zijn toegepast op je server:
1. Zet de IP-adressen van Sendcloud op de toegestane lijst
Sendcloud maakt verbinding met je e-commerce systeem via specifieke IP-adressen. Als je server of beveiligingstools (zoals een firewall of plugin) onbekende IP's blokkeren, moet je onze IP-adressen op de toegestane lijst zetten. Dit zorgt ervoor dat we nieuwe bestellingen kunnen ophalen en verzendupdates kunnen versturen zonder onderbreking.
Wat te doen:
Voeg alle IP-adressen die op deze pagina staan toe aan de toegestane lijst van je serverfirewall of beveiligingsplugin.
2. Zet de User-Agent van Sendcloud op de toegestane lijst
Naast IP-adressen gebruikt Sendcloud ook een specifieke User-Agent-string bij het verbinden met je shop. Sommige servers of beveiligingstools blokkeren verzoeken als ze deze string niet herkennen, wat de verbinding kan verstoren.
Wat te doen:
Zorg ervoor dat je server of beveiligingstools geen verzoeken blokkeren die de volgende User-Agent strings gebruiken:
- User-Agent: Sendcloud/1.0.0
- User-Agent: SendCloud/1.0 (<SHOP SYSTEM NAME>; https://www.sendcloud.sc)
Vervang <SHOP SYSTEM NAME>
door het type integratie dat je gebruikt, zoals prestashop
of woocommerce
.
3. Sta HTTP-methoden toe die Sendcloud gebruikt
Sendcloud gebruikt verschillende standaard HTTP-methoden om volledig met je e-commerce systeem te communiceren.
Hoewel GET
(om gegevens op te halen) en POST
(om gegevens te verzenden) meestal standaard zijn toegestaan, gebruiken we ook andere methoden om bijvoorbeeld orderstatussen bij te werken of productgegevens te synchroniseren. Deze kunnen geblokkeerd zijn tenzij je ze inschakelt.
Wat te doen:
Controleer met je serverbeheerder of bekijk de instellingen van je server, firewall of .htaccess
, om te zorgen dat de volgende HTTP-methoden zijn toegestaan voor verzoeken afkomstig van de IP-adressen van Sendcloud en met onze User-Agent:
GET
POST
OPTIONS
PATCH
DELETE
Het blokkeren van deze methoden kan leiden tot problemen zoals ontbrekende bestellingen of mislukte tracking-updates.
Zonder de bovenstaande configuraties kun je de volgende problemen ervaren:
- Ontbrekende of vertraagde order import
- Mislukte trackingnummers of statusupdates
- Algemene communicatieproblemen tussen je shop en Sendcloud
Deze fouten hebben directe impact op je orderverwerking en communicatie met klanten.
Worden orders niet gesynchroniseerd na onderhoud?
Als nieuwe bestellingen niet verschijnen na gepland onderhoud of een tijdelijke storing in je integratie, is de verbinding mogelijk in een vertraagde status terechtgekomen.
Wat te doen:
- Ga naar je integratielijst in Sendcloud.
- Selecteer de getroffen integratie.
- Klik op de knop vernieuwen om handmatig de ordersynchronisatie te starten.
Hulp nodig?
Als je niet zeker weet hoe je deze wijzigingen moet doorvoeren:
- Neem contact op met je webhostingprovider of serverbeheerder.
- Deel dit artikel met hen voor technische context.
Nog steeds problemen? Ons Support team staat klaar om je te helpen; neem via je Sendcloud panel contact op.