FakturaCloud Docs

Versand

DHL-Integration, Versandlabels erstellen, Auto-Print mit QZ Tray und Sendungen verfolgen.

FakturaCloud bietet eine integrierte Versandlösung. Erstelle Versandlabels direkt aus Bestellungen heraus, drucke sie automatisch und verfolge deine Sendungen.

Aktuell wird DHL als Versanddienstleister unterstützt. Weitere Carrier (DPD, Hermes, GLS) sind in Planung.

DHL-Integration

Voraussetzungen

  • Ein DHL Geschäftskundenportal-Account
  • DHL API-Zugangsdaten (Benutzername + Passwort)

Einrichtung

  1. Gehe zu Dashboard > Anbindungen
  2. Unter Versanddienstleister klicke bei DHL auf Verbinden
  3. Gib deine DHL API-Zugangsdaten ein
  4. Klicke auf Speichern

Versandlabel erstellen

  1. Öffne eine Bestellung unter Dashboard > [Brand] > Bestellungen
  2. Klicke auf Versandlabel erstellen
  3. Prüfe die Versanddaten:
    • Absender — Deine Brand-Adresse (aus den Brand-Einstellungen)
    • Empfänger — Versandadresse der Bestellung
    • Paketdaten — Gewicht, Maße (werden aus Produktdaten vorausgefüllt)
    • Versandart — DHL Paket, DHL Päckchen, etc.
  4. Klicke auf Label erstellen
  5. Das Versandlabel wird als PDF generiert und kann gedruckt werden

Die Tracking-Nummer wird automatisch in der Bestellung gespeichert. Der Bestellstatus wechselt automatisch auf Versendet.

DHL-Versandarten

FakturaCloud wählt die passende DHL-Versandart automatisch anhand von Gewicht und Zielland:

ProduktBeschreibungGewichtZiel
DHL Paket (V01PAK)Standard-Paketversandbis 31,5 kgDeutschland
DHL Kleinpaket (V62KP)Kleine, leichte Sendungenbis 1 kgDeutschland
DHL Kleinpaket International (V66WPI)Kleine Sendungen ins Auslandbis 1 kgInternational
DHL Paket International (V53WPAK)Pakete ins Auslandbis 31,5 kgInternational

Du kannst die bevorzugte Versandart auch pro Produkt festlegen — unter Produkte > [Produkt] > Versand. Die Produkt-Einstellung hat Vorrang vor der automatischen Erkennung.

Zoll für Nicht-EU-Sendungen

Bei Sendungen außerhalb der EU zeigt FakturaCloud automatisch ein Zollformular an:

  • HS-Code (Zolltarifnummer) — Klassifiziert die Ware für den Zoll
  • Herkunftsland — Wo wurde die Ware hergestellt?
  • Warenbeschreibung — Kurze Beschreibung für die Zollerklärung

Diese Daten werden aus den Produkt-Stammdaten vorausgefüllt, wenn du sie dort hinterlegt hast (Zolldaten im Produkt konfigurieren). Du kannst sie vor dem Label-Erstellen noch anpassen.

Automatischer Label-Druck (QZ Tray)

Für Vielversender (z.B. 50+ Pakete am Tag) bietet FakturaCloud einen automatischen Label-Druck. Nach der Einrichtung wird jedes erstellte Versandlabel sofort an deinen Drucker gesendet — kein manuelles Herunterladen und Drucken mehr.

Wie funktioniert das?

FakturaCloud nutzt QZ Tray, einen kleinen Hintergrunddienst auf deinem Computer. QZ Tray stellt die Verbindung zwischen deinem Browser und deinem lokalen Drucker (USB oder Netzwerk) her.

QZ Tray installieren

  1. Lade QZ Tray von qz.io/download herunter
  2. Installiere die Software auf dem Computer, von dem aus du versendest
  3. Starte QZ Tray — es läuft als Hintergrunddienst in der Taskleiste (Windows) bzw. Menüleiste (Mac)

QZ Tray ist kostenlos nutzbar. Beim Start erscheint ein kurzer Bestätigungsdialog. Für den Betrieb ohne Dialog ist eine Lizenz bei qz.io erhältlich.

Drucker am Computer einrichten

Bevor du den Drucker in FakturaCloud konfigurierst, muss die Papiergröße im Druckertreiber korrekt eingestellt sein. FakturaCloud sendet das Label-PDF direkt an den Drucker — die Skalierung übernimmt der Druckertreiber deines Betriebssystems.

Windows:

  1. Öffne Einstellungen > Bluetooth und Geräte > Drucker und Scanner
  2. Klicke auf deinen Label-Drucker (z.B. Dymo LabelWriter)
  3. Klicke auf Druckeinstellungen
  4. Stelle unter Papiergröße / Verfügbares Papier das korrekte Label-Format ein (z.B. 4 x 6 für Versandlabels)

macOS:

  1. Öffne Systemeinstellungen > Drucker und Scanner
  2. Wähle deinen Label-Drucker
  3. Klicke auf Optionen und Zubehör und prüfe das eingestellte Papierformat

Wichtig: Auch im DHL Geschäftskundenportal muss die Labelgröße korrekt eingestellt sein (z.B. 103 x 150 mm für Thermodruck). Wenn das DHL-Labelformat nicht zum Drucker passt, wird das Label zu klein oder abgeschnitten gedruckt — das kann FakturaCloud nicht korrigieren.

