1. Freight Brokerage Platform
  2. Freight brokerage data model
Reference

The tables behind Freight Brokerage Platform

Freight Brokerage Platform ships with 15 tables, grouped here by the feature that uses them. Every record your team works with lives in one of them, and you can add fields and tables in Proto.

Tables
15
Features
6, plus shared settings
Change it
Add fields and tables in Proto

How the model is organised

Load planning

Loads references Organizations, team members through Owner, and transport partners through Counterparty. Load stops references the load through Parent and carries Revision, stop sequence, window start and window end.

Carrier offers

Carrier offers references Loads and Organizations. Carrier, offered rate USD, valid until and authority reference describe the offer; Revision and Status identify its review scope.

Assignments and readiness

Load assignments links Loads, Drivers and Vehicles with starts at and ends at. Drivers retains eligibility until and external authority. Vehicles retains equipment class and Readiness; vehicle defects links repair and release evidence to its Vehicle.

Dispatch and delivery

Loads keeps promised delivery at independently from actual pickup at and actual delivery at. Load stops retains actual arrival at, actual departure at and proof reference.

Evidence and review

Record attachments links Parent to Loads and uploaded by to team members. Review decisions links the parent load and Reviewer, retaining source revision and Reason.

Exceptions and reconciliation

Operation receipts links the load and records expected revision, operation key, result state and effect references. Exchange rates holds read-only effective rate records; freight amount USD and offered rate USD remain USD amounts.

Every table, by feature

Load planning

6 tablesAbout this feature
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Load stops

    Ordered pickup and delivery stops within a load with appointment windows

    Linked to Loads
  • Organizations

    Logistics operating organizations with time zone, currency and active scope

  • Transport partners

    Eligible carriers and transport partners with contact and eligibility notes

    Linked to Organizations
  • Team members

    Staff membership linking platform users to organizations with operational roles

    Linked to Organizations, Users
  • Operation receipts

    Idempotent operation receipts recording executed or failed actions with stable keys

    Linked to Loads

Carrier offers

6 tablesAbout this feature
  • Carrier offers

    Carrier rate offers raised against a Loads parent: offered rate, carrier, validity and the independent review decision that authorizes award.

    Linked to Loads, Organizations
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Review decisions

    Independent approval, rejection or return decisions on a source revision

    Linked to Loads, Team members
  • Operation receipts

    Idempotent operation receipts recording executed or failed actions with stable keys

    Linked to Loads
  • Transport partners

    Eligible carriers and transport partners with contact and eligibility notes

    Linked to Organizations
  • Record attachments

    Evidence files attached to loads with visibility and evidence type

    Linked to Loads, Team members

Assignments and readiness

6 tablesAbout this feature
  • Load assignments

    Driver and vehicle assignments to loads with committed start and end times

    Linked to Loads, Drivers, Vehicles
  • Drivers

    Driver roster with eligibility expiry and external authority reference

  • Vehicles

    Fleet vehicles with equipment class, capacity, readiness and external fleet id

  • Vehicle defects

    Reported vehicle defects with severity, repair evidence and release time

    Linked to Vehicles
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Load stops

    Ordered pickup and delivery stops within a load with appointment windows

    Linked to Loads

Dispatch and delivery

7 tablesAbout this feature
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Load stops

    Ordered pickup and delivery stops within a load with appointment windows

    Linked to Loads
  • Load assignments

    Driver and vehicle assignments to loads with committed start and end times

    Linked to Loads, Drivers, Vehicles
  • Drivers

    Driver roster with eligibility expiry and external authority reference

  • Vehicles

    Fleet vehicles with equipment class, capacity, readiness and external fleet id

  • Record attachments

    Evidence files attached to loads with visibility and evidence type

    Linked to Loads, Team members
  • Operation receipts

    Idempotent operation receipts recording executed or failed actions with stable keys

    Linked to Loads

Evidence and review

6 tablesAbout this feature
  • Record attachments

    Evidence files attached to loads with visibility and evidence type

    Linked to Loads, Team members
  • Review decisions

    Independent approval, rejection or return decisions on a source revision

    Linked to Loads, Team members
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Team members

    Staff membership linking platform users to organizations with operational roles

    Linked to Organizations, Users
  • Carrier offers

    Carrier rate offers raised against a Loads parent: offered rate, carrier, validity and the independent review decision that authorizes award.

    Linked to Loads, Organizations
  • Operation receipts

    Idempotent operation receipts recording executed or failed actions with stable keys

    Linked to Loads

Exceptions and reconciliation

7 tablesAbout this feature
  • Loads

    Freight loads from pickup to delivery with promised windows, freight value and lifecycle

    Linked to Organizations, Team members, Transport partners
  • Operation receipts

    Idempotent operation receipts recording executed or failed actions with stable keys

    Linked to Loads
  • Review decisions

    Independent approval, rejection or return decisions on a source revision

    Linked to Loads, Team members
  • Load assignments

    Driver and vehicle assignments to loads with committed start and end times

    Linked to Loads, Drivers, Vehicles
  • Vehicles

    Fleet vehicles with equipment class, capacity, readiness and external fleet id

  • Vehicle defects

    Reported vehicle defects with severity, repair evidence and release time

    Linked to Vehicles
  • Record attachments

    Evidence files attached to loads with visibility and evidence type

    Linked to Loads, Team members

Shared and settings

2 tables
  • Exchange rates

    Read-only effective exchange rates for this app.

  • Users

    Users

    Linked to Users

Keys and references

Resolve actual record identifiers when loading references. Compare the organization on each carrier offer with its intended load. Carrier is text, so use the agreed identity procedure to reconcile it with transport partner and authority evidence. Keep the offer revision and parent load revision identifiable during review; source revision on review decisions concerns the load.

Map signed-in accounts through team members.User before enabling My Loads. Check resource visibility through the configured access rules when reading Drivers, Vehicles and their assignments. Preserve operation keys and expected revisions when investigating retries or uncertain outcomes. Agree the storage precision and time zones used by the date fields before importing interval detail.

Migration order

  1. Prepare Organizations and Users, then resolve team members membership and user references.
  2. Load transport partners with organization context, then prepare Drivers and Vehicles with their source identifiers.
  3. Load vehicle defects after the referenced vehicles exist, retaining real repair and release evidence.
  4. Load Loads with its owner and transport partner, then resolve parent links for load stops and carrier offers.
  5. Resolve load, driver and vehicle references for load assignments and check the committed intervals.
  6. Load record attachments with uploader identity and parent load. Preserve genuine review decisions and operation receipts with their original revision and operation references; maintain exchange rates through its read-only source procedure.

Set up Freight Brokerage Platform your way.

Start free, then use Proto to change fields, steps and approvals before your team goes live.

How to get started