Supergood | Fleetsoft API
Programmatically access Fleetsoft fleet asset records, work orders, preventive maintenance schedules, parts inventory, fuel logs, and purchasing workflows with a stable REST API. Supergood builds and operates production-grade, unofficial Fleetsoft integrations so your team can automate shop and back-office processes without heavy custom engineering.
Plain English: Fleetsoft is fleet maintenance and parts inventory software used by trucking, municipal, school bus, construction, and service fleets to manage vehicles/equipment, schedule preventive maintenance, track work orders and costs, manage parts and purchase orders, and log fuel and meter readings. An unofficial API lets you programmatically pull assets, PM schedules, work orders, parts inventory, fuel transactions, vendors, and purchase orders—and push new records or updates back into Fleetsoft.
For a tech company integrating with Fleetsoft, this means you can ingest real-time fleet and shop data to power dashboards, sync purchase orders and vendor bills to accounting (e.g., QuickBooks, Xero), automate PM triggers and work orders from your product, or enrich your platform with meter readings, fuel usage, tire tracking, and attachments. You can also trigger notifications for upcoming services, create work orders from telematics alerts, synchronize part stock levels across locations, and keep stakeholder systems (ERP, analytics, CRM, dispatch, telematics) in lockstep.
What is Fleetsoft?
Fleetsoft (https://fleet-maintenance.com/) is a fleet maintenance management and parts inventory platform that centralizes shop operations, preventive maintenance planning, procurement, and cost tracking for vehicles, trailers, and equipment. Teams use Fleetsoft to define PM programs, open and complete repair work orders, manage labor and parts, track fuel and meter readings, control stock across locations, and issue purchase orders to vendors—while maintaining compliance records and service history.
Core product areas include:
- Fleet Assets & Equipment (Vehicles, Trailers, Non-road Equipment)
- Maintenance & Work Orders (Tasks, Labor, Parts, Service History)
- Preventive Maintenance (Schedules based on time, miles, hours)
- Parts & Inventory (SKUs, Bins, Reorder Points, Multi-Location Stock)
- Fuel & Meter Tracking (Fuel Card Imports, Odometer/Hour Logs)
- Purchasing & Vendors (Purchase Orders, Receiving, Costing)
- Tires & Components (Positions, Rotations, Replacement History)
- Compliance & Inspections (DMV/DOT, Safety, Certificates)
Common data entities:
- Companies, Users, Roles/Permissions (Fleet Admins, Mechanics, Drivers)
- Assets (unit numbers, VINs, categories, locations, status)
- Work Orders (headers, tasks, labor lines, parts lines, totals)
- Preventive Maintenance Programs (services, thresholds, last service dates)
- Parts (SKU, description, unit of measure, bins, stock levels, costing)
- Vendors & Contacts (terms, lead times, catalogs)
- Purchase Orders & Receipts (lines, taxes, totals, status)
- Fuel Transactions (date, gallons, unit price, odometer, driver)
- Meter Readings (odometer, engine hours, source)
- Tire Records (positions, tread, serials)
- Shops/Locations (stock rooms, service bays)
- Attachments/Documents (photos, invoices, spec sheets)
The Fleetsoft Integration Challenge
Fleets rely on Fleetsoft daily, but turning shop- and portal-based workflows into API-driven automation is non-trivial:
- Mixed deployment and access: Some fleets run desktop/on-prem installations, others use hosted portals—authentication and session lifecycles vary
- PM logic: Service triggers depend on time, mileage, engine hours, and last-service events across multiple programs
- Inventory nuance: Multi-location stock, bin-level quantities, average cost, and reserved/available states require careful normalization
- Purchasing rigor: Vendor terms, receiving, taxes, and cost updates must be modeled consistently
- Data spread: Key objects span assets, work orders, PM schedules, parts, fuel, and purchasing with context in multiple views
- Limited official APIs: Many customers report lacking or incomplete public API access, making headless automation and data sync challenging without reverse-engineering
How Supergood Creates Fleetsoft APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Fleetsoft tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely where applicable
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
Use Cases
Asset & Maintenance Data Sync
- Mirror assets, locations, and service history into your internal systems
- Keep unit status, meter readings, and PM due dates current for analytics and planning
- Normalize identifiers (unit number, VIN) for cross-platform reporting
Preventive Maintenance & Scheduling
- Generate work orders automatically when PM thresholds are met
- Sync schedules with planning/dispatch tools and trigger reminders
- Apply meter readings from telematics feeds to recalculate due services
Parts, Procurement, and Accounting Sync
- Pull inventory levels and reorder points; push purchase orders to vendors
- Sync POs, vendor bills, and receipts to ERP/accounting (e.g., QuickBooks, Xero)
- Reconcile parts usage from completed work orders with costing and stock adjustments
Fuel, Meter & Telematics
- Ingest fuel card transactions to analyze MPG and cost per mile n* Post odometer/hour readings from devices or driver apps to keep PM forecasts accurate
- Trigger exception alerts (e.g., high idle hours, fuel anomalies) and open work orders programmatically
Available Endpoints
Authentication
POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_fsoft_29afc1",
"name": "Shop Manager",
"entitlements": ["assets", "work_orders", "pm", "parts", "purchasing", "fuel"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Assets
GET /assets: List fleet assets with filters and summary maintenance details.
Query parameters
- shopId: string
- status: active | out_of_service | retired
- category: vehicle | trailer | equipment
- pmDueWithinDays: integer
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"assetId": "a_veh_7842",
"unitNumber": "TRK-204",
"vin": "1FT9W3BT5PEC12345",
"plate": "TX-9H27L2",
"make": "Ford",
"model": "F-350",
"year": 2023,
"category": "vehicle",
"status": "active",
"locationId": "loc_dallas",
"assignedDriverId": "drv_108",
"currentOdometer": 48219,
"currentHours": null,
"pmDueCount": 2,
"nextPmDueDate": "2026-02-05",
"lastServiceDate": "2026-01-10",
"updatedAt": "2026-01-22T14:41:19Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Work Orders
POST /work-orders: Create a maintenance work order with tasks, labor, parts, and meter context.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/work-orders \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"shopId": "loc_dallas",
"assetId": "a_veh_7842",
"openedDate": "2026-01-22",
"priority": "high",
"complaintNotes": "Brake vibration under load; inspect rotors and pads.",
"meterReading": { "odometer": 48219, "hours": null },
"tasks": [
{"taskCode": "BRK-INSP", "description": "Brake inspection", "dueDate": "2026-01-23", "estimatedHours": 1.5},
{"taskCode": "BRK-REPL", "description": "Replace front pads/rotors if needed", "estimatedHours": 2.0}
],
"parts": [
{"partId": "p_pad_ferodo_f350", "quantity": 1, "unitPrice": 145.00},
{"partId": "p_rotor_f350_front", "quantity": 2, "unitPrice": 120.00}
],
"labor": [
{"userId": "mech_332", "hours": 2.5, "rate": 65.00}
],
"attachments": [
{"fileName": "complaint_photo.jpg", "uploadToken": "upl_3ab9ce"}
],
"requestedBy": "Dispatcher",
"referenceId": "telematics-alert-9021"
}'
Example response
{
"workOrderId": "wo_61bfa2",
"number": "WO-2026-00123",
"status": "open",
"assetId": "a_veh_7842",
"partsTotal": 385.00,
"laborTotal": 162.50,
"taxTotal": 38.60,
"grandTotal": 586.10,
"createdAt": "2026-01-22T15:07:31Z"
}
Work Order Updates
PATCH /work-orders/{workOrderId}: Update work order status, add lines, and close with final meter readings.
curl --request PATCH \
--url https://api.supergood.ai/integrations/<integration_id>/work-orders/wo_61bfa2 \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"status": "completed",
"closedDate": "2026-01-22",
"meterReading": { "odometer": 48236, "hours": null },
"notes": "Replaced front pads and rotors; test drive OK."
}'
Example response
{
"workOrderId": "wo_61bfa2",
"status": "completed",
"closedDate": "2026-01-22",
"grandTotal": 586.10,
"updatedAt": "2026-01-22T16:12:04Z"
}
Parts Inventory
GET /parts: List parts with stock levels, bins, and vendor metadata.
Query parameters
- locationId: string
- belowReorder: boolean
- sku, search: strings for matching
- vendorId: string
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"partId": "p_rotor_f350_front",
"sku": "ROT-F350-FR",
"name": "Brake Rotor - Front (F-350)",
"category": "brakes",
"unitOfMeasure": "each",
"stock": {"onHand": 12, "available": 10, "reserved": 2, "reorderPoint": 4},
"locations": [
{"locationId": "loc_dallas", "bin": "BRK-A2", "qtyOnHand": 8},
{"locationId": "loc_houston", "bin": "BRK-B1", "qtyOnHand": 4}
],
"averageCost": 110.25,
"preferredVendorId": "ven_auto_supplies_tx",
"lastReceivedDate": "2026-01-18",
"updatedAt": "2026-01-22T12:01:47Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination across modules
- Rate limits: Tuned for enterprise throughput while honoring customer entitlements and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of assets, PM schedules, work orders, parts inventory, purchasing, and fuel transactions
- Security: Encrypted transport, scoped tokens, and audit logging; respects Fleetsoft role-based permissions
- Webhooks: Optional asynchronous delivery for long-running workflows (e.g., work order completion, PO receipt, PM status changes)
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume asset/work order sync and parts/purchasing processing
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Fleetsoft adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Fleetsoft evolves.
Frequently Asked Questions
Q: Which Fleetsoft modules can this integration cover?
Supergood supports workflows across commonly used modules such as Assets, Preventive Maintenance, Work Orders, Parts & Inventory, Purchasing, and Fuel/Meter tracking, subject to your licensing and entitlements. We scope coverage during integration assessment.
Q: How are MFA, SSO, and on-prem deployments handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For hosted portals, we maintain session continuity; for desktop/on-prem deployments, we provide secure headless adapters and gateway options to expose a safe API surface.
Q: Can you sync purchase orders and vendor invoices to our accounting system?
Yes. We can normalize POs, receipts, and parts/labor job-cost line items to match your ERP/accounting schema and deliver updates via webhooks or polling while complying with rate and permission constraints. We commonly integrate with QuickBooks and Xero.
Q: Can you import fuel card transactions and meter readings from telematics?
Yes. We support ingesting fuel transaction files/feeds and posting odometer/hour readings to keep PM schedules accurate. We can also open or update work orders based on device alerts.
Q: Do you track tires and component history?
We can mirror tire position records, rotations, and replacements where available, and expose them via normalized endpoints or reports for analytics and compliance.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Fleetsoft workflows?
Supergood can have your Fleetsoft integration live in days with no ongoing engineering maintenance.
