Getting Started with Levy Swap

This is the practical checklist for getting Levy Swap running on a fleet that already exists in Levy Fleets. The whole flow takes about an hour for a fleet of 50 to 200 vehicles, most of which is waiting for pack QR labels to print.

Step 1: Confirm Your Fleet Is Eligible

Every vehicle that uses one of the supported IoT types gets a SoH score automatically once you're set up. Supported IoT types:

• OKAI — highest-fidelity voltage and temperature telemetry
• Segway — full coverage across kick scooters and mopeds
• Omni 4G — Levy Max and shared A3A4-family devices
• Queclink (ZK600 / ZK105L)
• Acton / Feishen / Physhen
• Zimo — limited fields (MQTT-only); SoH still works, with a lower confidence weight

Vehicles on axa or manual lock connections show n/a for SoH because there's no live battery telemetry. They're not blocked from anything else — you just won't see a SoH index.

Step 2: Open the Swap Hub

Navigate to Dashboard → Swap. You'll see four tiles:

If you don't see the Swap link in the dashboard nav, ask your operator success contact — it's a per-subaccount feature flag.

Step 3: Backfill Packs for Your Existing Fleet

When Levy Swap is first enabled on a subaccount, the migration writes one placeholder pack row per vehicle so you have something to attribute telemetry to. These placeholders are in the deployed state but have no QR code printed yet and no real serial number.

Two ways to make them real:

1. Bulk mint and label (recommended for fleets above ~30 vehicles)
   • Go to Dashboard → Swap → Packs → Mint
   • Enter the count, manufacturer, model, chemistry (LFP / NMC), rated capacity (Wh), and rated voltage
   • The system creates N packs in ordered state and returns a printable PDF of waterproof QR labels
   • Stick a label on each pack as you receive it, scan it once via the Receive flow, and the pack moves to received
2. Per-vehicle on next swap (for small fleets or as you go)
   • On the first swap, scan the QR you stick on the pack — the system replaces the placeholder with the real pack row in one step

Step 4: Wait for the First SoH Nightly Run

The SoH engine runs every night at 03:00 UTC. After your first run, every pack with at least 24 hours of telemetry gets a SoH score. Packs with less than 24 hours of data show as "warming up" until they accumulate enough samples — usually one to two nights.

You can verify the cron is wired by going to Battery Health the morning after enablement — the leaderboard should be populated.

Step 5: Set Up Your First Swap Station

If you have one warehouse, garage, or charging closet, create one station to start:

1. Dashboard → Swap → Stations → Add Station
2. Name it ("Main Garage", "Downtown HQ", etc.)
3. Pin the location on the map
4. Enter the slot capacity (how many packs fit) and the charger count
5. Save — slots are auto-created in empty state

As you charge packs, scan their QR into a slot via the station detail page. The slot moves through empty → charging → charged based on the slot state toggle, and the Stations page shows live counts.

See Swap Station Inventory for more detail.

Step 6: Roll Out the Operator App Swap Flow

Your full-time techs need to update their operator-app to the version that contains the Swap Queue tab. JavaScript-only update — no native rebuild, no App Store delay. It should arrive within a few minutes of opening the app on Wi-Fi.

Once they see the new tab, point them at In-House Swap Workflow for the full step-by-step.

Step 7 (Optional): Decide About Juicers

The Juicer marketplace is a deliberate, gated opt-in. Don't enable it without reading Juicer Marketplace Overview end-to-end — there are state allow-list, KYC, and insurance prerequisites.

Common First-Day Questions

• My packs all show SoH 100 — is that real? Brand-new packs do start at or near 100. Wait a week and look for movement.
• Some vehicles show "n/a" for SoH. Either the IoT type isn't supported (axa / manual) or the device hasn't reported voltage in the last 24 hours. Check the vehicle telemetry page.
• A pack QR won't scan. Use a clean lens and good lighting; if the QR is physically damaged, mint a new pack from the dashboard and swap the QR label.