Trimble TMW Suite

Supergood | Trimble TMW Suite API

Alex Klarfeld

Alex Klarfeld

— 6 min read

Programmatically access Trimble TMW Suite transportation operations data, dispatch workflows, and financials with a stable REST API. Supergood builds and operates production-grade, unofficial Trimble TMW Suite integrations so your team can automate fleet and back-office workflows without heavy custom engineering.

Plain English: Trimble TMW Suite is transportation management software used by for-hire carriers, private fleets, and brokers to run over-the-road operations end-to-end. An unofficial API lets you programmatically pull loads/orders, stops and appointments, drivers and equipment, routing and miles, EDI statuses, invoices and settlements—and push updates like dispatch assignments, appointment changes, tracking/check calls, and billing records back into TMW Suite.

For a tech company integrating with TMW Suite, this means you can ingest real-time load and asset data to power visibility dashboards, sync invoices to your ERP, automate dispatch from your platform, or enrich your product with tracking events and POD documents. You can also push driver/equipment assignments, update stop statuses and appointment windows, create invoices from rate data, and keep stakeholder systems (telematics, ERP/accounting, analytics) in lockstep.

What is Trimble TMW Suite?

Trimble TMW Suite (https://transportation.trimble.com/products/tmw-suite) is a comprehensive transportation management system (TMS) that centralizes order entry, planning/dispatch, asset and driver management, billing and settlements, and compliance for trucking and logistics operations.

Core product areas include:

  • Order Entry & Rating (e.g., customers, lanes, rate tables, accessorials)
  • Planning & Dispatch (e.g., loads, stops, appointments, driver/equipment assignments)
  • Visibility & Tracking (e.g., check calls, ELD/telematics, geofenced arrivals/departures)
  • Financials (e.g., invoices, AR, driver settlements, pay plans)
  • EDI (e.g., 204 tender, 214 status, 210 invoice) and document workflows (BOL, POD)
  • Fuel & Mileage/IFTA (e.g., miles, fuel purchases, tax reporting)
  • Maintenance integrations (e.g., TMT Fleet Maintenance)

Common data entities:

  • Companies (customers, vendors/carriers), Users, and Permissions
  • Loads/Orders (metadata, lanes, service levels, status)
  • Stops (pickup/delivery), Appointments, Locations/Addresses
  • Drivers, Tractors, Trailers, and Availability
  • Route Plans, Practical Miles, ETAs
  • Charges (linehaul, fuel surcharge, accessorials), Rate Tables
  • Invoices, Line Items, Settlements, Driver Pay
  • Tracking Events (check calls, arrival/departure), Documents (BOL/POD)

The Trimble TMW Suite Integration Challenge

Transportation teams rely on TMW Suite daily, but turning portal or client-based workflows into API-driven automation is non-trivial:

  • Legacy variance: Many fleets run on-prem/client-server editions; official REST coverage varies by module, and EDI/files are still common
  • Fragmented modules: Dispatch, Financials, EDI, and Fuel/Mileage have distinct schemas, permissions, and approval rules
  • Heavy configuration: Custom fields, charge codes, pay plans, and workflow gates differ widely by tenant
  • Portal-first and batch jobs: UI-optimized flows, nightly processes, and multiple exports complicate real-time integrations
  • Operational rigor: Check calls, stop status changes, and invoice creation must obey business rules and auditability
  • Enterprise security: SSO, MFA, service accounts, and role-based controls challenge headless access

How Supergood Creates TMW Suite APIs

Supergood reverse-engineers authenticated browser flows and service interactions to deliver a resilient API endpoint layer for your TMW Suite environment.

  • Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
  • 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, approval chains, and role-based permissions to ensure compliant access
  • Bridges EDI events (e.g., 204/214/210) into normalized resources where useful

Use Cases

Load and Master Data Sync

  • Mirror loads, customers, drivers, tractors, and trailers into your internal systems
  • Keep stop details, appointment windows, and statuses current for analytics and planning
  • Normalize service levels, lanes, and practical miles for multi-tenant operations

Dispatch Automation

  • Assign drivers and equipment from your product based on availability and constraints
  • Push special instructions, team driving flags, and planned depart times
  • Trigger schedule updates and notify stakeholders when assignments change

Tracking and Visibility

  • Ingest check calls and telematics events to populate real-time visibility dashboards
  • Update stop statuses (arrived, departed, POD received) and calculate dwell/detention
  • Generate SLA alerts when appointments or ETAs drift

Financials: Invoices and Settlements

  • Create invoices with linehaul, fuel surcharge, and accessorials
  • Sync invoice statuses to ERP (e.g., NetSuite, QuickBooks) and reconcile payments
  • Pull settlement data to automate driver pay reporting and audits

EDI Bridge & Backfill

  • Translate EDI 214 status codes into normalized tracking events
  • Backfill loads from EDI 204 tenders and create invoices aligned to 210s
  • Maintain compliant acknowledgments and audit trails

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_2a7310",
    "name": "Dispatch Manager",
    "entitlements": ["loads", "drivers", "equipment", "billing"]
  }
}

Loads

GET /loads: List loads/orders with filters and summary details.

