# Transportial Guides

Welcome to the Transportial developer guides. Whether you're getting started or building advanced integrations, you'll find everything you need here.

## Getting Started

- [Quickstart](/guides/quickstart) — Authenticate and create your first transport order in minutes
- [Onboarding](/guides/onboarding) — Full platform setup from registration to first planned transport


## Core

- [Core Concepts](/guides/concepts) — The OTM5 entity hierarchy: platforms, businesses, orders, consignments, trips, actions
- [Authentication & Permissions](/guides/authentication) — Login, 2FA, sessions, roles, SAML, and user management
- [Search & Filtering](/guides/search-and-filtering) — Pagination, search endpoints, TQL queries, and reference data


## Transport

- [Consignments & Goods](/guides/consignments-and-goods) — Manage cargo, split and combine consignments, track goods
- [Trips & Planning](/guides/trips-and-planning) — Create trips, assign vehicles, calculate routes, manage actions
- [Webhooks & Events](/guides/webhooks-and-events) — React to transport events, set up notifications


## Fleet

- [Vehicles & Fleet](/guides/vehicles-and-fleet) — Manage vehicles, transport equipment, sensors, board computers
- [Chauffeurs & Drivers](/guides/chauffeurs-and-drivers) — Driver management, activities, certificates, service cards


## Business

- [Businesses & Contacts](/guides/businesses-and-contacts) — Companies, customers, carriers, contact details, tax identifiers
- [Teams & Organizations](/guides/teams-and-organizations) — Teams, administrations, platform settings, tenders


## Finance

- [Invoicing & Finance](/guides/invoicing-and-finance) — Invoices, quotes, public quote links, payment tracking
- [Pricing & Charges](/guides/pricing-and-charges) — Pricing rules, charges, transactions, ledger entries, financial insights


## Platform

- [Integrations](/guides/integrations) — Connect external systems via data pipelines and API access
- [App Store](/guides/app-store) — Browse, install, and manage platform extensions
- [Documents & Files](/guides/documents-and-files) — Document management, file uploads, email processing


## Examples

Step-by-step practical examples:

- [Managing Transport Orders](/examples/managing-transport-orders) — CRUD operations and email import
- [Managing Locations](/examples/managing-locations) — Addresses, coordinates, duplicate checking
- [Planning a Multi-Stop Trip](/examples/planning-multi-stop-trip) — Multi-drop route with action tracking
- [Fleet Tracking & Monitoring](/examples/fleet-tracking) — GPS, sensors, events, and fleet analytics
- [End-to-End Invoice Workflow](/examples/invoice-workflow) — Quote to invoice to payment
- [Building a Custom Integration](/examples/building-an-integration) — Event-driven data sync with monitoring
- [Splitting & Combining Consignments](/examples/consignment-splitting) — Split for multiple trucks, combine for efficiency
- [Message Automations](/examples/message-automations) — Automated notifications and chat messaging