# Sendungsnummer in der E-Mail „Versandt“: vollständige Anleitung
> Übersicht Sendungsnummer in der E-Mail „Versandt“ fügt der E-Mail „Versandt“ von PrestaShop einen Block Sendung verfolgen hinzu: den Versanddienst, die Sendungsnummer und einen Button, der die Tracking-Seite des Versanddienstes öffnet.…
- Seite:
- Sprache: de
- Aktualisiert am: 2026-11-03
- Weitere Sprachen: [en](https://www.datafirefly.com/en/documentation/dftrackingmail/index.md), [fr](https://www.datafirefly.com/documentation/dftrackingmail/index.md), [es](https://www.datafirefly.com/es/documentation/dftrackingmail/index.md), [it](https://www.datafirefly.com/it/documentation/dftrackingmail/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftrackingmail/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftrackingmail/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftrackingmail/index.md)
- Index:
## Übersicht
Sendungsnummer in der E-Mail „Versandt“ fügt der E-Mail „Versandt“ von PrestaShop einen Block **Sendung verfolgen** hinzu: den Versanddienst, die Sendungsnummer und einen Button, der die Tracking-Seite des Versanddienstes öffnet. Der Block erscheint in der Sprache der Bestellung und wird beim Senden der E-Mail eingefügt: Ihre E-Mail-Vorlagen werden nie verändert.
Das Modul kann außerdem **die E-Mail „Versandt“ zurückhalten**, wenn eine Bestellung als versandt markiert wird, bevor ihre Sendungsnummer eingegeben ist, und sie senden, sobald die Nummer gespeichert ist. Es zeigt eine Tracking-Karte im Kundenkonto an und bietet Ihnen eine Live-Vorschau, eine Test-E-Mail, eine Warteschlange und ein Aktivitätsprotokoll.
Es läuft unter PrestaShop 1.7.8 bis 9.x mit PHP 7.1 bis 8.5, mit Classic, Hummingbird und deren Child-Themes. Das Backoffice und die Standardtexte sind auf Englisch, Französisch, Spanisch, Deutsch, Italienisch, Polnisch, Niederländisch und Portugiesisch verfügbar.
Der Tab „Übersicht“: Status, Kennzahlen der letzten 30 Tage, Checkliste „Erste Schritte“ und letzte Aktivität.
## Installation und Upgrade
1. Klicken Sie unter **Module > Modul-Manager** auf **Modul hochladen** und ziehen Sie die Datei `dftrackingmail-2.0.0.zip` hinein.
2. Klicken Sie auf **Konfigurieren**. Das Modul ist bereits für die E-Mail „Versandt“ aktiv, mit Standardtexten in jeder installierten Sprache.
Eine Willkommensmeldung nennt die drei zu prüfenden Punkte: die Tracking-Links Ihrer Versanddienste, die Farben des Blocks und eine Test-E-Mail.
**Upgrade von 1.0:** Laden Sie die neue ZIP-Datei über die alte hoch. Ihre Einstellungen, Texte, Farben, Links der Versanddienste und zurückgehaltenen E-Mails bleiben erhalten. Die Karte im Kundenkonto ist zunächst deaktiviert, sodass sich in Ihrem Shop nichts ändert, bis Sie sie aktivieren.
## Einstellungen
### Aktivierung
- **Tracking-Details zu den E-Mails hinzufügen**: Ist die Option deaktiviert, wird jede E-Mail genau so gesendet, wie PrestaShop sie erstellt.
- **Tracking-Karte im Kundenkonto anzeigen**: auf der Seite mit den Bestelldetails und auf der Seite zur Gast-Sendungsverfolgung.
### E-Mails mit Sendungsnummer
Der Standardstatus „Versandt“ sendet die E-Mail `shipped`, die standardmäßig ausgewählt ist. Jeder Bestellstatus, der eine E-Mail sendet, wird mit seiner Vorlage aufgeführt, sodass Sie eigene Status oder die E-Mail `in_transit` hinzufügen können.
### Daten und Datenschutz
Legen Sie fest, wie lange das Aktivitätsprotokoll und die gesendeten E-Mails aufbewahrt werden (standardmäßig 90 Tage). Die Kopie einer zurückgehaltenen E-Mail wird gelöscht, sobald sie gesendet oder abgebrochen ist. Mit dem offiziellen DSGVO-Modul werden die Kundendaten zusammen mit dem übrigen Konto exportiert und gelöscht.
Der Tab „Einstellungen“: Aktivierung, betroffene E-Mails, Zurückhalten der E-Mail und Datenaufbewahrung.
## E-Mail zurückhalten, bis die Sendungsnummer eingegeben ist
Wenn Sie den Status auf „Versandt“ setzen, bevor Sie das Etikett drucken, wird die Standard-E-Mail ohne Nummer gesendet. Aktivieren Sie **E-Mail zurückhalten**: Die E-Mail „Versandt“ wartet dann in einer Warteschlange und wird gesendet, sobald die Sendungsnummer gespeichert ist, auf der Bestellseite oder durch ein Versanddienst-Modul.
- **Trotzdem senden nach**: Die E-Mail wird nach dieser Frist ohne Nummer (oder mit der Wartemeldung) gesendet, standardmäßig nach 48 Stunden.
- **E-Mail „In Zustellung“**: PrestaShop sendet sie, wenn eine Sendungsnummer eingegeben wird. Standardmäßig wird sie übersprungen, wenn die zurückgehaltene E-Mail „Versandt“ gerade gesendet wurde, sodass der Kunde eine vollständige E-Mail statt zwei erhält.
- Zurückgehalten werden nur Versanddienste, bei denen **Sendungsnummer erwartet** im Tab „Versanddienste“ angehakt ist. Abholung im Geschäft und andere Versanddienste ohne Sendungsverfolgung werden nie zurückgehalten.
Auf der Bestellseite zeigt eine Karte die Nummern, die der Kunde sehen wird, den Stand der zurückgehaltenen E-Mail und zwei Aktionen: **Jetzt ohne Sendungsnummer senden** und **Nicht senden**.
Bestellseite: Die E-Mail „Versandt“ wird zurückgehalten, bis die Sendungsnummer eingegeben ist.
### Cron-Job
Der Cron-Job wird nur benötigt, wenn das Zurückhalten aktiv ist. Führen Sie ihn alle 15 Minuten aus: Er sendet die zurückgehaltenen E-Mails, deren Nummer von einem Versanddienst-Modul eingetragen wurde oder deren Frist abgelaufen ist, und löscht alte Einträge. Kopieren Sie die URL aus dem Tab „Einstellungen“ (sie funktioniert im Wartungsmodus) oder verwenden Sie die Kommandozeile:
```
php /path/to/prestashop/modules/dftrackingmail/cli/process-queue.php
```
**Neue URL erstellen** macht die vorherige URL ungültig.
## E-Mail und Texte
### Position in der E-Mail
- **Nach der Bestellreferenz** (empfohlen): direkt nach dem Satz, der die Bestellreferenz nennt.
- **Direkt nach der Begrüßung**: wird zuerst gesehen.
- **Manuell**: Der Block erscheint nur dort, wo Ihre Vorlage `{df_tracking_block}` enthält.
### Stil und Farben
Wählen Sie den Stil Karte, Akzentleiste oder Minimal, dann die Farben für Hintergrund, Rahmen, Button und Button-Text. Der Kontrast des Buttons wird live geprüft: Unter 4,5:1 ist der Text schwer lesbar, und es wird eine Warnung angezeigt.
### Inhalt und Texte
Blenden Sie den Namen des Versanddienstes und den Tracking-Button ein oder aus, und legen Sie fest, was passiert, wenn die Bestellung noch keine Sendungsnummer hat: Block ausblenden oder Wartemeldung anzeigen. Die Texte werden je Sprache bearbeitet: Titel, Einleitung, Bezeichnungen für Versanddienst und Sendungsnummer, Button-Text, Wartemeldung und Paketbezeichnung. Die Einleitung akzeptiert `{firstname}`, `{lastname}`, `{order_name}`, `{carrier_name}` und `{tracking_number}`; die Paketbezeichnung akzeptiert `{n}` und `{total}`.
Die Live-Vorschau rechts folgt Ihren Änderungen schon vor dem Speichern, in der für die Texte gewählten Sprache, auf dem Computer oder dem Smartphone.
Der Tab „E-Mail und Texte“ mit der Live-Vorschau.
## Versanddienste und Tracking-Links
Der Tracking-Button nutzt die unter **Versand > Versanddienste** festgelegte Tracking-URL. Füllen Sie das Feld eines Versanddienstes aus, um sie nur in den E-Mails zu ersetzen. Setzen Sie `{tracking_number}` (oder `@`, die PrestaShop-Syntax) an die Stelle der Nummer; `{postcode}` und `{country_iso}` werden für Versanddienste, die sie benötigen, aus der Lieferadresse übernommen.
- Ein Vorschlag erscheint, wenn der Name des Versanddienstes erkannt wird; **Andere Versanddienste** listet 21 Tracking-Links auf (Colissimo, Chronopost, Mondial Relay, DPD, GLS, UPS, FedEx, DHL, PostNL, bpost, Correos, SEUR, CTT, Poste Italiane, BRT, InPost, Poczta Polska, Royal Mail, USPS, 17TRACK).
- **Test** öffnet den Link mit einer Beispielnummer.
- **Sendungsnummer erwartet**: Entfernen Sie den Haken bei Versanddiensten, die nie eine Nummer haben. Ihre E-Mail wird nie zurückgehalten, und sie gelten nicht als Versanddienst ohne Link.
Testen Sie jeden Link einmal mit einer echten Nummer: Versanddienste ändern manchmal die Adresse ihrer Tracking-Seite.
Versanddienste, Tracking-Links, Vorschläge und Button „Test“.
## Vorschau und Test
Der Tab „Vorschau und Test“ zeigt die gesamte E-Mail, erstellt aus den Vorlagen Ihres Shops: mit fiktiven Beispieldaten (ein Paket, zwei Pakete oder noch keine Nummer) oder mit einer aktuellen Bestellung. Wählen Sie die Sprache und die E-Mail und wechseln Sie dann zwischen der HTML-Version, der Textversion und der Smartphone-Ansicht.
**Test-E-Mail senden** sendet die ausgewählte E-Mail an die eingegebene Adresse, mit **[Test]** im Betreff. Der Kunde erhält nichts. Der Test nutzt die gespeicherten Einstellungen.
Vorschau der E-Mail „Versandt“ zu einer echten Bestellung und gesendete Test-E-Mail.
## Was Ihre Kunden erhalten
Der Block zeigt den Versanddienst, die Sendungsnummer in gut lesbarer Schrift und den Tracking-Button. Hat eine Bestellung mehrere Pakete, wird jedes Paket nummeriert und erhält einen eigenen Button. Die Textversion der E-Mail enthält dieselben Informationen.
Die E-Mail „Versandt“ mit dem Tracking-Block.
Auf dem Smartphone, mit zwei Paketen.
## Kundenkonto
Ist die Option aktiviert, zeigen die Seite mit den Bestelldetails und die Seite zur Gast-Sendungsverfolgung eine Tracking-Karte mit dem Versanddienst, der Nummer, einem Button **Kopieren** und dem Tracking-Button. Die Karte verwendet die Texte des Blocks und passt sich an Classic, Hummingbird und deren Child-Themes an.
Tracking-Karte auf der Seite mit den Bestelldetails.
Dieselbe Karte auf dem Smartphone.
## Warteschlange und Aktivität
Der Tab **Warteschlange und Aktivität** listet die zurückgehaltenen E-Mails mit Filtern nach Status auf (zurückgehalten, gesendet, fehlgeschlagen, abgebrochen). **Jetzt senden** und **Nicht senden** wirken auf eine einzelne E-Mail; **Warteschlange jetzt verarbeiten** führt den Cron-Job sofort aus. Eine fehlgeschlagene E-Mail wird automatisch dreimal erneut versucht, und der Grund wird angezeigt.
Das Aktivitätsprotokoll erfasst jede E-Mail: Sendungsnummer hinzugefügt, ohne Nummer gesendet, zurückgehalten, zurückgehaltene E-Mail gesendet, E-Mail „In Zustellung“ übersprungen, Test-E-Mail.
Zurückgehaltene E-Mails und Aktivitätsprotokoll.
## Manuelle Position und Variablen
Fügen Sie bei manueller Position diese Variablen in Ihre E-Mail-Vorlage ein (Design > E-Mail-Design, der Ordner mails Ihres Themes oder ein E-Mail-Editor-Modul):
- `{df_tracking_block}`: der gesamte Block, HTML-Version.
- `{df_tracking_block_txt}`: der gesamte Block, Textversion.
- `{df_tracking_number}`: die Sendungsnummer(n), durch Kommas getrennt.
- `{df_tracking_url}`: der Tracking-Link des ersten Pakets.
- `{df_carrier_name}`: der oder die Name(n) des Versanddienstes.
Der Tab „Hilfe“: So funktioniert es, Variablen und häufig gestellte Fragen.
## Fehlerbehebung
### Der Kunde hat die E-Mail ohne Sendungsnummer erhalten
Die Bestellung wurde auf „Versandt“ gesetzt, bevor die Nummer eingegeben war. Aktivieren Sie das Zurückhalten im Tab „Einstellungen“. Die Tabelle „Aktivität“ zeigt jede E-Mail mit oder ohne Nummer.
### Der Tracking-Button erscheint nicht
Der Versanddienst hat keinen nutzbaren Tracking-Link. Öffnen Sie den Tab „Versanddienste“, nutzen Sie einen Vorschlag oder fügen Sie den Link des Versanddienstes ein und klicken Sie dann auf **Test**.
### Zurückgehaltene E-Mails werden nicht gesendet
Die Nummer wurde von einem Versanddienst-Modul eingetragen oder die Frist ist abgelaufen, aber der Cron-Job läuft nicht. Der Tab „Übersicht“ zeigt eine Warnung, wenn er seit mehr als 2 Stunden nicht gelaufen ist. Richten Sie ihn per URL oder Kommandozeile ein oder klicken Sie auf **Warteschlange jetzt verarbeiten**.
### Die E-Mail ist in der falschen Sprache
Die E-Mail verwendet die Sprache der Bestellung. Hat PrestaShop keine Vorlage in dieser Sprache, sendet es die Standardsprache: Die Vorschau zeigt Ihnen, welche Version verwendet wird.