Deliveo Wissensdatenbank

Das Deliveo Website Plugin (DWP) ist ein in eine Website integrierbares Deliveo-Modul, das es den Besuchern oder Kunden der Website ermöglicht, Sendungen direkt aufzugeben, ihre bestehenden Sendungen abzufragen sowie – je nach den freigeschalteten Funktionen – weitere Aktionen durchzuführen.

Das DWP ist über die Deliveo-API mit dem System verbunden, daher sind für die Nutzung ein aktives Deliveo-Abonnement und API-Zugriff erforderlich.

Das Modul lässt sich in eine eigene Website einbinden und ist daher vor allem für Kurierdienste nützlich, die ihren Kunden die Möglichkeit bieten möchten, Sendungen auch ohne separate Registrierung oder Nutzung des Deliveo-Kundenportals zu erfassen oder abzufragen.

Hauptfunktionen

Das DWP bietet unter anderem folgende Funktionen:

Erstellung einer neuen Sendung;
Auswahl der Versandoption;
Auswahl einer Abholstelle;
Verwaltung von Nachnahme;
Verwendung von Referenznummer und Sendungsverfolgungscode;
Verwaltung der benutzerdefinierten Felder OP1–OP3;
Berechnung der Versandkosten;
Berechnung des Volumengewichts;
Online-Zahlung über Barion;
Sendungsabfrage;
Anzeige von Sendungsverfolgungsinformationen;
Etikett herunterladen;
Unterschriftenblatt herunterladen;
Änderung oder Stornierung der Sendung, sofern zulässig;
Initiierung der Rücksendung einer zugestellten Sendung.

Ein Teil der verfügbaren Funktionen kann in den Einstellungen aktiviert oder deaktiviert werden.

Sendungsaufgabe

Eine der Hauptfunktionen des DWP ist die Erstellung neuer Sendungen. Auf der Oberfläche zur Sendungsaufgabe kann der Besucher die für den Transport der Sendung erforderlichen Daten eingeben, die das DWP anschließend an das Deliveo-System weiterleitet.

Daten des Absenders

Unter den Absenderdaten können die für den Abholort und den Ansprechpartner der Sendung erforderlichen Angaben gemacht werden. Dazu gehören beispielsweise:

Name;
Firmenname;
Land;
Postleitzahl;
Ort;
Adresse;
Telefonnummer;
E-Mail-Adresse.

Die tatsächlich angezeigten Felder können je nach DWP-Version und -Konfiguration variieren.

Angaben zum Empfänger

Bei den Empfängerdaten müssen die für die Zustellung erforderlichen Angaben gemacht werden. Ähnlich wie beim Absender können hier die Kontakt- und Adressdaten des Empfängers angegeben werden.

Nutzung von Paketabholstellen

Das DWP kann aktive Standorte vom Typ „Paketstation“, die in Deliveo angelegt wurden, anzeigen. Eine Paketstation kann separat ausgewählt werden:

auf der Abholseite;
auf der Zustellseite.

So kann die Sendung von einem Paketpunkt aus versendet werden, an einem Paketpunkt ankommen oder – je nach den vom Kurierdienst angebotenen Möglichkeiten – auf beiden Seiten ein Paketpunkt genutzt werden. DWP lädt die Paketabholstellen direkt aus dem Deliveo-System hoch, daher erfolgt deren Verwaltung nicht in DWP, sondern in den entsprechenden Stammdaten von Deliveo.

Verwaltung des Rechnungsempfängers

Das DWP kann auf zwei Arten genutzt werden, je nachdem, ob alle Online-Sendungen demselben Kunden zugeordnet sind.

Verwendung eines festen Kunden

In der Konfiguration kann eine feste Kunden-ID angegeben werden. In diesem Fall:

wird jede über das DWP erstellte Sendung diesem Kunden zugeordnet;
wird dem Besucher kein separater Block „Rechnungsempfänger“ angezeigt;
wird die Abrechnungsbeziehung durch den in der Konfiguration angegebenen Kunden bestimmt.

Dies kann bei Websites verwendet werden, bei denen das DWP für einen einzigen Vertragskunden bereitgestellt wird.

Kundenanlage anhand der angegebenen Daten

Wenn kein fester Kunde festgelegt ist, kann der Besucher die Daten des Rechnungsempfängers eingeben. Das DWP prüft daraufhin, ob der entsprechende Kunde bereits im Deliveo-System vorhanden ist.

Wird ein passender Kunde gefunden, wird der bestehende Kunde verwendet. Wird kein passender Kunde gefunden, legt das DWP anhand der eingegebenen Daten einen neuen Kunden an und ordnet die neue Sendung diesem Kunden zu.

Sendungsinhalt und Colli

Eine Sendung kann aus einem oder mehreren physischen Paketen, d. h. Colli, bestehen. Im DWP können mehrere Colli zur selben Sendung hinzugefügt werden. Für die einzelnen Colli können unter anderem folgende Angaben gemacht werden:

