Bedienung für Shop-Betreiber
Bemerkung
Diese Seite richtet sich an Shop-Betreiber und Mitarbeitende im OXID-Admin. Die technische Einrichtung steht unter Installation für Agenturen.
Schnellstart
Öffnen Sie und wählen Sie eComStyle.de: DHL-Paket.
Tragen Sie unter Einstell. zuerst Sandbox-Zugang, API-Key und die zehnstellige EKP ein.
Öffnen Sie und wählen Sie DHL Verbindung testen.
Erstellen Sie für eine Testbestellung ein Sandbox-Label und prüfen Sie Adresse, Produkt, Maße, Gewicht, PDF, Trackingcode und Versandstatus.
Stimmen Sie Versandmail, Datenübermittlung und Aufbewahrung intern ab.
Hinterlegen Sie erst danach die Produktivdaten, wechseln Sie auf Produktion (Live) und wiederholen Sie den Test mit einem dafür vorgesehenen Auftrag.
Warnung
In der Produktivumgebung erzeugt DHL Label erstellen eine reale DHL-Sendung. Verwenden Sie für Einrichtung und Schulung die Sandbox und kontrollieren Sie produktive Tests anschließend im DHL-Geschäftskundenportal.
DHL-Zugänge einrichten
Produktion
Melden Sie sich im DHL-Geschäftskundenportal an und ermitteln Sie Ihre zehnstellige EKP.
Legen Sie einen eigenen API-Systembenutzer an.
Erstellen Sie im DHL Developer Portal eine Production-App für Parcel DE Shipping und übernehmen Sie deren API-Key.
Tragen Sie EKP, Produktiv-Benutzername, Produktiv-Passwort und API-Key in den Moduleinstellungen ein.
Wählen Sie Produktion (Live), speichern Sie und führen Sie den Verbindungstest aus.
Sandbox
Erstellen Sie im DHL Developer Portal eine App für Customer (Integration) Testing und tragen Sie deren Sandbox-API-Key ein. Das Modul ist voreingestellt auf:
Benutzername
user-valid,Passwort
SandboxPasswort2023!undUmgebung
sandbox.
Als DHL-Sandbox-EKP kann entsprechend der DHL-Testkonfiguration
3333333333 verwendet werden. Ein API-Key ist nicht voreingestellt.
Achtung
Sandbox- und Produktivdaten dürfen nicht gemischt werden. Ein erfolgreicher Verbindungstest bestätigt noch nicht, dass Abrechnungsnummer, Produkt, Absender-, Empfänger- und Sendungsdaten für ein Label akzeptiert werden.
Moduleinstellungen
Öffnen Sie .
Zugang und Umgebung
Einstellung |
Bedeutung |
Standard |
|---|---|---|
Umgebung |
|
Sandbox |
EKP |
Zehnstellige DHL-Kundennummer. Aus ihr erzeugt das Modul die Abrechnungsnummer. |
leer |
Sandbox Benutzername / Passwort / API Key |
Zugang zur DHL-Testumgebung. |
|
Produktiv Benutzername / Passwort / API Key |
Zugang zur DHL-Produktivumgebung. |
leer |
Bewahren Sie Passwörter und API-Keys wie andere produktive Zugangsdaten auf und geben Sie sie nur berechtigten Personen. Die Bestellansicht zeigt sensible Werte nicht im Klartext an.
Produkt, Label und Paket
Einstellung |
Wirkung |
Standard |
|---|---|---|
Standard Service |
Vorauswahl für deutsche Sendungen: |
|
Vorausverfügung |
|
keine |
Label Druckformat |
|
|
Label nach Erstellung automatisch öffnen |
Öffnet das von DHL gelieferte Label in einem neuen Browserfenster. |
ein |
Absender-E-Mail an DHL übermitteln |
Übermittelt die in den Shop-Stammdaten hinterlegte Bestell-E-Mail als Absenderkontakt, unter anderem für den digitalen Einlieferungsbeleg. |
ein |
Verpackungsgewicht |
Wird in kg zur Summe aus Artikelmenge mal Artikelgewicht addiert. |
|
Standard Paketlänge / -breite / -höhe |
Vorschlag in Zentimetern. Bei Auswahl von DHL Kleinpaket setzt die Bestellansicht die Maße auf 35 × 25 × 8 cm. |
40 × 30 × 20 cm |
Das Modul bildet die Abrechnungsnummer automatisch:
EKP (10 Stellen) + DHL-Verfahrensnummer (2 Stellen) + 01
Für V01PAK verwendet es beispielsweise die Verfahrensnummer 01. Aus
3333333333 entsteht 33333333330101.
E-Mail und Bestellliste
Einstellung |
Wirkung |
Standard |
|---|---|---|
Kunden E-Mail an DHL |
|
Nie |
Versandmail nach Label automatisch senden |
Sendet nach erfolgreicher Labelerstellung die OXID-Standardversandmail. |
aus |
Standardfilter Ordner |
Öffnet die DHL-Liste mit dem angegebenen OXID-Bestellordner. Leer zeigt alle Ordner. |
leer |
Standardsortierung |
Sortiert zunächst absteigend nach Bestellnummer oder Bestellordner. |
Bestellnummer |
Label Bereinigung: Aufbewahrungstage |
Hinterlegter Fallbackwert für Bereinigungen: 180, 365 oder 730 Tage. Die Schaltfläche fragt vor jedem Löschen nochmals eine Tageszahl ab; diese Eingabe ist für den konkreten Lauf maßgeblich. |
365 Tage |
Achtung
Das Modul legt selbst kein Feld ECSMAILCONSENT an. Die Auswahl
Nur mit Zustimmung übermittelt daher nur dann eine Kunden-
E-Mail, wenn eine andere freigegebene Shop-Anpassung diesen Wert an der
Bestellung bereitstellt. Lassen Sie das vor dem Live-Betrieb durch Ihre
Agentur prüfen.
Bestellungen auswählen
Öffnen Sie . Die Liste zeigt nicht stornierte Bestellungen des aktuellen Shops, 25 Einträge je Seite. Zur Verfügung stehen:
Suche nach Bestellnummer, Vorname, Nachname, Firma oder E-Mail; die automatische Suche beginnt ab drei Zeichen,
Filter nach Bestellordner, bezahlt oder unbezahlt, versandt oder nicht versandt, Rechnungsland und Bestelldatum,
Sortierung über die Spalten Ordner, Nummer, Datum, Kunde, Ort und Land sowie
Refresh zum erneuten Laden.
Die Statuszeichen bedeuten:
€Bezahlt laut OXID-Zahlungsdatum.
SVersanddatum ist gesetzt.
LMindestens eine Trackingnummer steht im OXID-Feld
OXTRACKCODE.
Bemerkung
Das Zeichen L wird aus dem Trackingcode abgeleitet. Es beweist nicht,
dass die lokale Labeldatei noch vorhanden oder die Sendung bei DHL aktiv
ist.
Label erstellen
1. Bestellung prüfen
Wählen Sie in der Liste Label. Die Seitenleiste zeigt Bestellung, Lieferadresse, Artikel, Bestellordner und Versandstatus.
Prüfen Sie besonders:
Name, Straße, Hausnummer, Postleitzahl und Ort,
tatsächliches Empfängerland,
Artikelgewichte und Stückzahlen,
das vorgeschlagene Gesamtgewicht sowie
DHL-Produkt und Außenmaße des fertigen Pakets.
Fehlt eine gesonderte Lieferadresse, verwendet das Modul die Rechnungsadresse. Das Gewicht ist nur ein Vorschlag und kann vor dem Erstellen geändert werden.
Packstationen: Beginnt das Straßenfeld mit „Packstation“, verwendet das Modul die Hausnummer als Packstationsnummer. Ist sie dort nicht vorhanden, wird eine Zahl aus dem Straßenfeld verwendet. Die Postnummer wird als erste Zahl aus dem Feld für den Adresszusatz übernommen. Prüfen Sie diese Felder vor dem Erstellen besonders sorgfältig.
2. Paketdaten festlegen
Wählen oder korrigieren Sie:
Gewicht (kg),
Service,
Länge cm,
Breite cm und
Höhe cm.
Die Felder müssen positive Werte enthalten. Ob Gewicht, Maße, Zielland und Vertragskonto für das gewählte Produkt zulässig sind, entscheidet DHL bei der Übermittlung.
3. Label erzeugen
Wählen Sie DHL Label erstellen. Bei Erfolg:
erzeugt DHL Sendungs- und Trackingnummer sowie das Label,
speichert das Modul Label und Metadaten außerhalb des öffentlichen Shopverzeichnisses,
ergänzt die Trackingnummer in der OXID-Bestellung,
setzt das Versanddatum, falls es noch leer war, und
sendet bei aktivierter Automatik die OXID-Standardversandmail.
Bei eingeschaltetem automatischem Öffnen erscheint das Label in einem neuen Browserfenster. Erlauben Sie Pop-ups für den Shop-Admin. Mehrere Labels pro Bestellung sind möglich und werden einzeln in der Seitenleiste aufgeführt.
Internationale Sendungen und Zollpapier
Bei einem Ziel außerhalb Deutschlands wird Paket International vorgeschlagen. Für ein Nicht-EU-Ziel erzeugt das Modul aus den Bestellpositionen automatisch Zolldaten und zeigt ein von DHL zurückgegebenes Zollpapier an. Verwendet werden unter anderem Artikelbezeichnung, Menge, Gewicht, Positionswert, Währung, Versandkosten und der Exporttyp Handelsware.
Warnung
Prüfen und vervollständigen Sie alle für Ihr Zielland erforderlichen Zolldaten außerhalb dieses Moduls. Es gibt in der DHL-Seitenleiste keine Eingabefelder für Zolltarifnummer oder Ursprungsland. Die automatische Übernahme ersetzt weder Zollprüfung noch Handelsrechnung oder andere erforderliche Ausfuhrunterlagen.
Versandmail und Versandstatus
Mit Versandmail senden verschickt das Modul die OXID- Standardversandmail zur ausgewählten Bestellung. Dabei verwendet es das neueste lokale Label, ergänzt dessen Trackingnummer bei Bedarf und setzt das Versanddatum. Die automatische Versandmail nach Labelerstellung führt denselben OXID-Mailversand aus.
Mit Als versandt markieren können Sie das OXID-Versanddatum auch ohne Mail setzen. Versanddatum entfernen setzt es wieder zurück. Der Bestellordner lässt sich unabhängig davon direkt in der Seitenleiste ändern.
Achtung
Das Modul zeigt keine eigene Mailhistorie und verhindert keinen erneuten Versand. Prüfen Sie vor jedem manuellen Klick, ob der Kunde die Versandnachricht bereits erhalten hat.
Labels drucken, verfolgen und stornieren
Für jedes gespeicherte Label stehen zur Verfügung:
Klick auf die Trackingnummer für die DHL-Sendungsverfolgung,
Drucken zum erneuten Öffnen des lokalen Labels,
Zollpapier, wenn DHL ein solches Dokument geliefert hat, und
Stornieren nach einer Sicherheitsabfrage.
Nach einer vom Modul akzeptierten Stornierung werden das lokale Label, das zugehörige Zollpapier, die Metadaten und die betreffende Trackingnummer aus der Bestellung entfernt. Weitere Trackingnummern derselben Bestellung bleiben erhalten.
Warnung
Die Stornierung setzt das OXID-Versanddatum nicht zurück und ändert den Bestellordner nicht. Prüfen Sie die Stornierung zusätzlich im DHL- Geschäftskundenportal und korrigieren Sie Versandstatus beziehungsweise Ordner bei Bedarf manuell. Ein lokal verschwundenes Label allein ist kein ausreichender Nachweis für die Stornierung bei DHL.
Alte Labeldaten bereinigen
Unter öffnet Alte Label bereinigen eine Abfrage der Tageszahl. Nach der Bestätigung löscht das Modul vollständige lokale Label-Sätze, deren neueste Metadaten- oder Dateizeit älter als diese Grenze ist.
Warnung
Die Bereinigung löscht lokale Label-, Zoll- und JSON-Dateien dauerhaft. Sie storniert keine Sendung bei DHL und entfernt keine Trackingnummer aus der OXID-Bestellung. Es gibt keinen automatischen Zeitplan. Führen Sie die Bereinigung nur entsprechend Ihrer freigegebenen Aufbewahrungsregel und nach einer erforderlichen Sicherung aus.
Empfohlener Arbeitsablauf
Offene Bestellungen mit den Ordner-, Zahlungs- und Versandfiltern wählen.
Lieferadresse, Artikelgewichte und tatsächliches Packmaß kontrollieren.
DHL-Produkt auswählen und Label erstellen.
Label beziehungsweise Zollpapier öffnen und lesbar ausdrucken.
Trackingnummer und Versandstatus in der Liste gegenprüfen.
Versandmail je nach interner Regel automatisch oder genau einmal manuell senden.
Bei Stornierungen DHL-Portal, Trackingcode, Versanddatum und Bestellordner gemeinsam prüfen.
Lokale Labeldaten nach dem festgelegten Aufbewahrungsplan bereinigen.
Was das Modul nicht automatisch erledigt
Das Modul erledigt insbesondere nicht automatisch:
Auswahl oder vertragliche Prüfung des richtigen DHL-Produkts,
Prüfung von Gewicht, Paketmaßen, Adresse oder Packstationsdaten vor der DHL-Antwort,
Ermittlung aller erforderlichen Zollangaben und Ausfuhrdokumente,
rechtliche Prüfung der Kunden-E-Mail-Übermittlung,
Kommissionierung, Verpackung, Abholung oder Einlieferung,
Rückzahlung, Retoure, Lagerkorrektur oder Bestellstornierung,
Zurücksetzen von Versanddatum oder Bestellordner nach Labelstornierung,
Abgleich des lokalen Labelbestands mit dem DHL-Geschäftskundenportal,
automatische regelmäßige Datenbereinigung oder
Dokumentation einer Versandmail-Historie.
Prüfung vor dem Live-Betrieb
Kontrollieren Sie mit Ihrer Agentur mindestens:
Sandbox- und Produktivzugang getrennt,
Shop-Absenderdaten und alle verwendeten DHL-Vertragsprodukte,
deutsche Adresse, Packstation, EU- und Nicht-EU-Adresse,
Artikel- und Verpackungsgewichte sowie typische Paketmaße,
A4- beziehungsweise Etikettendruck am vorgesehenen Gerät,
Pop-up-Einstellung des Admin-Browsers,
Übermittlung von Absender- und Kunden-E-Mail gemäß Ihrer Datenschutzregel,
manuelle und automatische Versandmail,
Stornierung einschließlich Kontrolle im DHL-Portal sowie
Sicherung, Aufbewahrung und Bereinigung der Labeldateien.
Fehlerbehebung
Problem |
Das sollten Sie prüfen |
|---|---|
Die Verbindung meldet HTTP 401. |
Gewählte Umgebung, API-Key, Benutzername und Passwort müssen aus derselben DHL-App beziehungsweise demselben Zugang stammen. |
Der Verbindungstest ist erfolgreich, das Label aber nicht. |
EKP, Abrechnungsvertrag, Empfängeradresse, Absenderdaten, Produkt, Gewicht und Maße prüfen. Der Verbindungstest prüft nicht alle Sendungsdaten. |
Die Lieferadresse ist unvollständig. |
Name, Straße mit Hausnummer, Postleitzahl und Ort in der Bestellung vervollständigen. Bei Packstationen zusätzlich Stations- und Postnummer prüfen. |
Das falsche DHL-Produkt ist vorausgewählt. |
Empfängerland der Lieferadresse prüfen und den Service vor dem Erstellen ändern. Für Ziele außerhalb Deutschlands wird Paket International vorgeschlagen. |
Das Gewicht ist zu niedrig. |
Artikelgewichte und Mengen in der Bestellung sowie das konfigurierte Verpackungsgewicht prüfen; den tatsächlichen Wert vor dem Erstellen eintragen. |
Das Label öffnet sich nicht. |
Pop-ups für den Shop-Admin erlauben und die Schaltfläche Drucken verwenden. Bleibt das Problem, lokale Labelspeicherung durch die Agentur prüfen lassen. |
Kein Zollpapier ist sichtbar. |
Zollpapier wird nur angezeigt, wenn DHL eines zurückliefert. Zielland, DHL-Antwort und erforderliche Unterlagen fachlich prüfen. |
Die Versandmail fehlt. |
Automatikschalter, gültige Kundenadresse und allgemeinen OXID- Mailversand prüfen. Die manuelle Schaltfläche genau einmal testen. |
Nach Stornierung steht die Bestellung weiter auf versandt. |
Das ist das vorgesehene Modulverhalten. Verwenden Sie Versanddatum entfernen und korrigieren Sie den Ordner nach Ihrem Prozess. |
Das Label ist lokal gelöscht, aber Tracking bleibt sichtbar. |
Eine Bereinigung entfernt bewusst keine Trackingnummer. Prüfen Sie Bestellung und DHL-Portal; Änderungen nur entsprechend dem internen Nachweisprozess vornehmen. |
Wenn ein Fehler bleibt, halten Sie für Ihre Agentur OXID-Version, verwendetes Modulpaket, Umgebung, Bestellnummer, DHL-Produkt, Zeitpunkt und genaue Fehlermeldung bereit. Zugangsdaten und Kundendaten dürfen nur über einen dafür freigegebenen Supportweg übermittelt werden.