pixi

Anbindung von GLS und GLS Express

pixi verfügt über eine Echtzeit-Schnittstelle zur Logistik-Software GLS Gepard in der Version 1.11.8.0 oder höher der Firma GLS Logistics. Dieser Guide beschreibt die Konfiguration der sog. Polling-Einstellungen innerhalb der Anwendung GLS Gepard.

Vorab muss gewährleistet sein, dass manuell bereits Paket-Aufkleber über GLS Gepard erzeugt werden können. Eine funktionierende Grundinstallation wird vorausgesetzt.


Aufbau der Polling-Datei

pixi erzeugt beim Ship-Out einer Box eine sog. Polling-Datei, welche im Verzeichnis "C:\" abgespeichert wird und folgendes Format hat: "GLS_Poll.csv". Diese Datei wird bei jedem Ship-Out im Versandmodul neu erzeugt und hat immer den gleichen Dateinamen. Ist die Datei bereits vorhanden, wird diese überschrieben.

Die Einstellungen zum Speichern von Polling-Dateien finden Sie unter: pixi Versand > Menü Extras > Einstellungen > Versanddienstleister:

  1. Öffnen Sie im Versand unter Extras die Einstellungen.

  2. Wählen Sie Logistikdienstleister aus.

  3. Wählen Sie mit Ordner auswählen einen Ordner aus, in dem die Abfrage Datei gespeichert werden soll.

Die Polling-Datei lässt sich mit dem Standard-Editor von Windows oder mit Excel öffnen, der Inhalt zeigt sich wie folgt:

TEST000001;;;;COD;;;;;;;;;012345-12345;;;;;Mustermann GmbH;Max Mustermann;;Musterstr. 123;12345;
Musterstadt;;99,99;;;3,000;;;;DE;;;


Das Semikolon ";" wird als Feld- und Wert-Trennzeichen verwendet, um die einzelnen Parameter zu unterscheiden.

Die Felder im Einzelnen (leere Felder – sog. Dummy-Werte - werden nicht angegeben):

Feld-Nr.

Bezeichnung

Beispiel

Erklärung

1

ID-Nummer / Kundennummer / Verwendungszweck

TEST000001

Rechnungsnummer

5

Produktart

COD

Nachnahme-, Express- oder Normalversand

14

Telefonnummer

012345-12345

Telefonnummer der Versandadresse

19

Name 2

Mustermann GmbH

Firmenname der Versandadresse

20

Name 1

Max Mustermann

Kundenname der Versandadresse

22

Strasse

Musterstr. 123

Strasse der Versandadresse

23

Postleitzahl

12345

PLZ der Versandadresse

24

Ort

Musterstadt

Ort der Versandadresse

26

Betrag (Cash)

99,99

Nachnahmebetrag

29

Gewicht

3,000

Gewicht, wie beim SHIP-Out angegeben oder fest hinterlegt

33

Länderkennzeichen

DE

Land der Versandadresse (ISO-Code)


Zum Seitenanfang

Konfiguration des Imports über GLS Gepard

  1. Speichern Sie die von uns erhaltene Datei "GLS_Poll.dat" im Verzeichnis "C:" ab.

  2. Öffnen Sie GLS Gepard und melden Sie sich mit dem Administrator-Benutzerkonto an.


  3. Klicken Sie im Menü auf den Eintrag "Dienstprogramme" > "Systemeinstellungen", es öffnet sich ein neues Fenster. Wechseln Sie in der Baumstruktur auf "Lokal" > "Importsteuerung" und geben Sie die Einstellungen wie im Screenshot dargestellt an, bestätigen Sie die Eingaben danach mit "OK":


  4. Klicken Sie im Menü auf den Eintrag "Dienstprogramme" > "Importassistent", es öffnet sich der Importassistent, wählen Sie die Einstellungen wie in den Screenshots beschrieben:




  5. Wählen Sie als Trennzeichen den Semikolon (";"), wenn Sie die entsprechende Position markieren, können Sie den Wert direkt eingeben oder über den Dateibetrachter unten links aus der Datei den entsprechenden Wert direkt zuweisen, indem Sie diesen markieren. (In der Tabelle auf Seite 1 können Sie die entsprechenden Positionsnummern direkt entnehmen und eintragen.)



    Hinweis: Wird eine elektronische Waage verwendet, welche an GLS Gepard angeschlossen ist, so ist das Feld "Gewicht" leer zu lassen.

  6. Sind alle Positionen der einzelnen Felder gemäß der Tabelle auf Seite 1 eingetragen, klicken Sie auf "Weiter" und schließen Sie den Importassistenten ab, die Konfiguration ist somit abgeschlossen. Um den Import zu starten, klicken Sie im Menü auf "Paketabwicklung" > "Normalversand".

Zum Seitenanfang

GLS Express

Expressbestellungen, die mit GLS Express verwendet werden sollen, werden in pixi über den Parameter TE gekennzeichnet. Dieser Parameter ist im Feld Extras im pixi Kundenservice sichtbar: Reiter Bestellungen > Reiter Allgemein der Details zur Bestellung.

Funktionsweise GLS Express

Wenn beim Shop-Import im Tag <TRANSPORT_REMARKS> TE innerhalb der XML-Datei für den Bestellimport enthalten ist, so wird dieser in pixi importiert und der Auftrag als Expressauftrag übergeben.

