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](/outbound/packing.md) abgeschlossen wird und wenn unter [Pakete und Tracking](/orders/packages-and-tracking.md) ein Label angefordert wird. Ohne Regel wird ShipCloud verwendet.

![Screenshot: Seite Versanddienstleister mit der Karte Zugänge oben und der Karte Versand-Regeln darunter](/administration/images/shipping-providers-overview.png)

## 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](/company/shipcloud-accounts.md) 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

1. Öffne **Administration › Versanddienstleister**.
2. Klicke in der Karte **Zugänge** auf **Neuen Zugang anlegen**.
3. Wähle den **Anbieter**.
4. Wähle die **Firma**, zu der der Zugang gehört: deine eigene Firma (**Logistiker**) oder einen Mandanten (**Mandant**).
5. Trag eine **Bemerkung** ein, z. B. „Hauptkonto“ oder „Mandant XY“.
6. Füll die Zugangsdaten des Anbieters aus. Felder mit * sind Pflicht.
7. Klicke optional auf **Zugang testen**, um die Anmeldung beim Anbieter zu prüfen.
8. 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](/administration/images/shipping-providers-account-dialog.png)

### 2. Versand-Regeln festlegen

1. Klicke in der Karte **Versand-Regeln** auf **Regel hinzufügen**.
2. Wähle den **Anbieter**.
3. Wähle den **Zugang**. Zugänge von Mandanten zeigen den Mandantennamen in Klammern; für ShipCloud lässt du „-- kein Zugang --“ stehen.
4. Wähle den **Mandant**: „-- alle Mandanten --“ oder einen einzelnen Mandanten.
5. Trag optional **Frachtführer-Kennungen** ein.
6. Setze bei genau einer Regel den Haken **Standard** – sie gilt, wenn keine andere Regel passt.
7. Setze den Haken **Aktiv** und leg die **Reihenf.** fest.
8. Wiederhole das für weitere Regeln. **Regel entfernen** löscht eine Zeile.
9. 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](/administration/images/shipping-providers-rules.png)

## 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:

1. Regeln für einen anderen Mandanten oder mit Frachtführer-Kennungen, die im Namen des Frachtführers nicht vorkommen, werden übersprungen.
2. Eine Regel mit passender Frachtführer-Kennung gewinnt gegen eine Regel ohne Kennung.
3. Eine Regel für den Mandanten des Auftrags gewinnt gegen eine Regel für alle Mandanten. Eine Regel, die beides erfüllt, gewinnt.
4. Passt keine Regel, wird die **Standard**-Regel verwendet.
5. 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](/administration/images/shipping-providers-packing-carrier.png)

## 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](/administration/images/shipping-providers-accounts-table.png)

## 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](/orders/order-documents.md)).
- **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](/company/shipcloud-accounts.md). |
| „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](/company/shipcloud-accounts.md) 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](/administration/shipcloud-api-status.md). |

**Alle Verbindungen** öffnet [Jobs & Verbindungen](/administration/jobs-and-connections.md), 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](/orders/shipment-tracking.md) und [Versandlabels](/outbound/shipping-labels.md).