Fleet Route Accounting - Cost by Geographical Route
by Viindoo
| Lines of Code | 784 |
| Technical name | viin_fleet_planning_account |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/17.0/viin_fleet_planning_account |
| Read description for | v 18.0 |
| Required Apps | Invoicing (account) Discuss (mail) Employees (hr) Fleet (fleet) |
| Included Dependencies | Fleet Drivers Management Fleet Booking & Trip Management Fleet Loading Capacity Fleet Operations Employee Documents Viindoo Unified Routing Framework Fleet Trip Accounting Fleet Cost & Revenue Accounting QR Code Mixin Viindoo Base Viindoo Accounting Advanced HR Management Viin Fleet API Request Logger Route Cost & Revenue Accounting Partner Working Calendar |
Fleet Route Accounting - Cost by Geographical Route
Add the geographical route as a real cost dimension in your fleet accounting. When a trip is confirmed, this module quietly provisions the route's analytic account and tags fleet-service costs by route - so you can analyse cost and profitability route by route, right inside Odoo's standard Analytic Accounting, with no extra data entry.
Powering Your Business Growth.
This is a lightweight backend add-on. It has no screens of its own - it enriches the analytic data your Accounting reports already use, adding Route alongside the Vehicle and Trip dimensions you get today.
Extends viin_fleet_planning -
see its documentation.
Extends viin_fleet_booking_account -
see its documentation.
Key Features
Auto-Generate Route Analytic Account on Trip Confirmation
Automatically creates the Geographical Route analytic account the moment a trip is confirmed, so route-level cost tracking starts without any manual setup.
Route Dimension in Vendor-Bill Analytic Distribution
Splits vendor-bill costs proportionally across Vehicle + Trip + Route analytic combos, so route-level cost/profitability reporting is produced automatically at bill-validation time.
Route-Tagged Analytic Lines for Fleet Service Costs
Tags every fleet-service analytic cost line with its trip's route analytic account, making Route a first-class cost dimension alongside Vehicle and Trip.
Post-Install Backfill of Route Analytics for Existing Trips
On install/upgrade, retroactively generates route analytic accounts for existing non-draft trips and back-fills route analytic columns on already-posted cost lines, so historical reporting is not left with gaps.
Why It Matters
See cost and margin by route, not just by vehicle. "Which routes actually make money?" becomes a question your standard analytic reports can answer - because every fleet cost now carries the route it belongs to.
Zero extra data entry for your team. The route analytic account is provisioned on trip confirmation and the distribution is computed at bill validation. Operators and accountants keep their existing workflow; the route dimension appears on its own.
Nothing left behind on day one. The install-time backfill means route analytics apply to trips and bills that already exist, so reporting is consistent from the moment you switch it on - not only for trips created afterwards.
Route Account, Created Automatically
Accounting > Analytic Accounting > Analytic Accounts, grouped by the Geographical Route plan - the route account "Hanoi - Hai Phong" appears automatically after its trip was confirmed. Nobody created it by hand.
Vendor-Bill Cost, Split Three Ways
A posted vendor bill for a fleet service - its Analytic Distribution splits the cost across three accounts: Vehicle, Trip and Route, instead of Vehicle and Trip alone.
Route as a Reportable Dimension
The Analytic Items report filtered to the route "Hanoi - Hai Phong" - the fuel cost line carries the Route tag next to its Vehicle and Trip tags, so Route is a dimension you can group and filter by.
Need help with Fleet Route Accounting?
Pre-Sales & Partnership
apps.support@viindoo.comTechnical Support
apps.support@viindoo.comTechnical Requirement
- Odoo version: 17.0
- Editions: Community / Enterprise
- Required modules: Fleet Operations, Fleet Trip Accounting - Cost & Revenue by Trip, Route Cost & Revenue Accounting
- License: OPL-1
Who It's For
Fleet Operations Teams
Running trips on defined geographical routes, who want route cost tracking to start automatically the moment a trip is confirmed.
Accountants and Controllers
Need to analyse fleet cost and profitability by route in the standard Analytic Items report, alongside Vehicle and Trip.
Transport and Logistics Businesses
Using Odoo fleet planning together with fleet cost accounting, and wanting geographical route as a native cost dimension.
Get Started
Install Fleet Route Accounting to turn each geographical route into a tracked cost dimension across your fleet accounting - automatically, and for your existing trips too.
Get it on the Viindoo App Store today.
Powering Your Business Growth.
Fleet Route Accounting - Cost by Geographical Route
Note
Extends viin_fleet_planning (Fleet Operations) - see its documentation.
Note
Extends viin_fleet_booking_account (Fleet Trip Accounting - Cost & Revenue by Trip) - see its documentation.
This app adds one more cost dimension to your fleet accounting: the geographical route a trip follows. Once installed, confirming a trip quietly gives its route its own dedicated cost-tracking account, and every vendor bill for a route-linked vehicle service is split not just between the vehicle and the trip, but across Vehicle, Trip, and Route together - so you can see which routes are actually costing you the most, not just which vehicles or which trips.
Installation
Go to Apps.
Remove the default Apps filter and search for Fleet Route Accounting (technical name viin_fleet_planning_account).
Click Install - or simply install the two apps it builds on below, and Odoo activates this one automatically for you:
- Fleet Operations - route-aware trip planning and dispatch (see its own guide).
- Fleet Trip Accounting - Cost & Revenue by Trip - the per-trip accounting layer this app extends (see its own guide).
A third app, Route Cost & Revenue Accounting, is also required and installs alongside these automatically - it supplies the underlying Geographical Route analytic dimension.
Configuration
This app adds no configuration screens or settings of its own - everything below happens automatically the moment you confirm a trip or bill a route-linked service.
Access rights
Everyday use (confirming trips, logging services, billing vendors) only needs the fleet roles described in the Fleet Operations guide (Operator or Fleet Planning Administrator).
The screens that let you see this app's effect directly, however, all require a step up from the standard Billing access to full Accounting access ("Show Full Accounting Features"), granted by an administrator under Settings > Users & Companies > Users:
- Invoicing > Configuration > Analytic Accounting > Analytic Accounts - lists each route's own account directly, under the Geographical Route plan.
- Invoicing > Configuration > Analytic Accounting > Analytic Plans - shows the Geographical Route plan itself.
- The Analytic Items report and the Journal Items tab on a vendor bill - both show the Vehicle / Trip / Route cost split line by line.
If you only have standard Billing access, you can still do everything in the Usage section below - you simply will not be able to open the screens that display the route account and its cost split by name. Ask an administrator to raise your access if you need to review that reporting directly.
Usage
See a route get its own cost-tracking account when you confirm a trip
The first time a trip using a given route is confirmed, that route silently gets its own dedicated analytic account - no manual setup involved.
Open Fleet Operations > Trips > Planning.
Click a Draft trip that already has a Route assigned.
Click Confirm Trip in the statusbar. The trip moves from Draft to Confirmed.
Note
The route needs at least one waypoint to be confirmable - see Troubleshooting below. With full Accounting access, the new account appears by the route's name under Invoicing > Configuration > Analytic Accounting > Analytic Accounts, grouped under the Geographical Route plan (see Configuration above).
Bill a route-linked vehicle service and see the cost split across Vehicle, Trip and Route
When you bill a vehicle service that is tied to a trip, the cost is split across three accounts in one line - the vehicle's, the trip's, and now the route's too.
Open the confirmed trip and click the Services smart button (or go to Fleet Operations > Fleet > Services), then click New. Fill in Service Type, Vendor, and the cost under Unit Price. The Route field fills in by itself from the trip.
Save, then tick the new service row in the Services list.
From Actions, choose Create Vendor Bills.
On the Create Vendor Bills wizard, click Create and View Vendor Bills.
A draft vendor bill opens with one line for the service.
Click Confirm to post the bill.
Tip
With full Accounting access, open the Journal Items tab on the posted bill: the line's Analytic Distribution now spans three accounts - Vehicle, Vehicle Trip, and Geographical Route - each carrying its share of the cost, instead of only Vehicle + Trip as before this app was installed.
Review route-level costs in your accounting reports
With full Accounting access, the Analytic Items report lists every cost line by analytic account. Group or filter it by the Geographical Route plan to compare fleet costs by route the same way you already compare them by Vehicle or Trip - no extra setup needed, since every route-linked cost line already carries the Route tag from the moment it is posted.
Note
This screen needs full Accounting access (see Configuration above). If you only have Billing access, the cost split still happens automatically behind the scenes - you just cannot browse it by name yet.
Confirm existing trips were backfilled automatically after install
Installing this app does not leave older, already-confirmed trips behind - it retroactively creates the missing Route analytic accounts and re-splits already-posted vendor-bill costs for them too.
Open Apps and search for Fleet Route Accounting. Once installed, the card shows no Install button.
With full Accounting access, re-opening an older, already-posted vendor bill for a route-linked service shows its cost line's Analytic Distribution already carrying the Route dimension - historical reporting has no gap to fill in by hand.
Troubleshooting
- I confirmed a trip but cannot find its route's analytic account.
- That screen needs full Accounting access, not just Billing (see Configuration above). Ask an administrator to raise your access under Settings > Users & Companies > Users.
- The vendor bill's Journal Items tab does not show a Route column.
- That tab, and its Analytic Distribution detail, are only visible to users with full Accounting access.
- I get "You cannot confirm a trip which has no waypoint."
- That is an existing Fleet Operations rule, not something this app changes - the trip's route needs at least one waypoint before it can be confirmed. Add one, or pick a different route.
- Nothing seems to have changed after installing this app.
- The effect is intentionally invisible in day-to-day use - it only adds a reporting dimension. Confirm a trip and bill a linked service (see Usage above), then check the Analytic Items report with full Accounting access to see the Route dimension appear.
FAQ
- Do I need to configure anything before confirming my first trip?
- No - the Geographical Route analytic plan already exists once the required apps are installed, and each route's account is created automatically the first time it is used on a confirmed trip.
- Does every vendor bill for a fleet service get a Route split?
- Only service lines linked to a trip. A service with no Trip set is billed exactly as before - only vehicle-service lines that do carry a trip (and therefore a route) gain the extra Route dimension.
- What happens to trips and bills that already existed before I installed this app?
- They are backfilled automatically on install - see Confirm existing trips were backfilled automatically after install above.
This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).
You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.
The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
