MSA TMS — User Guide

A practical, end-to-end walkthrough of MSA's Transportation Management System for dispatchers, fleet managers, accountants, and safety teams. Every screen in the app is covered, with a screenshot and a short explanation of what to do there.

For end-users English Includes live screenshots Updated May 2026

Overview

MSA TMS is the daily operating system for the carrier. It is organised around three big ideas:

  1. Boards — at-a-glance, action-oriented views of what's happening right now (where trucks are, which loads need attention, who's home, what's invoiceable).
  2. Main — the source of truth for the company's data: loads, drivers, trucks, trailers, and reports.
  3. Dispatch / Fleet / Accounting / Safety / Settings — specialised areas for the teams who own those workflows.

Most days, a dispatcher lives on the Load Board and the Loads page. A fleet manager lives on Repair and PM. Accounting lives on Invoicing and Expenses. Safety lives on Claims.

M

Map

See every truck on the road in real time.

L

Loads

Create, assign, status-update, and close every load.

D

Drivers

Onboard, manage payroll, track hours and assignments.

F

Fleet

PM schedules, repairs, fuel cards, photo control.

$

Accounting

Toll, fuel, and unit-level expense tracking.

S

Settings

Users, roles, integrations, and company setup.

Logging in

MSA TMS lives at app.tms.msagroupllc.com. Use your work email and password to sign in.

  1. Open the URL above in a modern browser (Chrome, Edge, or Safari).
  2. Enter your Email and Password.
  3. Tick Remember me if you'd like the browser to remember your email next time.
  4. Click Login.

If your account belongs to more than one carrier, you'll be asked to pick which one to work in for this session. You can change carrier later by logging out and back in.

Forgot password? Click the Forgot password? link below the password field. You'll receive a reset link by email.
MSA TMS login screen
The login screen.

Welcome dashboard

The first screen after login is the Welcome page. It greets you by name, shows the current date and time (Eastern Time), and surfaces a row of Jump back in shortcuts to the four most-used screens: Load Board, Drivers, Trucks, and Invoicing.

The top bar shows live counts of Drivers, Trucks, Trailers, and Loads so you can confirm the fleet size at a glance. Your profile menu is at the far right.

Tip of the moment — a small motto rotates each minute. They're harmless dispatch wisdom, not action items.
Welcome dashboard
The Welcome page after logging in.

App layout

Every screen in the app uses the same shell:

  • Left sidebar — your map of the app, grouped by area (Boards, Main, Dispatch, Fleet, Accounting, Safety, Settings). Click an item to open the page; the active item is highlighted in orange.
  • Top bar — fleet counts, global search (🔎), notifications (🔔), and your profile menu.
  • Main area — the page itself. Most pages combine filters on the top, a table or map below, and an Action column on the right of each row.
  • Right drawer — when you edit a row (status, driver, truck, broker, etc.) the form slides in from the right rather than opening a pop-up dialog. Click outside or hit the Cancel button to dismiss.
Permission-driven UI: if a sidebar item or button is missing for you, your role doesn't have permission for it. Ask an admin to update your role under Settings → Users.

📊 Boards

Boards are the operational dashboards — they pull live data from across the system and present it in the shape that team needs right now.

Map

A live map of every truck in the fleet, with each pin showing the unit number, driver, current speed, and last update. Click a pin to reveal its route, recent stops, and any active load.

  • Pan and zoom like any web map.
  • Filter by driver, truck, or status from the toolbar.
  • Lines drawn on the map represent ongoing trips, including pickup and delivery points.
Boards / Map
Boards → Map — live fleet positions.

Load Board

The dispatcher's home base. Every load currently in the system, in one table, with filters at the top for status, driver, truck, dispatcher, broker, dates, and more.

  • Click a row to open the Load detail page.
  • Use the column sort arrows to re-order by pickup, delivery, or rate.
  • Inline status pills are colour coded — see Load statuses for the full legend.
Boards / Load Board
Boards → Load Board — every load at a glance.

Gross Board

