Versanddienstleister

Binde DHL, DPD, GLS, UPS oder Hermes direkt an oder nutze ShipCloud, und lege mit Versand-Regeln fest, welcher Anbieter das Label für welchen Mandanten und Frachtführer erstellt.

Unter Versanddienstleister legst du fest, wie die Versandlabel deines Lagers erstellt werden: über ShipCloud oder direkt über die Schnittstellen von DHL, DPD, GLS, UPS oder Hermes. Du hinterlegst die Zugänge der Versanddienstleister – für deine eigene Firma oder für einzelne Mandanten, sodass jeder Mandant mit seinem eigenen Versandvertrag versenden kann – und du legst Versand-Regeln fest. Die Regeln werden ausgewertet, wenn ein Paket am Packplatz abgeschlossen wird und wenn unter Pakete und Tracking ein Label angefordert wird. Ohne Regel wird ShipCloud verwendet.

Screenshot: Seite Versanddienstleister mit der Karte Zugänge oben und der Karte Versand-Regeln darunter

Bevor du startest

Dein Benutzer braucht das Recht Versanddienstleister im Bereich Administration des Rechtebaums. Frag deinen Administrator.
Deine Firma ist der Logistiker. Mandanten können diese Seite nicht öffnen – sie sehen „Versand-Regeln und Zugänge werden beim Logistiker gepflegt. …“.
Du hast die Zugangsdaten aus deinem Vertrag mit dem Versanddienstleister (siehe Tabelle der Pflichtfelder unten).
Für ShipCloud brauchst du keinen Zugang in dieser Liste – ShipCloud nutzt die ShipCloud-Konten unter den Firmen-Einstellungen.
Zugänge bei Versanddienstleistern sind Verbindungen und zählen gegen dein Paket.

Schritt für Schritt

1. Einen Zugang beim Versanddienstleister anlegen

Öffne Administration › Versanddienstleister.
Klicke in der Karte Zugänge auf Neuen Zugang anlegen.
Wähle den Anbieter.
Wähle die Firma, zu der der Zugang gehört: deine eigene Firma (Logistiker) oder einen Mandanten (Mandant).
Trag eine Bemerkung ein, z. B. „Hauptkonto“ oder „Mandant XY“.
Füll die Zugangsdaten des Anbieters aus. Felder mit * sind Pflicht.
Klicke optional auf Zugang testen, um die Anmeldung beim Anbieter zu prüfen.
Klicke auf Zugang speichern. Du siehst „Der Zugang wurde gespeichert.“

Anbieter und Firma lassen sich nach dem Anlegen des Zugangs nicht mehr ändern. Um die Zugangsdaten später zu ändern, klicke in der Zeile des Zugangs auf Bearbeiten. Testen prüft einen vorhandenen Zugang jederzeit.

Screenshot: Dialog „Zugang Versanddienstleister“ mit gewähltem Anbieter DHL, Firmenauswahl, Bemerkung und den DHL-Zugangsdaten

2. Versand-Regeln festlegen

Klicke in der Karte Versand-Regeln auf Regel hinzufügen.
Wähle den Anbieter.
Wähle den Zugang. Zugänge von Mandanten zeigen den Mandantennamen in Klammern; für ShipCloud lässt du „-- kein Zugang --“ stehen.
Wähle den Mandant: „-- alle Mandanten --“ oder einen einzelnen Mandanten.
Trag optional Frachtführer-Kennungen ein.
Setze bei genau einer Regel den Haken Standard – sie gilt, wenn keine andere Regel passt.
Setze den Haken Aktiv und leg die Reihenf. fest.
Wiederhole das für weitere Regeln. Regel entfernen löscht eine Zeile.
Klicke auf Speichern. Regeln werden nur mit dieser Schaltfläche gespeichert: „Die Versand-Regeln wurden gespeichert“.

