Administration
Integrations
The 23 outside services Harbor can work with, grouped by the question each answers, whether each is off, simulated or live, and how to save a key.
Integrations lists the outside services Harbor TMS can talk to: carrier data, load boards, truck tracking, ocean visibility, mapping, paperwork, messaging and accounting. For each one you choose a mode (Off, Simulated or Live) and, where the service needs one, save its key. Keys are encrypted on the server and never shown again.
- Where
- Administration → Integrations (/integrations)
- Who can open it
- Integrations · view. By default: Owner and General Manager
- Who can save keys and change modes
- Integrations · edit
- Live today
- FMCSA QCMobile is the one service with a working connector. Everything else is simulated or off
- Saves to
- Your company's integration settings (keys encrypted) and the audit log
The three modes
| Mode | What happens |
|---|---|
| Off | The service is not used. For FMCSA, lookups are refused: "FMCSA lookups are switched off. Turn them on under Integrations." |
| Simulated | Demo answers, labelled as simulated |
| Live | Real calls to the provider with your saved key. Only possible once a key is saved ("Live — save a key first") |
Each row also shows a connection state:
| State | Meaning |
|---|---|
| Live | A working connector, a saved key, and the mode set to Live |
| Key saved · untested | A key is saved, but the service has no connector yet, or the mode is not Live |
| Not connected | No key saved |
The header counts "N of 23 live" and how many are simulated.
The providers
Grouped as on the screen. "Starts as" is the mode in the seeded demo company.
Compliance: is this carrier who it says it is?
| Provider | What it does | Billing | Starts as | Status in Harbor |
|---|---|---|---|---|
| FMCSA QCMobile | Authority, identity and the registered email | Free public API | Simulated | Can be Live with your own FMCSA web key |
| FMCSA SAFER | Safety rating and out-of-service history | Free public API | Off | No connector yet |
| Highway | Double-brokering and identity risk grading | Subscription | Off | No connector yet |
| RMIS | Carrier packet, insurance certificates and W9 | Subscription | Off | No connector yet |
| MyCarrierPackets | Onboarding packets and monitoring | Subscription | Off | No connector yet |
Rate discovery: what will this lane cost to cover?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| DAT | Post a load, receive rate offers | Subscription | Simulated | No connector yet |
| Truckstop | Post a load, receive rate offers | Subscription | Simulated | No connector yet |
| Loadmatch | Post a load, receive rate offers | Subscription | Simulated | No connector yet |
| Ferry booking | Submit a sailing request, receive confirmation | Contracted | Simulated | Configured per ferry operator once a contract exists; no Connect form |
Telematics: where is the truck right now?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| Samsara | Truck position and hours of service | Subscription | Simulated | No connector yet |
| Motive | Truck position and hours of service | Subscription | Simulated | No connector yet |
| Geotab | Truck position and hours of service | Subscription | Simulated | No connector yet |
Ocean visibility: where is the box, and when does free time run out?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| Project44 | Vessel milestones and last free day | Contracted | Simulated | No connector yet |
Routing and distance: how far is it, really?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| Google Maps | Geocoding and distance | Per call | Off | No connector yet |
| Mapbox | Geocoding and distance | Per call | Off | No connector yet |
| PC*MILER | Practical truck miles for rating | Contracted | Off | No connector yet |
Paperwork: can the document sign or read itself?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| DocuSign | Signature on delivery orders and rate confirmations | Subscription | Off | No Connect form: it needs a private key uploaded to the server |
| AWS Textract | Arrival notice OCR | Per call | Off | No connector yet |
Messaging: how does this leave the building?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| Twilio | SMS to drivers and dispatchers | Per call | Off | No connector yet |
| SMTP (self-hosted) | All outbound email | No fee, self-hosted | Off | See the note below |
| Slack | Exception alerts to a channel | No fee | Off | No connector yet |
Money: where do the invoices and payments land?
| Provider | What it does | Billing | Starts as | Status |
|---|---|---|---|---|
| QuickBooks Online | Invoice and payment sync | Subscription | Off | No Connect form: it needs an OAuth sign-in with Intuit |
| Stripe | Subscription billing for the platform | Per transaction | Off | See the note below |
Save a key
Find the provider
Use the group links at the top to jump to a section.Click Connect
Or Replace key when one is already saved. The window says "Held on the server, never in this browser."Fill in the fields
Each provider asks for its own fields, named as in its documentation (for FMCSA, the web key).Click Save credential
The key is checked for shape, encrypted and stored. You see "Saved and encrypted on the server — ends in 1a2b."Switch the mode to Live
Pick Live in the row's mode menu.
- A saved key is never shown again, to anyone. The row shows only its last four characters (
•••• 1a2b), or "None on file". To change it, replace it. - Test connection is shown but not active yet: testing arrives with each provider's connector.
- For a provider with no Connect form, the button explains why when you hover it.
Rules
- Live needs a saved key: "Save a key first. Live mode needs a key to call the service with."
- Live means live. If the FMCSA key cannot be read, lookups are refused ("The FMCSA web key could not be read. Enter it again on Integrations.") and never quietly fall back to simulated answers.
What is recorded
| Action | Audit entry |
|---|---|
| Save a key | integration.key_save: the provider and how many fields were stored. Never the value |
| Replace a key | integration.key_replace |
| Change mode | integration.mode: for example "simulated → live." |
Related
- Carrier compliance: where FMCSA lookups are used
- Integrations, for developers
- Rate board
- Tracking
- Billing