Hinweise:
Die Felder für die Anzeige von Lieferoptionen (Verfahren, Product und Extras) sind standardmäßig ausgeblendet. Sie können diese Felder sichtbar machen, indem Sie folgende Einstellung aktivieren: pixi Control Center > Reiter Datenbank Einstellungen > Ordner Kundenservice > "Spezielle Versanddienstleister-Felder anzeigen".


Anzeige der GLS Express-Bestellung in der Polling Datei


Der Parameter TE wird als letztes Feld in der Polling-Datei eingefügt. Beispiel:

ABC100123;;;;;;;;;;;;;;;;;;;Max Mustermann;;Pixistr. 123;24109;Kiel;;1,99;;;0,130;;;;DE;;TE;


Hinweis: Wenn die XML-Datei für den Bestellimport sowohl Nachnahme (COD – Cash on delivery) als auch TE (GLS Express) als Lieferoptionen enthält, so wird die Option Nachnahme ignoriert und ausschließlich TE innerhalb der Polling-Datei berücksichtigt. Sie sollten diese Kombination daher in den Einstellungen des Web-Shops vermeiden.

Zum Seitenanfang

Tracking ID Einstellungen

Für den Import der Tracking IDs gibt es aktuell zwei Möglichkeiten.

  1. Nutzen Sie das Tool CSV Tracking ID Import zum Import der Tracking IDs.

  2. Treffen Sie die entsprechenden Einstellungen in GLS Gepard. In diesem Fall ist die Verwendung eines zusätzlichen Tools nicht nötig, da Sie mithilfe des Rückmeldeassistenten den Aufbau einer DHL-Datei nachempfinden und diese von pixi, wenn sie sich im korrekten Verzeichnis befindet, automatisch über die Applikation pixi Versand verarbeitet und die Tracking IDs in die Datenbank importiert werden. Folgen Sie dazu diesen Anweisungen:


Konfiguration GLS Gepard

  1. Starten Sie GLS Gepard und wählen Sie im Menü unter dem Punkt "Dienstprogramme", "Rückmeldeassistent".

  2. Wählen Sie die Versandart "Normalversand" aus und klicken Sie auf Weiter.


  3. Wählen Sie nun das Verzeichnis, in welches die Rückmeldedatei gespeichert werden soll, indem Sie es entweder über das Durchsuchen-Symbol auswählen, oder den Pfad manuell eintragen. Fügen Sie dem Pfad den Namen der Rückmeldedatei "ElSendExGLS1.txt" hinzu und klicken Sie anschließend auf Weiter.


  4. Wählen Sie nun das Dateiformat "ASCII, variable Satzlänge" sowie den Parameter "Neue Daten an Datei anfügen, bestehende aktualisieren." und klicken Sie auf Weiter.


  5. Konfigurieren Sie die Rückmeldedatei so, wie in den folgenden Screenshots zu sehen:
    Hinweis: Zwischen den Feldern "KDPAKET:PAKETNR" und "KDPAKET:ID_NR" befinden sich 20 "LEERFELDER".


  6. Wählen Sie im nächsten Schritt für die Sortierung das Feld "KDPAKET:ID_NR". Die Filter im nachfolgenden Schritt bleiben leer.


  7. Wählen Sie als Trennzeichen "59 --> ;" und klicken Sie anschließend auf Fertigstellen.


  8. Um sich nun eine Rückmeldedatei zu erstellen, wählen Sie im Menü unter dem Punkt "Tagesabschluss", "Schnittstellendateien erneut erstellen". Aktivieren Sie im Bereich Dateiauswahl "An vorhandene Schnittstellendateien anhängen" sowie die Checkbox "Rückmeldedatei". Klicken Sie anschließend auf Erstellen, um eine Rückmeldedatei mit Tracking IDs zu erstellen.



    Die Rückmeldedatei wird in dem Zielpfad abgelegt, den Sie im Schritt 2 festgelegt haben.


Konfiguration pixi Versand

Nachdem Sie GLS Gepard Konfiguriert haben, muss der entsprechende Pfad noch in der Applikation pixi Versand gesetzt werden, sodass die Tracking IDs schließlich importiert werden können.

Achtung: Die durch GLS erstellte Datei kann bei der Erstellung unter Umständen den gleichen Namen tragen, wie bereits eine zuvor erstellte Datei. Ist das der Fall, dann kann die neue Datei nicht verarbeitet werden, sofern bereits eine ältere Datei mit dem gleichen Namen und der Endung ".done" im gleichen Ordner vorhanden ist. Ein unendlicher Importversuch der Tracking-IDs ist die Folge.
Verschieben Sie die ".done"-Dateien daher regelmäßig oder nutzen Sie das CSV Tracking ID Import Tool.


Starten Sie den pixi Versand, wählen Sie im Menü "Datei" den Punkt "Einstellungen" und anschließend "Versanddienstleister.


Hinterlegen Sie im Bereich "DHL Polling-Einstellungen" bei "Easy Log Tracking-ID Verzeichnis" den Speicherort, den Sie im Rückmeldeassistent von GLS Gepart im Schritt 2 festgelegt haben. Sobald Sie nun über GLS Gepard eine Rückmeldedatei erstellen und diese im festgelegten Verzeichnis abgelegt wird, prüft der pixi Versand das hinterlegte Verzeichnis auf mögliche zu verarbeitende Dateien und importiert diese in die Datenbank.


Zum Seitenanfang