Skip to main content

Section 9: Troubleshooting and Common Issues

This section helps users troubleshoot common issues they might encounter while using the [Platform Name] Warehouse Management System. It provides a list of frequently encountered problems, their potential causes, and step-by-step solutions to resolve them.

1. Login Issues​

Problem: Unable to log in to the platform.​

Causes:​

  • Incorrect username or password.
  • Account is locked or inactive.
  • Two-factor authentication (2FA) setup issues.

Solution:​

  • Check Credentials: Ensure that the correct username and password are entered. If you forgot your password, use the "Forgot Password" option to reset it.
  • Account Lock: If your account is locked due to multiple unsuccessful login attempts, contact support to have it unlocked.
  • 2FA Issue: If 2FA is enabled, ensure that the correct authentication method (e.g., mobile app or email) is being used. If you're unable to authenticate, contact support for assistance.

2. Order Import Issues​

Problem: Orders are not being imported into the system from external platforms like Sellercloud, Shopify, or ShipStation.​

Causes:​

  • Integration configuration errors.
  • API connection issues.
  • Incorrect or missing mapping of external order fields.

Solution:​

  • Check Integration Settings: Go to the Integrations section of the platform and ensure that the API connections for the external platforms are correctly configured.
  • Verify Mappings: Ensure that all required fields are properly mapped between the external system and the platform. Refer to the Mappings section in the admin settings.
  • Test Connection: Use the test connection feature for integrations to verify that the platform can connect to external sales channels and aggregators.

3. Inventory Not Updating​

Problem: Product inventory is not syncing correctly, or quantities are not being updated.​

Causes:​

  • Syncing issues between the platform and external channels.
  • Inventory tracking settings are misconfigured.
  • Integration issue with external systems.

Solution:​

  • Check Sync Settings: Go to the Inventory section and verify the sync settings for each product and external platform. Ensure that the platform is set to update inventory quantities when orders are placed or stock levels change.
  • Review External Integration Logs: Review the log for any integration issues, such as failed API calls or errors in syncing inventory.
  • Check Warehouse Settings: Verify that each warehouse is correctly set up with the correct inventory tracking methods (FIFO, LIFO, etc.).

4. Shipping Costs Not Calculating Correctly​

Problem: The platform is not calculating shipping costs correctly for outbound orders.​

Causes:​

  • Missing or incorrect shipping carrier configuration.
  • Carrier rules are not properly set up.
  • Incorrect product or box dimensions leading to wrong volume/weight calculation.

Solution:​

  • Check Carrier Settings: Go to the Integrations section and ensure that the shipping carrier configurations (e.g., eShipper, EasyPost) are set up correctly.
  • Verify Carrier Rules: Review the shipping rules in the Shipping Settings and ensure that the correct carrier and service types are assigned to your orders.
  • Box and Product Dimensions: Verify that the product dimensions and weight are correctly entered. For boxes, you can use the Magic Button to automatically calculate dimensions based on item information.

5. Picking and Packing Issues​

Problem: Items are being picked from the wrong shelves, or boxes are not packed properly.​

Causes:​

  • Shelving configuration issues.
  • Incorrect picking or packing rules.
  • Misconfigured carton sizes or box contents.

Solution:​

  • Check Shelf Configuration: Go to the Warehouse section and ensure that shelves are configured correctly with accurate dimensions and barcodes.
  • Review Picking Rules: Make sure the picking process is properly configured to match the order items with their corresponding shelves.
  • Verify Box Contents: When packing, ensure that the correct quantity of items is assigned to each box. If needed, adjust the dimensions and weight of the boxes using the platform's tools.

6. Unable to Print Labels or Packing Slips​

Problem: The system is not generating or printing shipping labels, packing slips, or barcodes.​

Causes:​

  • Integration issues with label generation systems.
  • Printer configuration errors.
  • Missing or incorrect product information.

Solution:​

  • Check Label Generator Integration: Review the Integrations section for any issues with your label printing system (e.g., EasyPost, eShipper). Ensure that the integration is enabled and properly configured.
  • Check Printer Settings: Verify that your printer is correctly connected to the system, and the printer configuration (paper size, label template) is correct.
  • Ensure Product Information is Complete: Make sure all items have the necessary details (SKU, barcode, dimensions) for label generation. If any fields are missing, fill them in and try again.

7. Slow System Performance​

Problem: The platform is running slowly or experiencing lag during normal use.​

Causes:​

  • High volume of data being processed.
  • Unnecessary browser extensions or system resource limitations.
  • Issues with the underlying infrastructure or recent updates.

Solution:​

  • Clear Browser Cache: Try clearing your browser cache and cookies, as this can often resolve performance issues.
  • Check System Resources: Ensure your computer or device has adequate resources (CPU, memory) to run the platform smoothly.
  • Monitor Performance: Check the System Status Page for any ongoing infrastructure issues or outages. If necessary, reach out to support for performance troubleshooting.

8. Data Sync Issues Between Multiple Warehouses​

Problem: Data is not syncing between multiple warehouses or locations.​

Causes:​

  • Incorrect warehouse configuration.
  • Data sync delay or failure due to integration issues.
  • User permissions or access restrictions.

Solution:​

  • Verify Warehouse Setup: Ensure each warehouse is configured correctly in the platform, including its warehouse ID, location, and associated inventory data.
  • Check Data Sync Logs: Review the data sync logs for any failed sync attempts and identify potential errors or issues with syncing between warehouses.
  • Review User Permissions: Check that the user has the necessary permissions to view and manage data across all warehouses in the system.

9. Permissions and Access Control Issues​

Problem: Users are unable to access certain features or sections of the platform.​

Causes:​

  • Insufficient user permissions.
  • Incorrect role assignments.
  • Account configuration errors.

Solution:​

  • Review User Roles: Go to the User Management section and check that each user has been assigned the correct roles (e.g., Warehouse Admin, Vendor, Fulfiller) and associated permissions.
  • Check Role Permissions: Make sure the correct permissions for accessing platform features are enabled for each role.
  • Contact Support: If a user is unable to access essential sections, contact support for assistance in adjusting their permissions.

Contacting Support​

If the above solutions do not resolve your issue, or if you encounter a problem not listed here, please contact the support team. Use one of the following methods:

  • Submit a Support Ticket: Access the Support section in the platform to create a ticket.
  • Live Chat: Use the live chat feature for real-time assistance during business hours.
  • Phone Support: Contact our support hotline at [phone number] for urgent issues.

By following the troubleshooting steps above, most issues can be resolved quickly and efficiently. If you're still experiencing problems, our support team is available to assist you.