Einstellungen

Einstellungen im Backend

In den DHL-Einstellungen werden Zugangsdaten, Absenderdaten, Labeldruck, Nachnahme und Exportdokumente fuer den DHL-Versand gepflegt.

Inhaltsverzeichnis

Voraussetzungen und Speichern

Das Formular ist Teil der DHL-Schnittstelle und wird nur angezeigt, wenn die DHL-App aktiv ist und das passende Backend-Recht vorhanden ist. Beim Oeffnen legt das Backend fehlende DHL-Konfigurationswerte automatisch mit Standardwerten an.

  • Speichern: Schreibt alle Formularwerte in den Konfigurationsbereich dhl.
  • Checkbox-Logik: Nicht gesetzte Checkboxen werden beim Speichern ausdruecklich auf 0 gesetzt. Dadurch werden deaktivierte Optionen nicht versehentlich weiterverwendet.
  • Testmodus: Wenn der Testmodus aktiv ist, erscheint oberhalb des Formulars ein Warnhinweis. Labels werden dann gegen die Testkonfiguration erzeugt.
Automatische DHL-Labels entstehen nur, wenn die Versandart als Transportdienst DHL verwendet und der DHL-Labeldruck in diesen Einstellungen aktiviert ist.

Zugangsdaten und Abrechnung

Diese Felder bilden die technische und abrechnungsbezogene Basis fuer die DHL-Labelerstellung.

  • user - API-Benutzername: Benutzerkennung fuer die Anmeldung am DHL-Dienst. Der Standardwert wird beim ersten Anlegen der Konfiguration gesetzt und muss fuer den Produktivbetrieb angepasst werden.
  • password - API-Passwort: Passwort zum API-Benutzer. Das Formular rendert dieses Feld als Passwortfeld.
  • ekp - EKP: DHL-Kundennummer fuer normale Sendungen. Diese Nummer bildet den ersten Teil der Abrechnungsnummer.
  • partnerId - Teilnehmer Nr - Paket: Teilnehmernummer fuer nationale Paketsendungen.
  • partnerId_bpi - Teilnehmer Nr - WeltPaket: Teilnehmernummer fuer internationale Paketsendungen.
  • partnerId_wp - Teilnehmer Nr - Kleinpaket: Teilnehmernummer fuer Kleinpaket/Warenpost-Logik bei deutschen Empfaengeradressen.
  • ekp_beilageretoure - EKP - Beilageretoure: DHL-Kundennummer fuer beigelegte Retourenlabels.
  • partnerId_beilageretoure - Teilnehmer Nr - Beilageretoure: Teilnehmernummer fuer Retourenlabels.

Bei der Labelerstellung baut das Backend aus EKP, Produktkennung und Teilnehmernummer die Abrechnungsnummer. Fuer deutsche Pakete, internationale Pakete und Kleinpaket werden unterschiedliche Teilnehmerfelder verwendet.

Nachnahme und Kundendaten

Die Nachnahmefelder werden in die DHL-Sendung geschrieben, wenn beim Label die Nachnahmeoption aktiv ist.

  • cod_accountOwner - Inhaber: Kontoinhaber fuer Nachnahme-Auszahlungen.
  • cod_bankName - Bank: Bankname der Nachnahme-Bankverbindung.
  • cod_iban - IBAN: IBAN fuer den Nachnahme-Einzug.
  • cod_bic - BIC: BIC der Nachnahme-Bankverbindung.
  • cod_amount - Nachnahmegebuehr: Zusatzbetrag, der auf den Nachnahmebetrag aufgeschlagen wird.
  • use_notification - Kunden-E-Mail/Tel uebermitteln: Steuert die Uebergabe von Empfaenger-E-Mail und Telefon. Moegliche Werte sind ja, nein und je nach Zustimmung des Kunden.
  • filialrouting - Filialrouting aktivieren: Uebergibt bei erlaubter Kundendatenuebergabe die Empfaenger-E-Mail fuer DHL-Filialrouting.
Bei der Einstellung je nach Zustimmung des Kunden werden E-Mail und Telefon nur uebergeben, wenn an der Bestellung eine entsprechende Einwilligung vorliegt.

Absenderadresse

Normalerweise nutzt die Labelerstellung die Standard-Absenderdaten des Shops. Mit own_sender_address wird stattdessen eine gesonderte DHL-Absenderadresse verwendet. Die zugehoerigen Felder werden im Formular dynamisch ein- oder ausgeblendet.

  • own_sender_address - gesonderte Absenderadresse festlegen: Aktiviert die abweichende Absenderadresse fuer DHL-Labels.
  • sender_company - Absender-Name: Erste Namenszeile des Absenders.
  • sender_name - Absender-Name 2: Zweite Namenszeile des Absenders.
  • sender_street - Absender-Strasse: Strasse der Absenderadresse.
  • sender_street_number - Absender-HNr: Hausnummer der Absenderadresse.
  • sender_zip - Absender-PLZ: Postleitzahl des Absenders.
  • sender_city - Absender-Ort: Ort des Absenders.
  • sender_countryiso - Absender-Land ISO Code: Fest auf de gesetzt und im Formular nicht bearbeitbar.
  • sender_phone - Absender-Tel: Telefonnummer fuer den Absender.
  • sender_email - Absender-E-Mail: E-Mail-Adresse fuer den Absender.

