Basic integration troubleshooter

Je integratie loskoppelen en opnieuw installeren is een betrouwbare oplossing voor aanhoudende verbindingsfouten, authenticatieproblemen en situaties waarbij bestellingen niet meer worden geïmporteerd nadat andere stappen niet hebben geholpen. Begrijp eerst goed wat je kwijtraakt voordat je dit doet.

Stappen om je integratie opnieuw in te stellen

1. Ga in je Sendcloud account naar Instellingen > Integraties.
2. Zoek je integratie in de lijst en klik op Loskoppelen.
3. Installeer de integratie opnieuw door de installatiehandleiding voor jouw platform te volgen. Je vindt alle installatiehandleidingen in het gedeelte Integraties in het Helpcentrum.
4. Ga na het opnieuw verbinden naar Instellingen > Integraties > Configureren en maak de verwijderde verzendregels opnieuw aan.

Controleer eerst of je Sendcloud account volledig is ingesteld voordat je de instellingen van je webshop bekijkt. Een onvolledig account kan een nieuwe verbinding stilletjes blokkeren. Bekijk de accountinstellingen bovenaan dit artikel eerst.

Als je account correct is ingesteld, doorloop dan het volgende:

Je webshop is niet openbaar toegankelijk
Sendcloud moet je webshop via internet kunnen bereiken om een verbinding tot stand te brengen. Als je shop in onderhoudsmodus staat, achter een wachtwoord zit of nog niet gepubliceerd is, mislukt de verbinding. Zorg dat je shop live en openbaar toegankelijk is voordat je hem koppelt.

Je SSL certificaat is ongeldig of verlopen
Zelfs als je shop correct laadt in een browser, blokkeert een ongeldig SSL certificaat de API calls van Sendcloud. Controleer of je certificaat geldig en correct geconfigureerd is bij je hostingprovider.

Een plugin of app van een derde partij veroorzaakt een conflict
Beveiligingsplugins, cachingplugins en checkout extensies zijn de meest voorkomende oorzaken van verbindingsconflicten. Om de oorzaak te achterhalen, schakel je je extra plugins één voor één uit, te beginnen met beveiligings-, firewall- of cachingplugins, en probeer na elke uitschakeling opnieuw verbinding te maken. Zodra de verbinding slaagt, heb je het conflict gevonden.

De IP adressen van Sendcloud worden geblokkeerd
Als je server of hostingomgeving een firewall of IP allowlist gebruikt, kan het zijn dat Sendcloud wordt geblokkeerd. Voeg de IP adressen van Sendcloud toe aan je allowlist: 

De volledige lijst wordt ook bijgehouden en bijgewerkt op: https://cdn.sendcloud.com/global-media/public-ips.txt 
Als je webshop gebruikmaakt van Cloudflare, kunnen de beveiligingsinstellingen Sendcloud ook blokkeren. Lees onze speciale handleiding: Problemen met Cloudflare dat Sendcloud blokkeert oplossen.

Een cachingproxy blokkeert API calls
Als je een cachingproxy gebruikt, zorg er dan voor dat deze de API calls van Sendcloud niet blokkeert of cachet. Vraag je ontwikkelaar om de cache instellingen te controleren en te bevestigen dat het Sendcloud domein niet wordt geblokkeerd.

Controleer het logboek met mislukte aanvragen
Ga naar Instellingen > Integraties > Logboek mislukte aanvragen in je Sendcloud account. Verbindingsfouten worden hier gelogd met een omschrijving. Deel de foutmelding met je hostingprovider of ontwikkelaar als je hulp nodig hebt bij het interpreteren ervan.

Als je integratie werkte en plotseling is gestopt zonder dat je duidelijke wijzigingen hebt aangebracht, ligt de oorzaak bijna altijd bij iets dat is veranderd aan de kant van je webshop of aan de kant van Sendcloud. Doorloop het volgende voordat je contact opneemt met de ondersteuning.

