Skip to main content

Scanner Configuration

Teamship can leverage barcode scanning to drive nearly any physical warehouse workflow, including receiving, inventory movement, picking, packing, shipping, and LPN management.

To ensure reliable and consistent scanning behavior, industrial barcode scanners must be configured correctly before being used with Teamship.

This document outlines the required scanner settings, supported configurations, and troubleshooting guidance.


Overview​

Teamship is designed to work with scanners that behave like a keyboard input device.

When a barcode is scanned, the scanner should:

  1. Output the scanned value as plain text
  2. Insert the value into the active input field
  3. Automatically submit the value so the workflow can continue

This behavior is achieved through keyboard wedge mode and proper symbology configuration.


Required Scanner Capabilities​

To work correctly with Teamship, industrial scanners must meet all of the following requirements:

1. Code 128 Symbology Support (Required)​

All Teamship-generated barcodes use Code 128.

Your scanner must:

  • Support Code 128
  • Have Code 128 enabled in device settings

If Code 128 is disabled, Teamship barcodes will not scan.


2. Keyboard Wedge Mode (Required)​

Scanners must operate in keyboard wedge mode.

Keyboard wedge mode means:

  • The scanner behaves like a keyboard
  • Scanned values are “typed” into the active input field
  • No special drivers or SDK integrations are required

This allows Teamship to work with scanners across all browsers and devices.


3. Enter / Carriage Return Suffix (Required)​

After each scan, the scanner must append an Enter (Carriage Return).

This ensures:

  • The value is submitted immediately
  • Users do not need to press Enter manually
  • Scanning workflows remain fast and uninterrupted

Common names for this setting:

  • Enter Suffix
  • Carriage Return
  • CR
  • CR/LF

Without an Enter suffix, the scanned value may appear in the field but not trigger the workflow.


While exact menus vary by manufacturer, the following settings are strongly recommended:

SettingValue
SymbologyCode 128 (Enabled)
Input ModeKeyboard Wedge
Post-Scan ActionEnter / CR
Beep / FeedbackEnabled (optional)
Auto-TriggerDisabled (manual trigger preferred)

Supported Scanner Types​

Industrial Barcode Scanners​

Teamship works with most industrial scanners from major manufacturers, including:

  • Zebra
  • Honeywell
  • Datalogic
  • Socket Mobile

As long as the scanner:

  • Outputs keyboard input
  • Supports Code 128
  • Appends Enter

…it will work with Teamship.


Mobile & Camera-Based Scanners​

Teamship also supports scanning using:

  • Mobile phones
  • Tablets
  • Camera-based scanning via the browser

These scanners:

  • Require a mobile app to be installed on the device
  • Are ideal for lightweight or temporary workflows
  • Are supported anywhere Teamship runs

Where Scanning Is Used in Teamship​

Correct scanner configuration is required for:

  • Receiving inventory
  • LPN assignment and lookup
  • Location movements
  • Picking and packing
  • Shipping confirmation
  • Transfer orders
  • Inventory adjustments

If scanning fails in any of these areas, scanner configuration should be verified first.


Testing Your Scanner​

Before going live, test your scanner using the following steps:

  1. Click into any text input field in Teamship
  2. Scan a Teamship barcode
  3. Confirm that:
    • The value appears instantly
    • The action completes without pressing Enter
    • Focus moves to the next step or field

If scanning requires manual input or does nothing, configuration is likely incorrect.


Common Issues & Fixes​

Scan Appears but Nothing Happens​

Cause: Enter suffix not enabled
Fix: Enable Enter / CR after scan


Barcode Will Not Scan​

Cause: Code 128 disabled
Fix: Enable Code 128 symbology


Extra Characters Appear​

Cause: Prefix or suffix misconfigured
Fix: Remove unwanted prefixes; keep only Enter


Scanner Works in Other Apps but Not Teamship​

Cause: Scanner not in keyboard wedge mode
Fix: Switch scanner to keyboard wedge output


Warehouse IT Responsibility​

Scanner configuration is typically handled by:

  • Warehouse IT staff
  • Operations managers
  • Device vendors or integrators

Teamship does not require proprietary drivers or custom firmware.


Best Practices​

  • Standardize scanner settings across all devices
  • Test scanners before onboarding new warehouse staff
  • Document scanner model and configuration internally
  • Keep at least one mobile device available as a backup

  • Printing & Scanning
  • Receiving Orders
  • Shipping Orders
  • Inventory
  • LPN Management
  • Label Designer