Versandarten und Versandetiketten in Odoo

In Odoo 20.0 sind Versandart und Versandetikett zwei getrennte Dinge: Die Liefermethode bestimmt den Preis im Verkaufsauftrag oder Webshop, das Etikett kommt vom Paketdienst. Der Ablauf gehört zur App Lager und gilt für jede Sendung aus dem Lager, unabhängig von der Herkunft des Auftrags.

Was Sie vorab brauchen

Bevor das erste Etikett entsteht, müssen vier Dinge stehen: das Modul, die Lagerstammdaten, die Produktgewichte und ein Konto beim Paketdienst.

• Modul: Installieren Sie in der App Apps das Modul Delivery Costs; es bringt die Versandmethoden mit. Für einen Paketdienst aktivieren Sie zusätzlich dessen Konnektor in den Einstellungen der App Lager und speichern.
• Stammdaten Lager: Adresse und Telefonnummer des Lagerhauses unter Lager ‣ Konfiguration ‣ Lagerhäuser, erreichbar über das Feld Firma des Lagerhauses. Beide Angaben braucht der Konnektor.
• Produktgewichte: Ein Gewicht je Produkt unter Lager ‣ Produkte ‣ Produkte, Reiter Lager, Bereich Logistik. Ohne Gewicht kann der Paketdienst keinen Tarif berechnen.
• Paketdienstkonto: ein Konto beim gewählten Paketdienst und dessen API-Zugangsdaten; Bpost verlangt laut Dokumentation ein Geschäftskonto. Sendcloud fragt bei der Kontoanlage eine VAT- oder EORI-Nummer ab.

Die Bauarten von Liefermethoden

Odoo nennt die Versandarten Liefermethoden (in der Dokumentation auch Shipping Methods). Die Bauart hängt am Feld Anbieter auf der Methode; Paketdienst-Etiketten entstehen nur mit einem angebundenen Konnektor.

Bauart (Anbieter)	Wie der Preis entsteht	Etikett des Paketdienstes	Zusätzliche Einrichtung
Festpreis	fester Betrag je Auftrag; optional kostenlos ab dem im Feld Kostenlos bei Bestellbetrag über eingetragenen Betrag	nein	Anbieter Festpreis, Betrag im Feld Festpreis, ein Lieferprodukt
Basierend auf Regeln	Versandkosten aus Preisregeln nach Gewicht, Volumen, Preis oder Menge, dazu Marge und zusätzliche Marge	nein	Anbieter Basierend auf Regeln, Reiter Preisregeln mit Bedingung und Versandkosten
Paketdienst-Konnektor	Tarif des Paketdienstes aus Gewicht und Entfernung; mit dem Integrationslevel Tarif erhalten und Sendung erstellen zusätzlich das Etikett	ja	Zugangsdaten im Konnektor-Reiter; Testmodus für Testetiketten, Produktivmodus für echte Etiketten
Abholung im Geschäft (Anbieter Pick up in store)	keine Versandkosten; für Click & Collect	nein	eCommerce-Funktion Click & Collect und die Lagerorte, an denen abgeholt wird

Alle vier legen Sie unter Lager ‣ Konfiguration ‣ Liefermethoden an, sofern in den Einstellungen der App Lager das Kontrollkästchen Liefermethoden gesetzt ist. Ist der Menüpunkt nicht sichtbar, fehlt diese Einstellung.

Schritt für Schritt: Paketdienst anbinden

Schritt 1: Konnektor installieren

Öffnen Sie die App Apps, entfernen Sie den Filter Apps und suchen Sie nach dem gewünschten Paketdienst; installieren Sie das Modul. Alternativ setzen Sie in den Einstellungen der App Lager im Abschnitt Shipping Connectors das Kontrollkästchen des Anbieters und speichern. Mehrere Konnektoren lassen sich gleichzeitig wählen.

Schritt 2: Liefermethode anlegen

Gehen Sie zu Lager ‣ Konfiguration ‣ Liefermethoden und klicken Sie Neu. Füllen Sie den Namen, das Feld Anbieter und das Lieferprodukt, also die Position, die auf dem Verkaufsauftrag als Versandkosten erscheint. Der gewählte Anbieter steuert, welche weiteren Felder und Reiter sichtbar werden; beim Paketdienst erscheint ein Reiter mit den Zugangsdaten. In Datenbanken mit mehreren Firmen gilt ein leeres Firmenfeld für alle Firmen.