Query parameters

  • customerId: string
  • status: planned | dispatched | enroute | delivered | cancelled
  • pickupFrom, pickupTo: ISO 8601 timestamps
  • deliveryFrom, deliveryTo: ISO 8601 timestamps
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "loadId": "ld_7f3b19",
      "referenceNumber": "L-2026-001234",
      "orderNumber": "SO-884312",
      "status": "dispatched",
      "customerId": "cust_21aa05",
      "serviceLevel": "tl_dry_van",
      "stops": [
        {
          "stopId": "stp_5a9920",
          "type": "pickup",
          "location": {
            "name": "Paper Mill",
            "address": {
              "line1": "100 Mill Rd",
              "city": "Eden",
              "region": "NC",
              "postalCode": "27288",
              "country": "US"
            }
          },
          "appointmentWindow": {
            "start": "2026-01-25T08:00:00Z",
            "end": "2026-01-25T10:00:00Z"
          },
          "status": "arrived"
        },
        {
          "stopId": "stp_9c3137",
          "type": "delivery",
          "location": {
            "name": "Distribution Center",
            "address": {
              "line1": "500 Logistics Pkwy",
              "city": "Columbus",
              "region": "OH",
              "postalCode": "43085",
              "country": "US"
            }
          },
          "appointmentWindow": {
            "start": "2026-01-26T14:00:00Z",
            "end": "2026-01-26T16:00:00Z"
          },
          "status": "scheduled"
        }
      ],
      "driverId": "drv_4c119a",
      "tractorId": "trk_9021bf",
      "trailerId": "trl_18cd77",
      "commodity": "Paper rolls",
      "weightLbs": 42000,
      "plannedRouteMiles": 812,
      "updatedAt": "2026-01-21T13:45:00Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Dispatch Assignments

PATCH /loads/{loadId}/assignments: Assign a driver and equipment to a load with planned dispatch details.

curl --request PATCH \
  --url https://api.supergood.ai/integrations/<integration_id>/loads/ld_7f3b19/assignments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "driverId": "drv_4c119a",
    "tractorId": "trk_9021bf",
    "trailerId": "trl_18cd77",
    "plannedDepartAt": "2026-01-25T07:30:00Z",
    "teamDriving": false,
    "notes": "Seal at shipper; use dock 3."
  }'

Example response

{
  "loadId": "ld_7f3b19",
  "status": "dispatched",
  "assignment": {
    "driverId": "drv_4c119a",
    "tractorId": "trk_9021bf",
    "trailerId": "trl_18cd77",
    "plannedDepartAt": "2026-01-25T07:30:00Z",
    "teamDriving": false,
    "notes": "Seal at shipper; use dock 3."
  },
  "assignedAt": "2026-01-21T14:10:22Z"
}

Invoices

POST /invoices: Create an invoice against a completed load with linehaul, fuel surcharge, and accessorials.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/invoices \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "loadId": "ld_7f3b19",
    "customerId": "cust_21aa05",
    "currency": "USD",
    "terms": "net_30",
    "referenceNumber": "INV-2026-000128",
    "lineItems": [
      {"chargeCode": "linehaul", "description": "Linehaul: Eden, NC to Columbus, OH", "amount": 1450.00},
      {"chargeCode": "fuel_surcharge", "description": "Fuel surcharge", "amount": 185.00},
      {"chargeCode": "detention", "description": "Detention at shipper (1 hr)", "amount": 75.00}
    ],
    "attachments": [
      {"fileName": "invoice.pdf", "uploadToken": "upl_7fa223"},
      {"fileName": "pod.jpg", "uploadToken": "upl_0ac912"}
    ],
    "notes": "Rate per contract; detention approved by customer."
  }'

Example response

{
  "invoiceId": "inv_51af80",
  "status": "submitted",
  "loadId": "ld_7f3b19",
  "totalAmount": 1710.00,
  "createdAt": "2026-01-21T15:20:44Z"
}

Get full API Specs →

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 loads, assignments, tracking events, and financial objects
  • Security: Encrypted transport, scoped tokens, and audit logging; respects TMW Suite role-based permissions and approvals
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., appointment changes, invoice approvals)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume load sync and billing event processing
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
  • Adaptation: Continuous monitoring for UI/EDI changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened TMW Suite adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as TMW Suite evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which TMW Suite modules can this integration cover?

Supergood supports workflows across commonly used modules such as Order Entry & Rating, Planning/Dispatch (loads, stops, assignments), Visibility/Tracking (check calls, telematics), Financials (Invoices, Settlements), and Fuel & Mileage/IFTA, subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.

Q: Can you sync invoices and settlements to our ERP?

Yes. We can normalize invoices and settlements to match your ERP schema (e.g., charge codes, line items, taxes) and deliver updates via webhooks or polling while complying with rate and permission constraints.

Q: Do you bridge EDI workflows (204/214/210)?

Yes. We can translate EDI acknowledgments and statuses into normalized resources (loads, tracking events, invoices) and reconcile differences with TMW Suite records for end-to-end traceability.

Q: Are attachments like BOL and POD supported?

Yes. We support downloading artifacts and uploading attachments via signed uploads, with checksum validation and time-limited URLs.

Samsara API - Power visibility with telematics and ELD data from Samsara

Ready to automate your Trimble TMW Suite workflows?

Supergood can have your Trimble TMW Suite integration live in days with no ongoing engineering maintenance.

Get Started →

Read more