Screenshot: Tabelle der Versand-Regeln mit drei Regeln – DHL für alle Mandanten mit Kennung „dhl“, GLS für einen Mandanten, ShipCloud als Standard

So wird eine Regel ausgewählt

Wird ein Paket abgeschlossen, nimmt X-Sitter den Namen des Frachtführers: den am Packplatz gewählten Frachtführer oder – bei „Versandart des Auftrags“ – die Versandart des Auftrags. Dann gilt:

Regeln für einen anderen Mandanten oder mit Frachtführer-Kennungen, die im Namen des Frachtführers nicht vorkommen, werden übersprungen.
Eine Regel mit passender Frachtführer-Kennung gewinnt gegen eine Regel ohne Kennung.
Eine Regel für den Mandanten des Auftrags gewinnt gegen eine Regel für alle Mandanten. Eine Regel, die beides erfüllt, gewinnt.
Passt keine Regel, wird die Standard-Regel verwendet.
Gibt es gar keine Regel, wird das Label über ShipCloud erstellt.

Beispiel: Regel A: DHL, alle Mandanten, Kennungen „dhl, warenpost“. Regel B: GLS, Mandant „Shop Miller“. Regel C: ShipCloud, Standard. Ein Auftrag von Shop Miller mit Frachtführer „DHL Warenpost“ passt zu A (Kennung) und B (Mandant). Eine passende Kennung zählt mehr als ein passender Mandant, also wird Regel A verwendet. Soll Shop Miller DHL über sein eigenes Konto versenden, leg Regel D an: DHL, Mandant Shop Miller, Kennung „dhl“, mit dem DHL-Zugang von Shop Miller – sie erfüllt beides und gewinnt. Ein Auftrag eines anderen Mandanten mit Frachtführer „Hermes“ passt weder zu A noch zu B, also greift die Standard-Regel C.

Screenshot: Packplatz beim Abschließen eines Pakets, mit der Auswahl des Frachtführers, die für die Regelauswahl genutzt wird

Felder und Optionen

Versand-Regeln

Feld	Bedeutung
Anbieter	ShipCloud, DHL, DPD, GLS, UPS oder Hermes.
Zugang	Der Zugang beim Versanddienstleister. Für ShipCloud nicht nötig. Zugänge, die eine andere Firma mit dir geteilt hat, sind mit „geteilt“ markiert.
Mandant	„-- alle Mandanten --“ oder ein Mandant.
Frachtführer-Kennungen	Komma-getrennte Begriffe in Kleinschreibung, die im Namen des Frachtführers / der Versandart vorkommen müssen, z. B. `dhl, warenpost`. Leer = gilt für jeden Frachtführer.
Standard	Wird verwendet, wenn keine andere Regel passt.
Aktiv / Reihenf.	Regel ein/aus; Sortierung der Liste.

Pflicht-Zugangsdaten je Anbieter

Jeder Zugang hat einen Modus: Sandbox (Testsystem) oder Live.

Anbieter	Pflichtfelder	Nützliche optionale Felder
DHL	Benutzer und Passwort des Geschäftskundenportals (GKP Benutzer / GKP Passwort), API-Key aus dem DHL Developer Portal, EKP (10-stellige Kundennummer)	Teilnahmenummern je Produkt (Paket, International, Kleinpaket, Retoure, Europaket, Warenpost International), Retoure Receiver-ID (nötig für später erstellte Retourenlabels), Inlandsprodukt, Druckformat, Incoterm
DPD	Delis-ID und Passwort (von DPD für die Web-Service-Anbindung vergeben, nicht dein myDPD-Login), DPD-Plattform (Deutschland oder Niederlande)	DPD-Kundennummer, Produkt, Papierformat, Versanddepot, Predict-Benachrichtigung per E-Mail
GLS	Client-ID, Client Secret, Kontakt-ID (Versender)	Produkt, Labelformat, App-ID für Shop Returns, Incoterm, Zollanmeldung für Sendungen außerhalb der EU
UPS	Client-ID, Client Secret, UPS-Kontonummer (Shipper Number)	Standard-Service, Benachrichtigung per E-Mail, Incoterm
Hermes	Benutzer, Passwort, Client-ID, Client Secret (vom Hermes Business Service)	Produkttyp, Gewichtseinheit, Mandator, Benachrichtigung des Empfängers per E-Mail