Schritt 3: Zugangsdaten je Paketdienst eintragen

Jeder Konnektor verlangt eigene Daten. Prüfen Sie vorab, dass der gebuchte Dienst in Ihrem Vertrag freigeschaltet ist; DHL unterstützt laut Dokumentation nur DHL Express, nicht die übrigen DHL-Dienste.

Paketdienst	Was Sie bereithalten	Etikett und Formate laut Dokumentation
DHL Express	DHL API Key im Feld DHL SiteID, API Secret im Feld DHL Password; das sind nicht die Zugangsdaten des DHL-Kontos	Felder Label Format und Label Template; Optionen Rücksendeetikett generieren und Dutiable Material
UPS	UPS Account Number, Client ID und Client Secret aus dem UPS-Entwicklerkonto; Service Type und Package Type	Label Format PDF, ZPL, EPL oder SPL; als Anbieter UPS wählen, nicht UPS Legacy
FedEx	FedEx-Geschäftskonto, Registrierung mit Annahme der EULA, Validierung über Rechnung oder Sicherheitscode	Label Type und Label Format; die neueste API ist seit dem 21. Oktober 2025 ausgesetzt, neue Einrichtungen sind blockiert
Sendcloud	Public Key und Secret Key aus der Sendcloud-Integration Odoo Native, Ship-From-Adresse	je Paket ein Etikett, dazu Rücketiketten und Zollunterlagen; Versandregeln nur für die Etiketten
Envia.com	Production Access Token und Sandbox Access Token aus dem Envia-Entwicklerbereich	je Paket ein Etikett, dazu Rücketiketten; für internationale Sendungen HS-Nummer und Ursprungsland am Produkt
Bpost	Account ID und Passphrase aus dem Bpost Shipping Manager; nur Geschäftskonten	Label Type A6 oder A4, Label Format PDF oder PNG; Lieferart national oder international

Die Dokumentation nennt je Dienst eine eigene Länderreichweite: DHL Express, UPS und Envia.com arbeiten in allen Regionen, Sendcloud versendet aus Deutschland, Österreich, Belgien, Frankreich, Italien, den Niederlanden, Spanien und dem Vereinigten Königreich an jedes europäische Land, Bpost aus Belgien, EasyPost in Nordamerika, Shiprocket in Indien sowie Starshipit in Australien und Neuseeland. Ein Konnektor für ein Schweizer Postprodukt steht in der Liste nicht.

Schritt 4: Produktivmodus und Integrationslevel setzen

Für Etiketten muss das Integrationslevel auf Tarif erhalten und Sendung erstellen stehen; Tarif erhalten berechnet nur den Preis. Über den Umschalter Test Environment wechseln Sie auf Production Environment. Im Testmodus dient die Etiketterstellung nur dem Test, und das Testetikett wird sofort storniert (DHL, Sendcloud); erst im Produktivmodus erzeugt das Validieren der Lieferung ein echtes Etikett, das dem Konto des jeweiligen Paketdienstes in Rechnung gestellt werden kann, auch bevor Sie dem Kunden die Versandkosten berechnen. Prüfen Sie die Einrichtung deshalb vor dem Umschalten; bei zwei- oder dreistufiger Lieferung kann das Etikett schon beim Kommissionieren oder Packen entstehen.

Schritt 5: Sendung auslösen und Lieferung validieren

Fügen Sie im Verkaufsauftrag die Versandkosten hinzu: Wählen Sie im Fenster Eine Liefermethode hinzufügen die Methode, tragen Sie das Gesamtgewicht des Auftrags ein und holen Sie mit Tarif erhalten den Preis. Bestätigen Sie den Auftrag und öffnen Sie die Lieferung über die Schaltfläche Lieferung. Erst das Validieren der Lieferung löst die Sendung aus, bei zwei- oder dreistufiger Lieferung das Validieren der Vorgangsart, an der das Kontrollkästchen für das Etikett gesetzt ist. Ohne die App Verkauf setzen Sie den Zusteller direkt in der Lieferung im Reiter Zusätzliche Infos.

Versandetiketten drucken und prüfen