Drucker in FakturaCloud einrichten

  1. Stelle sicher, dass QZ Tray auf deinem Computer läuft
  2. Gehe zu Dashboard > Brand-Einstellungen > Versand
  3. Klicke auf Mit QZ Tray verbinden
  4. Wähle deinen Label-Drucker aus der Dropdown-Liste
  5. Wähle das Papierformat passend zu deinem Drucker (z.B. DHL Thermodruck 103 x 150 mm für Thermodrucker wie Dymo, Brother QL)
  6. Aktiviere Auto-Print, wenn Labels nach Erstellung automatisch gedruckt werden sollen
  7. Klicke auf Speichern

Der Drucker muss auf deinem Computer installiert und eingeschaltet sein, damit er in der Liste erscheint. QZ Tray erkennt alle Drucker, die dein Betriebssystem kennt.

Auto-Print nutzen

Wenn Auto-Print aktiviert ist:

  • Label erstellen — Das Label wird wie gewohnt erstellt und zusätzlich automatisch an den konfigurierten Drucker gesendet
  • Kein manueller Schritt — Du musst das PDF nicht öffnen oder manuell drucken
  • Browser-Fallback — Falls QZ Tray nicht erreichbar ist, öffnet sich das Label wie gewohnt im Browser

Label nachdrucken

Bereits erstellte Labels können jederzeit nachgedruckt werden:

  1. Öffne die Bestellung mit dem gewünschten Label
  2. Im Abschnitt Sendung klicke auf Label drucken (Drucker-Symbol)
  3. Das Label wird erneut an deinen konfigurierten Drucker gesendet

Testdruck

Nach der Einrichtung kannst du einen Testdruck starten:

  1. Gehe zu Brand-Einstellungen > Versand
  2. Klicke auf Testdruck
  3. Eine Testseite wird an den ausgewählten Drucker gesendet

Tracking

Nach dem Erstellen eines Labels kannst du den Sendungsstatus verfolgen:

  • In der Bestellung — Tracking-Nummer und aktueller Status
  • Sendungsübersicht — Alle aktiven Sendungen auf einen Blick

Sendungsübersicht

Unter Dashboard > [Brand] > Versand siehst du alle Sendungen:

SpalteBeschreibung
BestellnummerVerknüpfte Bestellung
Tracking-Nr.DHL-Sendungsnummer
EmpfängerName und Stadt
StatusAktueller Versandstatus
Erstellt amDatum der Label-Erstellung

Häufige Probleme beim Label-Druck

Label wird zu klein oder zu groß gedruckt

Das Label-PDF wird von FakturaCloud 1:1 an den Drucker gesendet. Die Größe wird durch zwei Einstellungen bestimmt, die außerhalb von FakturaCloud liegen:

  1. Labelformat beim Versanddienstleister — Im DHL Geschäftskundenportal unter Druckeinstellungen muss das korrekte Format gewählt sein (z.B. 103 x 150 mm für Thermodruck)
  2. Papiergröße im Druckertreiber — In den Windows-/Mac-Druckereinstellungen muss das Papierformat zum physischen Label passen (z.B. 4 x 6 für Versandlabels)

Wenn diese beiden Einstellungen nicht zueinander passen, wird das Label verzerrt, zu klein oder abgeschnitten gedruckt.

QZ Tray verbindet sich nicht

  • Prüfe, ob QZ Tray in der Taskleiste (Windows) läuft
  • Starte QZ Tray neu
  • Stelle sicher, dass kein Antivirenprogramm die Verbindung blockiert (QZ Tray nutzt wss://localhost:8181)

Label wird nicht gedruckt

  • Prüfe, ob der Drucker eingeschaltet und mit dem Computer verbunden ist
  • Prüfe, ob der richtige Drucker in den Brand-Einstellungen ausgewählt ist
  • Versuche einen Testdruck unter Brand-Einstellungen > Versand

Versand-Dashboard

Das Versand-Dashboard bietet einen dedizierten Arbeitsplatz für den Versandprozess mit drei Bereichen:

Versand-Queue

Unter Versand in der Sidebar sehen Sie alle offenen Bestellungen als Karten-Liste. Jede Karte zeigt:

  • Bestellnummer und Kundenname
  • Anzahl der Positionen
  • Wartezeit mit Farbcodierung (grün < 4h, gelb < 24h, rot > 24h)
  • Zoll-Badge bei Nicht-EU-Sendungen

Klicken Sie auf eine Karte oder den "Packen"-Button um den Scan-Flow zu starten.

Barcode-Scan-Verpackung

Im Scan-Flow scannen Sie Artikel mit einem USB-Barcode-Scanner:

  1. Scanner liest Code — Das System matcht automatisch gegen:
    • Interner Artikelcode (ART-xxxx) — primär
    • SKU — Fallback
    • EAN/GTIN — Fallback
    • ASIN — Fallback
  2. Audio-Feedback: Erfolg (hoher Ton), Warnung bei Duplikat (mittlerer Ton), Fehler (tiefer Ton)
  3. Soll/Ist-Vergleich: Die Artikelliste zeigt erwartete vs. gescannte Menge
  4. Manuelles +/-: Fallback-Buttons pro Artikel wenn der Scanner nicht funktioniert

Nach dem Scannen wählen Sie das DHL-Versandprodukt und erstellen das Label mit einem Klick.

Nachdruck

Unter Nachdruck in der Sidebar finden Sie versendete Bestellungen und können Labels, Lieferscheine oder Rechnungen nachdrucken. Jeder Druckvorgang wird protokolliert.

Nächste Schritte

  • Bestellungen — Bestellungen verwalten und Versand vorbereiten
  • Lager — Bestandsführung nach Versand aktualisieren
  • Anbindungen — DHL-Verbindung einrichten

On this page