Epson TM-m30III mit Adiutor verbinden (Server Direct Print)

Adiutor unterstützt Epson-Bondrucker (z.B. TM-m30III) über Epsons eigene Cloud-Funktion "Server Direct Print". In Einstellungen > Geräte > Drucker hinzufügen entspricht das dem Druckmodus "Epson: Server Direct Print" - dafür wird tatsächlich nur die 10-stellige Seriennummer des Druckers benötigt, keine feste IP-Adresse und keine Portfreigabe.

Was "Server Direct Print" bedeutet

Bei klassischem Netzwerkdruck schickt die Kassensoftware die Druckdaten aktiv an eine feste IP-Adresse des Druckers. Bei Server Direct Print ist es umgekehrt: Der Drucker fragt selbstständig und periodisch bei Adiutor nach, ob ein neuer Druckauftrag vorliegt. Liegt einer vor, druckt das Gerät ihn sofort aus.

Vorteil: Der Drucker muss nicht von aussen erreichbar sein (kein Port-Forwarding, keine feste IP im Gastro-WLAN nötig) - er muss lediglich selbst eine Internetverbindung aufbauen können.

Voraussetzungen am Drucker

Der TM-m30III bietet WLAN, Ethernet, Bluetooth und USB als Schnittstellen; für Server Direct Print wird eine aktive Internetverbindung über WLAN oder Ethernet benötigt (Bluetooth/USB reichen dafür nicht, das sind reine PC-Kopplungen).

Die Adiutor-Ziel-URL

Für Server Direct Print braucht der Drucker eine feste Ziel-URL, bei der er nach Druckaufträgen fragt. Für Adiutor ist das immer dieselbe URL, unabhängig von der einzelnen Verkaufsstelle:

https://app.adiutor.swiss/api/v1/print-direct/epson

Diese URL wird unten in Schritt 5 direkt am Drucker (nicht in Adiutor) im Feld "Server1" eingetragen. Die Zuordnung, welcher Drucker zu welcher Verkaufsstelle/Station gehört, übernimmt anschliessend Adiutor selbst über die hinterlegte Seriennummer (siehe Schritt 6).

Ablauf: Drucker erstmalig einrichten

1. Drucker mit dem Internet verbinden

Einmaliger, physischer Schritt direkt am Gerät/Netzwerk und unabhängig von Adiutor - am einfachsten per Epson TM Utility-App (iOS/Android): QR-Code am Drucker scannen, WLAN-Zugangsdaten des Betriebs eingeben, Einstellungen ans Gerät übertragen. Eine feste IP-Adresse ist dafür NICHT nötig - eine IP-Adresse wird nur kurz gebraucht, um im nächsten Schritt einmalig auf die Konfigurationsseite des Druckers zuzugreifen.

2. Seriennummer notieren

Sie befindet sich auf dem Typenschild am Gerät (bei den TM-Modellen meist unter der Abdeckung/auf der Rückseite) und ist exakt 10 Zeichen lang. Sie wird als Name-Feld beim Server-Direct-Print-Eintrag gebraucht (Schritt 6).

3. Administrator-Passwort notieren

Am Gerät befindet sich ein eigener Aufkleber mit Schloss-Symbol - darauf steht das Passwort für die Administrator-Anmeldung der Druckerkonfiguration (Schritt 5). Dieser Aufkleber ist unabhängig vom Typenschild mit der Seriennummer.

4. IP-Adresse des Druckers ermitteln und WebConfig öffnen

Um die Konfigurationsoberfläche des Druckers im Browser zu öffnen, wird kurz die aktuelle IP-Adresse des Druckers benötigt:

Drucker per Ethernet-Kabel mit dem Netzwerk verbinden.
Drucker ausschalten, dann bei gedrückter Feed-Taste wieder einschalten (gedrückt halten, bis der Drucker einen Beleg mit den Netzwerk-Statusinformationen inkl. IP-Adresse ausdruckt).

IP-Adresse-Beleg — DesktopAusgedruckter Beleg mit Netzwerk-Statusinformationen inkl. IP-Adresse, den der Drucker beim Einschalten bei gedrückter Feed-Taste ausdruckt.

Im Browser http://<IP-Adresse-des-Druckers> aufrufen.

IP-Adresse im Browser aufrufen — DesktopAdresszeile eines Browsers mit der IP-Adresse des Druckers.

Es erscheint die Startseite der Drucker-Weboberfläche:

5. Als Administrator anmelden

