Cockpit Identify

Overview

Orbit Cockpit includes an Identify function that allows users to point their camera at a barcode on a package and immediately view the associated Tour, its stops, and all loads. This is useful in warehouse and yard scenarios where a worker needs to quickly answer the question: "Where does this package go?"

Identify is a read-only feature — it displays information but does not update any statuses or trigger any actions. It works independently of any tour and can be used at any time.

How It Works

Identify uses the camera on the driver's device to scan a barcode containing an Orbit Resource Number (ORN) — a unique identifier that Orbit assigns to resources such as loads, shipments, and tours. When a valid ORN is scanned, Cockpit resolves it and displays the corresponding Tour details.

Only barcodes containing an ORN are supported by Identify. Other barcode contents (such as a plain load ID or reference) cannot be resolved outside the context of a specific stop.

Accessing Identify

There are two ways to use Identify:

A. From within the Cockpit Drivers App:

1. Tap the more menu (three dots icon) in the bottom navigation bar

2. Tap Identify Load

3. Point the camera at a barcode on a package to scan it

B. From the built-in Camera App on any Phone:

If your labels contain QR codes generated through Orbit's Document Engine, you can scan them with your phone's built-in camera app or any barcode reader. This opens Cockpit directly in the Identify view and displays the resolved Tour information — no need to navigate through the app first.

Scanning a Barcode

When a barcode is scanned, Cockpit extracts the ORN and looks up the associated Tour. A result card appears below the viewfinder showing the Tour details.

What You See on the Result Card

The result card displays:

• Tour header — The Tour name and date, with a button to jump directly to the Tour in Cockpit

• Stops — The relevant stops on the Tour, including company name, address, and scheduled time window

• Loads — All loads on the Tour, with details such as type, dimensions, and quantity

Only Tours that the App User has permission to see will be resolved.

Session History

Each scan during a session adds a new card to a horizontal carousel. You can swipe left and right between cards to review previously scanned items. Pagination dots below the cards indicate your position in the list. The session history is cleared when you leave the Identify screen.

Supported Barcode Formats

The Identify scanner reads the following barcode formats:

• QR Code

• Code 128

• Data Matrix

For the most reliable identification, we recommend encoding Orbit Resource Numbers as QR codes on your labels.

Error Messages

Document Engine Integration

Orbit's Document Engine supports generating QR codes that link directly to Cockpit Identify. When creating label templates, you can use the generateLoadDeepLink filter to produce a deep link URL for any load. Combined with a QR code renderer, this embeds a scannable code on each label that opens Cockpit Identify when scanned.

FAQ