pixi Connector

Die Desktop-Applikation pixi Connector ist die Schnittstelle zwischen Web und Desktop und wird folgende Aufgaben übernehmen:

• Weitergabe des lokalen Computernamens (Host Name) an pixi Web

• Übersicht und Anzeige aller lokal eingerichteten oder im Netzwerk verbundenen Drucker

• Druck-Aufträge an den/die ausgewählten Drucker weiterzuleiten

  • um aus dem Web - Artikelverwaltung Artikel-(EAN)-Etiketten zu drucken

  • um aus dem Web - Wareneingang Artikel-(EAN)-Etiketten zu drucken

  • um aus dem Web die Lieferscheine für die Ein-Paket-Sendungen (gewohnter Scan-In bzw. Ship-Out-Prozess) zu drucken

  • um aus dem Web die Versandetiketten für die Ein-Paket-Sendungen (gewohnter Scan-In bzw. Ship-Out-Prozess) zu drucken

  • um aus dem Web die Lieferscheine als Paketbegleitdokumente für Mehr-Paket-Sendungen zu drucken

  • um aus dem Web die Versandetiketten für die Mehr-Paket-Sendungen zu drucken
    (erweiterter Scan-In bzw. Ship-Out-Prozess)

• Speichern von Polling-Dateien auf dem Arbeitsplatz/Computer

• Logging des Verbindungsaufbaus zwischen Desktop-Applikation und Web-Applikation

• Einlesen und Verarbeiten von Tracking- und Retouren-Tracking-IDs

Installation | Ersteinrichtung

Der pixi Connector ist Bestandteil des pixi Desktop-Installers, der in pixi Web unter Administration > Downloads heruntergeladen werden kann.

Hinweise:
Die Applikation steht derzeit nur in englischer Sprache zur Verfügung.
Für die Anmeldung am pixi Connector ist die Aktivierung des pixi Messagings erforderlich.
Sollte dieses bei Ihnen noch nicht aktiv sein, kontaktieren Sie bitte den Descartes pixi Support.

Nachdem Sie die Applikation heruntergeladen und installiert haben, können Sie wie gewohnt, ihre Datenbank-Zugangsdaten zum Login verwenden, jeder Mitarbeiter kann sich mit seinem Username und Password anmelden. Es gibt für die Verwendung des pixi Connectors keine separate Benutzerverwaltung oder Rollenvergabe im Control Center.

• URL: https://web-ams.pixi.eu/ oder https://web.pixi.eu/

• Database: [Ihr Datenbankkürzel]

• Username: [Ihr Benutzername]

• Password: [Ihr Passwort]

Achtung: Läuft der Connector dauerhaft auf einem PC oder Server, der nie heruntergefahren wird, muss mindestens alle 5 Tage eine erneute Anmeldung erfolgen. Erfolgt diese Anmeldung nicht, kann sich der Connector im Hintergrund nicht mehr authentifizieren und stellt seine Funktion ein. Es erscheint dabei kein Hinweis für den Nutzer. In diesem Fall sollte der Connector manuell neu gestartet werden.

Der Installer erstellt automatisch eine Verknüpfung in den Verzeichnissen:

• C:\ProgramData\Microsoft\Windows\Start Menu\Programs\pixi (Windows 10)

• C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp (Windows 10)

anlegen, die auf den pixi Connector im pixi Verzeichnis verlinken (C:\pixi\pixiConnector.exe) sofern sie die Autostart-Optionen für den pixi Connector ändern möchten, finden Sie weiterführende Information auf dieser Microsoft-Seite (Ändern der Funktion, welche Apps beim Start von Windows 10 automatisch ausgeführt werden).

In unseren Tests wurde nach der Deinstallation und erneuter Installation der Status in den Autostart-Optionen beibehalten (wurde der Autostart vor der Deinstallation deaktiviert = blieb der Autostart auch nach erneuter Installation deaktiviert).

Nachdem Sie sich an der Applikation angemeldet haben, läuft diese im System-Tray des Arbeitsplatzes:

Rechtsklick auf das Icon pixi Connector:

• About: zeigt Ihnen die aktuell verwendete Version, den angemeldeten Benutzer (User) und den Computer-Namen (Computer) an.

