How can we help you?

How Do I Use the Mobile App for Barcode Scanning?

The mobile app uses your phone's camera as a barcode scanner for fast product lookups and warehouse operations.

How to Scan

1. Open any screen with a scan icon (product search, receiving, picking, etc.)
2. Tap the barcode scanner icon
3. Point your camera at the barcode
4. Hold steady — the scan happens automatically
5. The product is identified and loaded

Where Scanning Works

Supported Barcode Types

• UPC-A / UPC-E
• EAN-13 / EAN-8
• Code 128
• Code 39
• QR Codes

Troubleshooting

Scanner not working?

• Ensure camera permissions are granted in your phone settings
• Clean your camera lens
• Ensure adequate lighting
• Hold the phone 6-12 inches from the barcode
• If a barcode is damaged, use manual SKU search instead

Tip: For high-volume scanning (like receiving a large shipment), consider a Bluetooth barcode scanner for faster, more reliable scanning.

Troubleshooting Common Issues

Quick solutions for the most frequently encountered problems.

Login Problems

Mobile App Issues

Inventory Discrepancies

If your system quantities don't match physical counts:

1. Run a Cycle Count on the affected locations
2. Review the Stock Movements Audit Trail for unexpected changes
3. Check if receiving was completed for recent shipments
4. Verify no pending transfers are in transit

Orders Stuck in Processing

• Verify a pick list has been created and assigned
• Check that all items have sufficient available stock
• Look for short-pick holds on the order

CSV Import Failures

• Ensure required columns exist: Name and SKU at minimum
• Check for duplicate SKUs in the file
• Verify file encoding is UTF-8
• Remove any special characters from column headers

Payment Gateway Errors

• Verify API credentials are correct in Payment Gateway Setup
• Check that the gateway is set to the right environment (sandbox vs. production)
• Ensure at least one gateway is marked as Default

Tip: When contacting support, include the error message, the page you were on, and steps to reproduce the issue. Screenshots help enormously.

How Do I Import Products from CSV?

The CSV import tool lets you bulk-upload products, saving hours of manual data entry.

Step 1: Prepare Your CSV

Your CSV file should include at minimum a Name and SKU column. Supported columns include:

Step 2: Upload

1. Go to Products
2. Click Import CSV in the top right
3. Select your CSV file
4. Choose or create an Import Template to save your column mapping for future imports

Step 3: Map Columns

The importer will auto-detect common column names. For any unrecognized columns, manually map them to WareSquared fields using the dropdown menus.

Step 4: Preview & Confirm

Review the preview showing the first several rows of data. Check that:

• Column mappings are correct
• Data looks right in the preview
• No duplicate SKUs will be created

Click Import to begin processing.

Step 5: Review Results

After import, you'll see a summary showing:

• Products created
• Products updated (if SKUs matched existing products)
• Rows skipped (with error details)

Tip: Save your column mapping as an Import Template so you can reuse it for future imports from the same supplier or system. Go to Products → Import Templates to manage saved mappings.

Can I use my company's UPS / FedEx / DHL account through Shippo?

Yes. Shippo supports both modes. You can ship using Shippo's pre-negotiated rates (good for businesses without their own contracts), OR you can connect your existing carrier accounts and use your negotiated rates. This is called Bring Your Own Account (BYOA).

Either way, you only set up one integration in WareSquared (Shippo) and you can use it for USPS, UPS, FedEx, DHL, and others.

Mode 1 — Shippo's discounted rates

Use Shippo's pre-negotiated rates without any carrier contracts of your own.

• USPS Commercial Plus (about 30% off retail USPS pricing)
• Discounted UPS Ground / Air rates
• Discounted FedEx rates
• Discounted DHL international rates

Best for: small to mid-sized businesses, businesses just starting out, anyone without an existing carrier contract.

Mode 2 — Bring Your Own Account (BYOA)

Connect your existing UPS, FedEx, DHL, or other carrier account in Shippo's dashboard. Shippo intermediates the API call but the rates come from your contract.

Best for: businesses with high volume that have negotiated their own contracts with carriers (e.g., a UPS account manager set you up with discounted rates). You keep those rates and Shippo just prints the labels.

To set up BYOA, log into your Shippo dashboard and connect your carrier accounts there. They'll then appear automatically when WareSquared fetches rates.

What does Shippo charge on top?

Shippo's pricing has two parts. Carrier markup is not one of them — Shippo doesn't add a margin on top of the carrier's rate, regardless of which mode you use.

For exact current pricing, check Shippo's pricing page.

Which mode should my business choose?

Roadmap: direct UPS / FedEx integrations

WareSquared has scaffolded direct UPS and FedEx integrations (the adapters exist in our codebase) but the order flow currently routes every label through Shippo. When the direct adapter dispatch lands, you'll be able to choose between Shippo and direct integration on a per-carrier basis. For now, Shippo's BYOA covers the same carriers with the convenience of a single integration.

See also: Shipping Carrier Integration, Packing and Shipping

How Do I Manage Suppliers?

Suppliers are the businesses you purchase inventory from. Managing supplier information in WareSquared helps streamline purchasing and reorder workflows.

Adding a Supplier

1. Go to Suppliers in the main navigation
2. Click + New Supplier
3. Fill in the details:
   • Name — Supplier business name
   • Email — Primary contact email
   • Phone — Contact number
   • Address — Business address for purchase orders
4. Click Create Supplier

Linking Products to Suppliers

When editing a product, set the Preferred Supplier field. This enables:

• Quick purchase order creation from low-stock alerts
• Supplier filtering on the Products page
• Supplier-based reporting

Viewing Supplier Details

