Wise Systems API
Wise Systems is an autonomous routing and last-mile delivery optimization platform that uses machine learning to plan routes, dispatch drivers, and coordinate field operations across distribution, parcel, food & beverage, and parts fleets. An API lets you programmatically pull and push tasks, stops, routes, drivers, vehicles, and tracking data—creating and reassigning tasks, dispatching and optimizing routes in real time, and managing driver and customer records inside Wise Systems.
What is Wise Systems?
Wise Systems is an autonomous routing and delivery optimization platform that uses machine learning to improve last-mile delivery performance. Fleets use Wise Systems to model optimal vehicles, drivers, and delivery frequencies; calculate constraint-aware routes; dispatch and monitor drivers in real time; capture proof of delivery; and give customers live order tracking with ETAs—serving wholesale and retail distribution, parcel and courier, food & beverage, and auto parts operations.
Core product areas include:
- Planning (Strategic Planner, Route Planner, Performance Manager)
- Execution (Dispatcher real-time fleet monitoring, Driver mobile app with navigation, proof of delivery, and barcode scanning)
- Coordination & Communication (Mobile Manager, Customer Portal with live tracking and ETAs)
- Dynamic optimization engine and Engine API powering all solutions
Common data entities:
- Tasks/Orders, Stops, Pickup/Delivery pairs, Inventory Items
- Routes, Schedules, Sequences, Real-Time Adjustments
- Drivers, Shifts, Breaks, Location updates
- Vehicles, Compartments, Zones, Depots
- Customers, Locations/Addresses, COD payments, Custom Forms
- Users, User Groups, Roles and feature permissions
The Wise Systems Integration Challenge
Fleets run dispatch and routing on Wise Systems all day, but wiring portal- and app-driven workflows into reliable automation is non-trivial:
- Short-lived bearer tokens: Access tokens expire after roughly an hour and must be refreshed, so headless automation needs robust token rotation and replay handling
- Role-scoped authorization: Most endpoints enforce role-based checks tied to user groups, so an integration must respect planning, dispatch, and driver-management entitlements
- Real-time state churn: Routes, sequences, and driver locations change continuously via real-time adjustment, so pulled data goes stale fast without webhooks and change detection
- Driver-app data: Proof of delivery, barcode scans, and COD captured in the mobile app must be reconciled back against tasks and orders
- Bulk and idempotent writes: Task creation, replacement, and reassignment happen in bulk against live schedules, so writes need idempotency and careful sequencing
- Partner-integration variability: Coverage differs depending on whether you connect through the open API directly or through partner integrations such as Samsara and Motive
How Supergood Creates Wise Systems APIs
Supergood combines Wise Systems' open API surface with authenticated browser and driver-app flows to deliver a resilient, normalized API layer for your Wise Systems tenant—across planning, dispatch, and execution.
- Handles username/password login, bearer-token issuance, and automated refresh of expiring access tokens
- Maintains session continuity with managed token rotation and change detection on live routes
- Normalizes responses across tasks, routes, drivers, vehicles, and customers so you integrate once and rely on consistent objects
- Respects role-based authorization and user-group entitlements to ensure compliant access
Use Wise Systems with AI agents: Wise Systems MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, fleets, and authentication model.
- Supergood Generates and Validates Your API
We deliver a production-ready Wise Systems adapter tailored to your tenant configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Wise Systems evolves.
API Endpoints
Authentication
/authenticateAuthenticate with username/password to obtain a bearer access token and refresh token for downstream calls.
Tasks
/tasksList tasks and stops with filters for status, route, driver, and time window.
Tasks
/tasksCreate or bulk-replace tasks, including pickup/delivery pairing and suggested-driver matching.
Routing
/optimize_routesRun the Route Planner scheduler to sequence and optimize routes, with manual or automatic sequencing.
Drivers
/driversRetrieve driver profiles, schedules, shift status, and real-time location updates.
Vehicles
/vehiclesList vehicles, compartments, and zone associations available for routing and dispatch.
Use Cases
Push orders into Wise Systems and pull back optimized routes
- Create and bulk-replace tasks from your OMS, ERP, or route accounting system - Pair pickups and deliveries and apply suggested-driver matching - Pull optimized routes and sequences back for downstream planning and reporting
Stream live tracking and proof of delivery to customers
- Pull driver location and route progress for real-time customer ETAs - Capture proof of delivery, barcode scans, and COD from the driver app - Push status events to notification, CX, and billing workflows
Sync drivers, shifts, and vehicles with workforce systems
- Onboard drivers and sync shifts, breaks, and schedules from HR and scheduling tools - Reflect vehicle, compartment, and depot changes in routing constraints - Register shift start/end and reassign tasks between clients without portal clicks
Reconcile dispatch and delivery data into analytics
- Stream task, route, and driver events into BI and performance dashboards - Reconcile COD payments and custom-form submissions against orders - Surface late-arrival and utilization metrics for continuous fleet optimization
Technical Specifications
Authentication
Username/password login issuing bearer access tokens (≈1-hour expiry) and refresh tokens, handled in a managed session
Connectivity
Wise Systems open Engine API plus authenticated browser and driver-app flows where coverage is not exposed
Response format
Normalized JSON across Tasks, Routes, Drivers, Vehicles, and Customer objects
Rate limits
Adaptive throttling tuned to your tenant to avoid platform-side limits
Session management
Automatic access-token refresh, credential rotation, and replay handling for expiring sessions
Data freshness
Near real-time pulls for routes, tasks, and driver locations with optional scheduled batch syncs
Security
Encrypted credential vault, scoped bearer tokens, role-based authorization, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks via Wise Systems webhook subscriptions for task, route, and delivery status changes
Latency
Sub-second reads on cached entities; multi-second writes when posting bulk tasks and route optimizations
Throughput
Horizontally scaled workers sized to multi-fleet task and route volume
Reliability
Retry, backoff, and idempotency keys for bulk task creation, replacement, and reassignment
Adaptation
Continuous monitoring of Wise Systems API releases, partner-integration changes, and tenant configuration drift
Frequently asked questions
Yes. Wise Systems offers an open Engine API documented at api-docs.wisesystems.io, using JSON payloads and bearer-token authentication. Supergood layers on managed token refresh, normalization, and authenticated app flows so you integrate once across planning, dispatch, and execution.
The API uses bearer tokens passed in HTTP headers, with access tokens that expire after roughly an hour and refresh tokens for renewal. Supergood manages login, token issuance, and automatic refresh so your integration never breaks on expiry.
Yes. The API supports creating, bulk-replacing, pairing, and reassigning tasks, plus running the Route Planner scheduler for manual or automatic sequencing and real-time route adjustments.
Yes. Proof of delivery, barcode scans, custom forms, and Collect-on-Delivery payments captured in the driver app are reconciled back against tasks and orders through the normalized API surface.
Yes. Wise Systems supports partner integrations such as Samsara and Motive. Supergood can work alongside these or against the open API directly, normalizing coverage so it is consistent regardless of the path.