Dieser Artikel beschreibt die technische Einrichtung der Lagerverwaltung: Voraussetzungen, Workspace-Einstellungen, die begleitende mobile Web-App (PWA), QR-Code-Konfiguration, Fotospeicherung und die optionale KI-Recherchefunktion. Einen Überblick über die Grundfunktionen findet sich unter Lagerverwaltung – Überblick.
Voraussetzungen
- REST API aktiviert: Die PWA und alle mobilen Buchungen laufen über die eingebettete REST API von ComBinder. Ohne aktive API ist kein Smartphone-Zugriff möglich. Einrichten: REST API aktivieren.
- Netzwerkzugang zum ComBinder-Rechner: Smartphones müssen den Rechner erreichen können, auf dem ComBinder läuft (gleiches WLAN oder VPN). Der konfigurierte Port (Standard:
8765) muss in der Windows-Firewall freigegeben sein. - Workspace geöffnet: Inventare sind an ein Projekt gebunden; ein geöffneter Workspace ist für alle API-Zugriffe Voraussetzung.
Einstellungen öffnen
Alle lagerverwaltungsspezifischen Einstellungen befinden sich in den ComBinder-Einstellungen im Tab „Lagerverwaltung". Dort stehen fünf Konfigurationsfelder zur Verfügung:
LLM-Anbieter
Auswahl des KI-Sprachmodells für die Produktrecherche-Funktion in der PWA. Optionen: none (deaktiviert), anthropic (Claude), openai (GPT). Standardmäßig ist die Funktion deaktiviert.
Anthropic API-Schlüssel / OpenAI API-Schlüssel
Der API-Schlüssel des gewählten Anbieters. Wird nur ausgewertet, wenn der passende Anbieter ausgewählt ist. Die Recherche-Funktion ist auf 20 Anfragen pro Minute begrenzt (gilt workspace-weit für alle gleichzeitig verbundenen PWA-Nutzer).
QR-Code Basis-URL
Die Deep-Link-URL, die in jedem QR-Code steckt. Format: https://<host>/inventory/ – ComBinder hängt automatisch {inventoryId}/{locationId} an. Standardwert: https://inventory.combinder.app/l/.
Wichtig vor dem Produktivbetrieb: Diesen Wert auf die tatsächlich erreichbare Adresse des ComBinder-Rechners setzen, z. B. http://192.168.1.100:8765/inventory/. Sonst öffnet der QR-Code auf dem Smartphone eine nicht erreichbare URL. Bereits gedruckte QR-Codes werden ungültig, wenn die Basis-URL nachträglich geändert wird.
Foto-MIME-Root
Legt fest, in welchem MIME-Root-Speicherort die über die PWA hochgeladenen Produktfotos abgelegt werden. Nur lokale MIME-Roots (kein FTP) sind zulässig. Wird kein Wert gesetzt, verwendet ComBinder den Standard-MIME-Root des Workspace.
Die PWA aufrufen
Die Inventar-PWA ist über denselben Port wie die REST API erreichbar und muss nicht separat installiert werden:
http://<IP-des-ComBinder-Rechners>:8765/inventoryDie PWA kann auf dem Smartphone-Homescreen als App-Symbol gespeichert werden (im Browser „Zum Startbildschirm hinzufügen"). Sie funktioniert als Single-Page-App: Direktlinks aus QR-Codes (z. B. /inventory/5/abc123) öffnen sofort den richtigen Lagerort.
Login in der PWA
Die PWA nutzt dieselben Benutzerkonten wie der ComBinder-Desktop. Benutzername und Passwort sind identisch. Nach dem Login ist der Nutzer 24 Stunden angemeldet (Token-Gültigkeitsdauer).
QR-Codes einrichten und drucken
- Basis-URL in den Einstellungen korrekt setzen (siehe oben).
- Im Inventar-Baum einen oder mehrere Lagerorte auswählen.
- Rechtsklick → „QR-Code exportieren" → Zielordner wählen. ComBinder erzeugt 600-px-PNG-Dateien, je eine pro Lagerort, benannt nach dem Lagerort-Namen.
- PNG-Dateien ausdrucken (z. B. als Regalschilder, Etiketten oder laminierte Karten) und am physischen Lagerort anbringen.
Alternativ lässt sich über „QR-Link kopieren" der Deep-Link-URL manuell in ein eigenes Etikettendruckprogramm einfügen.
Produktfotos via PWA
In der PWA kann ein Nutzer zu einem gefundenen Produkt ein Foto aufnehmen oder aus der Galerie hochladen. ComBinder speichert das Bild als regulären MIME-Eintrag am Produkt (Zweck: InventoryPhoto) und erstellt automatisch ein Thumbnail (max. 400 px). Das Originalbild erscheint danach im Produktmanager der Desktop-Anwendung in der Bildergalerie des Produkts.
Voraussetzung: Der unter „Foto-MIME-Root" konfigurierte Speicherort muss vom ComBinder-Rechner aus beschreibbar sein.
REST API für eigene Integrationen
Die Inventar-API lässt sich auch direkt von eigenen Skripten oder Automatisierungstools ansprechen. Alle Endpunkte erfordern ein Bearer-Token (POST /api/auth/login):
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /api/inventory | Alle Inventare (optional: ?projectId=) |
| POST | /api/inventory | Neues Inventar anlegen |
| GET | /api/inventory/{id}/locations | Alle Lagerorte eines Inventars |
| POST | /api/inventory/{id}/locations | Lagerort anlegen |
| GET | /api/inventory/{id}/locations/{locationId}/products | Produkte an einem Lagerort |
| POST | /api/inventory/{id}/locations/{locationId}/products | Produkt einbuchen |
| PATCH | /api/inventory/{id}/locations/{locationId}/products/{productId} | Menge / Einheit / Mindestbestand aktualisieren |
| DELETE | /api/inventory/{id}/locations/{locationId}/products/{productId} | Produkt ausbuchen |
| GET | /api/inventory/{id}/movements | Bewegungsprotokoll (neueste zuerst) |
| GET | /api/inventory/{id}/locations/{locationId}/qrcode | QR-Code als PNG (?size=400) oder JSON (?format=json) |
Der Lagerort-Bezeichner root steht stellvertretend für den Wurzel-Lagerort des Inventars.
FAQ
Der QR-Code öffnet auf dem Smartphone eine leere Seite oder zeigt einen Verbindungsfehler.
Die häufigste Ursache ist eine falsch konfigurierte Basis-URL. Prüfen: Einstellungen → Lagerverwaltung → QR-Code Basis-URL. Die URL muss die tatsächlich erreichbare IP-Adresse und den Port des ComBinder-Rechners enthalten. Außerdem muss die REST API aktiv und der Port in der Windows-Firewall freigegeben sein.
Die PWA fragt nach einem Login, obwohl ich die Zugangsdaten korrekt eingegeben habe.
Benutzername und Passwort in der PWA sind identisch mit dem ComBinder-Desktop-Login. Großschreibung wird beachtet. Wenn das Login im Desktop funktioniert, aber in der PWA nicht, kann ein zwischengespeichertes abgelaufenes Token im Browser die Ursache sein – Browser-Cache löschen und erneut versuchen.
Hochgeladene Fotos erscheinen nicht im Produktmanager.
Mögliche Ursachen: Der konfigurierte MIME-Root ist nicht beschreibbar (Berechtigungsproblem), oder es ist kein MIME-Root konfiguriert und der Standard-MIME-Root des Workspace ist ein FTP-Root (FTP wird für Fotos nicht unterstützt, nur lokale Roots). Im Einstellungsdialog explizit einen lokalen MIME-Root auswählen.
Die KI-Recherche in der PWA liefert keine Ergebnisse.
Prüfen: Einstellungen → Lagerverwaltung → LLM-Anbieter ist nicht auf „none" gesetzt, und der passende API-Schlüssel ist hinterlegt. Bei Fehlermeldungen im Browser-Kontext kann auch das Rate-Limit (20 Anfragen/Minute) erreicht worden sein – kurz warten und erneut versuchen.
Wie erstelle ich Inventare für mehrere Standorte?
Ein Projekt kann mehrere Inventare enthalten. Einfach für jeden Standort über „Add Inventory" ein eigenes Inventar anlegen und benennen. Die Inventar-IDs sind in der REST API und in den QR-Code-URLs eindeutig.
Was passiert mit dem Bewegungsprotokoll, wenn ich „Delete all content" ausführe?
Das Bewegungsprotokoll bleibt vollständig erhalten. Nur die Lagerorte und Produktzuweisungen im Inventar-Baum werden gelöscht.