Levy Swap FAQ
Battery Health and SoH
Do I need new hardware for SoH tracking?
No. Levy Swap uses the OEM telemetry your IoT devices already report (voltage, temperature, current). No BMS firmware flashing, no extra sensors, no warranty risk.
Which IoT types are supported?
OKAI, Segway, Omni 4G, Queclink (ZK600 / ZK105L), Acton / Feishen / Physhen, and Zimo. Each OEM has a confidence weight applied to its SoH score — OKAI is 1.0, Zimo is 0.5. AXA-locked and manual-lock vehicles show "n/a" for SoH because there's no live telemetry.
How accurate is the EoL prediction?
We target ±10% MAE on 30-day-ahead capacity prediction across the supported OEMs. That's better than reactive replacement and good enough to plan procurement. It's not a lab capacity test.
Why does my pack's SoH not match my range observations?
Range depends on weight, terrain, weather, and riding style on top of pack health. SoH is the pack-only signal. If the SoH is healthy but range feels short, look at vehicle weight (overloaded carrier?), tire pressure, and brake drag before suspecting the pack.
Can I run SoH on packs from a vendor not on the supported list?
Yes — the pack record exists for any vehicle. But SoH will only score if the IoT type is supported. The Battery Health dashboard shows "n/a" with the IoT-type reason.
In-House Swap Workflow
Do I need to print QR labels for every pack?
For full SoH visibility and the swap workflow, yes. The mint tool produces a printable PDF of waterproof labels — you can mint 100 at a time and label as you go.
Can a swap happen without a QR scan?
No — the QR scan is what makes the workflow rejection-safe. Without scans, we'd have to guess which pack went where and the audit log would be unreliable. If a QR is damaged, mint a replacement from the dashboard.
What if the operator-app loses connectivity mid-swap?
The local app remembers what you scanned. The Complete tap queues locally and replays when you reconnect. If the vehicle has been swapped by someone else in the meantime, you'll see a "Swap superseded" message and the queued attempt is discarded.
How long does a typical swap take?
60 to 90 seconds for a clean swap. The slowest step is usually the physical pack replacement, which depends on the vehicle model.
Swap Stations
How many stations do I need?
Most operators start with one. The data model handles one or hundreds — split when you have multiple warehouses or when filtering inventory by location helps your techs.
Do I need smart chargers?
No. The slot state (charging / charged) is manual today. Smart-charger integration is on the v2.5 roadmap; when added, charge-in/out timestamps log automatically.
What about packs in a station that go bad?
Flip the slot to maintenance. The pack stays in the slot but is excluded from the install pool. Resolve it as warranty (export the vendor payload), recycling, or a re-charge attempt.
Juicer Marketplace
Do I have to use Juicers?
No. The Juicer marketplace is a deliberate opt-in. Many operators use only the in-house swap workflow.
What states is the Juicer marketplace available in?
Launch allow-list: TX, FL, GA, NC, AZ. Other states require legal review and possible additional insurance work. Talk to your operator success contact about expanding the allow-list for your market.
What does Levy charge for the Juicer marketplace?
Two things:
- $0.99/vehicle/month platform fee for operators using Juicers (covers infrastructure, KYC, insurance endorsement).
- 15% platform fee on every Juicer payout (configurable per subaccount).
The remaining 85% (or whatever you set the platform fee to) is split between the operator's bounty budget and the Juicer's earnings.
Does Levy cover Juicer insurance?
A new Christensen Group endorsement is required for Phase 3 launch ($30 to $60k/year, passed through to operators participating in the marketplace). Each operator also signs an attestation that they've informed their own insurer of the Juicer model — many will want a rider.
Can a Juicer steal a vehicle?
Mitigated by:
- KYC at onboarding (Stripe Identity — government ID + selfie + SSN-last-4)
- Throttle disabled during claim — the vehicle doesn't motor under its own power until the drop completes
- GPS-validated photo at pickup and drop
- Per-Juicer claim radius — can't operate outside the verified home area
- Operator suspend/ban controls — instant lockout from the dashboard
Net: vehicle theft via the gig system is uneconomical and traceable.
What if a Juicer drops outside the zone?
The drop is rejected. The Juicer relocates the vehicle and tries again. No partial payout, no exception. Repeat drop-zone violations add fraud-score points and can trigger auto-suspension.
Can a Juicer dispute a held payout?
There's no Juicer-initiated dispute path today. Juicers contact the operator directly through the support email exposed on their Earnings page. Operator-initiated decisions are final.
Cron and Operations
How often does the SoH job run?
Nightly at 03:00 UTC.
How often does the bounty engine refresh?
Every 5 minutes for enabled subaccounts.
How often do payouts drain?
Every 15 minutes. The default scheduled_for delay is 24 hours after session completion to allow operator review; operators can adjust this per subaccount.
How often do stale claims get released?
Every 1 minute (the bounty-expire cron).
Pricing and Packaging
Is SoH tracking included in my plan?
Yes — SoH tracking is included in Pro and Enterprise tiers at no extra cost.
Is swap-station inventory included?
It's an Enterprise-tier feature.
Are Juicers an add-on?
Yes — Juicers are a separate add-on with two billable components (per-vehicle platform fee + per-payout platform fee). Talk to your operator success contact to enable.