Fehlerbehebung

Häufige Probleme rund um den Warehouse Client und ihre Lösung – getrennt nach App-Betrieb und Einrichtung in Business Central.

Verbindung & Anmeldung

Symptom	Ursache	Lösung
„Nicht verbunden"	Verbindungsdaten fehlen/falsch	Einstellungen prüfen; QR erneut scannen; Verbindung testen
Anmeldung schlägt fehl	Entra Client ID fehlt/falsch	Im Setup Entra Client ID hinterlegen; QR neu erzeugen
HTTP 401 / nicht autorisiert	Token ungültig/abgelaufen	In der App neu anmelden; Entra-App-Registrierung und Berechtigungen prüfen
HTTP 403	Fehlende Berechtigung	Permission Set `ALN MCWC API User` zuweisen
Timeout	Netzwerk/Firewall	BC-Umgebung erreichbar? Internet am Gerät?

Schnelltest

In den Einstellungen Verbindung testen ausführen – die Meldung nennt die Fehlerursache (Erreichbarkeit, Berechtigung, Setup).

Symptom	Ursache	Lösung
QR wird nicht erkannt	Schlechtes Licht / kleiner Code	QR größer anzeigen, Abstand/Beleuchtung anpassen
Nach Scan keine Anmeldung möglich	Entra Client ID fehlte beim Erzeugen	Client ID im Setup eintragen, QR neu erzeugen
Falsches Terminal/Lagerort	QR eines anderen Terminals	QR des korrekten Terminals verwenden

Symptom	Ursache	Lösung
Scan löst nichts aus	Falscher Scanner-Typ	In den Einstellungen Typ wählen (Tastatur/DataWedge/Kamera)
Zebra-Trigger reagiert nicht	DataWedge-Intent falsch	DataWedge Intent Action gemäß MDM-Profil eintragen
Barcode unbekannt	Code nicht am Artikel gepflegt	GTIN/EAN bzw. Artikelreferenz in BC pflegen

Symptom	Ursache	Lösung
Kein Gewicht	Host/Port/Befehl falsch	Waage-Einstellungen prüfen; Waage testen
Etikett wird nicht gedruckt	ZPL-Drucker nicht erreichbar	Drucker-IP/-Port prüfen; ZPL testen; Netzwerk/Drucker eingeschaltet?
Keine Packliste	PDF-Drucker fehlt (nur Windows)	PDF Printer Name setzen
Etikett kommt verspätet	Versandconnector erzeugt asynchron	Kurz warten; bei Dauerausfall Connector prüfen (Versand)

Symptom	Ursache	Lösung
Modul wird nicht aktiviert	Keine Lizenz/Demo	Demo registrieren (Lizenzierung); Modul auf der Setup-Karte aktivieren
Schreibaktion verweigert	Lizenz fehlt oder Modul am Terminal aus	Lizenz prüfen; Terminal-Override auf Enabled setzen
Demo nicht erneut startbar	Demo im Produktivsystem verbraucht	Freischaltung über den Lizenzmanager; Sandbox ist frei
Kachel fehlt in der App	Modul global/terminalseitig deaktiviert	Setup bzw. Terminal prüfen

Symptom	Ursache	Lösung
Beleg „in Bearbeitung"	Sperre eines anderen Terminals	Auf Freigabe warten; Sperre verfällt nach Lock Timeout
Sperre hängt nach Absturz	Terminal beendet ohne Freigabe	Cleanup Expired Locks auf der Setup-Karte
Terminal „idle"	Keine Aktivität	Idle-Schwelle über Terminal Idle Minutes anpassen
Terminal-Limit erreicht	Zu viele aktive Terminals	Ungenutzte Terminals deaktivieren (Terminals)

Symptom	Ursache	Lösung
Badge zeigt 0/zu wenig	Filter durch erlaubte Versandagenten/Lagerort	Terminal: erlaubte Agenten und Lagerort prüfen
Zahl veraltet	Nicht aktualisiert	Zum Hauptmenü zurückkehren – die Zähler werden neu geladen