Voraussetzungen
- Abonnierte Deliveo-API-Verbindung.
- Berechtigung zur Installation des Add-ons.
- Berechtigung zur 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 / Statusimport“ verfügbar. Die Installation und Nutzung darf nur von Benutzern mit entsprechenden Berechtigungen durchgeführt werden.
Datei hochladen
Das Add-on unterstützt die folgenden Dateiformate:
- CSV
- XLSX
- XLS
Die maximale Dateigröße beträgt 10 MB. Die Datei muss eine Kopfzeile enthalten. Das System verwendet die in der Kopfzeile angegebenen Spaltennamen, um die Spalten der Datei den Feldern in Deliveo zuzuordnen.
So laden Sie die Datei hoch:
- Öffnen Sie den Menüpunkt „Erweiterungen / Status importieren“.
- Ziehen Sie die Datei in den Upload-Bereich oder klicken Sie auf „Durchsuchen“.
- Wählen Sie die zu verarbeitende Datei aus.
- Klicken Sie auf die Schaltfläche „Hochladen“.
Nach erfolgreichem Hochladen werden die Oberfläche zur Feldzuordnung und eine Vorschau des Dateiinhalts angezeigt.
Felder zuordnen
Für die Verarbeitung müssen die Spalten der Datei den entsprechenden Feldern in Deliveo zugeordnet werden.
Pflichtfelder
Sendungs-ID
Wählen Sie die Dateispalte aus, die die Sendungs-ID enthält.
Typ der Sendungs-ID
Die folgenden Identifikationsarten können verwendet werden:
- DeliveoID
- ESID (External Shipment ID, vom Partner zurückgesendete ID)
Der ausgewählte Identifikationstyp muss mit dem Typ der Identifikationen in der Datei übereinstimmen.
Weitere zuordnungsfähige Felder
Name des Empfängers
Name der Person, die die Sendung entgegennimmt.
Zustellungsdatum
Datum und Uhrzeit der erfolgreichen Zustellung.
Der angegebene Zeitpunkt darf nicht vor dem Zeitpunkt der letzten Statusänderung der Sendung liegen.
Zahlungsart
Zulässige Werte:
CASH– BarzahlungCARD– Zahlung per Kreditkarte
ID des Fehlerstatus
Die Status-ID für eine fehlgeschlagene Zustellung. Diese ID befindet sich in der ersten Spalte der Tabelle unter dem Menüpunkt „Einstellungen / Rückläufer“.
Zeitpunkt des Fehlversuchs
Datum und Uhrzeit des fehlgeschlagenen Zustellvorgangs. Es ist nicht erforderlich, alle auswählbaren Felder zuzuordnen. Ordne nur die Felder zu, die in der hochgeladenen Datei enthalten sind und die du importieren möchtest.
Zuordnungsvorlage speichern
Die eingerichtete Feldzuordnung kann über die Schaltfläche „Vorlage speichern“ gespeichert werden. Wenn Sie später eine Datei mit denselben Spaltenüberschriften hochladen, wendet das System automatisch die zuvor gespeicherte Zuordnung an. Dies beschleunigt die Verarbeitung bei Statusdateien, die regelmäßig in derselben Struktur eingehen. Die aktuelle Zuordnung kann mit der Schaltfläche „Auf Standard zurücksetzen“ zurückgesetzt werden.
Verarbeitung der Status
Klicken Sie nach dem Zuordnen der Felder auf die Schaltfläche „Status verarbeiten“. Das System führt für jede Zeile folgende Schritte durch:
- die Sendung anhand der angegebenen Identifikationsnummer;
- überprüft die importierten Daten;
- führt die entsprechende Statusänderung durch;
- zeigt das Ergebnis der Verarbeitung an.
Verarbeitungsergebnis
Nach Abschluss der Verarbeitung zeigt das System eine Zusammenfassung an:
- Anzahl der verarbeiteten Zeilen;
- Anzahl der erfolgreich verarbeiteten Zeilen;
- Anzahl der fehlerhaften Zeilen;
- Fortschritt der Verarbeitung;
- detaillierte Fehlermeldungen zu den fehlerhaften Zeilen.
Im Fehlerfall zeigt das System Folgendes an:
- die Nummer der fehlerhaften Zeile;
- die Sendungs-ID;
- die Fehlerursache.
Die Verarbeitung kann beispielsweise fehlschlagen, wenn der in der Datei angegebene Zustellzeitpunkt vor dem Zeitpunkt der letzten Statusänderung der Sendung liegt. Der Fehler verhindert nur die Verarbeitung der betroffenen Zeile. Die übrigen Zeilen, die korrekte Daten enthalten, können verarbeitet werden.
Häufige Fehler
Die Sendung wurde nicht gefunden
Bitte überprüfen Sie:
- die Sendungs-ID;
- den ausgewählten Identifikationstyp;
- ob die Datei „DeliveoID“ oder „ESID“ enthält;
- ob die Identifikationsnummer kein überflüssiges Leerzeichen enthält.
Das Datum liegt vor dem Zeitpunkt der letzten Statusänderung
Das Datum des Status darf nicht vor dem Datum des aktuellsten Status der Sendung liegen.
Korrigieren Sie das Datum und die Uhrzeit in der Datei und laden Sie die Datei anschließend erneut hoch.
Die Zahlungsart wird nicht akzeptiert
Verwenden Sie im Feld „Zahlungsart“ ausschließlich die folgenden Werte:
CASHCARD
Die Spalten der Datei werden nicht angezeigt
Bitte überprüfen Sie, ob:
- die Datei eine Kopfzeile enthält;
- die Kopfzeilenfelder nicht leer sind;
- die Datei im CSV-, XLSX- oder XLS-Format vorliegt;
- die Dateigröße 10 MB nicht überschreitet.
Ein fehlerhaftes Feld wurde zugeordnet
Klicke auf die Schaltfläche „Zurück auf Standard“ und richte die Feldzuordnung neu ein. Falls du zuvor eine fehlerhafte Vorlage gespeichert hast, speichere die korrekten Einstellungen erneut.