Controleer eerst of het een Sendcloud probleem is
Voordat je tijd besteedt aan het oplossen van problemen met je webshopinstellingen, controleer je de statuspagina van Sendcloud. Als er een actief incident is dat integraties beïnvloedt, kan het zijn dat je probleem vanzelf wordt opgelost zodra het is verholpen, jij hoeft dan niets te doen.

Bedenk wat er recentelijk is veranderd
De overgrote meerderheid van plotselinge integratiestoringen wordt veroorzaakt door een wijziging, zelfs een die niets met Sendcloud te maken lijkt te hebben. Vraag jezelf af:

• Heb je je webshopplatform, thema of plugins recentelijk bijgewerkt?
• Heb je de Sendcloud plugin of app in je webshop bijgewerkt?
• Heeft je hostingprovider je server gemigreerd of een configuratie gewijzigd?
• Is het domein of de URL van je shop gewijzigd?
• Heb je API sleutels opnieuw gegenereerd of wachtwoorden gewijzigd in het beheergedeelte van je webshop?
• Heb je een nieuwe beveiligingsplugin geïnstalleerd of een firewallregel ingeschakeld?

Als een van deze zaken van toepassing is, is die wijziging waarschijnlijk de oorzaak. Controleer het logboek met mislukte aanvragen (zie het gedeelte hierboven) voor de fout die rond diezelfde tijd is verschenen.

Controleer of je Sendcloud plugin up-to-date is
Een verouderde versie van de Sendcloud plugin in je webshop is een veelvoorkomende oorzaak van plotselinge storingen, met name na een platformupdate. Ga naar het plugin of app gedeelte van je webshop en bevestig dat je de nieuwste versie van de Sendcloud integratie gebruikt.

Controleer of je API inloggegevens nog geldig zijn
Als API sleutels of tokens in je webshop opnieuw zijn gegenereerd, zelfs automatisch, verbreekt de verbinding met Sendcloud onmiddellijk. Ga naar Instellingen > Integraties > Configureren in je Sendcloud account en controleer de inloggegevens. Als ze verouderd lijken, koppel de integratie opnieuw met de nieuwe sleutels.

Controleer het logboek met mislukte aanvragen
Ga naar Instellingen > Integraties > Logboek mislukte aanvragen en zoek naar het moment waarop de fouten zijn begonnen. De foutcode en omschrijving vertellen je wat er is veranderd. Koppel dit aan het relevante gedeelte in dit artikel.

Doorloop de volgende controles in volgorde voordat je contact opneemt met de ondersteuning.

Nieuwe bestellingen kunnen tot 4 minuten nodig hebben om te verschijnen
Sendcloud haalt nieuwe bestellingen ongeveer elke 4 minuten op. Als je net een testbestelling hebt geplaatst en deze nog niet zichtbaar is, wacht dan een paar minuten en vernieuw de pagina voordat je ervan uitgaat dat er iets misgaat.

Controleer het datumfilter in Sendcloud
Standaard toont de weergave van binnenkomende bestellingen bestellingen van de afgelopen 7 dagen. Als je naar oudere bestellingen zoekt, open dan het datumfilter en stel een ruimere periode in. Dit is de meest voorkomende reden waarom bestellingen 'ontbreken'.

Bestellingen ouder dan 30 dagen worden niet geïmporteerd
Wanneer je je webshop voor het eerst koppelt, importeert Sendcloud alleen bestellingen van de afgelopen 30 dagen. Bestellingen van vóór die periode worden niet automatisch weergegeven. Als je oudere bestellingen wilt importeren, neem dan contact op met de ondersteuning vanuit je Sendcloud account.

Controleer of je integratie nog verbonden is
Ga naar Instellingen > Integraties en bevestig dat je shop wordt vermeld onder gekoppelde integraties. Als dat niet het geval is, is de verbinding verbroken en moet deze opnieuw worden ingesteld. Zie het gedeelte hieronder over het opnieuw instellen van je integratie.

