Integrations · Telematics · Units

Telematics units

Ingestion auto-creates gear the moment a unit reports and can't be matched — reconciling it to real gear, Claim or Merge, is live today. Match-and-improve, not link-and-forget.

View placeholders in Fleet

Unit / provider ID	Provider	Serial	Matched gear	Last reading	Status

Loading telematics units… (skeleton shimmer pauses under reduced motion)

Back to Integrations

📡

No telematics units yet — connect a provider

Once a provider is connected, ingestion starts reporting units automatically and auto-creates placeholder gear for anything it can't match — nothing to set up here by hand.

Connect a provider Browse integrations

Reporting units and any unmatched placeholders show up here on the next sync. A sync runs on connect, on manual "Sync now", and on the scheduled fleet-wide sweep (shipped 2026-07-09 — 5-min default, 15-min per-integration floor). Evidence-based per-provider cadences are design-ahead (issue #252).

Units reporting

○ Cached 7:02 AM

Linked to gear

○ Cached

Awaiting claim

○ Cached

Providers connected

○ Cached

Unit / provider ID	Provider	Serial	Matched gear	Last reading	Status
CAT-EX214-4471	Caterpillar	CAT0320GCJRW58821	EX-214 CAT 320 GC excavator	8:42 AM (cached)	○ Cached
CAT-99213	Caterpillar	CAT0000UNK99213JX	○ Placeholder	8:41 AM (cached)	○ Cached

Showing 2 of 8 cached rows. Reconnect for the full list, live status, and Claim/Merge.

reporting

Units reporting

● live via ingest

linked

Linked to gear

in Fleet →

claim

Awaiting claim

▲ placeholders below

providers

Providers connected

manage →

Units

◇ Design-ahead

Flagged — not silently chosen This table itself is design-ahead: there's no live "list provider units" endpoint. The earlier G-036 proposal (list units · link · unlink) was superseded by the placeholder+claim/merge model — today, reconciling a telematics unit happens as placeholder rows inline in Fleet, not in a dedicated Units list. What's below previews a dedicated lens over that same shipped data. CSV export has no live endpoint either.

Unit / provider ID	Provider	Serial	Matched gear	Last reading	Status
CAT-EX214-4471	Caterpillar	CAT0320GCJRW58821	EX-214 CAT 320 GC excavator	8:42 AM Silloth Yard	● Reporting
IMEI 356938035643809	FleetMotion	— (IMEI-keyed)	DT-330 Kenworth T370 dump truck	8:40 AM Bridgeport	● Reporting
KOM-GN042-0087	Komatsu (Komtrax)	KMTGN042998214	GN-042 Generator, 25 kW towable	7:10 AM Silloth Yard	▲ Idle 6h
VCE-RL88-2201	Volvo (CareTrack)	VCE0RL88LX20291	RL-88 Roller	yesterday 6:15 PM North Ridge	○ No signal 14h
CAT-WL203-9042	Caterpillar	CAT0WL203HDT88214	WL-203 Wheel loader	8:39 AM Bridgeport	● Reporting
CAT-99213	Caterpillar	CAT0000UNK99213JX	○ Placeholder	8:41 AM Silloth Yard	● Reporting
KOM-40877	Komatsu (Komtrax)	KMT4087712X09	○ Placeholder	7:02 AM North Ridge	▲ Idle
DK220-7-00291 EquipmentID	JCB LiveLink	— (EquipmentID-keyed)	○ Placeholder	8:20 AM Bridgeport	● Reporting

Showing 8 of 96 reporting units.Claim and Merge act on the two placeholder rows above (○ Placeholder) — both are live, shipped actions; selected rows feed the panels below.

Reconcile CAT-99213 — shipped

Both actions are live in the monorepo today (verified against the monorepo 2026-07-09). You'd do one or the other, not both.

Claim CAT-99213○ Placeholder

Fills in the blanks on this exact placeholder gear record. Only valid on placeholders — claiming an already-real record returns 409 not claimable. Every field below is optional.

Gear type

Make

Model

Serial number

Unit number

Description

Hours

Miles

Merge CAT-99213 into existing gear

Folds this placeholder into a gear record that already exists, instead of claiming it as new. Picks from active, non-placeholder gear; already-linked targets sort to the bottom.

Target gear	Status
WL-204 Wheel loader	● Active
WL-205 Wheel loader	● Active
EX-214 CAT 320 GC excavator — already linked to CAT-EX214-4471	● Active

Pick a target above first.

Honest error states (shipped):

Target already linked — 409, shows the existing linked unit (see EX-214, greyed out above).

Target archived — blocked; archived gear can't receive a merge.

Target is itself a placeholder — blocked; merge only resolves into real gear.

Same gear — blocked; nothing to merge.

Latest reading — EX-214● as of 8:42 AM

Per-gear latest-snapshot API — shipped. This is the newest reading only; readings are stored on ingest but there's no history API yet, so no trend is shown here.

Location

Lat / lng45.6811, -121.5341

As of8:42 AM

Usage

Operating hours4,812.6 hr

Odometer— n/a

Idle hours312.4 hr

PTO hours88.1 hr

Max speed (24h)6.2 mph

Fuel

Cumulative used18,204 gal

Last 24h22.4 gal

Remaining64%

Tank capacity80 gal

Load

Avg load factor (24h)58%

Payload total1,204 yd³

Status

DEF level72%

Engine running● Yes

Engine numberCAT-C7.1-88214

Fields above are provider-agnostic — normalized at ingest into the same shape regardless of Caterpillar, Komatsu (Komtrax), Volvo (CareTrack), JCB LiveLink, or FleetMotion.

How matching works

Two-pass, run at ingest — shipped, no manual re-run beyond Claim/Merge above.

Pass 1Exact match on the provider's own equipment ID.

Pass 2Serial-number fallback — only for serial-keyed providers (below).

No matchIngest auto-creates a placeholder gear record — that's every ○ Placeholder row above.

Provider	Keys on
Caterpillar, Komatsu, Liebherr, Volvo	Serial number (pass 2 eligible)
JCB	EquipmentID
FleetMotion	IMEI

DESIGN MOCKUP — GearJot V2 · C2e·Straight · design target, not a screenshot.
Tokens: foundation-tokens-vC2e-straight.json (every ratio computed) · gloved 44/48px floors · status = glyph + label, never color alone.
Shipped: placeholder auto-create, claim, merge (verified against the monorepo 2026-07-09; the live UI does this inline in the gear list — this dedicated lens is the improve step).
Design-ahead, tagged: units inventory endpoint (G-036 superseded), CSV export.
← Prototype home