PrestaShop-Modul: Bestellungen automatisch drucken (Cloud Print)

Drucken Sie neue Bestellungen automatisch, sobald sie eingehen (oder sobald die Zahlung akzeptiert wird). Ohne Computer, Tablet, Smartphone, lokalen Druckserver oder Treiber zum Installieren. Ihr Drucker verbindet sich über den Expedy Cloud Print Server direkt mit Ihrem PrestaShop-Shop, per WLAN, Ethernet oder 3G/4G-SIM-Karte.

Diese Dokumentation behandelt ExpedyPRINT v2, unser aktuelles Modul, das auf der ExpedyPRINT API v2 neu aufgebaut wurde. Für Versionen vor v2 bieten wir keinen Support an.

⚠️ Ihr PrestaShop-Shop muss SSL aktiviert haben und darf nicht im Dev- oder Debug-Modus laufen. Diese Modi können API-Anfragen blockieren und den Versand von Druckaufträgen verhindern.

Kompatible Drucker:

Möchten Sie die Kompatibilität mit einem anderen Drucker prüfen? Erstellen Sie ein Support-Ticket.

Voraussetzungen

Minimum
PrestaShop 1.6 (getestet bis 8.x)
PHP 7.2

Sie benötigen außerdem ein kostenloses Expedy-Konto mit einer API-SID, einem API-Token und mindestens einem im Konto registrierten Cloud-Drucker.

Download

Laden Sie die neueste expedyprint.zip von der GitHub-Releases-Seite herunter:

👉 github.com/ExpedyDev/expedyprint-prestashop-addon/releases

Jedes Release liefert die installationsbereite Zip-Datei und ihr Changelog. Diese eine Datei ist alles, was Sie brauchen.

Der vollständige Quellcode ist offen und hier verfügbar:

👉 github.com/ExpedyDev/expedyprint-prestashop-addon

Installation

  1. Laden Sie expedyprint.zip vom neuesten Release herunter.
  2. Öffnen Sie im PrestaShop-Backoffice Module → Modul-Manager.
  3. Klicken Sie auf Modul hochladen und wählen Sie die heruntergeladene expedyprint.zip aus. Das Modul wird automatisch installiert.
  4. Klicken Sie nach der Installation auf Konfigurieren.

Keine Treiber, keine Befehlszeile, keine zusätzliche Software.

Konfiguration

Öffnen Sie Module → Modul-Manager → ExpedyPRINT → Konfigurieren. Das Einstellungs-Dashboard ist in klar beschriftete Bereiche gegliedert, und die Tools für Verbindung, Drucker und Vorschau funktionieren alle, ohne dass das Formular zuerst gespeichert werden muss.

1. API-Verbindung

Fügen Sie Ihre API-SID und Ihr API-Token ein und klicken Sie dann auf Verbindung testen.

Einstellung Beschreibung
API-SID Ihre Konto-Kennung, verfügbar in der Expedy-Konsole unter API.
API-Token Ihr geheimer Schlüssel, verfügbar im selben Bereich API. Behandeln Sie es wie ein Passwort. Es wird sicher und schreibgeschützt gespeichert und daher nie wieder angezeigt. Lassen Sie das Feld beim Speichern leer, um das bereits gespeicherte Token beizubehalten.

Bei einem erfolgreichen Test wird die Druckerliste aus Ihrem Konto abgerufen und das Drucker-Dropdown automatisch befüllt.

2. Drucker

Einstellung Beschreibung
Drucker Wählen Sie Ihren Drucker aus dem Dropdown, das aus Ihrem Konto geladen wird (es zeigt Name, Papierbreite und UID).
UID des Ersatzdruckers Optional. Ein zweiter Drucker, der denselben Beleg erhält, nützlich für Redundanz.
Papierbreite 58 mm oder 80 mm, passend zur Papierrolle Ihres Druckers.

Verwenden Sie Testdruck senden, um einen Beispielbeleg auf dem ausgewählten Drucker zu drucken und zu bestätigen, dass alles korrekt eingerichtet ist.

3. Druckauslöser

Einstellung Beschreibung
Beleg drucken Wählen Sie, wann gedruckt wird: sobald eine Bestellung aufgegeben wird, oder wenn der Bestellstatus „Zahlung akzeptiert" wird.
Anzahl der Kopien 1 bis 5 Kopien pro Bestellung.
Papier nach jedem Beleg abschneiden Schneidet das Papier am Ende jedes Druckauftrags automatisch ab, bei Druckern, die dies unterstützen.