Gewicht;
Länge;
Breite;
Höhe;
eine eindeutige Kennung.

Das DWP ermittelt aus den Daten der einzelnen Pakete die Gesamtdaten der Sendung.

Gesamtgewicht und Gesamtvolumen

Bei Verwendung mehrerer Colli addiert das System deren Gewicht und Volumen zusammen. Anhand der angegebenen Paketmaße berechnet das DWP automatisch auch das Volumengewicht.

Mithilfe des Volumengewichts können auch große, aber relativ leichte Pakete bei der Gebührenberechnung angemessen berücksichtigt werden.

Versandoptionen

Für die Sendung kann die in Deliveo angelegte Versandoption ausgewählt werden. Das DWP lädt die verfügbaren Versandoptionen aus dem Deliveo-System herunter, daher erfolgt deren Erstellung und Verwaltung über das Dispatcher-Portal.

Mithilfe der Versandoption kann der Kurierdienst verschiedene Serviceleistungen anbieten, beispielsweise mit unterschiedlichen Zustell- oder Abholbedingungen.

Nachnahme

Das DWP unterstützt die Erfassung von Nachnahmesendungen. Wenn für die Sendung eine Nachnahme vorgesehen ist, können der Nachnahmebetrag und die dazugehörigen Daten angegeben werden. Die Abwicklung der Nachnahme erfolgt in Deliveo gemäß dem üblichen Nachnahmeabwicklungsprozess.

Referenznummer und Sendungsverfolgungscode

Für die Sendung können angegeben werden:

Referenznummer;
Tracking-Code.

Mithilfe dieser Angaben können auch eigene Identifikatoren aus externen Systemen, Webshops oder kundenseitigen Prozessen mit der Deliveo-Sendung verknüpft werden.

Individuelle Felder OP1–OP3

Das DWP unterstützt die Deliveo-Felder OP1, OP2 und OP3. Dabei handelt es sich um benutzerdefinierte Datenfelder, die zur Abfrage zusätzlicher Informationen genutzt werden können, die für den eigenen Betrieb des Kurierdienstes erforderlich sind. Die angezeigten Namen der Felder können in der Konfiguration geändert werden, sodass dem Besucher die technischen Bezeichnungen OP1, OP2 oder OP3 nicht angezeigt werden müssen.

Gebührenberechnung

Das DWP kann auf Grundlage der Sendungsdaten eine Gebühr vom Deliveo-System anfordern. Bei der Gebührenberechnung können unter anderem folgende Faktoren berücksichtigt werden:

Abhol- und Zustelladresse;
die Versandoption;
Anzahl der Pakete;
Gewicht;
Volumen;
Volumengewicht;
Nachnahme;
die in Deliveo konfigurierten Tarifbedingungen.

Die tatsächliche Gebühr richtet sich stets nach der in Deliveo festgelegten Preisgestaltung.

Online-Zahlung mit Barion

DWP kann auch mit Barion-Onlinezahlung genutzt werden. Wenn die Barion-Integration aktiviert ist und die Deliveo-Gebührenberechnung einen zu zahlenden Betrag ausweist, kann der Besucher die Gebühr für die Dienstleistung im Rahmen der Sendungsaufgabe online bezahlen.

Der Ablauf ist in diesem Fall wie folgt:

Der Besucher gibt die Daten der Sendung ein.
Das DWP ermittelt die Versandkosten.
Der Besucher führt die Zahlung über die Barion-Oberfläche durch.
Nach erfolgreicher Zahlung legt das DWP die Sendung in Deliveo an.

Auf diese Weise verhindert das System, dass bei einer fehlgeschlagenen oder abgebrochenen Zahlung eine unbezahlte Sendung entsteht.

Sendungsabfrage

Das DWP verfügt außerdem über eine separate Funktion zur Sendungsabfrage. Diese Funktion kann in der Konfiguration separat aktiviert oder deaktiviert werden. Um eine Sendung abzufragen, muss der Besucher Folgendes angeben:

die DeliveoID;
die Postleitzahl des Empfängers.

Die kombinierte Verwendung dieser beiden Daten verhindert, dass jemand allein durch Kenntnis einer DeliveoID die Sendungsdaten einsehen kann.

Die bei der Abfrage angezeigten Daten

Nach erfolgreicher Identifizierung kann das DWP die zum Paket gehörenden Informationen anzeigen.

Dazu können gehören:

der aktuelle Status der Sendung;
das Sendungsprotokoll;
der Inhalt des Pakets;
die Daten des Absenders;
die Daten des Empfängers;
die Sendungsverfolgungsdaten;
das Sendungsetikett;
das Unterschriftenblatt.

Die Anzeige der Absender- und Empfängerdaten kann separat konfiguriert werden.

Etikett herunterladen

Das zum abgefragten Paket gehörende Etikett kann aus dem DWP heruntergeladen werden, sofern diese Funktion verfügbar ist. Dies ist beispielsweise nützlich, wenn der Absender das Paketetikett selbst ausdrucken und auf das Paket aufkleben möchte.

