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; BC-Verbindung testen
„Gerät nicht angemeldet"	Geräteanmeldung fehlt oder ist abgelaufen	In der App Einstellungen → Gerät anmelden ausführen – die App fragt nie selbst nach einer Microsoft-Anmeldung (Anmeldung)
Anmeldung schlägt fehl	Entra Client-ID fehlt/falsch	In der Einrichtung die Entra Client-ID (MAUI App) hinterlegen; QR neu erzeugen
Mitarbeiter muss sich nach Neustart neu anmelden	Gewolltes Verhalten	Ausweis + PIN nach jedem App-Start; die Geräteanmeldung bleibt bestehen
Ausweis-Anmeldung abgelehnt	Lagerbenutzer deaktiviert, Ausweisbarcode unbekannt oder keine PIN gesetzt	Lagerbenutzer prüfen: Aktiviert, Ausweisbarcode, PIN setzen (Mitarbeiter)
HTTP 401 / nicht autorisiert	Token ungültig/abgelaufen	Gerät anmelden erneut ausführen; Entra-App-Registrierung prüfen
HTTP 403	Fehlende Berechtigung	Berechtigungssatz `ALN MCWC API User` zuweisen
Timeout	Netzwerk/Firewall	BC-Umgebung erreichbar? Internet am Gerät?

Schnelltest

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

Symptom	Ursache	Lösung
QR wird nicht erkannt	Schlechtes Licht / kleiner Code	QR größer anzeigen, Abstand/Beleuchtung anpassen – oder unter Windows QR-Code aus Bild laden
Nach Scan keine Anmeldung möglich	Entra Client-ID fehlte beim Erzeugen	Client-ID in der Einrichtung eintragen, QR neu erzeugen
Falsches Terminal/Lagerort	QR eines anderen Terminals	QR bzw. Einrichtungsblatt des korrekten Terminals verwenden

Symptom	Ursache	Lösung
Scan löst nichts aus	Falscher Scannertyp	In den Einstellungen Typ wählen (Tastatur/DataWedge/Kamera)
Geänderter Scannertyp wirkt nicht	Der Scanner wird nur beim App-Start eingerichtet	App neu starten
Zebra-Trigger reagiert nicht	DataWedge-Profil fehlt oder Intent-Aktion passt nicht	App neu starten – sie legt das Profil „MC Warehouse Client" beim Start an; eine geänderte DataWedge Intent Action muss zum Profil passen
Barcode unbekannt	Code nicht am Artikel gepflegt	GTIN/EAN bzw. Artikelreferenz in BC pflegen

Symptom	Ursache	Lösung
„Versenden" grau, Hinweis „Gewicht erforderlich"	Gewichtseingabe erforderlich aktiv, Gewicht 0 (keine Bruttogewichte, keine Waage)	Bruttogewichte an den Artikeln pflegen oder Waage anbinden; sonst die Pflicht am Terminal abschalten
Kein Gewicht	Host/Port/Befehl falsch	Waage-Einstellungen prüfen; Waagenverbindung testen
Etikett wird nicht gedruckt	ZPL-Drucker nicht erreichbar	Drucker-IP/-Port prüfen; ZPL-Verbindung testen; Netzwerk/Drucker eingeschaltet?
Lieferschein wird nicht gedruckt	Kein A4-Drucker, Android-Gerät, Bericht nicht eingerichtet oder Terminal-Konto darf ihn nicht ausführen	PDF-Druckername am Terminal setzen (nur Windows); Berichtsauswahl prüfen. Der Client nennt den Grund in der Statuszeile
Etikett: kein Versanddienstleister	Zum Zusteller des Belegs gehört kein aktiver Versandconnector	Connector aktivieren oder Zusteller am Beleg korrigieren – es wird nicht still auf einen anderen Dienstleister ausgewichen (Zusteller-Auflösung)
Etikett kommt verspätet	Versandconnector erzeugt asynchron	Kurz warten; bei Dauerausfall Connector prüfen (Versand)

Symptom	Ursache	Lösung
Warenausgang findet nichts	Filter durch Lagerort bzw. zugelassene Zustelldienstleister	Terminal prüfen; im Modus Verkaufsaufträge nennt die App die Zahl der offenen Aufträge, die nicht zum Terminal passen
*Warenausgang-Modus Lagerkommissionierungen* nicht wählbar**	Lagermodus ohne BC-Lagerverwaltung	Lagermodus auf BC-Lagerkommissionierung (mit Lagerverwaltung) stellen (Einrichtung)
Lagermodus lässt sich nicht zurückstellen	Warenausgang-Modus steht auf Lagerkommissionierungen	Zuerst den Warenausgang-Modus ändern
Kommissionierliste bzw. Kommissionierung lässt sich nicht aktivieren	Modul passt nicht zum Lagermodus	Lagermodus umstellen oder das passende Modul verwenden
Zusteller lässt sich dem Terminal nicht zuordnen	Zum Zusteller gehört kein aktiver merchantCENTRAL-Versanddienstleister	Versanddienstleister im Hub aktivieren

Symptom	Ursache	Lösung
Modul wird nicht aktiviert	Keine Lizenz/Demo	Demo registrieren (Lizenzierung); Im Hub aktivieren auf der Einrichtungsseite
App meldet „Modul nicht aktiviert" / „Lizenz nicht gültig"	Extension im Hub inaktiv oder Lizenz abgelaufen	Lizenz prüfen, im Hub aktivieren, in der App Erneut prüfen
Schreibaktion verweigert	Lizenz fehlt oder Modul am Terminal aus	Lizenz prüfen; Terminal-Überschreibung auf Aktiviert setzen
Demo nicht erneut startbar	Demo im Produktivsystem verbraucht	Freischaltung über den Lizenzmanager; in der Sandbox zählt eine Demo nicht als verbraucht
Kachel fehlt in der App	Modul global/terminalseitig deaktiviert	Einrichtung bzw. Terminal prüfen
„Keine Retourengründe hinterlegt" / „Keine Reklamationsgründe hinterlegt"	Kein Reklamationsgrund für die Terminals freigegeben	In den Reklamationsgründen Am Lagerterminal anbieten setzen (Reklamationsgründe)

Symptom	Ursache	Lösung
Neues Terminal wird abgelehnt	Terminal-Limit erreicht	Terminals deaktivieren oder Terminals lizenzieren / ändern (Terminals)
Beleg „in Bearbeitung"	Sperre eines anderen Terminals	Auf Freigabe warten; Sperre verfällt nach dem Sperren-Timeout
Sperre hängt nach Absturz	Terminal beendet ohne Freigabe	Abgelaufene Sperren bereinigen auf der Einrichtungsseite
Terminal „inaktiv"	Keine Aktivität	Inaktivitätsschwelle über Terminal-Inaktivitätsminuten im Einrichtungsassistenten anpassen
Kennzahl „Lieferungen pro Stunde" passt nicht	Tagesbeginn falsch	Arbeitsbeginn in der Einrichtung auf den Schichtbeginn setzen

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