QuixPOS/Dokumentation/quixpos2jtl (JTL-Wawi Sync)/Überblick & Architektur

QuixPOS2JTL - Überblick & Architektur

QuixPOS2JTL ist das Verbindungsglied (Middleware) zwischen deinem QuixPOS ↗ Kassensystem und der JTL-Wawi (JTL-Warenwirtschaft).

┌─────────────────────────────────────────────────────────────┐
│                    Electron (Tray App)                      │
│  ┌───────────┐  ┌────────────────────────────────────────┐  │
│  │ Tray Icon │  │ Settings Dialog (7 Tabs)               │  │
│  │  + Menu   │  │  • Database     • Pairing (PIN/Devices)│  │
│  └─────┬─────┘  │  • Shop         • Service Manager      │  │
│        │        │  • Network      • Live Logs Terminal   │  │
│        │        │  • Certificate                         │  │
│        │        └────────────────────────────────────────┘  │
│  ┌─────▼────────────────────────┐                           │
│  │       Service Manager        │                           │
│  │  ┌──────────┬──────────────┐ │                           │
│  │  │ Embedded │ Win Service  │ │                           │
│  │  │  (fork)  │ (LocalSystem)│ │                           │
│  │  └──────────┴──────────────┘ │                           │
│  └──────────────────────────────┘                           │
└─────────────────────────────────────────────────────────────┘
         │                          │
         ▼                          ▼
┌─────────────────────────────────────────────────────────────┐
│                     REST API Service                        │
│   Express (HTTP :8087 / HTTPS :4447 / Windows Named Pipe)   │
│   ├── JTL-POS Core Protocol (/v1/*)                         │
│   │    ├── Pairing & Auth Handshake (/v1/client, /v1/newpin)│
│   │    ├── Master Data (/v1/init, category, product, etc.)  │
│   │    ├── Images & Resize (/v1/pimage, /v1/cimage)         │
│   │    └── Orders & Fulfillment (/v1/order)                 │
└─────────────────────────────────────────────────────────────┘

Hauptfunktionen

  • JTL-POS Core Protokoll: 100% kompatibel zu den JTL-POS Kommunikationsstandards.
  • Automatische Synchronisation:
  • Artikelstammdaten, Preise, EANs, Barcodes und Warengruppen direkt aus MSSQL (eazybusiness).
  • Produktbilder werden on-the-fly skaliert und über den Sync-Server bereitgestellt.
  • Kassenbelege, Rechnungen und Zahlungsarten werden sofort in JTL verbucht.
  • Bestände werden in Echtzeit abgeglichen.
  • Flexible Betriebsmodi:
  • System Tray App: Läuft unauffällig in der Windows-Taskleiste neben der Uhr.
  • Windows-Hintergrunddienst (LocalSystem): Startet automatisch vor der Windows-Benutzeranmeldung.
  • Linux / Docker CLI: Headless-Betrieb auf POS-Servern.