Versandetiketten (DHL, shipcloud, Sendcloud)

Händler verbinden ihre Versanddienste unter Einstellungen → Versand → Versandetiketten (Inhaber/Admin). Die Zugangsdaten liegen verschlüsselt im Shop (AES-256-GCM, Schlüssel aus dem COOKIE_SECRET des Shops) und gelten sofort – kein Neustart.

#So läuft ein Etikett

Bestellung → „Versandetikett erstellen“ (Versanddienst, Versandart, Gewicht, Maße)
  ├─ Etikett beim Versanddienst kaufen, PDF speichern (druckbar bis zur Zustellung)
  ├─ Sendung „gepackt“ anlegen  → bis zum Versand stornierbar
  ├─ erster Scan des Versanddienstes (oder „Jetzt als versendet melden“)
  │     → „versendet“ + Versandbestätigung mit Sendungsnummer an die Kund:in
  ├─ „In Zustellung“  → Mail „Dein Paket kommt heute“
  ├─ „Achtung“        → Mail „Zustellproblem / zur Abholung“
  └─ „Zugestellt“     → Sendung zugestellt + Mail „Paket zugestellt“

• Gewicht = Produktgewichte + Verpackung (Einstellungen → Versand → Gewicht), im Dialog änderbar.
• Sendungsverfolgung: DHL per Abfrage (vormittags alle 30 Minuten, sonst alle 3 Stunden), shipcloud und Sendcloud per Webhook plus Abfrage.
• Kundenmails schickt der Shop nur, wenn „Der Versanddienst benachrichtigt meine Kund:innen selbst“ aus ist. Ist es an, bekommt der Versanddienst die E-Mail-Adresse und benachrichtigt selbst. Jede Mail lässt sich unter Einstellungen → Benachrichtigungen bearbeiten oder abschalten.
• Test-Etiketten (Sandbox) haben in der Bestellung „Test: Status simulieren“ – das spielt den echten Ablauf durch, inklusive Mails.
• Zoll: Sendungen außerhalb der EU bekommen eine Zollinhaltserklärung aus den Produktdaten (Zolltarifnummer, Herkunftsland, Wert).

#DHL – Sandbox

1. Kostenlos registrieren auf developer.dhl.com.
2. My Apps → Create App, die APIs „Parcel DE Shipping (Post & Parcel Germany)“ und „Shipment Tracking – Unified“ hinzufügen. Der Sandbox-Zugang ist sofort freigeschaltet. API Key und API Secret kopieren.
3. Im Shop-Dashboard DHL verbinden, Sandbox anhaken, API Key und Secret eintragen. Benutzer, Passwort und EKP des öffentlichen DHL-Testzugangs setzen wir automatisch.
4. In einer Bestellung ein Etikett erstellen: Du bekommst ein DHL-Testetikett (nicht versandfähig). Die Sandbox hat keine Sendungsverfolgung → „Status simulieren“.

#DHL – Live

1. DHL-Geschäftskundenvertrag (Paket, etwa ab 200 Sendungen im Jahr) → Zugang zum Post & DHL Geschäftskundenportal.
2. Im Portal einen Systembenutzer für die API anlegen (Benutzerverwaltung – besser als das persönliche Login) und die EKP (10-stellige Kundennummer) sowie die Teilnahmen deiner Produkte notieren (meist 01).
3. developer.dhl.com → deine App → Produktionszugang für „Parcel DE Shipping“ beantragen (DHL gibt ihn meist innerhalb weniger Tage frei). Tracking – Unified erlaubt im kostenlosen Plan 250 Abfragen am Tag (mehr auf Anfrage).
4. Im Shop-Dashboard Zugangsdaten ändern → Sandbox aus, API Key/Secret, Systembenutzer und Passwort, EKP. Abweichende Teilnahmen unter „Teilnahmen“.

Abrechnungsnummer = EKP + Verfahren + Teilnahme (14 Ziffern). Es funktionieren nur Produkte aus deinem Vertrag.

#shipcloud – Sandbox

1. Konto bei shipcloud.
2. Einstellungen → API: shipcloud gibt einen Sandbox-Schlüssel und einen Live-Schlüssel.
3. Im Shop-Dashboard shipcloud verbinden, „Sandbox-Schlüssel“ anhaken. Die Versanddienste (DHL, DPD, GLS, Hermes, UPS …) kommen aus deinem shipcloud-Konto. Sandbox-Etiketten gehen nicht an die Versanddienste und haben keine Sendungsverfolgung → „Status simulieren“.

#shipcloud – Live

1. In shipcloud einen Tarif buchen und Versanddienste verbinden (eigene Verträge unter Versanddienstleister oder die Preise von shipcloud).
2. Mit dem Live-Schlüssel neu verbinden, „Sandbox-Schlüssel“ aus. Den Webhook für die Sendungsverfolgung richten wir automatisch ein.

#Sendcloud – Test

Sendcloud hat keine Sandbox.

1. Konto bei Sendcloud.
2. Einstellungen → Integrationen → Sendcloud API → Verbinden: Namen vergeben, Public Key und Secret Key kopieren, Webhook-Feedback aktivieren und die Webhook-URL aus dem Shop-Dashboard (Einstellungen → Versand → Sendcloud) eintragen.
3. Im Shop-Dashboard Sendcloud verbinden.
4. Testen mit der Versandart „Unfrankierter Brief“ (kostenlose Testetiketten) oder bezahlte Etiketten gleich wieder stornieren.

#Sendcloud – Live

Versanddienste in Sendcloud aktivieren (Sendcloud-Preise mit Zahlungsmethode oder eigene Verträge) – sie erscheinen automatisch im Etiketten-Dialog des Shops.