A weekly profitability scorecard. For each truck (or driver) the board shows total gross revenue, miles, rate per mile, deductions, and notes. The colours flag trucks that are over- or under-performing the threshold set in Settings → Gross Board.

  • Switch between weeks with the date picker at the top.
  • Click a row to expand the individual loads that contributed to the total.
  • The notes column is shared with the dispatcher — leave a comment when re-classifying a load.
Boards / Gross Board
Boards → Gross Board — weekly profitability per unit.

Lane Board

A view of your top-performing lanes (origin → destination pairs). Use it to spot where the company is making the most money per mile, where you have a backlog of trips, and where rates are dropping.

  • Sort by gross, RPM, or trip count to find the most valuable lanes.
  • Click a lane to see every load that ran it.
  • Use the date filter to compare this month to last.
Boards / Lane Board
Boards → Lane Board.

Home Time

The driver vacation / home-time planner. Each row is a driver; the columns are days of the week. Use it to plan routing around drivers who'll be off, and to honour home-time requests.

  • Click a cell to mark a driver as home / on the road / off.
  • Hover for the driver's last and next planned home dates.
Boards / Home Time
Boards → Home Time.

Invoicing

The accounting team's worklist for closing out loads and getting paid. Filter by broker, dispatcher, or invoice status (Pending, Invoiced, Paid). For each load you can review the rate confirmation, BOL, and any photo control evidence before sending the invoice.

  • Send invoices in bulk by selecting rows and using the Action menu.
  • Mark paid loads from the row's edit drawer — this updates the related Gross Board calculation.
Boards / Invoicing
Boards → Invoicing.

Docs Board

A documentation health board — for each load it shows what's uploaded and what's missing (Rate Confirmation, BOL, POD, lumper receipts, scale tickets, photo control). Red badges mean a document is missing; green means uploaded.

  • Click a row to jump straight to the load's Documents tab.
  • Use this board the day before invoicing to make sure nothing's missing.
Boards / Docs Board
Boards → Docs Board.

PM Planning

A forward-looking maintenance calendar. PM (Preventive Maintenance) schedules from the Fleet module are projected onto a calendar so you can plan which trucks come off the road in which week.

  • Filter by PM type (A-service, B-service, DOT inspection, etc.).
  • Click an event to open the PM record in Fleet → PM.
Boards / PM Planning
Boards → PM Planning.

📁 Main

Main is where the core data lives. Anything you read in a board is created and edited here.

Loads

The full loads ledger. Create a new load (top-right button), search and filter existing loads, and open any one of them for a detailed view.

The Load detail page is the most-edited surface in the system. From there you can:

  • Assign and re-assign drivers, trucks, and trailers.
  • Change the load status (Upcoming → En Route → Delivered → Closed).
  • Upload Rate Confirmation, BOL, POD, and lumper receipts.
  • Edit the rate, deadhead, broker, lane, and notes.
Edit drawer pattern: editing any field opens a right-hand drawer. The drawer always has a Save button at the bottom. There's no separate "Edit mode" — every visible value with a pencil icon is in-place editable.
Main / Loads
Main → Loads.

Drivers

The driver roster. For each driver you can open a profile page with personal info, CDL, medical, payroll (% per load or per mile), assigned truck, hours of service, contacts, and uploaded documents.

  • + New driver — onboarding wizard for a brand-new driver.
  • Filter by employment status (Active, Terminated, Onboarding).
  • Open a driver to manage hold/release, vacation, and pay history.
Main / Drivers
Main → Drivers.

Trucks

Every power unit in the fleet. A truck record holds VIN, plate, make and model, annual registration, ownership (owned / leased / O/O), assigned driver, and any attached devices (Samsara, Azuga, etc.).

From a truck record you can:

  • Assign or unassign a driver.
  • Open the truck's PM schedule, repair history, fuel-card transactions.
  • Add documents (registration, IFTA, annual inspection, plates).
Main / Trucks
Main → Trucks.

Trailers