• Darüberhinaus werden alle an diesem Arbeitsplatz/Computer eingerichteten/verbundenen Drucker (Printers) angezeigt, die sie im Nachgang in der Web-Applikation zum Drucken von Artikel-Etiketten, Versand-Etiketten oder Lieferscheinen auswählen können.

• Die Angabe bei Printing zeigt Ihnen an, ob eine Verbindung zum pixi Messaging (Rabbit MQ) hergestellt werden konnte (Enabled/Disabled).

• Rediscover printers: sucht und lädt erneut die lokal verbundenen Drucker in die pixi Datenbank und protokolliert diese auch in der Log-Datei (siehe Logging des Verbindungsaufbaus) (bpsw. relevant, wenn ein Drucker zu einem späteren Zeitpunkt gelöscht oder hinzugefügt wird.)

• Beim (Neu-)Start des pixi Connectors werden immer alle derzeit verfügbaren Drucker geladen.

:{"@t":"2020-09-04T13:09:23.6168393Z","@mt":"Discovered printers: Adobe PDF, ZDesigner GC420d, SLO_RICOH_MP_C2004ex, OneNote for Windows 10, Print barcode to file_ZDesigner GK420d (EPL), OneNote (Desktop), Microsoft XPS Document Writer, Microsoft Print to PDF, KONICA MINOLTA bizhub 20 PCL (10.8.157.199) UPD, Fax, \\\\CPINF01\\SI-SNR-RICOH, \\\\CPINF01\\SI-SNR-GEN-Konica Minolta Bizhub 20.","Username":""}

• Exit: beeendet die Applikation

Speichern von Druck-Aufträgen

• Dokumente wie bspw. Lieferscheine werden so lange temporär (als .pdf) gespeichert, bis diese gedruckt werden konnten.

• Dokumente wie bspw. Versand-Etiketten werden so lange temporär (als .) gespeichert, bis diese gedruckt werden konnten.

• Die Dateien werden in folgendem Verzeichnis gespeichert:

  • C:\Users\{%User%}\AppData\Local\pixi\pixiConnector\savedPrintJobs

• Das Verzeichnis wird komplett geleert, sobald die Größe von 1GB überschritten wurde.

Logging des Verbindungsaufbaus

• Der Verbindungsaufbau zwischen Desktop-Applikation und Web-Applikation sowie die jeweiligen Druckaufträge werden lokal in folgendem Verzeichnis protokolliert:

  • C:\Users\{%User%}\AppData\Local\pixi\pixiConnector\

Bitte übermitteln Sie uns zur weiteren Analyse bzw. zum Troubleshooting immer auch die Log-Files des jeweiligen Arbeitsplatzes.

• Log Rotation:

  • Es wird zunächst eine Log-Datei: pixiConnector.log erstellt, sobald die Größe von 33 MB überschritten wurde, wird eine neue Datei in folgendem Format erstellt: pixiConnector_001.log
    Weitere Dateien werden analog dazu erstellt: pixiConnector_002.log.

  • Die maximale Größe des Verzeichnisses überschreitet nicht die 100 MB-Marke,
    sofern die pixiConnector_004.log Datei geschrieben wurde,
    wird die älteste Datei bspw. pixiConnector_001.log entfernt.

Drucken von Artikel-Etiketten aus den Wareneingängen

Sie können Artikel-Etiketten aus den Wareneingängen drucken.

Hinweis: Das Drucken von Artikel-Etiketten aus den Wareneingängen erfordert die vorherige Aktivierung von pixi Messaging, bitte wenden Sie sich an die Kollegen vom Support (servicedesk@descartes.com).
Sie werden Ihnen bei der Einrichtung von pixi Messaging behilflich sein.

Einlesen und Verarbeiten von Tracking- und Retouren-Tracking-IDs

Tracking-Informationen konnten bisher nicht automatisiert über pixi zum jeweiligen Paket oder zur jeweiligen Rechnung importiert werden. Die Daten mussten daher entweder zur Rechnung importiert werden, konnten im Fallen von Retouren-Tracking-IDs systemseitig über das Control Center generiert werden und über die "Versandbestätigung" E-Mail an die Endkunden (mit Tracking-Link funktioniert nur dann, wenn alle Pakete mit dem gleichen Logistiker versandt wurden) übermittelt werden.

