Sendcloud.
Op maat.

Waarom SendCloud koppelen?

SendCloud is een shipping-platform dat als tussenlaag fungeert tussen je webshop en de vervoerders. In plaats van aparte koppelingen te bouwen met PostNL, DPD, GLS, DHL en andere carriers, koppel je eenmalig aan SendCloud en krijg je toegang tot al die vervoerders via een enkele API. Dat maakt SendCloud bijzonder populair bij e-commercebedrijven die flexibiliteit willen in hun verzendstrategie.

Maar de standaard SendCloud-integraties via plugins zijn vaak beperkt. Ze werken prima voor simpele scenario's, maar zodra je maatwerksoftware gebruikt — een eigen ordersysteem, een custom checkout of een specifieke fulfillment-workflow — heb je een directe API-koppeling nodig die aansluit op jouw processen.

Eén koppeling, alle vervoerders. Dat is de kracht van SendCloud: je hoeft niet voor elke carrier een aparte integratie te bouwen.

Wat kun je doen met de SendCloud API?

De SendCloud API biedt een breed scala aan functionaliteit voor het automatiseren van je verzendproces:

• Multi-carrier labels — Verzendlabels genereren voor elke vervoerder die je in SendCloud hebt geconfigureerd. Eenzelfde API-call, ongeacht of het pakket via PostNL, DPD, GLS of een andere carrier gaat.
• Shipping rules — Automatische regels instellen die bepalen welke vervoerder en dienst wordt gebruikt op basis van gewicht, bestemming, orderwaarde of andere criteria. Zo gaan zware pakketten automatisch via de ene carrier en brievenbuspakketten via de andere.
• Parcels & tracking — Zendingen aanmaken, labels ophalen en de volledige trackinghistorie per pakket opvragen. SendCloud aggregeert de tracking van alle carriers in een uniform formaat.
• Service points — Afhaalpunten van alle carriers opvragen zodat je klanten een pickup-locatie kunnen kiezen, ongeacht de uiteindelijke vervoerder.
• Retourportaal — Een branded retourflow aanbieden waarbij klanten zelf een retour aanmelden, een retourlabel ontvangen en het pakket inleveren bij een servicepunt.
• Webhooks — Real-time notificaties ontvangen bij statuswijzigingen van zendingen, zodat je systeem altijd up-to-date is.

Hoe werkt de koppeling?

De koppeling communiceert via een beveiligde verbinding met SendCloud. Er is een testomgeving beschikbaar zodat alles grondig getest kan worden voordat het live gaat; zonder kosten.

In de praktijk werkt het als volgt: zodra een bestelling klaarstaat voor verzending, worden de ordergegevens automatisch naar SendCloud gestuurd. Op basis van de ingestelde verzendregels wordt de juiste vervoerder en dienst gekozen. Het label wordt gegenereerd, het trackingnummer verschijnt in je ordersysteem en de klant ontvangt automatisch een trackinglink.

De webhook-integratie is bijzonder waardevol. In plaats van periodiek de status van elke zending te pollen, ontvang je automatisch een bericht wanneer de status wijzigt. Van “label aangemaakt” tot “in transit” en “afgeleverd” — elk event komt binnen als webhook die je in je systeem kunt verwerken. Zo kun je klanten proactief informeren en interne processen triggeren.

Belangrijk: SendCloud kan bij netwerkstoringen dezelfde statusmelding meerdere keren versturen. De koppeling die wij bouwen houdt hier rekening mee en voorkomt dat dezelfde actie dubbel wordt uitgevoerd.

Hoe Coding Agency dit implementeert

Wij bouwen SendCloud koppelingen voor bedrijven die meer nodig hebben dan een standaard plugin. Denk aan een maatwerk ordersysteem dat automatisch de juiste vervoerder selecteert op basis van complexe businesslogica, een custom checkout met verzendopties en servicepunten, of een fulfillment-dashboard dat labels in bulk genereert voor het magazijnteam.

De koppeling wordt gebouwd met robuuste achtergrondverwerking. Labels worden via een queue gegenereerd zodat het bestelproces niet blokkeert, zelfs niet bij honderden orders tegelijk. Webhooks worden betrouwbaar verwerkt met retry-mechanismen en logging. En het retourproces wordt geïntegreerd in je klantenportaal zodat retouren gestroomlijnd verlopen.

De echte winst van een verzendkoppeling zit niet in het label zelf; het zit in de uren die je bespaart en de fouten die je voorkomt.