Screenshot: Tabelle der Zugänge mit Anbieter, Nummer, Bemerkung, Modus (Sandbox/Live), Firma und den Schaltflächen Testen / Bearbeiten

Sendungen in Länder außerhalb der EU

Für Empfänger außerhalb der EU übermittelt X-Sitter die Zolldaten automatisch (Preis der Auftragsposition, Gewicht, Zolltarifnummer und Ursprungsland aus dem Artikel; ohne Ursprungsland wird DE verwendet).

ShipCloud und DHL liefern ein Zollformular CN23 zurück, UPS eine Handelsrechnung (Commercial Invoice). Das Dokument wird am Packplatz zusammen mit dem Label gedruckt und im Auftrag unter Dokumente gespeichert (siehe Auftragsdokumente).
GLS übermittelt Zolldaten nur, wenn im Zugang die Option für die Zollanmeldung aktiviert ist.
DPD und Hermes unterstützen in X-Sitter keine Sendungen außerhalb der EU – nutze dafür einen anderen Anbieter.

Achte darauf, dass deine Artikel eine Zolltarifnummer und ein Ursprungsland haben.

Gut zu wissen / Fehlerbehebung

Meldung	Ursache	Lösung
„Pflichtfelder fehlen: …“	Zugangsdaten unvollständig.	Füll die genannten Felder aus.
„ShipCloud braucht keinen Zugang in dieser Liste.“	Du hast versucht, einen Zugang für ShipCloud anzulegen.	Pflege ShipCloud unter ShipCloud-Konten.
„Bitte eine Firma wählen“	Für den Zugang wurde kein Eigentümer gewählt.	Wähle deine Firma oder einen Mandanten.
„Regel …: Der Zugang #… passt nicht zum Anbieter oder gehört nicht zu Deinen Firmen.“	Der Zugang gehört zu einem anderen Anbieter oder einer anderen Firma.	Wähle einen passenden Zugang.
„Regel …: Der Mandant #… gehört nicht zu Deinen Firmen.“	Der Mandant ist inaktiv oder nicht deiner.	Wähle einen deiner aktiven Mandanten.
„DHL API Fehler: …“ / „DPD API Fehler: …“ / „GLS API Fehler: …“ / „UPS API Fehler: …“ / „Hermes API Fehler: …“	Der Anbieter hat das Label abgelehnt.	Prüfe Zugangsdaten, Empfängeradresse und Gewicht.
„DPD Login fehlgeschlagen: …“	Falsche Delis-ID oder falsches Passwort.	Korrigiere den Zugang.
„DHL: Keine Receiver-ID für Retouren in der Verbindung hinterlegt.“	Retourenlabel ohne Receiver-ID angefordert.	Trag die Retoure Receiver-ID im DHL-Zugang ein.
„Für den Mandanten … sind keine ShipCloud-Einstellungen hinterlegt (Firma > Einstellungen > ShipCloud).“	Keine Regel hat gegriffen, und der Mandant hat kein ShipCloud-Konto.	Ordne ein ShipCloud-Konto zu oder leg eine Regel an.
„ShipCloud hat keine Trackingnummer zurückgegeben.“	Vorübergehendes Problem bei ShipCloud.	Versuch es noch einmal; siehe Shipcloud API Status.

Alle Verbindungen öffnet Jobs & Verbindungen, wo alle Zugänge als Verbindungen erscheinen (nur mit dem passenden Recht). Das Tracking von Labels über die direkten Schnittstellen wird automatisch aktualisiert, siehe Sendungsverfolgung und Versandlabels.