Login & Authentication

Signing in to Shipedge Warehouse Pro is the first step to accessing warehouse operations on your Android device. This guide covers the login process, authentication flow, and how to resolve common sign-in issues.

Before You Sign In

Make sure you have completed the initial setup and entered your warehouse information. You’ll need your access code (provided by your administrator) to sign in.

Understanding Login

Shipedge Warehouse Pro uses token-based authentication. When you enter your access code, the app validates it with the Shipedge server and receives a session token. This token allows you to access features based on your user permissions.

What happens during login:

• Your access code is validated against the server
• Your device is verified and activated
• Your user permissions are loaded
• A session token is created for your session
• You’re redirected to the main menu

Signing In

1. Launch the App

   Open Shipedge Warehouse Pro from your device’s app drawer. The login screen appears automatically.

2. Enter Your Access Code

   In the password field, enter your access code:

   • The field hint shows “Scan or enter access code” if a physical keyboard is detected
   • The field hint shows “Enter access code” if no physical keyboard is detected
   • You can scan a barcode if your access code is in barcode format
   • Or type the access code manually

3. Tap OK

   Tap the OK button to submit your credentials. The button becomes disabled during authentication.

4. Wait for Authentication

   You’ll see a progress indicator with “Please wait - Processing…” while the app:

   • Connects to the Shipedge server
   • Validates your access code
   • Checks device activation
   • Loads your user permissions

5. Access Granted

   On successful authentication:

   • Your password field is cleared
   • A session token is stored
   • You’re automatically redirected to the main menu
   • Your available features are displayed based on permissions

Login Methods

Manual Entry

Enter your access code using the on-screen keyboard or a physical keyboard if available.

Barcode Scanning

If your access code is provided as a barcode:

• Tap the camera icon on the login screen
• Scan the barcode using your device camera
• The access code is automatically entered

Camera Scanner

If you don’t have a barcode scanner app installed, the app will prompt you to install one from the Play Store.

Bluetooth Scanner

If you have a Bluetooth scanner connected:

• Scan your access code barcode with the scanner
• The code is automatically entered into the password field
• Tap OK to proceed

See Bluetooth Scanner Setup for connection instructions.

Authentication Flow

The login process follows these steps:

1. Input Validation

• Checks that password field is not empty
• Shows “Enter access code” if field is empty

2. Server Connection

• Creates JSON data with device information and access code
• Sends authentication request to Shipedge server
• Waits for server response

3. Response Handling

• Processes server response
• Handles success or error messages
• Stores user data and permissions

4. Navigation

• On success: Navigates to main menu
• On error: Displays error message and allows retry

Login Status Messages

The app displays different messages based on authentication results:

Success Messages

Successful Login:

• Password field is cleared
• You’re redirected to the main menu
• No error message is shown

Error Messages

“No connection to internet”

• Your device cannot reach the Shipedge server
• Check your internet connection (Wi-Fi or mobile data)
• Verify you’re not in airplane mode
• Try again when connection is restored

“Your request was registed, try again”

• Your device registration request was received
• Wait a moment and try logging in again
• Contact your administrator if the issue persists

“Please contact your supplier to active your device”

• Your device is not activated in the system
• Contact your administrator to activate your device
• Provide your device ID if requested (long-press the app icon to see device ID)

“Out of service”

• Warehouse key error or service unavailable
• Verify your warehouse configuration is correct
• Contact your administrator

“Error, try again please”

• Invalid access code or authentication failed
• Verify you entered the correct access code
• Check for typos or extra spaces
• Contact your administrator if the code should be valid

“You do not have any activity activated, please contact your wms admin”

• Your user account has no permissions assigned
• Contact your WMS administrator to activate activities for your account
• You need at least one activity permission to use the app

“Unable to reach server”

• Connection attempts failed after multiple retries
• Check your internet connection
• Verify the server is accessible
• Try again later

After Successful Login

Once you’re signed in:

Main Menu Access:

• You’re redirected to the main menu
• Available features are displayed based on your permissions
• Only features you’re allowed to use are shown

Session Management:

• Your session token is stored for the current session
• Session remains active until you close the app
• You’ll need to sign in again when you reopen the app

User Information Loaded:

• User ID (Users.userId)
• User name (Users.userName)
• Recount settings (Users.recount)
• Activity permissions (Users.activity)
• Warehouse information

Background Services:

• Notification service starts automatically
• Bluetooth scanner connection is maintained (if connected)
• Periodic activation checks run in the background

💡 Best Practices

Keep Access Code Secure

Don’t share your access code with others. Treat it like a password and keep it confidential.

Use Bluetooth Scanner

If you frequently sign in, use a Bluetooth scanner for faster access code entry and reduced errors.

Check Connection First

Verify your internet connection before attempting to sign in to avoid connection errors.

Contact Admin for Issues

If you consistently can’t sign in, contact your administrator. They can verify your account status and device activation.

Troubleshooting Login Issues

Can’t Sign In

Check these items:

1. Internet Connection

   • Verify Wi-Fi or mobile data is enabled
   • Try opening a web browser to test connectivity
   • Disable and re-enable your connection

2. Access Code

   • Verify you’re using the correct access code
   • Check for extra spaces before or after the code
   • Ensure caps lock is off if code is case-sensitive

3. Device Activation

   • Confirm your device is activated in the system
   • Check for “device not activated” error messages
   • Contact administrator if needed

4. App State

   • Close and reopen the app
   • Clear app cache if problems persist
   • Restart your device if needed

Password Field Issues

Field is empty after error:

• This is normal behavior for security
• Re-enter your access code
• The field clears automatically after failed attempts

Can’t type in password field:

• Tap the field to focus it
• Check that keyboard is enabled
• Restart the app if keyboard doesn’t appear

Bluetooth Scanner Not Working

If you’re trying to use a Bluetooth scanner:

• Verify Bluetooth is enabled on your device
• Check scanner is paired and connected
• See Bluetooth Scanner Setup for detailed help

Security Features

Device Verification:

• Each device is identified by Android ID
• Device must be activated before use
• Rooted devices are blocked for security

Session Management:

• Tokens are device-specific
• Sessions don’t persist after app closure
• Re-authentication required on each app launch

Error Handling:

• Password field clears after failed attempts
• Error messages don’t reveal sensitive information
• Multiple failed attempts may trigger account review

Advanced: Warehouse Settings

If you need to change warehouse settings:

Access Settings:

• Tap the app icon 5 times quickly on the login screen
• Or long-press the main icon to see device ID
• Settings window opens for warehouse configuration

Settings Options:

• Change warehouse name
• Update warehouse key
• Configure external order settings

Settings Access

Only change warehouse settings if instructed by your administrator. Incorrect settings can prevent login.

Next Steps

After successful login:

• Main Menu Navigation - Learn how to navigate the app and access features
• Bluetooth Scanner Setup - Connect and configure your Bluetooth scanner
• App Overview - Review available features and operations

Technical Details

Authentication Endpoint:

• URL: https://[warehouse].shipedge.com/android/login_last.php
• Method: POST
• Format: JSON

Data Sent:

• Warehouse key (keyWh)
• Access code token
• Device serial (deviceSerial)
• App version (appVersion)
• System version (systemVersion)
• Operation type (opt: "login")
• App identifier (app: "pro")
• Activity list

Response Data:

• Message status
• User ID (UserID)
• User name (UserName)
• Recount setting (Recount)
• Activity permissions (Activity)

Activity Class: ReplenishmentActivity.java

Navigation: On success, navigates to AppMenu.java via Intent

---

Next: Main Menu Navigation or Bluetooth Scanner Setup