Standardmäßig legt Odoo das Etikett beim Validieren der Lieferung als PDF im Chatter ab; die Sendungsverfolgungsnummer steht im Reiter Zusätzliche Infos. Besteht eine Lieferung aus mehreren Paketen, entsteht je Paket ein Etikett. Über die Schaltfläche Sendungsverfolgung erreichen Sie die Verfolgungsseite des Paketdienstes.

Für den automatischen Ausdruck öffnen Sie unter Lager ‣ Konfiguration ‣ Vorgangsarten die gewünschte Vorgangsart und setzen im Reiter Hardware das Kontrollkästchen Etiketten des Zustellers. Unter Lager ‣ Konfiguration ‣ Drucker verwalten verknüpfen Sie einen Drucker mit dem Bericht Versandetiketten (Shipping Labels) und stellen auf der Versandmethode das Etikettformat passend zum Druckertyp ein: PNG für ePOS, ZPL2 für Zebra, PDF für Laserdrucker. Bei IoT-Druckern muss zusätzlich die Berichtart zum Drucker passen, PDF für Laserdrucker und Text für Zebra. Für mehrstufige Lieferungen lässt sich der Ausdruck statt an der Auslieferung auch am Kommissionier- oder Packschritt auslösen.

Versandmethoden mit Konnektor werden mit Produkt-, Verpackungs- und Gewichtsdaten an den Paketdienst übergeben; bei einer zu schweren Sendung teilt Sendcloud das Gewicht laut Dokumentation auf mehrere Pakete auf, sodass Sie die Ware vor dem Validieren auf Pakete verteilen müssen.

So prüfen Sie das Ergebnis

1. In der Lieferung steht im Reiter Zusätzliche Infos das Feld Zusteller und darunter die Sendungsverfolgungsnummer; ohne Nummer wurde keine Sendung ausgelöst.
2. Im Chatter liegt mindestens ein Etikett, standardmäßig als PDF und bei mehreren Paketen eines je Paket; für den Ausdruck gilt das auf der Methode eingestellte Etikettformat (PNG, ZPL2 oder PDF).
3. Der Preis auf dem Verkaufsauftrag entspricht dem Produktivtarif und nicht einem Schätzwert aus dem Testmodus.
4. Wollen Sie eine Sendung zurückziehen, klicken Sie neben der Sendungsverfolgungsnummer auf Abbrechen und lösen die Sendung mit anderem Zusteller neu aus.

Wenn etwas nicht klappt

Symptom	Ursache nach Dokumentation 20.0	Abhilfe
Beim Validieren entsteht kein gültiges Etikett	Integrationslevel nur Tarif erhalten, oder die Methode steht im Testmodus und das Testetikett wird sofort storniert	Integrationslevel auf Tarif erhalten und Sendung erstellen stellen und auf Production Environment umschalten
Tarif erhalten liefert einen Fehler	Lageradresse oder Telefonnummer fehlt, oder ein Produkt hat kein Gewicht	Stammdaten im Lagerhaus und Gewicht im Produkt pflegen
Preise weichen von der Abrechnung ab	Testmodus aktiv, oder der Paketdienst rechnet die Sendung anders	Produktivmodus einschalten, die Sendung in Odoo und beim Paketdienst vergleichen und am Konnektor Debug Requests einschalten; die Protokolle lesen Sie nur im Entwicklermodus
Der Drucker gibt das Etikett falsch aus	Das Etikettformat passt nicht zur Berichtart des Druckers	PNG, ZPL2 und PDF dem Druckertyp entsprechend einstellen
Kein Etikett für ein Land	Der Dienst ist für das Zielland nicht aktiviert	Die Dienste beim Paketdienst freischalten und die Verfügbarkeit auf der Methode prüfen

Wann Sie Hilfe holen sollten

Wenn der Paketdienst das Geschäftskonto ablehnt, wenn die abgerechneten Preise dauerhaft von Odoo abweichen oder wenn Sendungen über Zollgrenzen laufen, ist der Schritt zu Frachtführer, Steuerberatung oder einem Odoo-Partner sinnvoll. Die Ausgabe an einem Scan-Arbeitsplatz beschreibt Barcode-Scanning im Odoo-Lager, die Paketübergabe im Lager Wareneingang und Lieferung und der Umgang mit Rücksendungen Retouren in Odoo abwickeln.