Every trailer in the fleet. Mirrors the Trucks page: VIN, plate, type (Dry Van, Reefer, Flatbed), ownership, current assignment, and documents.

  • Use the Type filter to find an available Reefer for a temperature-controlled load.
  • Trailer history shows which truck pulled it and when.
Main / Trailers
Main → Trailers.

Reports

A hub of pre-built reports — driver pay, gross, dispatcher commission, broker analysis, lane analysis, and more. Pick a report card to open it, choose a date range, and export to Excel / PDF.

  • Reports run against live data so they always match the current state.
  • Save common filter sets as bookmarks (browser URL captures filter state).
Main / Reports
Main → Reports.

Archive

Where Closed loads go after you mark them. The Archive is read-only — open a load to review the final invoice and documents, but you can't edit financial figures. Use it during audits or to look up an old POD.

Main / Archive
Main → Archive.

🚚 Dispatch

Dispatch Teams

Group dispatchers into teams (e.g. Day Shift, Night Shift, Reefer Desk). Each team has members and the trucks/drivers they own. The team a load is dispatched by is what feeds the dispatcher-commission report.

Dispatch / Teams
Dispatch → Dispatch Teams.

Brokers

The brokers and shippers you do business with. Each broker record stores MC number, contact info, factoring company, and rate history. When you create a load you pick a broker from this list.

  • Use the + New broker button to add a brand-new partner.
  • Open a broker to see every load you've ever run for them.
Dispatch / Brokers
Dispatch → Brokers.

Lanes

Named lanes (origin → destination, e.g. ATL → MIA). Used both for reporting and as a quick pick when creating a load. Lanes link to recurring broker contracts.

Dispatch / Lanes
Dispatch → Lanes.

Partner Companies

Other carriers you partner with — outsourcing loads, leasing trucks, or running drop-and-hook arrangements. Each partner record stores their MC, COI, and the contact people you deal with.

Dispatch / Partner Companies
Dispatch → Partner Companies.

🔧 Fleet

PM (Preventive Maintenance)

Scheduled maintenance for every truck and trailer. Each row shows the unit, the next due date or mileage, and the current state (Upcoming, Due, Overdue, Done).

Fleet / PM
Fleet → PM.

Repair

A live ticket of every truck or trailer currently in or recently out of the shop. Top tabs let you switch between Truck and Trailer. Filters on the right narrow by shop, mechanic, status (In Shop, Diagnosing, Done), and date.

  • + New repair — opens a form to log a unit going to the shop.
  • Attach photos and the shop's invoice; cost flows into Accounting.
Fleet / Repair
Fleet → Repair.

Photo Control

Drivers upload photos of the truck and trailer (interior, exterior, tires) at regular intervals. Photo Control is where Safety and Fleet review those submissions, flag issues, and follow up with the driver.

  • Filter by date and driver to spot drivers who missed a check.
  • Use the inline approve/reject buttons; comments are visible to the driver.
Fleet / Photo Control
Fleet → Photo Control.

Fuel Card

Manage the fleet's fuel cards (e.g. EFS, Comdata). Each card record links to a truck and a driver. Transactions imported from the fuel-card provider show here and feed Accounting → Fuel.

  • Issue, deactivate, or replace a card.
  • Set per-card daily or weekly spending limits.
Fleet / Fuel Card
Fleet → Fuel Card.

Inventory

Parts and supplies on hand at your shop (filters, brake pads, tires, fluids). Use inventory to track what you have so a repair can be costed against it instead of always buying new.

Fleet / Inventory
Fleet → Inventory.

Repair Shops

The directory of shops you use — in-house and 3rd-party. Each record stores address, contact, accepted payment methods, and labour rate. New repair tickets pick a shop from this list.

Fleet / Repair Shops
Fleet → Shops.

💵 Accounting

Toll

Toll transactions imported from Bestpass (and similar). Each row shows toll amount, lane, transponder, truck, and the load it should be billed against.

  • Reassign a toll to a different load if it was auto-matched incorrectly.
  • Export selected rows for reconciliation.