Sollen Tracking-Informationen zum Paket importiert werden, muss dies aktuell über den bestehenden API Call pixiUpdateInvoicePackage realisiert werden.
In diesem Fall kann die neue E-Mail-Art "Paketinformationen" ohne Einschränkungen verwendet werden.

Der Import von Tracking und Retouren-Tracking-IDs wird über die Konfigurationsdatei pixiToolboxSettings.json gesteuert.
Die Konfigurationsdatei befindet sich im Pfad:
C:\Users\{%User%}\AppData\Local\pixi\pixiConnector\
z. B. C:\Users\{user}\AppData\Local\pixi\pixiConnector\pixiToolboxSettings.json

In der Konfigurationsdatei lassen sich beliebig viele Profile speichern und somit Dateien auch aus anderen Verzeichnissen berücksichtigen und verarbeiten.

Sollte sich die Datei nicht im beschriebenen Pfad befinden, so können Sie diese mithilfe eines Text-Editors als
pixiToolboxSettings.json anlegen.

Derzeit lassen sich Tracking-Dateien nur im Format *.csv|*.xml|*.out verarbeiten.

Beispiel: Wenn bei Ihnen die TrackingID in der CSV-Datei an zweiter Stelle steht, sollten Sie den entsprechenden Wert für TrackingIDIndex im pixiToolboxSettings.json CSV-Profil auf 1 setzen.
Gleiches gilt für ReturnTrackingIDIndex, PackageIDIndex, InvoiceNumberIndex.
Der Wert kann auch leer gelassen werden, dann wird jedoch nichts für diesen Parameter importiert.

*.csv Profil DHL

• DHL SP = DHL Single Package Ship-Out = Ein-Paket-Sendungen:

  • Für das Einlesen und Verarbeiten von Tracking- und Retouren-Tracking-IDs für Ein-Paket-Sendungen muss der Parameter PackageIDIndex entfernt bzw. ausgelassen werden.

• DHL MP = DHL Multiple Package Ship-Out = Mehr-Paket-Sendungen:

  • Für das Einlesen und Verarbeiten von Tracking- und Retouren-Tracking-IDs für Mehr-Paket-Sendungen muss der Parameter PackageIDIndex gesetzt sein (bpsw. "PackageIDIndex": 0,)

  • Weitere Informationen zur Konfiguration finden Sie hier: Mehr-Paket-Sendungen

{
    "GeneralSettings": {
                    "TrackingIdImportChunkSize": 200,
                    "PixiWebURL": "https://web.pixi.eu",
                    "PixiDatabase": "ABC",
                    "ResetClientNotified": true,
										"AutomaticLogin": false
                   
},
    "SaveDocumentSettings": {
            "SavedDocumentsPath": "C:\\pixi\\SavedDocuments",
            "CreateSubfoldersForEachMonth": true
        },

    "Profiles": [
        {
            "ProfileName": "DHL CSV Profile SP",
            "ParsingMethod": 0,
            "ShipVendorFolder": "C:\\pixi\\DHL\\TrackingIds\\",
            "FileFilter": "*.csv",
            "ProcessedFilePath": "C:\\pixi\\DHL\\TrackingIds\\",
            "ProcessedFileType": ".done",
            "ErrorFilePath": "C:\\pixi\\DHL\\TrackingIds\\",
            "ErrorFileType": ".error",
            "IgnoreHeader": true,
            "Separator": ";",
            "TrackingIDIndex": 1,
            "ReturnTrackingIDIndex": 66,
            "InvoiceNumberIndex": 22
        },
        {
            "ProfileName": "DHL CSV Profile MP",
            "ParsingMethod": 0,
            "ShipVendorFolder": "C:\\pixi\\DHL\\TrackingIdsSubfolders\\",
            "FileFilter": "*.csv",
            "ProcessedFilePath": "C:\\pixi\\DHL\\TrackingIdsSubfolders\\Processed\\",
            "ProcessedFileType": ".done",
            "ErrorFilePath": "C:\\pixi\\DHL\\TrackingIdsSubfolders\\Error\\",
            "ErrorFileType": ".error",
            "IgnoreHeader": true,
            "Separator": ";",
            "TrackingIDIndex": 1,
            "ReturnTrackingIDIndex": 66,
            "PackageIDIndex": 0,
            "InvoiceNumberIndex": 22
        }
    ]
}

