P44 Connect

Die Integration kann für jeden Kunden einzeln aktiviert werden, daher werden nur die Sendungsdaten der ausgewählten Deliveo-Kunden weitergeleitet.

Voraussetzungen

• abonnierte Deliveo-API-Verbindung;
• abonnierte Nutzung des Deliveo-Webhooks;
• ein aktives Project44-Konto;
• Berechtigung zur Installation des Add-ons;
• Berechtigung zur Einrichtung und Nutzung des Add-ons.

Installation und Zugriff

Das Add-on kann im Dispatcher-Portal unter dem Menüpunkt „Add-ons“ installiert werden.

Nach der Installation ist es unter dem Menüpunkt „Add-ons / Project44 Connect“ verfügbar. Die Installation und Nutzung darf nur von Benutzern mit entsprechenden Berechtigungen durchgeführt werden.

Eigene Menüpunkte des Add-ons:

• Dashboard
• Kunden
• Einstellungen

Verbindung mit dem Project44-Konto

Beim Verbinden des Add-ons erstellt das System einen technischen Benutzer im Project44-Konto.

So schließen Sie die Verknüpfung ab:

1. Öffnen Sie die Benutzerverwaltung von Project44.
2. Suchen Sie den Benutzer, dessen Name auf der Seite „Einstellungen“ von Project44 Connect angezeigt wird.
3. Öffnen Sie die Benutzerrollen.
4. Klicken Sie im Abschnitt „Roles“ auf die Schaltfläche „Manage Roles“.
5. Fügen Sie die Berechtigung „Shipment Management“ hinzu.
6. Speichern Sie die Änderung.

Auf der Seite „Einstellungen“ von Project44 Connect zeigt eine grüne Statusanzeige an, dass die Verbindung erfolgreich hergestellt wurde.

Einrichtung der weitergeleiteten Sendungs-ID

Auf der Seite „Einstellungen“ können Sie auswählen, welche Sendungs-ID Deliveo an Project44 weiterleiten soll. Zur Auswahl stehen folgende IDs:

• DeliveoID
• Referenznummer
• Tracking-Code

Um den ausgewählten Wert zu speichern, klicken Sie auf die Schaltfläche „Identifikationsnummer speichern“. Die Einstellung wirkt sich nur auf die an Project44 weitergeleitete Identifikationsnummer aus. Die interne Zuordnung der Ereignisse von Deliveo und Project44 erfolgt weiterhin anhand der DeliveoID.

Webhooks einrichten

Project44 Connect erhält über die Webhook-Funktion von Deliveo Benachrichtigungen über Sendungsereignisse. So nehmen Sie die Einstellung vor:

1. Öffnen Sie im Dispatcher-Portal den Menüpunkt „Einstellungen / Webhooks“.
2. Wählen Sie das entsprechende Ereignis aus.
3. Öffnen Sie die erweiterten Einstellungen des Ereignisses.
4. Kopieren Sie die Webhook-URL, die auf der Seite „Einstellungen“ von Project44 Connect für das jeweilige Ereignis angezeigt wird.
5. Speichern Sie die Webhook-Einstellung.
6. Wiederholen Sie diesen Vorgang für alle erforderlichen Ereignisse.

Für die folgenden Ereignisse gibt es jeweils eine eigene Webhook-URL:

• Sendung erstellen
• Sendung abholen
• Umschlag
• Erfolgreiche Zustellung
• Fehlgeschlagene Zustellung

Die Webhook-URLs sind einzigartig. Verwenden Sie daher immer die Adressen, die auf der Seite „Einstellungen“ Ihrer jeweiligen Project44 Connect-Installation angezeigt werden.

Auswahl der Kunden

Auf der Seite „Kunden“ können Sie festlegen, welche Daten von Deliveo-Kunden an Project44 weitergeleitet werden sollen.

So aktivieren Sie einen Kunden:

1. Öffnen Sie den Menüpunkt „Kunden“.
2. Suchen Sie den Kunden in der Liste.
3. Aktivieren Sie den Schalter „Aktiv“ in der Zeile des Kunden.

Im aktivierten Zustand werden die zu diesem Kunden gehörenden Sendungsereignisse weitergeleitet. Im deaktivierten Zustand werden die Kundendaten nicht an Project44 weitergeleitet.

Die Kundenliste:

• kann nach Namen gefiltert werden;
• die Filterung kann aufgehoben werden;
• bei mehreren Seiten kann geblättert werden.

Überprüfe vor dem Aktivieren der Integration, ob tatsächlich nur jene Kunden aktiv sind, deren Daten du weiterleiten möchtest.

Übermittelte Ereignisse