4. Beleginhalt

Wählen Sie, wie Produkte und Beträge angezeigt werden und welche Blöcke gedruckt werden:

  • Produktanzeige: Produktname und Attribute, Produktreferenz und Attribute, nur Name oder nur Referenz.
  • Beträge: Zeilenbeträge inkl. MwSt., exkl. MwSt. oder keine Zeilenbeträge. Beträge werden ohne Währungssymbol gedruckt, um maximale Kompatibilität mit Thermodruckern zu gewährleisten.
  • Summen: drucken Sie den Gesamtbetrag inkl. MwSt., den Gesamtbetrag exkl. MwSt. und/oder das Steuerdetail.
  • EAN-13-Barcodes: drucken Sie den Produkt-Barcode in jeder Zeile.
  • Anzahl der Artikel, Zahlungsart, Liefer-/Versandart, Kundennotiz: schalten Sie jeden Block ein oder aus.

5. Kopf- und Fußzeile des Shops

Optionale Logo-URL (HTTPS, GIF/JPG/PNG, max. Breite 570px), Shop-Titel, Firmenname, Adresse, Postleitzahl, Stadt, Telefon und Unternehmens-ID, alle auf dem Beleg gedruckt.

6. Beleg-Wortlaut

Jede auf dem Beleg gedruckte Bezeichnung (Bestellung, Produkt, Preis usw.) ist vollständig anpassbar, in der von Ihnen gewünschten Sprache.

7. Erweitert: Multistore-Zuordnung

Leiten Sie Abholungen im Geschäft an einen bestimmten Drucker weiter, im Format store_id:printer_uid||store_id:printer_uid. Zum Beispiel können Bestellungen für Ihren Londoner Shop automatisch auf einem Drucker gedruckt werden, während Edinburgh-Bestellungen an einen anderen gehen, vollständig automatisiert, ohne manuelle Sortierung.

Bestellbeleg-Vorschau

Unten auf der Einstellungsseite erzeugt das Tool Bestellbeleg-Vorschau den exakten Beleg für jede bestehende Bestellung. Geben Sie einfach die Bestell-ID ein und klicken Sie auf Vorschau. Kein Drucker erforderlich.

Funktionsweise

Das Modul überwacht Ihre Bestellereignisse und erstellt, sobald der konfigurierte Auslöser erreicht ist, den Beleg und sendet ihn über die ExpedyPRINT-Cloud-API an Ihren Drucker.

Eine Bestellung wird einmal gedruckt: ein Idempotenz-Flag verhindert, dass dieselbe Bestellung zweimal gedruckt wird. Schlägt ein Druckversuch fehl, wird die Bestellung nicht markiert und kann beim nächsten Statuswechsel erneut versucht werden. Jeder Versuch, ob erfolgreich oder nicht, wird unter Erweiterte Parameter → Protokolle (Logs) aufgezeichnet (Quelle expedyprint).

Kompatible Module

ExpedyPRINT kann Daten aus anderen PrestaShop-Modulen lesen, um zusätzliche Informationen wie Abhol- oder Lieferart, Datum und Zeitfenster sowie Produktoptionen zu drucken. Zu den unterstützten Integrationen gehören:

  • Liefer- und Abholzeitfenster: prestatilldrive, prestadrive, prestatillhomedelivery, fspickupatstorecarrier, preferreddeliverytime
  • Produktoptionen und benutzerdefinierte Felder: configurator, an_productfields, idxrcustomproduct

Diese Liste ist nicht vollständig. Wir können einen korrekten Druck nicht garantieren, wenn Ihre PrestaShop-Installation stark angepasst wurde oder Module verwendet, die die zentralen Bestellfunktionen verändern.

Eigene Integration entwickeln

Um aus Ihrer eigenen Anwendung oder einer anderen Plattform zu drucken, verwenden Sie das offizielle Node.js-SDK und die API-Beispiele:

👉 github.com/ExpedyDev/expedy-sdk-node

Es zeigt, wie Sie sich authentifizieren, Ihre Drucker auflisten und Druckaufträge über die ExpedyPRINT API v2 senden.

Anpassung und Support

Das Modul ist Open Source unter der Open Software License (OSL 3.0), Sie können den Code also frei an Ihre Bedürfnisse anpassen. Expedy bietet keine maßgeschneiderte Entwicklung oder individuelle Anpassungsleistungen mehr an.

Support wird nur für ExpedyPRINT v2 angeboten. Versionen vor v2 werden nicht mehr unterstützt.