Click any supplier to see their contact info and all linked products. Use this view to quickly check which products come from a specific vendor.

Searching and Filtering

The supplier list supports search by name, email, or contact person. Sort by name or date added.

Tip: Keep supplier contact info and lead times updated. This data powers the reorder point system and purchase order workflows.

See also: Adding and Editing Products, Low Stock Alerts and Reorder Points, Purchase Order Management

Quick Answer

The amber Short stock chip on the Orders list flags orders that meet all of these:

• Status is still Pending / Processing (not yet shipped)
• Has a fulfillment warehouse assigned
• No pick list has been created yet
• At least one line item doesn't have enough stock in the assigned warehouse to fulfil

Hover the chip to see how many lines are short.

What to Do When You See It

Click into the order. The Fulfillment panel on the right shows exactly which products are short, by how much, and what's on hand:

Insufficient inventory · 3 lines short

• PU Pastel Purple — Need 1, on hand 0 — short 1
• Glitter Rainbow Pink — Need 1, on hand 0 — short 1
• Flock Dark Purple — Need 1, on hand 0 — short 1

Your options:

1. Restock the short lines (create a Purchase Order to your supplier — the order page links straight to it).
2. Move the short items off this shipment so the in-stock items can ship today; the dropped lines go on a follow-up shipment when stock arrives. See Moving Items Between Shipments.
3. Issue a partial refund if the customer agrees to settle for what's available.

The chip disappears the moment all lines have stock OR a pick list is created (because at that point you've committed to fulfilling what's there).

See also: Handling Insufficient Inventory

How Do I Use the Mobile App for Receiving?

Receiving logs incoming inventory from suppliers into your warehouse.

Web App Receiving

1. Go to Warehouse → Receiving
2. Click + New Receipt
3. Select the supplier and warehouse
4. Add products and quantities received
5. Assign to locations (where to put the items)
6. Click Complete Receiving

Mobile App Receiving

The mobile app streamlines receiving with barcode scanning:

1. Open the mobile app
2. Go to WMS Hub → Receiving
3. Scan the product barcode with your camera
4. Enter the quantity received
5. Scan or select the destination location
6. Confirm

Incoming Shipment Tracking

Track expected deliveries before they arrive:

1. Go to Warehouse → Receiving → Incoming Shipments
2. Click + New Shipment
3. Enter supplier, products, expected quantities, and delivery date
4. Track status: Pending → In Transit → Arrived

When the shipment arrives, click Receive to convert it into a receiving record.

Tip: Set up incoming shipments when you place purchase orders. This gives you visibility into what's expected and helps plan warehouse labor for receiving.

See also: Stock Movements Audit Trail, Low Stock Alerts and Reorder Points, Mobile Receiving

How Do I Connect a Payment Gateway?

Set up payment processing to accept payments from customers.

Supported Gateways

Adding a Gateway

1. Go to Settings → Payment Gateways
2. Click + Add Gateway
3. Select your provider
4. Enter a Name for this gateway (e.g., "Main Stripe Account")
5. Enter your API credentials
6. Choose Environment:
   • Sandbox — For testing (no real charges)
   • Production — Live payment processing
7. Click Save

Setting a Default

If you have multiple gateways, set one as default:

• Toggle Is Default on the gateway you want as primary
• The default gateway is pre-selected when processing payments

Testing

Always test in Sandbox mode first:

1. Add the gateway with sandbox credentials
2. Process a test payment
3. Verify it appears in your gateway's dashboard
4. Switch to Production when ready

Important: Keep your API credentials secure. Never share them publicly or commit them to source code. WareSquared encrypts all payment credentials at rest.

How Do I Set Up Multiple Warehouses?

WareSquared supports multiple warehouses, making it easy to track inventory across different storage locations, retail stores, or distribution centers.

Adding a Warehouse

1. Go to Warehouse in the navigation
2. Click Warehouses → + New Warehouse
3. Fill in the details:

4. Click Create Warehouse

Warehouse Types

After Creating a Warehouse

Once created, you should:

1. Add locations — Create shelves, bins, and zones within the warehouse
2. Assign products — Start receiving inventory into locations
3. Set as fulfillment source — Choose this warehouse when creating orders

Tip: Even if you only have one physical location, creating a warehouse lets you use WMS features like locations, transfers, and pick lists.

How Do I Run a Cycle Count?

Cycle counts are periodic physical inventory audits that verify system accuracy without shutting down operations.

What Is a Cycle Count?

Unlike a full physical inventory that counts everything at once, cycle counts focus on a subset of inventory on a rotating schedule. This means:

• No warehouse shutdown required
• Higher accuracy through regular checking
• Issues caught and corrected quickly

Creating a Cycle Count

1. Go to Warehouse → Cycle Counts
2. Click + New Cycle Count
3. Select the Warehouse
4. Choose which products or locations to count
5. Set priority and assign to a counter
6. Click Create

Cycle Count Statuses

ABC Analysis for Scheduling

Not all inventory is created equal. Use the ABC method to prioritize what to count and when:

• A-Items (High Value / Fast Moving) — 20% of items, 80% of value. Count weekly or monthly.
• B-Items (Moderate Movement) — 30% of items, 15% of value. Count quarterly.
• C-Items (Slow Moving) — 50% of items, 5% of value. Count semi-annually.

Common Pitfalls

• Counting on Paper — Always use the mobile app for real-time verification and automatic discrepancy detection.
• Ignoring Damages — Use the "Damaged" status during counting to trigger disposal or return workflows.
• Counting During Peak Hours — Schedule counts during low-activity periods for maximum accuracy.

Tip: Use the mobile app for cycle counts. The barcode scanner makes counting faster and reduces data entry errors.