Waarom koppelen aan Sendcloud?
Kort antwoord
Sendcloud is een Nederlands verzendplatform dat je webshop verbindt met tientallen vervoerders. Een koppeling met Sendcloud automatiseert je verzendproces: bestellingen worden verzendklaar, labels en track-and-trace worden automatisch aangemaakt en statusupdates stromen realtime terug in je eigen software — zonder handmatig labels plakken.
Sendcloud is een van de bekendste verzendplatformen van Nederland en groeide uit tot een standaardkeuze voor webshops in de Benelux. Het bundelt de aansluiting op vervoerders, het aanmaken van labels, track-and-trace en retouren op één plek. Draai je daarnaast een eigen webshop, een ordersysteem of een maatwerkapplicatie, dan wil je verzendorders niet handmatig overtypen in Sendcloud.
Een koppeling met Sendcloud lost dat op. Een betaalde bestelling in je systeem verschijnt automatisch als verzendklaar pakket in Sendcloud. Het label wordt gegenereerd, de klant krijgt track-and-trace en de verzendstatus komt terug in je eigen software. Het resultaat: minder handwerk op de inpaktafel, minder fouten in adressen en labels, en klanten die automatisch op de hoogte blijven.
Wat kun je koppelen?
De Sendcloud API geeft toegang tot de kern van het verzendproces. De meest voorkomende onderdelen van een koppeling:
- Verzendorders (parcels): bestellingen vanuit je webshop of ordersysteem automatisch als pakket aanmaken in Sendcloud, met adres, gewicht en gekozen vervoerder.
- Verzendlabels: labels genereren en ophalen als PDF, klaar om te printen op de inpaktafel of via een labelprinter.
- Vervoerders en verzendmethoden: de beschikbare shipping methods ophalen, zodat je klant bij de checkout de juiste optie ziet (pakket, brievenbus, afhaalpunt).
- Track-and-trace: de tracking-URL en -code teruglezen en tonen in je eigen klantomgeving of e-mails.
- Retouren: retourlabels aanmaken en het retourportaal koppelen aan je eigen retourproces.
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.
Realtime statusupdates met webhooks
Een pakket doorloopt allerlei statussen: aangemaakt, aangeboden bij de vervoerder, onderweg, afgeleverd. Je wilt die veranderingen realtime in je eigen software hebben zonder er constant naar te vragen. Sendcloud ondersteunt daarvoor webhooks: zodra de status van een pakket verandert, stuurt Sendcloud automatisch een bericht naar een door jou opgegeven webhook-URL.
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.
Met webhooks reageert je software direct: een status "afgeleverd" kan een bevestigingsmail triggeren, een status "retour ontvangen" kan je voorraad bijwerken. Een koppeling die alleen op vaste tijden checkt, loopt altijd achter en belast de API onnodig.
Van bestelling tot verzendlabel
In de praktijk ziet een goed opgezette Sendcloud-koppeling er zo uit:
- Order verzendklaar: een betaalde bestelling wordt in je systeem gemarkeerd als klaar om te versturen en als parcel naar Sendcloud gestuurd.
- Vervoerder en methode: op basis van gewicht, bestemming en klantkeuze wordt de juiste verzendmethode meegegeven.
- Label genereren: Sendcloud maakt het label aan; jouw software haalt de PDF op en biedt die aan voor de labelprinter.
- Klant informeren: de track-and-trace-link wordt teruggelezen en in je bevestigings- of verzend-e-mail verwerkt.
- Status volgen: via webhooks houd je de bezorgstatus bij en werk je je administratie en klantcommunicatie automatisch bij.
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 bijvoorbeeld 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
Zo helpt Coding Agency hierbij
Wij bouwen verzend- en e-commercekoppelingen op maat, precies afgestemd op jouw bestelproces. Van een directe koppeling tussen je maatwerk-webshop en Sendcloud tot het doorzetten van verzendstatussen naar je klantportaal en administratie — inclusief signature-verificatie, idempotente webhookverwerking en heldere monitoring. Meer weten over onze API- en koppelingsexpertise? Neem contact op voor een vrijblijvend gesprek.