Unterschriftsblatt

Das Anzeigen oder Herunterladen des zur Zustellung gehörenden Unterschriftsbogens kann ebenfalls freigeschaltet werden. Ist die Funktion aktiv und liegt für die Sendung ein entsprechendes Dokument vor, ist dieses über die Abfrageoberfläche des DWP abrufbar.

Sendung bearbeiten und löschen

Im DWP kann das Bearbeiten und Löschen zuvor erstellter Sendungen aktiviert werden. Die Funktion kann nur genutzt werden, wenn sie in der DWP-Konfiguration freigeschaltet wurde. Darüber hinaus muss die Sendung die folgenden Bedingungen erfüllen:

Der Kurier hat die Sendung noch nicht abgeholt;
sie wurde noch nicht zugestellt;
sie wurde noch nicht bezahlt.

Ist einer dieser Punkte bereits eingetreten, ist das Ändern oder Löschen der Sendung über das DWP nicht zulässig.

Rücksendung

Das DWP unterstützt auch die Einleitung der Rücksendung zugestellter Sendungen. Diese Funktion kann separat aktiviert werden. Wenn für eine zugestellte Sendung eine Rücksendung möglich ist, erstellt das DWP anhand der Daten der ursprünglichen Sendung ein neues Versandformular.

Dabei werden die ursprünglichen:

Absenderdaten als Empfänger der Rücksendung;
die Daten des Empfängers werden zum Absender der Rücksendung

Der Besucher muss somit nicht erneut die vollständigen Adressdaten eingeben. Die Rücksendung bedeutet technisch gesehen die Erstellung einer neuen Sendung.

Anpassung des Erscheinungsbilds

Das Erscheinungsbild des DWP ist teilweise konfigurierbar. Unter anderem können folgende Einstellungen vorgenommen werden:

eigenes Logo;
Themenfarbe;
angezeigte Funktionen;
Bezeichnungen einzelner Felder;
die angezeigten Namen der Felder OP1–OP3;
auf der Tracking-Seite angezeigte Daten.

Damit lässt sich das Erscheinungsbild des DWP an die Website des Kurierdienstes anpassen.

Mehrsprachiger Betrieb

Das DWP kann in mehreren Sprachen genutzt werden. Mithilfe der entsprechenden Sprachdateien kann dieselbe Installation auch auf mehreren Websites in verschiedenen Sprachen oder für unterschiedliche Kundenkreise verwendet werden.

Installation

Das DWP kann auf einem eigenen Webserver installiert werden. Zur Installation müssen die Programmdateien in das entsprechende Webverzeichnis kopiert und anschließend die Konfigurationsdatei erstellt und eingerichtet werden. In der Konfiguration müssen unter anderem folgende Angaben gemacht werden:

die Anbindungsdaten der Deliveo-API;
die gewünschten Funktionen;
eine eventuelle feste Kunden-ID;
die Anzeigeeinstellungen;
die für die Online-Zahlung erforderlichen Daten;
sonstige Betriebsparameter.

Die für die Installation und den Betrieb erforderlichen konkreten Konfigurationsvariablen sind in der Datei .env.example .

Download: https://gitlab.com/mav-it/deliveo-website-plugin

Demo: https://dwp.deliveo.eu/

Serveranforderungen

DWP ist eine PHP-basierte Anwendung. Es wird empfohlen, stets eine PHP-Version zu verwenden, die noch offiziell unterstützt wird.

Die Weiterentwicklung und Fehlerbehebung von Deliveo erfolgt für die unterstützten PHP-Versionen. Wir übernehmen keine Verantwortung für die Behebung von Kompatibilitäts- oder Funktionsfehlern, die auf die Verwendung einer nicht mehr unterstützten, veralteten PHP-Version zurückzuführen sind. Der Webserver muss über die für den Betrieb von DWP erforderlichen PHP-Erweiterungen sowie über die Möglichkeit einer externen HTTPS-Verbindung verfügen.

Aktualisierung

Nach der Installation einer neuen Version empfiehlt es sich, die aktuelle .env.example Datei mit der bisherigen Konfiguration zu vergleichen, da bei der Einführung neuer Funktionen auch neue Konfigurationsvariablen hinzukommen können.

Das Plugin kann sich selbst über die Website https://gitlab.com/mav-it/deliveo-website-plugin aktualisieren. Um die Aktualisierung auszuführen, fügen Sie hinter der Installations-URL Folgendes ein: /update

Beispiel: dwp.example.com/update

Wichtige Hinweise

DWP basiert auf der Deliveo-API, daher stammen die in DWP erstellten oder abgefragten Daten direkt aus dem Deliveo-System. DWP ist keine eigenständige Kurierdienst-Datenbank, sondern die Web-Erweiterung von Deliveo.

Ein Großteil der verfügbaren Dienste, Versandoptionen, Abholstellen, Gebühren und sonstigen Geschäftsregeln muss daher nicht im DWP, sondern im Deliveo-Dispatcher-Portal konfiguriert werden.