Sendcloud
Zweck
Diese Anbindung kauft Etiketten über die Versand-Plattform Sendcloud aus dem Versandprozess heraus. Sendcloud ist ein Vermittler: Über ein Konto bucht man bei DHL, DPD, UPS, GLS und weiteren Dienstleistern — welcher es wird, entscheidet die Versandart des Kontos.
Funktionsumfang
- Schnittstelle Version 3 von Sendcloud — Version 2 ist seit April 2026 im Wartungsmodus.
- Etikett anlegen als PDF — im Format A6 für den Etikettendrucker, auf Wunsch A4.
- Versandoption des Kontos wählen: ihr Code (z. B.
dhl:standard) an der Sendung (Feld Versandart)
oder als Vorgabe der Einrichtung. Ohne beides entsteht kein Etikett — geraten wird kein Porto; eine Nummer aus der alten Schnittstelle wird abgewiesen. Steht eine solche Nummer noch als Vorgabe in der Einrichtung, zeigen die Integrationen einen Hinweis darauf, und das Update-Protokoll nennt sie im Schritt „Einrichtung der Plugins prüfen“.
- Altersnachweis: Artikel ab 16 oder 18 Jahren gehen über Sendcloud, wenn die gewählte Versandoption
die Altersprüfung in dieser Stufe enthält (Code mit age_check=18 oder laut Produktauswahl). Sonst lehnt der Versand vor der Buchung mit einer klaren Meldung ab — die Ware bleibt am Lager.
- Zustellorte: Packstation, Postfiliale, Paketshop und Access Point über die Service-Punkt-Kennung
(Nummer bei Sendcloud oder Kennung des Dienstleisters); die DHL-Postnummer geht als Adresszusatz mit.
- Retourenetiketten über die Retouren-Schnittstelle von Sendcloud — Ziel ist die eingerichtete
Absenderadresse — und Zollangaben für Sendungen ins Drittland.
- Storno mit ehrlicher Rückmeldung: vollzogen, vorgemerkt (das Etikett verfällt ungenutzt) oder
abgelehnt mit der Begründung von Sendcloud.
- Sendungsverfolgung mit Statusabgleich.
Einrichtung
Die Zugangsdaten stehen als Integration unter Integrationen — Anbieter sendcloud. Die Schlüssel findet man im Sendcloud-Konto unter Einstellungen → Integrationen.
| Einstellung | Pflicht | Bedeutung |
|---|---|---|
sendcloud_public_key | ja | Öffentlicher API-Schlüssel. Wird verschlüsselt abgelegt und nie wieder angezeigt. |
sendcloud_secret_key | ja | Geheimer API-Schlüssel. Wird verschlüsselt abgelegt und nie wieder angezeigt. |
default_shipping_method | nein | Code der Versandoption (z. B. dhl:standard, aus der Produktauswahl), wenn die Sendung keinen nennt. Eine Nummer der alten Schnittstelle wird abgewiesen. |
sender_address | ja | Nummer der Absenderadresse im Konto. Version 3 verlangt einen Absender; Retouren gehen an diese Adresse. |
label_size | nein | a6 (Standard, Etikettendrucker) oder a4 (Bürodrucker). |
Sendcloud hat keine getrennte Testumgebung: Getestet wird im selben Konto, etwa mit der Versandart „Unstamped letter", die kein Porto kostet. Das Modul ist ab Werk ausgeschaltet und wird unter den Feature-Flags eingeschaltet.
Produktauswahl
Welche Versandoptionen das Konto buchen darf, liefert die Anbindung selbst: GET /v1/carrier-sendcloud/products nennt je Versandoption den Code (code), den Namen, den Dienstleister, das Gewichtsband, ob ein Service-Punkt Pflicht ist, und die Altersstufe (ageCheck: 16, 18 oder leer); optional eingeschränkt auf ein Zielland (toCountry), das dann als Zielland erscheint. Der Code ist genau der Wert, der beim Versand als Versandart an die Sendung geht.
Einstellungen & Rechte
- Die Integration anlegen und die Schlüssel eintragen darf, wer
platform.integration.managehält. - Die Produktauswahl sieht, wer versendet (
shipping.shipment.manage) oder den Versand einrichtet
(shipping.config.manage).
- Den Einrichtungs-Hinweis (
GET /v1/carrier-sendcloud/setup-check) sieht, wer Integrationen
einrichtet (platform.integration.manage) oder den Versand (shipping.config.manage).
- Versendet wird über die Rechte des Versands; eigene Rechte bringt die
Anbindung nicht mit.
Zusammenspiel
Die Anbindung hängt am Versand: dort entsteht die Sendung, dort wird das Etikett gekauft, dort läuft die Sendungsverfolgung. Im Integrations-Hub meldet der Baustein „Versandetikett erzeugen" den Versand über die eigene Schnittstelle an; roher Zugriff auf Sendcloud geht nur über den einen generischen Baustein. Wann welches Etikett entsteht, entscheiden Automationen.
Grenzen
- Der Echt-Lauf steht aus. Geprüft ist, dass richtig gefragt und die Antwort richtig gedeutet
wird — mit vorbereiteten Antworten. Dass Sendcloud die Anfrage annimmt, ist damit nicht belegt.
- Ein Paket je Sendung. Mehrere Pakete werden abgelehnt, nicht still verschluckt.
- Zusatzleistungen wie Unterschrift oder Altersprüfung wählt man bei Sendcloud über die
Versandoption (etwa eine mit ageCheck 18), nicht als eigenen Schalter. Für einen Artikel mit Altersgrenze prüft der Versand vor der Buchung, ob die gewählte Versandoption die Stufe trägt; eine Prüfung ab 18 deckt auch Ware ab 16, umgekehrt nie. Lässt sich das nicht prüfen (Sendcloud nicht erreichbar), wird nicht gebucht.
- Retourenetiketten lassen sich hier nicht stornieren — der Storno sucht die Sendung über die
Sendungsnummer, Retouren führt Sendcloud getrennt.
- Preise kommen nicht von hier — sie stehen im Vertrag mit Sendcloud.