Einrichtungsanleitung für den Labeldruck in der Scanstation

Einleitung

tricoma ist eine webbasierte Onlinesoftware und kann daher nicht direkt auf einen lokalen Labeldrucker zugreifen. Deshalb müssen auf dem lokalen PC, an dem die Scanstation geöffnet ist und an dem ein Labeldrucker angeschlossen ist (Scanstation-PC), bestimmte Einrichtungen vorgenommen werden, damit der Zugriff möglich ist.

In diesem Tutorial wird Schritt für Schritt erklärt, wie du die Einrichtung korrekt vornimmst. Als Beispiele verwenden wir die Versanddienstleister DHL und UPS. Möchtest du die Einrichtung für andere Versanddienstleister durchführen, übertrage die Beispiele entsprechend auf die gewünschten Anbieter.

Nach der Einrichtung solltest du in der Lage sein, die Labels deiner Versanddienstleister direkt bei der Kommissionierung auf dem Scanstation-PC auszudrucken.
Wenn du die App Druckserver nutzen möchtest, um Dokumente oder Belege aus dem tricoma System zu drucken, folge bitte diesem Tutorial:
Einrichtungsanleitung des Druckservers

Bevor du startest, ist es wichtig, dass die Einrichtung der entsprechenden Connectoren der Versanddienstleister abgeschlossen ist. Unter anderem sollte der Verbindungstest in den Schnittstellen funktionieren.

Hinweis:
Die folgenden Schritte müssen auf jedem Scanstation-PC durchgeführt werden, auf dem die Paketlabels gedruckt werden sollen.

Voraussetzungen am Scanstation-PC

• 64-Bit Windows-Betriebssystem, auf dem neuesten Stand
• Ausreichende Zugriffsrechte
• Microsoft Runtime (bei Windows standardmäßig installiert)
• Installierter Druckertreiber in der aktuellsten Version
• Labeldrucker angeschlossen und vom PC erreichbar (am besten Testseite in den Drucker-Einstellungen drucken)

Wende dich an den Administrator oder IT-Dienstleister, wenn die Voraussetzungen nicht erfüllt sind.
Der tricoma Support ist in diesem Fall nicht der richtige Ansprechpartner.

1. Schritt: XAMPP und Zertifikat installieren

Hinweis: Dieser und der nächste Schritt müssen nur einmal pro PC durchgeführt werden. Wenn XAMPP und das Zertifikat bereits installiert sind (z. B. für den Druckserver oder andere Druckskripte), fahre direkt mit Schritt 3 fort.

Öffne den Scriptgenerator in der App Einrichtungsassistent und lade XAMPP über den grünen Button herunter:

Entpacke den Ordner xampp aus der heruntergeladenen ZIP-Datei direkt auf das Laufwerk C:\.

• Wichtig: Keine Dateien oder Unterordner im Ordner xampp löschen.
• Achte darauf, dass das Antivirus-Programm nichts aus diesem Ordner entfernt.

Führe die Datei C:\xampp\setup_xampp.bat mit Administratorrechten aus (Rechtsklick → Als Administrator ausführen). Falls eine Fehlermeldung erscheint, führe die Datei ohne Adminrechte aus.

Wenn alles erfolgreich war, erscheint in der Kommandozeile die Meldung:

• Warnmeldungen können ignoriert werden.
• Drücke eine beliebige Taste, um die Kommandozeile zu schließen.

Installiere nun das Zertifikat, indem du die Datei C:\xampp\server.crt öffnest und auf „Zertifikat installieren“ klickst.
Befolge die Einzelschritte der folgenden Screenshots und klicke anschließend auf „Fertigstellen“:

2. Schritt: XAMPP konfigurieren

Öffne mit Administratorrechten die Datei C:\xampp\xampp-control.exe und folge den Einzelschritten gemäß dem Screenshot:

Nach der Konfiguration sollte das XAMPP-Fenster ungefähr so aussehen:

XAMPP wird nun automatisch bei jedem Hochfahren des PCs gestartet, inklusive des Dienstes Apache. Bitte nimm keine Änderungen mehr vor.

Hinweis:
Der Apache-Dienst wird benötigt, um die Druckaufträge vom onlinebasierten tricoma an die lokale Druckerwarteschlange des Scanstation-PCs weiterzuleiten.

Prüfe nun den Dienst, indem du localhost in die Adresszeile deines Browsers eingibst. Wenn der Dienst korrekt läuft, wird die folgende Grafik angezeigt. Danach bist du bereit für den nächsten Schritt.

3. Schritt: Druckskripte generieren und herunterladen

1. Öffne erneut den Scriptgenerator, in dem du XAMPP heruntergeladen hast.
2. Scrolle nach unten, um alle installierten Versanddienstleister-Connectoren zu sehen.

In unserem Beispiel werden die Druckskripte für DHL und UPS heruntergeladen:

1. Wähle den DHL Connector und anschließend die Lieferart(en), die du für DHL-Sendungen vorgesehen hast. In unserem Beispiel heißt die Lieferart ebenfalls DHL.
2. Gib im Feld „Name des Labeldruckers“ die exakte Bezeichnung deines Druckers ein (zu finden in der Systemsteuerung oder Windows-Einstellungen). Bei Unsicherheiten wende dich an einen IT-Fachmann oder Administrator.
3. Wiederhole die Schritte für UPS WorldShip entsprechend den vorgesehenen Lieferarten

Klicke nun auf „Druckskripte herunterladen“. Dabei wird folgendes gleichzeitig passieren:

• Die Druckskripte werden gemäß der gewählten Konfiguration generiert
• Die URLs für den Paketdatenexport werden in den Einstellungen der App Scanstation hinterlegt
• Die Druckskripte werden in der Datei exports.zip gepackt und auf dem Scanstation-PC heruntergeladen

4. Schritt: Druckskripte installieren

Entpacke die Ordner aus der ZIP-Datei nach C:\xampp\htdocs\.

In den entpackten Ordnern sollten Verknüpfungen enthalten sein (Dateityp: Verknüpfung):

• DHL Connector: Datei Intrashipexport
• UPS WorldShip Connector: Datei UPS WorldShip

Kopiere die Verknüpfungen in den Autostart-Ordner von Windows:
👉🏻 Windows-Taste + R → gib shell:startup ein → ENTER

Dadurch werden die Verknüpfungen beim Hochfahren des Scanstation-PCs automatisch ausgeführt.

• Bei Bedarf kannst du die Verknüpfungen direkt starten, ohne deinen PC neu zu starten.
• Beim Start öffnet sich jeweils ein Kommandozeilenfenster. Diese Fenster bitte niemals schließen, sonst funktioniert der Labeldruck nicht.

Sobald die Kommandozeilen im Hintergrund laufen, kannst du Paketlabels für DHL und UPS über die Scanstation drucken.

Die Einrichtung für diesen Scanstation-PC ist damit abgeschlossen.

Weiterführende Links

Videoanleitung:

• Video: Druckskripte über den Skriptgenerator erstellen

Bei Probleme:

• Probleme beim Druckserver bzw. Labeldruck selbst lösen
• Probleme beim Generieren von DHL-Paketlabels
• Fehlermeldung: "Hard Validation Error" im DHL Connector

Informationen zum Paketdatenexport:

• Workflow: Kommissionierung, Paketdatenexport und Checkout