Troubleshooting
Common problems around the Warehouse Client and how to solve them – separated by app
operation and setup in Business Central.
Connection & sign-in
| Symptom |
Cause |
Solution |
| "Not connected" |
Connection data missing/incorrect |
Check the Settings; rescan the QR; Test connection |
| Sign-in fails |
Entra Client ID missing/incorrect |
Enter the Entra Client ID in the Setup; regenerate the QR |
| HTTP 401 / unauthorized |
Token invalid/expired |
Sign in again in the app; check the Entra app registration and permissions |
| HTTP 403 |
Missing permission |
Assign the ALN MCWC API User permission set |
| Timeout |
Network/firewall |
Is the BC environment reachable? Internet on the device? |
Quick test
Run Test connection in the Settings – the message names the
cause of the error (reachability, permission, setup).
QR pairing
| Symptom |
Cause |
Solution |
| QR not recognized |
Poor light / small code |
Display the QR larger, adjust distance/lighting |
| No sign-in possible after scan |
Entra Client ID was missing when generated |
Enter the Client ID in the Setup, regenerate the QR |
| Wrong terminal/location |
QR of a different terminal |
Use the QR of the correct terminal |
Scanner
| Symptom |
Cause |
Solution |
| Scan does nothing |
Wrong scanner type |
Select the type in the Settings (keyboard/DataWedge/camera) |
| Zebra trigger does not respond |
DataWedge intent incorrect |
Enter the DataWedge Intent Action according to the MDM profile |
| Barcode unknown |
Code not maintained on the item |
Maintain GTIN/EAN or item reference in BC |
Scale & printer
| Symptom |
Cause |
Solution |
| No weight |
Host/port/command incorrect |
Check the scale settings; Test scale |
| Label not printed |
ZPL printer not reachable |
Check the printer IP/port; Test ZPL; network/printer switched on? |
| No packing list |
PDF printer missing (Windows only) |
Set the PDF Printer Name |
| Label arrives late |
Shipment connector generates asynchronously |
Wait briefly; if it fails permanently, check the connector (Shipping) |
License & modules
| Symptom |
Cause |
Solution |
| Module is not activated |
No license/demo |
Register a demo (Licensing); enable the module on the Setup card |
| Write action denied |
License missing or module off at the terminal |
Check the license; set the terminal override to Enabled |
| Demo cannot be restarted |
Demo consumed in the production system |
Unlock via the license manager; sandbox is free |
| Tile missing in the app |
Module disabled globally/at the terminal |
Check the Setup or terminal |
Terminals & locks
| Symptom |
Cause |
Solution |
| Document "in progress" |
Lock of a different terminal |
Wait for release; the lock expires after the Lock Timeout |
| Lock stuck after crash |
Terminal closed without releasing |
Cleanup Expired Locks on the Setup card |
| Terminal "idle" |
No activity |
Adjust the idle threshold via Terminal Idle Minutes |
| Terminal limit reached |
Too many active terminals |
Deactivate unused terminals (Terminals) |
Badges & counters
| Symptom |
Cause |
Solution |
| Badge shows 0/too few |
Filtered by allowed shipping agents/location |
Terminal: check the allowed agents and location |
| Number outdated |
Not refreshed |
Return to the main menu – the counters are reloaded |
Further help