Sendcloud koppeling met je webshop en ERP: labels, douane en tracking terug

Wat is Sendcloud en wie gebruikt het?

Sendcloud is een verzendplatform voor webshops. Je maakt er labels voor meer dan 170 vervoerders, met de tarieven van Sendcloud of met je eigen contract, en je regelt er afhaalpunten, retouren en track en trace mee. Voor Shopify, WooCommerce en andere platformen heeft Sendcloud kant-en-klare koppelingen die orders ophalen en de tracking terugzetten.

Een eigen koppeling verbindt Sendcloud met wat daarbuiten ligt: orders die uit het ERP komen, een levering die na verzending in het ERP geboekt wordt, en zendingen buiten de EU waarvoor de douanegegevens alleen in het ERP staan. Sendcloud is dan de plek waar het label ontstaat; de orders, artikelen en boekingen liggen in de systemen eromheen.

Wat je met Sendcloud koppelt

Er zijn twee manieren om tot een label te komen. Met de Orders API zet je orders in Sendcloud, waarna iemand in Sendcloud of de koppeling via Ship an Order het label maakt. Met de Shipments API maak en meld je de zending direct aan, zonder order in Sendcloud; dat past als het ERP of magazijn al weet welk pakket weggaat. Een order aanmaken maakt geen zending, geen label en geen aanmelding bij de vervoerder.

Hoe Sendcloud data vrijgeeft

API v3, met v2 in onderhoudsmodus

Sendcloud heeft twee API-versies. API v3 is de actuele. API v2 gaat sinds april 2026 in onderhoudsmodus: bestaande koppelingen op accounts van voor april 2026 blijven werken, maar krijgen geen nieuwe functies, en het aanmaken van pakketten via v2 is gesloten voor nieuwe gebruikers. Een koppeling op v2 is dus niet kapot, maar elke uitbreiding wordt een migratie naar v3.

Inloggen met een sleutelpaar of OAuth2

Een API-koppeling in Sendcloud krijgt een publieke en een geheime sleutel. Daarmee log je in met basic authentication, of je haalt er een OAuth2-token mee op met de client credentials flow. Zo'n token is 3.599 seconden geldig, ongeveer een uur, en de koppeling haalt kort voor het verlopen een nieuwe. In de instellingen van de koppeling in Sendcloud kun je OAuth2 verplicht maken.

De limieten van Sendcloud

Boven de limiet volgt HTTP 429. De bron is de pagina rate limits van Sendcloud.

De schrijflimiet is de krappe. De rekensom voor een drukke dag met 1.200 orders: één order per aanroep zijn 1.200 aanroepen, bij 100 per minuut 12 minuten volle belasting, en dan is er nog geen label gemaakt. In batches van 100 zijn het 12 aanroepen. De labels via Ship an Order asynchroon in groepen van 20 zijn 1.200 / 20 = 60 aanroepen. Samen 72 schrijfverzoeken in plaats van 2.400 als je elke order en elk label los zou doen.

Webhooks per koppeling

Sendcloud stuurt een webhook bij elke statuswijziging van een pakket, maar alleen voor pakketten die via die koppeling zijn aangemaakt. Heb je meerdere koppelingen in Sendcloud, dan heeft elke koppeling een eigen webhookadres. Elk bericht is ondertekend: de koppeling berekent een HMAC-SHA256 over de ruwe body met de geheime sleutel en vergelijkt die met de header Sendcloud-Signature. Mislukt de aflevering, dan volgen tot 10 nieuwe pogingen met pauzes van 5 minuten oplopend tot 1 uur. Berichten kunnen in de verkeerde volgorde komen; het veld timestamp bepaalt welke status de laatste is. Zie wat is een webhook.

Waar het bij Sendcloud op vastloopt

Adresvelden met een lengte per vervoerder

Het adresobject van de API noemt geen maximale lengtes; de vervoerders hebben ze wel. Sendcloud publiceert ze per vervoerder, in tekens:

Een B2B-klant met een lange bedrijfsnaam past bij GLS in 30 tekens niet en bij PostNL in 35 niet. Welke vervoerder het wordt, beslist vaak een verzendregel in Sendcloud, dus de koppeling controleert de lengtes tegen de strengste vervoerder die de regel kan kiezen en zet een te lang veld op de controlelijst, met het voorstel erbij. Het adres zelf heeft address_line_1, house_number en address_line_2, en geen veld voor de toevoeging. Hoe 12 A op het label komt, leggen we per vervoerder vast met een testlabel. Zie adresvelden mappen.

Douanegegevens die de webshop niet heeft

Voor een zending buiten de EU vraagt Sendcloud per artikel een omschrijving, aantal, gewicht, prijs, hs_code en origin_country als ISO-landcode, plus een blok customs_information. Zonder dat blok wordt de zending geweigerd. Voor Australië, Canada, Italië, de VS en Vietnam is ook de provinciecode verplicht, met landprefix: US-NY, niet NY. Alle prijzen in een zending moeten in dezelfde valuta staan, en Sendcloud rekent niets om.

De webshop kent de goederencode en het herkomstland meestal niet; het ERP wel, als veld op het artikel. De koppeling haalt ze daar op, zet Duitsland om naar DE en controleert voor de aanmelding of elk artikel in de zending ze heeft. Een artikel zonder goederencode komt op de controlelijst in plaats van bij de douane.

Orders die er nog niet zijn

De Orders API slaat orders asynchroon op. Een 201 betekent dat het verzoek is aangenomen, niet dat de order al bestaat. Wie direct daarna een label vraagt, kan "order not found" terugkrijgen. Een batch is alles of niets: één fout adres in 100 orders en geen enkele order wordt opgeslagen; de fout wijst met source.pointer naar de positie in de lijst. De koppeling haalt die order eruit en stuurt de andere 99 opnieuw.

Twee kleinere dingen. Orders worden gematcht op order_id plus het id van de koppeling, en order_id kan daarna niet meer veranderen. Het eigen id van Sendcloud komt terug als getal, maar moet in een verzoek als tekst mee: "669", niet 669.

Platformen die we aan Sendcloud koppelen

De koppeling wordt gebouwd op jouw combinatie van webshop, ERP en Sendcloud-account, met jouw verzendregels en vervoerders. De platformen staan op Shopify koppeling, WooCommerce koppeling en Magento koppeling. Aan de ERP-kant: Exact Online koppeling, Business Central koppeling en AFAS webshop koppeling. Besteed je het magazijn uit, dan staat dat op Monta koppeling. Het overzicht van de orderstroom staat op orders, klanten en verzending, alle stromen op koppelingen.

Wij bouwen de koppeling voor een vaste prijs, en hosten, draaien en bewaken hem daarna voor een vast bedrag per maand. Voor de livegang draait hij als dry run: je ziet per order welk adres, welke douaneregels en welke vervoerder naar Sendcloud zouden gaan, zonder dat er een label wordt gemaakt. Vertel waar je orders vandaan komen en waar je naartoe verzendt, dan hoor je welke gegevens de koppeling uit welk systeem haalt.