*.csv Profil DPD

{
  "Profiles": [
    {
        "ProfileName": "DPD CSV Profile SP",
        "ParsingMethod": 0,
        "ShipVendorFolder": "C:\\pixi\\DPD\\Tracking\\",
        "FileFilter": "*.csv",
        "ProcessedFilePath": "C:\\pixi\\DPD\\Tracking\\DONE\\",
        "ProcessedFileType": ".done",
        "ErrorFilePath": "C:\\pixi\\DPD\\Tracking\\ERROR\\",
        "ErrorFileType": ".error",
        "IgnoreHeader": true,
        "Separator": ";",
        "TrackingIDIndex": 0,
        "InvoiceNumberIndex": 3
    }
  ]
}

*.xml Profil UPS

{
  "Profiles": [
    {
        "ProfileName": "UPS XML profile SP",
        "ParsingMethod": 1,
        "ShipVendorFolder": "C:\\pixi\\UPS\\Polling\\",
        "FileFilter": "*.Out",
        "ProcessedFilePath": "C:\\pixi\\UPS\\Polling\\Success",
        "ProcessedFileType": ".success",
        "ErrorFilePath": "C:\\pixi\\UPS\\Polling\\Error",
        "ErrorFileType": ".error",
        "TrackingIDPath": "OpenShipments/OpenShipment/ProcessMessage/TrackingNumbers/TrackingNumber",
        "InvoiceNumberPath": "OpenShipments/OpenShipment/ShipmentInformation/Reference1"
    },
    {
        "ProfileName": "UPS XML profile MP",
        "ParsingMethod": 1,
        "ShipVendorFolder": "C:\\pixi\\UPS\\Polling_MP\\",
        "FileFilter": "*.Out",
        "ProcessedFilePath": "C:\\pixi\\UPS\\Polling_MP\\Success",
        "ProcessedFileType": ".success",
        "ErrorFilePath": "C:\\pixi\\UPS\\Polling_MP\\Error",
        "ErrorFileType": ".error",
        "TrackingIDPath": "OpenShipments/OpenShipment/ProcessMessage/TrackingNumbers/TrackingNumber",
        "PackageIDPath": "OpenShipments/OpenShipment/ShipmentInformation/Reference2",
        "InvoiceNumberPath": "OpenShipments/OpenShipment/ShipmentInformation/Reference1"
    }
  ]
}

*.xml Profil VLOG

{
  "Profiles": [
    {
      "ProfileName": "VLOG XML profile",
      "ParsingMethod": 1,
      "ShipVendorFolder": "C:\\pixi\\XMLImportTesting",
      "FileFilter": "*.xml",
      "ProcessedFilePath": "C:\\pixi\\XMLImportTesting\\Success",
      "ProcessedFileType": ".success.xml",
      "ErrorFilePath": "C:\\pixi\\XMLImportTesting\\Error",
      "ErrorFileType": ".error.xml",
      "Separator": ";",
      "TrackingIDPath": "MHP_STRUKTUR/SHIPMENT/SHIPMENT_DETAILS/PACKAGE/PACKAGE_HEADER/SEND_ID",
      "ReturnTrackingIDPath": "MHP_STRUKTUR/SHIPMENT/SHIPMENT_DETAILS/PACKAGE/PACKAGE_HEADER/SEND_GEWICHTEINZEL",
      "PackageIDPath": "MHP_STRUKTUR/SHIPMENT/SHIPMENT_DETAILS/PACKAGE/PACKAGE_HEADER/SEND_2N_PRODCODE",
      "InvoiceNumberPath": "MHP_STRUKTUR/SHIPMENT/SHIPMENT_HEADER/SEND_REFERENZNR_01"
    }
  ]
}