Controleer het logboek met mislukte aanvragen
Ga naar Instellingen > Integraties > Logboek mislukte aanvragen. Als er fouten worden vermeld, noteer dan de foutmelding, dit is de snelste manier om te achterhalen wat er misgaat. Geef de fout door aan je hostingprovider of ontwikkelaar indien nodig.

Een plugin stuurt mogelijk onvolledige bestelgegevens
Sommige plugins wijzigen of verwijderen bestelgegevens voordat deze Sendcloud bereiken, waardoor bestellingen stil worden overgeslagen. Schakel extra plugins één voor één uit om te achterhalen of een ervan interfereert. Producten die als virtueel zijn gemarkeerd in je webshop kunnen er ook voor zorgen dat bestellingen worden overgeslagen.

Je webshop is mogelijk niet openbaar toegankelijk
Als je shop in onderhoudsmodus is gegaan of de verbinding onbereikbaar is geworden, stoppen bestellingen met importeren. Controleer of je shop live en bereikbaar is vanaf internet.

Wanneer je een label aanmaakt in Sendcloud, stuurt de integratie automatisch het trackingnummer en de bijgewerkte bestelstatus terug naar je webshop. Als dit niet gebeurt, controleer dan het volgende.

Controleer of je integratie nog verbonden is
Feedback kan alleen worden verstuurd als de verbinding tussen Sendcloud en je webshop actief is. Ga naar Instellingen > Integraties en bevestig dat je shop wordt weergegeven onder gekoppelde integraties. Als de verbinding is verbroken, worden trackingupdates voor tussendoor verzonden bestellingen niet met terugwerkende kracht verstuurd, je moet die bestellingen handmatig bijwerken in je webshop.

Controleer het logboek met mislukte aanvragen
Ga naar Instellingen > Integraties > Logboek mislukte aanvragen. Als Sendcloud heeft geprobeerd feedback te sturen maar dit is mislukt, wordt de fout hier geregistreerd met een omschrijving. Dit is de snelste manier om te bevestigen of er überhaupt een poging is gedaan om feedback te sturen.

Controleer wanneer het label is aangemaakt
Feedback wordt verstuurd op het moment dat het label in Sendcloud wordt aangemaakt. Als het label is aangemaakt terwijl de integratie was losgekoppeld, is er geen feedback verstuurd voor die bestelling. Werk de bestelstatus in die gevallen handmatig bij in je webshop.

De feedback kan vertraagd zijn in plaats van ontbrekend
Als je een groot aantal bestellingen tegelijk verwerkt, kan je webshopplatform de binnenkomende updates van Sendcloud beperken, wat een korte vertraging veroorzaakt voordat statussen en trackingnummers verschijnen. Wacht een paar minuten voordat je ervan uitgaat dat de feedback volledig is mislukt.

Dit zijn de meest voorkomende authenticatiegerelateerde problemen bij alle integraties. Ze lijken op elkaar maar hebben verschillende oorzaken.

401, Sendcloud kan niet authenticeren bij je webshop
Dit betekent dat Sendcloud wordt geweigerd omdat de inloggegevens die het gebruikt ongeldig of verlopen zijn. De meest voorkomende oorzaken zijn:

• De API sleutels die zijn gebruikt om je integratie te koppelen, zijn verlopen of opnieuw gegenereerd in je webshop zonder dat ze in Sendcloud zijn bijgewerkt.
• Je Sendcloud account heeft geen actieve betaalmethode. Ga naar Instellingen > Financieel en zorg dat een betaalmethode actief is, een onvolledige facturatieconfiguratie kan authenticatie blokkeren.

Om een 401 fout te verhelpen, genereer je je API sleutels opnieuw in je webshop en voer je ze opnieuw in bij Sendcloud via Instellingen > Integraties > Configureren. Als dat niet werkt, koppel de integratie los en installeer hem opnieuw om een nieuwe verbinding tot stand te brengen.

