KoppelingenSendcloud
Sendcloud API koppelen aan je website.
Met een koppeling op de Sendcloud API gaan orders uit je eigen webshop, ERP of maatwerkplatform rechtstreeks naar Sendcloud, en komen label, trackingnummer en status terug. Zo staat track & trace in het account van je klant en start een retour vanuit dezelfde bestelling.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Sendcloud je oplevert.
Orders zonder export. Elke betaalde order staat klaar in Sendcloud, ook als er voor je platform geen plugin bestaat.
Status op je eigen site. Webhooks van Sendcloud zetten de verzendstatus bij de order, zodat je klant hem in zijn account ziet in plaats van te mailen.
Retour vanuit de bestelling. Een knop bij de order opent het retourportaal van Sendcloud voor precies die zending.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- API v3 op panel.sendcloud.sc/api/v3, in JSON, met orders, zendingen, labels, retouren, servicepunten en tracking
- Authenticatie
- De Public en Secret Key van je API-integratie als Basic-authenticatie, of een OAuth2-token dat een uur geldig is
- Richting
- Beide kanten op
- Verversing
- Per aanroep, en een webhook bij elke statuswijziging van een pakket; 1.000 leesacties en 100 schrijfacties per minuut
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- API v2 is dicht voor nieuwe gebruikers. Sendcloud heeft versie 2 in april 2026 in onderhoudsmodus gezet: hij krijgt geen nieuwe functies meer en nieuwe gebruikers kunnen er niet meer op beginnen. Veel voorbeelden, plugins en handleidingen online gebruiken nog adressen met /api/v2/parcels. Wie daarop bouwt, bouwt op iets wat langzaam verdwijnt. Wij bouwen nieuwe koppelingen op API v3.
- Een testlabel kan geld kosten. Sendcloud heeft twee gratis verzendopties om mee te testen: Unstamped letter voor zendingen en Unstamped letter return voor retouren. De andere manier is een echt label maken en dat binnen de termijn annuleren, maar dat hangt af van de vervoerder. Niet elke vervoerder accepteert een annulering, en een label dat niet te annuleren is, wordt gefactureerd. Wij testen dus met de gratis optie, en pas aan het eind met één echt label.
- Webhooks horen bij één integratie, en komen niet altijd op volgorde. Je krijgt alleen meldingen over pakketten die via die integratie zijn gemaakt. Voor retouren krijg je pas updates als de heenzending ook via de API-integratie liep. Lukt een levering niet, dan probeert Sendcloud het tot 10 keer opnieuw, met een wachttijd die oploopt van 5 minuten tot een uur. Daardoor kan een oude status na een nieuwe binnenkomen. Wij kijken daarom naar het tijdstip in de melding en controleren de handtekening in de header Sendcloud-Signature.
- Schrijven is beperkt tot 100 aanroepen per minuut. Lezen mag 1.000 keer per minuut, maar aanmaken, wijzigen en verwijderen samen 100 keer, met een piek van 15 per seconde. Op een drukke dag met veel orders tegelijk is dat sneller bereikt dan je denkt. Orders kun je met maximaal 100 tegelijk aanbieden, en Sendcloud herkent ze aan je eigen ordernummer, zodat een tweede aanbieding de order bijwerkt in plaats van verdubbelt.
Sendcloud koppelen
Wat je moet weten voor je begint.
Wat is Sendcloud?
Sendcloud is verzendsoftware voor webshops. Je haalt je orders binnen, kiest per order een vervoerder en verzendoptie, en maakt het label. Daarna volgt Sendcloud het pakket en stuurt het je klant berichten over de bezorging. Retouren lopen via een eigen retourportaal.
Het voordeel zit in de laag tussen jou en de vervoerders. Je werkt met één systeem voor meerdere vervoerders, met de tarieven van Sendcloud of met je eigen contract. Verzendregels kiezen automatisch de juiste optie, op basis van voorwaarden die je zelf instelt, zoals de waarde van de order.
Verzend je alleen met PostNL en wil je de labels direct op je eigen contract maken, zonder platform ertussen, dan is een PostNL-koppeling het alternatief.
Hoe de Sendcloud API werkt
De Sendcloud API is REST en spreekt JSON. Versie 3 is de versie waar Sendcloud aan doorbouwt. De sleutels maak je zelf aan in je Sendcloud-account, onder Instellingen en dan Integraties, bij de integratie Sendcloud API. Je krijgt een Public Key en een Secret Key, en die gaan als gebruikersnaam en wachtwoord mee in elke aanroep.
Wie liever met tokens werkt, wisselt dezelfde sleutels in voor een OAuth2-token dat een uur geldig is. Sendcloud raadt aan dat token te bewaren en kort voor het verloopt te vernieuwen, in plaats van per aanroep een nieuw te vragen. In beide gevallen staat de Secret Key alleen op de server.
De integratie in je account bepaalt ook wat de koppeling mag. Zo staat daar een vinkje voor servicepunten en een veld voor het adres waar webhooks naartoe gaan. Heb je meer winkels of kanalen, dan is het vaak overzichtelijker om per kanaal een eigen integratie te maken.
Order, zending en label
Sendcloud maakt onderscheid tussen een order en een zending. De order is de verkoop: wat er is gekocht, door wie en waar het naartoe moet. De zending is hoe het verstuurd wordt: met welke vervoerder, in hoeveel pakketten en met welke regels. Het label hoort bij de zending.
Er zijn twee routes. Bij de eerste zet je koppeling de order in Sendcloud en maakt je team daar de labels, zoals ze gewend zijn met verzendlabels printen vanuit één scherm. Bij de tweede maakt de koppeling direct een zending en vraagt het label op, bijvoorbeeld zodra de order in je ERP op verzendklaar gaat. Dan komt het label terug als PDF, of als PNG of ZPL voor een labelprinter, en print het magazijn het vanuit het eigen systeem.
Welke route past, hangt af van waar je inpakt. Werk je met een magazijnsysteem als Picqer, dan spreken we vooraf af welk systeem het label maakt, anders ontstaan er twee. Besteed je verzending uit aan een fulfilmentpartij als Monta, dan maakt die partij de labels en loopt de order daarheen.
Track & trace op je eigen site
Elke zending krijgt een trackingnummer. Via de webhook Parcel status changed laat Sendcloud je server weten wanneer de status verandert: aangemeld, onderweg, bezorgd of een probleem. Wij zetten die status bij de order in je eigen database.
Daarmee kan je klant in zijn account op je site zien waar zijn pakket is, met de status in jouw woorden en in je eigen opmaak. Dat scheelt de mail met de vraag waar het pakket blijft. Voor wie niet inlogt, sturen we de link mee in de orderbevestiging.
Komt een melding niet aan, dan kun je de status van een pakket ook zelf opvragen op trackingnummer. Wij doen dat als controle voor zendingen die te lang op dezelfde status staan.
Retouren via het retourportaal
Sendcloud heeft een retourportaal waarin je klant zelf een retour aanmeldt en een label krijgt. Via de API vraag je per zending een directe link naar dat portaal op. Die zetten we als knop bij de bestelling in het klantaccount, zodat de klant meteen bij de juiste zending uitkomt.
Er zijn twee voorwaarden. In je Sendcloud-account moet een retourportaal zijn ingericht, en er moet een merk aan de zending hangen. Ontbreekt een van beide, dan geeft de API geen link maar een foutmelding, en dan hoort de knop niet te verschijnen.
Wil je meer regie op retouren, zoals ruilen, terugbetalen per reden of beoordelen voordat er een label komt, dan kijken we naar een retourplatform als Returnista.
Plugin of eigen koppeling
Voor WooCommerce heeft Sendcloud een eigen plugin. Die haalt orders op, voegt een keuze voor servicepunten toe aan de checkout en verzorgt tracking-e-mails en het retourportaal. Sendcloud heeft ook een app voor Shopify. Draai je een standaardwinkel op een van die platforms, dan raden we de plugin aan en heb je geen eigen koppeling nodig.
Een eigen Sendcloud-koppeling is logisch als er geen plugin is: een Next.js-shop, een B2B-portaal, een ERP waaruit de orders komen. Of als de status in je eigen klantomgeving moet staan, met je eigen regels voor wat een klant ziet.
Sendcloud koppelen met WordPress of met maatwerk
Op WordPress met WooCommerce gebruiken we de plugin waar het kan, en vullen we aan waar hij ophoudt: de status in het klantaccount, een retourknop per bestelling, of een eigen keuze van verzendopties. Het adres voor de webhooks staat dan op dezelfde site.
Op een maatwerksite in Next.js of naast een ERP is het een eigen serverroute met een wachtrij. Die biedt orders in porties van maximaal 100 aan, blijft onder de schrijflimiet en verwerkt de webhooks op volgorde van tijdstip.
Koppelingen en maatwerk als dit vallen bij ons onder Design & Development.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Wat zijn de verzendregels van Sendcloud?
Verzendregels in Sendcloud zijn automatische regels die per zending de verzendoptie en instellingen kiezen, op basis van voorwaarden die je zelf instelt, zoals de waarde van de order. Ze worden in een vaste volgorde toegepast, van de eerste tot de laatste. Een koppeling via de Sendcloud API kan zendingen aanmaken waarbij die regels en je standaardinstellingen worden gebruikt, zodat de keuze in Sendcloud blijft liggen.
Waar vind ik de API keys van Sendcloud?
De API keys van Sendcloud maak je aan in je account onder Instellingen en dan Integraties. Daar kies je Sendcloud API, geef je de integratie een naam en sla je op. Je krijgt dan een Public Key en een Secret Key. De Public Key is de gebruikersnaam, de Secret Key het wachtwoord, en die laatste hoort alleen op de server.
Moet ik API v2 of API v3 van Sendcloud gebruiken?
Gebruik API v3 voor een nieuwe koppeling. Sendcloud heeft API v2 in april 2026 in onderhoudsmodus gezet: er komen geen nieuwe functies bij en nieuwe gebruikers kunnen er niet meer mee beginnen. Bestaande koppelingen op v2 werken nog, maar wie nu bouwt of een oude plugin vervangt, kiest v3.
Kan ik de Sendcloud API testen zonder te betalen voor labels?
Ja. Gebruik de verzendoptie Unstamped letter voor zendingen en Unstamped letter return voor retouren; daar worden geen kosten voor gerekend. Een echt label maken en annuleren kan ook, maar niet elke vervoerder accepteert een annulering, en een label dat niet te annuleren is, wordt gefactureerd.
Hoe krijg ik track & trace van Sendcloud op mijn eigen website?
Via webhooks. Sendcloud stuurt bij elke statuswijziging van een pakket een melding naar je server, met de nieuwe status en het tijdstip. Die status zetten we bij de order, zodat je klant hem in zijn account ziet. Omdat meldingen niet altijd op volgorde komen, gebruiken we het tijdstip om de nieuwste te bepalen.
Hoeveel aanvragen mag een Sendcloud-koppeling doen?
Een Sendcloud-koppeling mag 1.000 leesaanvragen per minuut doen en 100 aanvragen die iets aanmaken, wijzigen of verwijderen, met een piek van 15 per seconde. Daarboven volgt een 429. Orders kun je met maximaal 100 tegelijk aanbieden, en dat houdt een drukke dag binnen de limiet.
Kan ik orders vanuit mijn ERP of maatwerkshop naar Sendcloud sturen?
Ja, via de Orders API van Sendcloud. Je biedt orders aan in porties van maximaal 100, en Sendcloud herkent ze aan je eigen ordernummer, zodat een tweede aanbieding de order bijwerkt. Daarna maak je de labels in Sendcloud, of laat je de koppeling direct een zending en label aanmaken.
Werkt Sendcloud met WooCommerce?
Ja. Sendcloud heeft een eigen plugin voor WooCommerce die orders ophaalt, een keuze voor servicepunten in de checkout zet en tracking en retouren regelt. Voor een standaardwinkel is dat genoeg. Een eigen koppeling vanuit WooCommerce is pas nodig als je de status in het klantaccount wilt of afwijkende regels voor verzendopties hebt.
Kan mijn klant vanuit mijn website een retour aanmelden bij Sendcloud?
Ja. Via de API vraag je per zending een directe link naar het retourportaal van Sendcloud op, en die zetten we als knop bij de bestelling. Voorwaarde is dat je retourportaal is ingericht en dat er een merk aan de zending hangt. Zonder die twee geeft de API een foutmelding en tonen we de knop niet.
Kan ik servicepunten van Sendcloud in mijn eigen checkout tonen?
Ja. Sendcloud heeft een API voor servicepunten waarmee je punten van gekozen vervoerders in een gebied opvraagt en controleert of een punt beschikbaar is. Daarvoor zet je in je API-integratie de optie voor servicepunten aan. Op WooCommerce regelt de plugin van Sendcloud dit al in de checkout.
Hoe controleer ik of een webhook echt van Sendcloud komt?
Elke webhook van Sendcloud heeft een handtekening in de header Sendcloud-Signature. Je berekent zelf een HMAC-SHA256 over de ruwe inhoud van het verzoek met je Secret Key, of met de aparte Webhook Signature Key als je integratie die heeft, en vergelijkt die met de header. Gebruik de inhoud precies zoals hij binnenkomt, want na het uitlezen en opnieuw opbouwen klopt de handtekening niet meer.
Let's work together.
Je orders verzonden, en de status op je eigen site.