Het voordeel van SendCloud als tussenlaag is dat je vervoerders kunt wisselen of toevoegen zonder je code aan te passen. Wil je naast PostNL ook DHL aanbieden? Configureer het in SendCloud en je bestaande koppeling werkt direct met de nieuwe carrier. Die flexibiliteit bouwen we in, zodat je verzendstrategie mee kan groeien met je bedrijf.

Authenticatie: public key en secret key

De Sendcloud API v2 werkt met een public key en een secret key die je aanmaakt in je Sendcloud-account. De authenticatie verloopt via HTTP Basic Authentication: de public key fungeert als gebruikersnaam en de secret key als wachtwoord. Er is dus geen OAuth2-flow met access tokens die na verloop van tijd verlopen.

Dat maakt de koppeling in de basis eenvoudiger dan een OAuth2-integratie, maar het legt de verantwoordelijkheid voor de sleutels volledig bij jou. De secret key hoort uitsluitend aan de serverkant te staan — nooit in front-endcode of een openbaar toegankelijke plek. Behandel hem zoals je een wachtwoord behandelt.

Bij Sendcloud vervalt je toegang niet vanzelf zoals bij OAuth. Precies daarom is het bewaken en veilig opslaan van je secret key des te belangrijker.

Volgens de eigen documentatie koppelt Sendcloud aan meer dan 170 vervoerders, waaronder PostNL, DPD, DHL, GLS en UPS. Je configureert ze één keer in Sendcloud en verstuurt daarna met allemaal via dezelfde koppeling — zonder per vervoerder een aparte integratie te bouwen en te onderhouden.

Webhooks veilig verwerken: verifieer de signature

Een pakket doorloopt allerlei statussen: aangemaakt, aangeboden bij de vervoerder, onderweg, afgeleverd. Je stelt de webhook in bij de integratie-instellingen in Sendcloud en verwerkt de binnenkomende Parcel Status Changed-events in je applicatie.

Belangrijk daarbij: Sendcloud ondertekent de webhook-berichten met een signature op basis van je secret key. Verifieer die HMAC-signature altijd voordat je de data verwerkt, zodat je zeker weet dat het bericht echt van Sendcloud komt en niet van een kwaadwillende die je endpoint kent. Zonder die controle accepteer je in theorie berichten van iedereen die het adres van je webhook kent.

Sendcloud doorkoppelen naar je andere systemen

Een verzendkoppeling staat zelden op zichzelf; de echte winst zit in het doorkoppelen. Verzendstatussen die terugkomen uit Sendcloud kun je doorzetten naar je klantportaal, je voorraadsysteem en je boekhoudpakket. Zo blijft de hele keten — van order tot bezorging tot factuur — sluitend en zonder dubbel invoerwerk. Verkoop je ook via marketplaces, dan combineer je Sendcloud vaak met een Bol.com koppeling, zodat orders uit meerdere kanalen via hetzelfde verzendproces lopen.

Veelgemaakte fouten bij Sendcloud-koppelingen

Op basis van de verzend- en e-commercekoppelingen die we bouwen, zijn dit de valkuilen die we het vaakst tegenkomen:

• Secret key op de verkeerde plek — de secret key in front-endcode of een repository zetten is een direct beveiligingsrisico. Houd hem strikt serverside.
• Webhook-signature niet verifiëren — zonder controle van de HMAC-signature accepteer je in theorie berichten van iedereen die je endpoint kent.
• Geen idempotente verwerking — webhooks kunnen dubbel binnenkomen. Zonder idempotente afhandeling boek je een statuswijziging per ongeluk twee keer.
• Adresvalidatie overslaan — onjuiste of onvolledige adressen leiden tot mislukte labels en retouren. Valideer adressen voordat je het pakket aanmaakt.
• Rate limits negeren — bij drukte kun je tegen limieten aanlopen. Bouw nette foutafhandeling met retries en wachttijden in.

Mijn kijk op verzendkoppelingen

Verzenden voelt als een detail aan de achterkant van je webshop, maar het is precies waar klanten je op beoordelen. Een verkeerd label, een adres dat niet klopt of een track-and-trace die niet werkt, kost je direct vertrouwen. En op de inpaktafel is elke handmatige stap er één te veel als het volume groeit.

Wat ik na jaren koppelingen bouwen zie: de techniek van Sendcloud is niet het moeilijke deel — de API is helder en het model met public en secret key is prettig eenvoudig. Het verschil zit in de details eromheen. Verwerk je webhooks idempotent? Verifieer je de signature? Weet iemand het als een label mislukt? Een koppeling die op mooie dagen werkt is makkelijk. Een koppeling die ook op Black Friday blijft draaien, vraagt om doordachte foutafhandeling en monitoring.

— Jasper

Bron: Sendcloud Developer Documentation (sendcloud.dev).