403, Sendcloud wordt actief geblokkeerd
Dit betekent dat je server of een beveiligingslaag ervoor de aanvragen van Sendcloud volledig weigert. De meest voorkomende oorzaken zijn:

• De IP adressen van Sendcloud worden geblokkeerd door de firewall of hostingomgeving van je server. Voeg ze toe aan je allowlist, de volledige lijst staat op https://cdn.sendcloud.com/global-media/public-ips.txt.
• Cloudflare blokkeert de aanvragen van Sendcloud via de Bot Fight Mode of WAF regels. Lees onze speciale handleiding: Problemen met Cloudflare dat Sendcloud blokkeert oplossen.
• Voor Shopify: het OAuth token dat tijdens de installatie is gebruikt, is verlopen of de app machtigingen zijn gewijzigd. De Sendcloud app opnieuw installeren in Shopify genereert een nieuw token en lost dit op.

Controleer eerst het logboek met mislukte aanvragen
Ga naar Instellingen > Integraties > Logboek mislukte aanvragen. Een 401 fout verschijnt als orders.apis.base.exceptions.AuthenticationError. Een 403 fout verschijnt als orders.apis.base.exceptions.AccessDenied of een generieke 'verboden' fout. Het logboek vertelt je met welk type je te maken hebt voordat je actie onderneemt.

Het logboek met mislukte aanvragen is je eerste stap bij elk integratieprobleem. Het registreert elke keer dat Sendcloud heeft geprobeerd te communiceren met je webshop maar dit is mislukt, of dat nu gaat om het ophalen van bestellingen, het sturen van trackingfeedback of het controleren van de verbinding. Als er iets misgaat met je integratie, staat de reden hier vrijwel altijd in.

Hoe je het vindt
Ga naar Instellingen > Integraties in je Sendcloud account. Zoek je integratie in de lijst en klik op Bekijken > logboek verbindingsproblemen (of Logboek mislukte aanvragen, afhankelijk van je integratietype).

Wat je ziet
Elke vermelding toont de datum en tijd van de mislukte aanvraag, de foutcode en een omschrijving van wat er is misgegaan. De meest recente fouten staan bovenaan. Belangrijke dingen om op te letten:

• De foutcode (401, 403, 404, 500, enz.) geeft de categorie van het probleem aan. Gebruik het gedeelte hierboven over 401 en 403 fouten, of de relevante platformprobleemoplosser onderaan dit artikel, om de code te koppelen aan een oplossing.
• De foutomschrijving noemt vaak de exacte oorzaak, bijvoorbeeld: orders.apis.base.exceptions.AuthenticationError of orders.apis.base.exceptions.NotFoundError. Kopieer deze tekst wanneer je contact opneemt met de ondersteuning, want dit versnelt de diagnose aanzienlijk.
• De tijdstempel vertelt je wanneer het probleem is begonnen. Als fouten op een specifiek moment beginnen, bedenk dan wat er rond die tijd is veranderd, een plugin update, een servermigratie, een wachtwoordwijziging of een WooCommerce update zijn veelvoorkomende triggers.

Als het logboek leeg is
Een leeg logboek betekent niet altijd dat alles werkt. Het kan betekenen dat Sendcloud je webshop helemaal niet bereikt, de aanvraag komt niet eens door om een fout te genereren. Als je bestellingen zijn gestopt met importeren en het logboek leeg is, ga dan terug naar de verbindingschecklist hierboven en controleer of je webshop openbaar toegankelijk is en of de IP adressen van Sendcloud niet zijn geblokkeerd.

Wat je met de fout doet
De meeste fouten in het logboek zijn oplosbaar, koppel de foutcode aan het relevante gedeelte in dit artikel of in de probleemoplosser van je platform. Als je de relevante stappen hebt doorlopen en de fout aanhoudt, open dan een ondersteuningsverzoek vanuit je Sendcloud account en voeg een screenshot van de logvermelding en de exacte fouttekst toe. Dit is het meest waardevolle dat je aan de ondersteuning kunt aanleveren.