Oben rechts auf "Advanced Settings" klicken, dann "Administrator Login".
Als Passwort das Passwort vom Aufkleber mit dem Schloss-Symbol aus Schritt 3 eingeben.

Administrator-Login — DesktopAnmeldeseite 'Administrator Login' mit Feld 'Current password'.

6. Server Direct Print konfigurieren

Im linken Menü unter dem Reiter "Status" die Gruppe "TM-Intelligent" aufklappen und "TM-i Settings" anwählen.

Menü TM-Intelligent > TM-i Settings — DesktopLinkes Menü nach Administrator-Login: Reiter 'Status', darunter 'TM-Intelligent' mit Untereintrag 'TM-i Settings'.

Auf der folgenden Seite links unter "Services" den Punkt "Server Direct Print" auswählen.

TM-i Settings: Services > Server Direct Print — DesktopMenüstruktur der TM-i-Settings-Seite mit den Gruppen Information, Device Admin, Services (ePOS-Print, ePOS-Device, Server Direct Print, Status Notification), Miscellaneous Settings, System.

Folgende Felder ausfüllen:
- Server Direct Print: Enable
- Server1 > URL: https://app.adiutor.swiss/api/v1/print-direct/epson
- Server1 > Interval(s): 1
- ID / Password: leer lassen
- URL Encode: Enable
- Name: die 10-stellige Seriennummer des Druckers aus Schritt 2
- Server Authentication: Disable

Server Direct Print Formular mit Adiutor-URL — DesktopAusgefülltes Formular 'Services > Server Direct Print': Server Direct Print Enable, Server1-URL https://app.adiutor.swiss/api/v1/print-direct/epson, Interval(s) 1, ID/Password leer, URL Encode Enable, Name = Seriennummer, Server Authentication Disable.

Oben rechts auf "Apply & Restart" klicken. Der Drucker startet neu und übernimmt die Einstellungen.

DesktopButton 'Apply & Restart' zum Übernehmen der geänderten Einstellungen, der Drucker startet danach neu.

7. In Adiutor: Drucker anlegen

Einstellungen > Geräte > "Drucker hinzufügen":

Name vergeben.
Seriennummer eintragen (dieselben 10 Zeichen wie in Schritt 2 und 6).
Druckmodus auf "Epson: Server Direct Print" belassen (ist der Standard).
Unter "Zuweisen" die passende(n) Station(en) auswählen (z.B. "Küche"), damit Artikel mit aktivem "Küchenbon drucken" für diese Station automatisch auf diesem Drucker landen (siehe Artikel "Wie richte ich Stationen ein und weise sie Artikeln zu?").
Mit "Erstellen" speichern.

Der Drucker fragt ab jetzt selbstständig und periodisch bei Adiutor nach offenen Druckaufträgen - eine manuelle IP-Konfiguration in Adiutor entfällt vollständig.

8. Test

Am einfachsten mit einer echten Testbestellung prüfen: Artikel mit aktivem "Küchenbon drucken" für die zugewiesene Station bestellen und beobachten, ob der Beleg praktisch sofort ausgedruckt wird.

Wenn es nicht funktioniert

URL genau prüfen: Gross-/Kleinschreibung und Schrägstriche müssen exakt stimmen - https://app.adiutor.swiss/api/v1/print-direct/epson, kein abschliessender Schrägstrich, kein Leerzeichen.
Internetverbindung des Druckers prüfen: Server Direct Print funktioniert nur, wenn der Drucker selbst eine ausgehende Internetverbindung hat (nicht nur lokales WLAN ohne Internetzugang).
Name-Feld: Muss exakt der Seriennummer entsprechen, die auch in Adiutor unter Geräte hinterlegt ist - darüber ordnet Adiutor eingehende Anfragen dem richtigen Drucker zu.
Interval(s): Muss auf 1 gesetzt sein.
Administrator-Passwort: Steht auf dem Aufkleber mit dem Schloss-Symbol am Gerät, nicht auf dem Typenschild mit der Seriennummer.
Nach jeder Änderung in der Druckerkonfiguration "Apply & Restart" nicht vergessen, sonst werden die Werte nicht übernommen.

Einordnung der anderen Druckmodi

"Epson: Lokal (über Browser)": klassischer lokaler Druck, bei dem der Browser/das Kassenterminal direkt mit dem Drucker im selben Netzwerk kommuniziert - hierfür wird eine lokale Netzwerkerreichbarkeit benötigt.
"Sunmi Lokal": für Sunmi-Kassengeräte mit eingebautem/lokal verbundenem Drucker, kein Epson-spezifisches Protokoll.