Bei Dropshipping kann die Bestellung eigene Versanddaten liefern. Die gesonderte DHL-Absenderadresse ueberschreibt danach die vorbereiteten Absenderdaten fuer DHL-Labels.

Exportdokumente

Fuer Laender mit erforderlichem Zolldokument erzeugt die DHL-Labelerstellung Exportdaten. Das Formular bietet zwei Arbeitsweisen: eine vereinfachte Sammelposition oder produktbezogene Angaben aus Merkmalen.

  • exportdoc_format - vereinfachte Exportdokumenten-Eingabe: Aktiviert eine vereinfachte Eingabe mit einer zusammengefassten Exportposition.
  • exportdoc_text - Bezeichnung: Beschreibung der vereinfachten Exportposition.
  • exportdoc_zolltarif - Zolltarifnummer: Zolltarifnummer fuer die vereinfachte Exportposition.
  • exportdoc_country - Ursprungsland: Ursprungsland fuer die vereinfachte Exportposition.
  • exportdoc_product_country_merkmal_id - Produkt-Merkmal fuer Ursprungsland bei Exportpositionen: Merkmal, aus dem bei produktbezogener Eingabe das Ursprungsland gelesen wird.
  • exportdoc_product_zolltarif_merkmal_id - Produkt-Merkmal fuer Zolltarifnummer bei Exportpositionen: Merkmal, aus dem bei produktbezogener Eingabe die Zolltarifnummer gelesen wird.

Ist die vereinfachte Eingabe aktiv, blendet das Backend die produktbezogenen Merkmalsfelder aus. Ist sie inaktiv, werden die Merkmalsfelder angezeigt und die Exportpositionen koennen aus Produktdaten aufgebaut werden.

Labeldruck und Standardoptionen

Diese Optionen beeinflussen, welche Werte beim Erstellen eines DHL-Labels vorbelegt oder an DHL uebergeben werden.

  • labeldruck - Bei Transportdienst DHL Labeldruck: Aktiviert die automatische Labelerstellung fuer Sendungen, deren Transportdienst DHL ist.
  • beilage_retoure - Beilageretoure immer erstellen: Setzt Retourenlabels als Standard voraus. Die Retoure wird nur erzeugt, wenn das gewaehlte DHL-Produkt Retouren erlaubt.
  • versicherung_vorauswahl - Versicherung entsprechend vorauswaehlen: Belegt Zusatzversicherung anhand des Bestellwerts vor. Ab hoeheren Warenwerten werden groessere Versicherungsstufen vorbelegt.
  • sendungsgewicht_typ - Sendungsgewicht auf die Anzahl der Sendungen aufteilen: Teilt das angegebene Sendungsgewicht durch die Anzahl der zu erzeugenden Sendungen.
  • ein_label - Label und Exportdokument in einem PDF: Steuert die gemeinsame Ausgabe von Label und Exportdokument.
  • empfaenger_unterschrift - Vorauswahl Empfaenger Unterschrift: Belegt die Option fuer persoenliche Empfaengerunterschrift in der Labelmaske vor.
Weitere Labeloptionen wie Kleinpaket, Sperrgut, Premium, persoenliche Uebergabe, keine Nachbarschaftszustellung, Nachnahmebetrag und Anzahl der Sendungen werden nicht auf dieser Setup-Seite gepflegt, sondern in der Labelmaske der Bestellung.

Wirkung in der Labelerstellung

  1. Das Backend bereitet Absender, Empfaenger, Gewicht und Bestelldaten aus der Bestellung vor.
  2. Bei aktiver gesonderter Absenderadresse werden die hier gepflegten Absenderdaten fuer DHL eingesetzt.
  3. Je nach Lieferland und Kleinpaket-Auswahl wird das passende DHL-Produkt und die passende Teilnehmernummer ausgewaehlt.
  4. Falls Kundendaten nicht uebergeben werden duerfen, werden Empfaenger-E-Mail und Telefon vor der DHL-Anfrage geleert.
  5. Bei Nachnahme werden Nachnahmebetrag, Gebuehr und Bankverbindung an DHL uebergeben.
  6. Bei erforderlichen Exportdokumenten werden Zollpositionen, Warenwert, Ursprungsland und Zolltarifnummer an DHL uebergeben.
  7. Bei erfolgreicher Rueckmeldung speichert das Backend Label, Trackingnummer und optionales Exportdokument als Versandlabel.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.