The transporter dashboard is the central workspace for logistics companies using TranslogiX. It gives transporter users a scoped view of their own company’s shipments and fleet — no other company’s data is ever accessible. This page explains the dashboard overview, the shipments list, and the vehicles section.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/fatelessdev/translogiX/llms.txt
Use this file to discover all available pages before exploring further.
All data shown in the transporter dashboard is filtered server-side by the authenticated user’s
transporterId. It is not possible to access another company’s shipments or vehicles by modifying requests.Dashboard overview
When a transporter user signs in, the dashboard (/transporter) greets them by name and displays a summary of their company’s shipment activity across four stat cards.
Total Shipments
The total count of all shipments ever assigned to your transporter, regardless of status.
In Transit
Shipments currently in the
IN_TRANSIT status — actively moving to their destination.Picked Up
Shipments with the
PICKED_UP status — collected from the source but not yet in transit.Delivered
Shipments that have reached their destination and been marked
DELIVERED./transporter/shipments.
Shipments
The shipments section (/transporter/shipments) lists every shipment assigned to your transporter. Transporter users can also create new shipments from this view — newly created shipments are automatically scoped to the authenticated user’s company.
Table columns
| Column | Description |
|---|---|
| Package Code | The unique identifier for the shipment (e.g. PKG-001). |
| Source | The pickup origin of the shipment. |
| Destination | The delivery destination. |
| Material | The type of material being transported. |
| Gross Wt (kg) | Gross weight of the shipment in kilograms. |
| Qty | Number of units in the shipment. |
| Status | Current shipment status with a colour-coded badge (see below). |
| Transporter | The name of your transporter company. |
| Vehicle | The vehicle number assigned to the shipment, if any. |
| Actions | An edit button to open the shipment details form. |
Searching shipments
A search bar above the table lets you filter shipments in real time. The search matches against:- Package code
- Source location
- Destination location
Shipment statuses
Shipments move through a fixed sequence of statuses. The status column is an interactive dropdown for non-terminal states, allowing you to advance a shipment to its next valid state.| Status | Meaning | Badge colour |
|---|---|---|
CREATED | Shipment record created, not yet assigned. | Grey |
ASSIGNED | Vehicle assigned, ready for pickup. | Blue |
PICKED_UP | Shipment collected from source. | Yellow |
IN_TRANSIT | Shipment actively moving to destination. | Orange |
DELIVERED | Shipment delivered. Terminal — cannot be changed. | Green |
CANCELLED | Shipment cancelled. Terminal — cannot be changed. | Red |
Vehicles
The vehicles section (/transporter/vehicles) lists all vehicles registered under your transporter company. The Transporter column shown in the admin view is hidden here, since all vehicles belong to the same company.
Table columns
| Column | Description |
|---|---|
| Vehicle Number | The registration or identifier for the vehicle. |
| Type | Vehicle category: TRUCK, DUMPER, VAN, or OTHER. |
| Capacity (kg) | Maximum load capacity in kilograms. |
| Status | Current operational status (see below). |
| Location | Last recorded location of the vehicle, if set. |
| Actions | An edit button to open the vehicle details form. |
Vehicle statuses
The status column is an interactive dropdown. You can change a vehicle’s status at any time from this view.| Status | Meaning | Badge colour |
|---|---|---|
AVAILABLE | Vehicle is free and can be assigned to a shipment. | Green |
BUSY | Vehicle is currently assigned to an active shipment. | Yellow |
MAINTENANCE | Vehicle is undergoing maintenance and unavailable. | Red |
Searching vehicles
A search bar above the vehicle table lets you filter by vehicle number, transporter name, or vehicle type.Adding vehicles
Use the Add Vehicle button in the top-right of the vehicles page to register a new vehicle. New vehicles are automatically associated with your transporter company.Transporters can only view and manage vehicles that belong to their own company. Vehicles registered under other transporters are never returned by the API.