Project44 Connect wandelt Deliveo-Ereignisse in Project44-Ereignisse um.

Beispiele für die Zuordnung von Ereignissen:

• Sendung erstellen → SHIPMENT_CREATED
• Sendung abholen → PICKED_UP
• Sendung umladen → ARRIVED_AT_STOP
• Erfolgreiche Zustellung → DELIVERED
• Fehlgeschlagene Zustellung → zum Beispiel DELIVERY_MISSED oder RETURN_TO_SENDER

Das Project44-Ereignis für eine fehlgeschlagene Zustellung kann von dem in Deliveo erfassten Ereignis für eine fehlgeschlagene Zustellung abhängen.

Dashboard

Das Dashboard zeigt die Webhook-Anfragen der letzten 30 Tage an.

Die Seite fasst nach Ereignistypen zusammen:

• die Sendungserstellungen;
• die Sendungsabholungen;
• Sendungsumleitungen;
• erfolgreiche Zustellungen;
• Zustellversuche;
• die erfolglosen Zustellungen.

Die detaillierte Ereignisliste enthält folgende Daten:

• Deliveo-ID
• Deliveo-Ereignis
• P44-Ereignis
• Angenommen
• Datum

Die Spalte „Angenommen“ gibt an, ob Project44 das gesendete Ereignis angenommen hat.

Die Liste:

• kann nach Deliveo-ID gefiltert werden;
• kann durchgeblättert werden;
• kann zur chronologischen Überprüfung und Fehlersuche verwendet werden.

Überprüfung der Datenverbindung

Nach der Einrichtung empfiehlt es sich, die Funktion mit einer Testsendung zu überprüfen.

1. Stellen Sie sicher, dass der zum Auftrag gehörende Kunde auf der Seite „Kunden“ aktiv ist.
2. Erstellen oder bearbeiten Sie eine Sendung so, dass eines der konfigurierten Webhook-Ereignisse ausgelöst wird.
3. Öffnen Sie das Project44 Connect-Dashboard.
4. Suchen Sie die Sendung anhand der Deliveo-ID.
5. Überprüfen Sie das Deliveo-Ereignis und das zugehörige P44-Ereignis.
6. Überprüfen Sie, ob die Spalte „Akzeptiert“ einen erfolgreichen Empfang anzeigt.

Beenden der Verbindung

Die aktive Project44-Verbindung kann über die Schaltfläche „Verbindung löschen“ auf der Seite „Einstellungen“ beendet werden.

Vergewissere dich vor dem Löschen der Verbindung, dass keine Ereignisübertragung an Project44 mehr erforderlich ist.

Nach dem Beenden der Verbindung empfiehlt es sich, im Deliveo-Menü unter „Einstellungen“ → „Webhooks“ die Webhook-Einstellungen für Project44 Connect zu überprüfen und gegebenenfalls zu entfernen.

Häufige Fehler

Es werden keine Ereignisse im Kontrollpanel angezeigt

Bitte überprüfen Sie:

• ob die Verbindung aktiv ist;
• ob der betreffende Kunde auf der Seite „Kunden“ als aktiv gekennzeichnet ist;
• ob die erforderlichen Webhooks eingerichtet sind;
• ob für das jeweilige Ereignis die richtige Webhook-URL angegeben wurde;
• ob das Ereignis in den letzten 30 Tagen stattgefunden hat.

Project44 akzeptiert das Ereignis nicht

Bitte überprüfen Sie:

• ob der technische Benutzer bei Project44 über die Berechtigung „Shipment Management“ verfügt;
• ob die Verbindung zum Project44-Konto aktiv ist;
• ob die übermittelte Sendungs-ID in der Sendung vorhanden ist;
• welche Deliveo- und P44-Ereignisse im Dashboard angezeigt werden.

Die Sendungen eines Kunden werden nicht weitergeleitet

Öffnen Sie die Seite „Kunden“ und überprüfen Sie, ob der Schalter „Aktiv“ für den betreffenden Kunden aktiviert ist.

In Project44 wird eine fehlerhafte Sendungs-ID angezeigt

Überprüfen Sie die auf der Seite „Einstellungen“ ausgewählte Sendungs-ID.

Die verfügbaren Werte sind:

• DeliveoID
• Referenznummer
• Tracking-Code

Klicken Sie nach der Änderung auf die Schaltfläche „ID-Einstellung speichern“.

Die Übermittlung eines bestimmten Ereignistyps funktioniert nicht

Überprüfen Sie, ob der Webhook für das jeweilige Ereignis separat eingerichtet ist. Für jeden Ereignistyp muss die auf der Project44 Connect-Seite angezeigte eigene URL verwendet werden.