Zum Inhalt

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, Umlagerung, Inventur 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, Lagerbenutzer, 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 15 Module. Sie werden global (Einrichtung) und je Terminal (Überschreibung) einzeln aktiviert. Die Namen entsprechen den Kacheln in der App:

Modul (App-Kachel) Funktion
Wareneingang Bestellungen per Scan erfassen und mit Kred.-Lief.-Nr. als Wareneingang buchen
Warenausgang Prüfen/Packen, wiegen, Versandetikett erstellen – in drei Betriebsarten (siehe Warenausgang-Modus)
Kommissionierliste Mehrere Aufträge bündeln und konsolidiert picken (nur ohne BC-Lagerverwaltung)
Kommissionierung BC-Lagerkommissionierungen scannen und buchen (nur mit BC-Lagerverwaltung)
Artikelsuche Bestand, Lagerplätze, Chargen/Serien, Preise und Artikelposten per Scan abfragen
Retoure Rücksendung zu einer Rechnung erfassen → Gutschrift oder Verkaufsreklamation anlegen
Reklamation Mängel mit Rechnungsbezug erfassen und im Status weiterschalten
Einlagerung Artikeln eine Regalnummer (Artikelkarte) zuweisen
Etikettendruck Artikel- und Fachetiketten drucken – ZPL oder PDF (BC-Bericht)
Foto Belege, Schäden oder Artikel fotografieren und am BC-Beleg ablegen
Verwiegung Netto-/Bruttogewicht auf die Artikelkarte schreiben, Sperrgut-Warnung
Umlagerung Lagerplatz ↔ Lagerplatz (Umbuchung) und Lagerort ↔ Lagerort (Umlagerungsauftrag)
Inventur Ad-hoc-Zählung und Zählliste (Cycle Counting), optional Blindzählung
Einlagerung WMS Einlagerungsbelege abarbeiten oder ad hoc in Lagerplätze einlagern
Nachschub Nachschub berechnen und Lagerbewegungen abarbeiten (nur bei gesteuerter Einlagerung und Kommissionierung)

Zwei Kommissionier-Wege – gegenseitig exklusiv

Kommissionierliste und Kommissionierung schließen sich aus. Der Lagermodus in der Einrichtung bestimmt, welches der beiden verfügbar ist: Auftragskommissionierung (ohne BC-Lagerverwaltung) ↔ BC-Lagerkommissionierung (mit Lagerverwaltung). Die letzten vier Module bilden die Lagerplatz-/WMS-Funktionen ab – siehe Umlagerung, Inventur & Lagerplätze.

Architektur

flowchart LR
  subgraph DEV["MAUI-Client (Gerät)"]
    direction TB
    D1["Windows-Packtisch<br>Android-Handheld"]
    D2["Scanner · Waage · Drucker"]
    D1 -.- D2
  end
  subgraph BC["Business Central (Cloud)"]
    direction TB
    EXT["Warehouse-Extension<br>Einrichtung · Terminals · API-Pages · Dashboard"]
    HUB["merchantCENTRAL Hub<br>Lizenz · Versand · Druck"]
    EXT --> HUB
  end
  DEV <==>|"OData v4 / HTTPS<br>MSAL / Microsoft Entra ID"| BC
  • Anmeldung: Das Gerät meldet sich über Microsoft Entra ID (MSAL) an, die Mitarbeiter app-intern mit Ausweis + PIN. Es werden keine Passwörter in der App oder im QR-Code gespeichert. Siehe Lizenzierung & Module.
  • Schreibvorgänge: laufen über gesicherte Aktionen, die jeweils Lizenz und Terminal-Modul-Zugriff prüfen.
  • 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; Lieferscheine und PDF-Etiketten als PDF (nur Windows).

Voraussetzungen

  • [ ] merchantCENTRAL Hub (AD merchantCENTRAL ≥ 2.73.0.0) installiert und eingerichtet
  • [ ] Modul-Lizenz – Lizenz oder Demo für das Modul WAREHOUSE
  • [ ] Microsoft-BC-Device-Lizenz + ein Geräte-Entra-Konto je Terminal; Lagermitarbeiter brauchen kein eigenes Microsoft-Konto (Ausweis-Login, siehe Lizenzierung)
  • [ ] Entra-ID-App-Registrierung (Client-ID) für die Geräteanmeldung: delegierte Berechtigung Dynamics 365 Business Central / user_impersonation, öffentliche Client-Flows aktiviert, Redirect-URIs http://localhost (Windows) und msal<CLIENT-ID>://auth (Android). Kein Client-Secret erforderlich.
  • [ ] Endgeräte: Windows 10/11 (x64/arm64) oder Android 7.0+ (API 24+)
  • [ ] Optional: ZPL-Thermodrucker (Zebra), A4-Drucker für PDF (nur Windows), TCP/IP-Waage, USB-Scanner (Tastatur-Modus) oder Zebra-Handheld mit DataWedge
  • [ ] Für den Versand: mindestens ein aktiver merchantCENTRAL-Versandconnector (z. B. DHL, DPD)

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

Handbücher als PDF – zum Ausdrucken & Weitergeben

Die komplette Anleitung gibt es auch als PDF – praktisch als Aushang am Packtisch oder zur Weitergabe an neue Mitarbeiter. Diese Online-Hilfe ist stets die aktuellste Fassung; die PDFs geben den Stand 24.09.2026 wieder.

Für Administratoren (Einrichtung in Business Central)

Seite Inhalt
Einrichtungsassistent Schritt-für-Schritt durch die Erstkonfiguration
Einrichtung (Referenz) Lagermodus, Warenausgang-Modus und vollständige Feldreferenz der Einrichtungsseite
Terminals & QR-Kopplung Terminals, Drucker, Überschreibungen, zugelassene Zustelldienstleister, QR-Kopplung
Dashboard & Kennzahlen Tagesüberblick: Kennzahlen, ausstehende Arbeit, Terminals, Leistung
Lizenzierung & Module Demo/Lizenz, Terminals, Geräte- und Mitarbeiteranmeldung
Client-Installation & Updates App verteilen, installieren und aktuell halten
API-Referenz Endpunkte und Aktionen 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 Prüfen, packen, wiegen, Etikett erstellen
Kommissionierung Kommissionierliste und Lagerkommissionierungen
Artikelsuche Bestand und Artikelinfos abfragen
Retoure & Reklamation Rücksendungen und Mängel bearbeiten
Umlagerung, Inventur & Lagerplätze Umlagerung, Inventur, Einlagerung WMS, Nachschub
Weitere Werkzeuge Einlagerung, Etikettendruck, Verwiegung, Foto

Bei Problemen

→ Fehlerbehebung