Warehouse Client
Überblick
Der merchantCENTRAL Warehouse Client ist eine native Scanner- und Terminal-App (.NET MAUI) für Windows und Android, mit der Lagermitarbeiter alle täglichen Lagerprozesse direkt am Packtisch oder mit dem Handheld-Scanner erledigen: Wareneingang, Kommissionierung, Verpackung und Versand, Retouren, Reklamationen sowie Artikel- und Bestandsabfragen.
Die App spricht nicht direkt mit der Datenbank, sondern ausschließlich über eine abgesicherte OData-v4-API von Business Central. Diese API – und die gesamte Verwaltung in BC – stellt die Extension „AD merchantCENTRAL Warehouse Client" bereit.
Der Warehouse Client besteht damit aus zwei Komponenten:
| Komponente | Wo | Wer nutzt sie | Zweck |
|---|---|---|---|
| BC-Extension (Backend) | In Business Central | Administrator | Einrichtung, Terminals, Lizenz, Dashboard, API für die App |
| MAUI-Client (Frontend) | Auf dem Gerät (PC/Scanner) | Lagermitarbeiter | Scannen, Buchen, Packen, Drucken |
Lizenz bleibt serverseitig
Die App selbst ist kostenlos und lizenzfrei. Die Lizenzierung erfolgt zentral in
Business Central pro Tenant + Modul (WAREHOUSE) über den merchantCENTRAL Hub.
Siehe Lizenzierung & Module.
Funktionsumfang
Der Client umfasst 11 Module, die je Mandant und je Terminal einzeln aktiviert werden können:
| Modul (App-Kachel) | Funktion |
|---|---|
| Wareneingang | Bestellungen annehmen, Artikel per Barcode prüfen, Mengen buchen |
| Warenausgang | Aufträge packen, wiegen, Versandetikett erstellen, Lieferung buchen |
| Kommissionierliste | Mehrere Aufträge bündeln und als konsolidierte Pickliste abarbeiten |
| Kommissionierung | BC-Lagerbelege (Kommissionierung/Einlagerung) scannen und registrieren |
| Artikelsuche | Bestand, Lagerplatz, Preis und Lagerbuchungen per Scan abfragen |
| Retoure | Rücksendungen annehmen, prüfen, Gutschrift oder Retourenauftrag erzeugen |
| Reklamation | Mängel mit Belegbezug erfassen und im Status verfolgen |
| Einlagerung | Wareneingänge per Lagerplatz-Scan einlagern |
| Etikettendruck | Artikel- und Lagerplatzetiketten als ZPL drucken |
| Foto | Belege, Schäden oder Artikel fotografieren und an BC anhängen |
| Verwiegung | Netto-/Bruttogewicht erfassen, Sperrgut automatisch kennzeichnen |
Architektur
┌───────────────────────────┐ ┌────────────────────────────┐
│ MAUI-Client (Gerät) │ │ Business Central (Cloud) │
│ • Windows-Packtisch │ │ ┌──────────────────────┐ │
│ • Android-Handheld │ OData │ │ Warehouse-Extension │ │
│ │ v4 / │ │ • Setup & Wizard │ │
│ Scanner ▸ Waage ▸ Drucker │◀──────▶│ │ • Terminals │ │
│ │ HTTPS │ │ • API-Pages │ │
│ Anmeldung über MSAL/Entra │ │ │ • Dashboard/Cues │ │
└───────────────────────────┘ │ └──────────┬───────────┘ │
│ │ │
│ merchantCENTRAL Hub │
│ (Lizenz, Versand, Druck) │
└────────────────────────────┘
- Anmeldung: Microsoft Entra ID (Azure AD) über MSAL. Es werden keine Passwörter in der App oder im QR-Code gespeichert.
- Versand: Versandetiketten werden über die merchantCENTRAL-Versandconnectoren (DHL, DPD, GLS, UPS …) erzeugt – der Client stößt dies nur an. Siehe Versand.
- Druck: Etiketten gehen direkt per ZPL/TCP an den Drucker; Packlisten als PDF.
Voraussetzungen
- [ ] merchantCENTRAL Hub (
AD merchantCENTRAL≥ 2.2.0.0) installiert und eingerichtet - [ ] Modul-Lizenz – mindestens eine Demo für das Modul
WAREHOUSE - [ ] Entra-ID-App-Registrierung für die MAUI-Anmeldung (für QR-Provisionierung empfohlen)
- [ ] Endgeräte: Windows 10/11 (x64/arm64) oder Android 7.0+ (API 24+)
- [ ] Optional: ZPL-Thermodrucker (Zebra), TCP/IP-Waage, USB-/DataWedge-Scanner
Reihenfolge: Hub zuerst
Der Einrichtungsassistent des Warehouse Clients lässt sich erst öffnen, wenn der Hub eingerichtet ist (Platform-Guard). Richten Sie zuerst den merchantCENTRAL Hub ein.
So ist diese Hilfe aufgebaut
Für Administratoren (Einrichtung in Business Central)
| Seite | Inhalt |
|---|---|
| Einrichtungsassistent | Schritt-für-Schritt durch die Erstkonfiguration |
| Einrichtung (Referenz) | Vollständige Feldreferenz der Setup-Seite |
| Terminals & QR-Kopplung | Terminals, Drucker, Modul-Overrides, Versandagenten, QR-Provisionierung |
| Dashboard & Kennzahlen | Live-Überblick über Durchsatz, Auslastung und Qualität |
| Lizenzierung & Module | Demo/Lizenz, Modulfreischaltung, Terminal-Limits |
| Client-Installation & Updates | App verteilen, installieren und aktuell halten |
| API-Referenz | Endpunkte der Warehouse-API (für Integratoren) |
Für Anwender (Bedienung der App)
| Seite | Inhalt |
|---|---|
| Die App im Überblick | Start, Anmeldung, Kopplung, Hauptmenü, Bedienkonzept |
| Einstellungen & Hardware | Scanner, Waage, Drucker und Verbindung einrichten |
| Wareneingang | Lieferungen annehmen und buchen |
| Warenausgang | Packen, wiegen, Etikett, Versand buchen |
| Kommissionierung | Kommissionierliste und Lagerbelege |
| Artikelsuche | Bestand und Artikelinfos abfragen |
| Retoure & Reklamation | Rücksendungen und Mängel bearbeiten |
| Weitere Werkzeuge | Einlagerung, Etikettendruck, Verwiegung, Foto |