Accounting / Toll
Accounting → Toll.

Fuel

Fuel-card transactions, joined to drivers and trucks. Use it to spot anomalous spending (volume way above typical, unfamiliar location, mismatched truck).

  • Filter by truck, driver, card, or location.
  • Click a row to see the transaction in detail (gallons, price/gal, MPG).
Accounting / Fuel
Accounting → Fuel.

Expenses

The catch-all expenses ledger — anything that isn't a toll or a fuel-card swipe (Bestpass fees, IFTA, registration, deductions, etc.). Each line has an expense category, an amount, a date, and is attached to a truck, trailer, or driver.

Accounting / Expenses
Accounting → Expenses.

🛡️ Safety

Claims

The accident / cargo-claim register. Each claim record holds the date, location, driver, truck, photos, police report, the broker's claim number, and the cost.

  • Use the status workflow (Open → Investigating → Settled / Denied) to track resolution.
  • Closed claims feed driver scorecards and insurance reporting.
Safety / Claims
Safety → Claims.

⚙️ Settings

Users

Manage everyone who can log in: name, email, role, dispatcher team, status. Only users with the SETTINGS_USERS_VIEW permission see this page.

  • + New user — invite a new teammate.
  • Click a user to edit their role, reset password, or deactivate them.
Permission-driven: a user's role determines which sidebar items and buttons they see. See Permissions.
Settings / Users
Settings → Users.

Integrations

Third-party integrations the carrier uses. The card grid surfaces Samsara, Azuga, SkyBitz, Bestpass, ELD providers, and Gemini. Each card opens its own settings screen where you paste in API keys and toggle features.

  • Once configured, integrations populate the Map, Fuel Card, Toll, and similar pages automatically.
  • Use the Test connection button on each card before saving.
Settings / Integrations
Settings → Integrations.

Settings hub

The catch-all settings grid. Each card opens a sub-page:

  • Roles — define permission sets that get assigned to users.
  • Companies — your own legal entities (DBAs / MCs).
  • Departments — internal org chart used for routing and reports.
  • Expenses Categories — the taxonomy used in Accounting → Expenses.
  • Payment methods — ACH, Wire, Check, etc., used on broker invoices.
  • Gross Board settings — the threshold colours and rules for the Gross Board.
Settings hub
Settings hub.

📖 Reference

Load status legend

Every load row in the system wears one of these statuses. The colour and meaning are consistent across Boards, Loads, and Reports.

Upcoming — booked, not yet picked up En Route — driver on the load On Hold — paused (waiting on broker / shop / driver) Delivered — POD received Closed — invoiced and reconciled Rejected — broker declined the load Cancelled — pulled off the schedule

Permissions, in short

Permissions are resource-based — for each resource (Loads, Drivers, Trucks, Brokers, Fuel Cards, …) a role can have VIEW, ADD, EDIT, and DELETE rights independently.

The sidebar groups and buttons you see are filtered by permissions. If a screen or button is missing, ask an admin to grant the appropriate resource on your role under Settings → Roles.

FAQ

I don't see a sidebar item I used to have.

Your role's permission for that resource was removed. Speak to an admin who can update your role under Settings → Users / Roles.

The page won't load — it spins forever.

Check your internet connection first. The app needs to reach api.tms.msagroupllc.com. If that's blocked by your network, the app will route you to a maintenance page. A hard refresh (Ctrl+Shift+R) clears most stuck states.

I edited something but the change doesn't show up.

The edit drawers send a partial update — the change is saved on the server, but you may need to re-load the page to see it propagate to other widgets (e.g. the Gross Board cache).

How do I switch carrier?

Log out and log back in. If your account belongs to multiple carriers, the picker shows up after you enter your password.

How do I reset my password?

Click Forgot password? on the login screen. You'll receive an email with a reset link. Reset links expire in 24 hours.

Which browser is supported?

Recent Chrome, Edge, Safari, or Firefox. The app uses modern JavaScript and may misbehave on Internet Explorer or very old releases.