Logistics Shipment
by Viindoo
| Lines of Code | 8524 |
| Technical name | viin_logistics |
| License | OPL-1 |
| Website | https://viindoo.com/apps/modules/17.0/viin_logistics |
| Read description for | v 18.0 v 19.0 |
| Required Apps | Discuss (mail) |
| Included Dependencies | Logistics Package Type Tracking Location QR Code Mixin Viindoo Base |
| Extensions | Logistics Cargo Template Logistics Sales Team Logistics Routes Integration Logistics Accounting |
One shipment record the whole business can point at
The shared logistics shipment model - cargo, packages, containers, HS codes and status - used by fleet, freight forwarding and warehousing alike.
Logistics Shipment (technical name viin_logistics) is an Odoo 17.0 app for Odoo Community and Odoo Enterprise and Viindoo Cloud, built for operations, sales, finance, management.
At a Glance
The facts of Logistics Shipment, version 1.1.5, in one place. Published by Viindoo.
How It Works
Three screens.
The shipments
Everything moving, in one list.
One shipment
Parties, cargo and status on one record.
The containers
What is packed into what.
What You Get
A shared logistics shipment model
Cargo, packages and container tracking
HS codes and cargo types
Status and progress on the shipment
Extended by fleet, freight and warehousing modules
Import, export and domestic views
More Screens
Everything below was taken on a database seeded with real business data, on this series - not a mock-up and not a screenshot from an older version.
Container tracking
What This App Does Not Do
Read this before you buy. Everything below is something the app deliberately leaves to another app or to you.
The operational apps sit on top of it.
Booking is the freight app's.
Status is recorded, not fetched.
Charges come with the forwarding app.
Works Well With
Apps from the same stack, built to fit this one:
Who Should Use Logistics Shipment?
Operations
Runs the job from one record.
Sales
Sees what happened to what they sold.
Finance
Costs and bills against the movement.
Management
Reads volume and margin per lane.
Frequently Asked Questions
What does Logistics Shipment do?
The shared logistics shipment model - cargo, packages, containers, HS codes and status - used by fleet, freight forwarding and warehousing alike.
What does Logistics Shipment not do?
It is a model, not an application. The operational apps sit on top of it. It does not book carriers. Booking is the freight app's. It does not track live positions. Status is recorded, not fetched. It does not price anything. Charges come with the forwarding app.
Who is Logistics Shipment for?
Operations: Runs the job from one record. Sales: Sees what happened to what they sold. Finance: Costs and bills against the movement. Management: Reads volume and margin per lane.
Which Odoo version and editions does it support?
Odoo 17.0 - Odoo Community, Odoo Enterprise, Viindoo Cloud. Upgrades to a newer Odoo series are a separate purchase for that series.
What does it depend on?
It installs on top of: viin_logistics_package_type, viin_qrcode, base_automation, viin_tracking_location, base_setup. Odoo installs them with it.
How do I set it up?
Three screens.
What works well with it?
Freight Management (viin_freight_management): The forwarding desk built on it. Logistics with Sales (viin_logistics_sale): Shipments from sales orders.
Can I try it before buying?
Yes - the Live Preview button at the top of this page opens the module's own screen on a working database.
How do I get support?
Write to apps.support@viindoo.com with your Odoo version and the technical name viin_logistics; pre-sales questions go to sales@viindoo.com.
See Logistics Shipment in Action
Live demo: v17demo-int.viindoo.com/web#action=viin_logistics.action_logistics_shipment
Need help with Logistics Shipment?
For questions, implementation support or a custom feature, contact Viindoo.
Pre-Sales & Partnership
sales@viindoo.comUpgrades to a newer Odoo series are a separate purchase for that series.
All Viindoo apps: apps.odoo.com/apps/modules/browse?author=Viindoo
Technical Requirement
Changes log
1.1.5 - Latest on the 17.0 line
- Aligned with the 17.0 logistics shipment model.
Logistics Shipment
Note
Extends viin_logistics_package_type - see its documentation.
This module gives you a single Shipment Management app to run any transport job - trucking, sea freight, air freight, rail, or a mix of these - from booking to delivery. One shipment record carries the customer, the route (one or more legs), the cargo or packages/containers being moved, a live tracking timeline your customers can follow, and the full lifecycle status (Draft, Confirmed, In Transit, Done, Cancelled).
Installation
- Open the Apps app.
- Remove the default "Apps" filter from the search bar and search for "Logistics Shipment".
- Click Install on the module's card.
Installing this module automatically pulls in the small supporting components it relies on - the shared Package Types library, the QR Code Mixin and the Tracking Location component - there is nothing to install beforehand.
Configuration
Access rights. Under Settings > Users & Companies > Users, open a user's Access Rights tab. In the Industry/Logistics category, choose one of:
- User: Own Shipments - can only see and work on shipments where they are the Customer, Shipper, Consignee or Responsible.
- User: All Shipments - can see and manage every shipment.
- Administrator - also manages the configuration screens described below (Shipment Types, Stages, Tags, Templates, Package Types, dangerous-goods master data, and the Settings screen).
Settings. Go to Shipment Management > Configuration > Settings. From here an administrator can turn on optional extensions:
- Logistics Shipment Sale Integration - automatically create shipments from confirmed sales orders.
- Logistics Cargo Template - reuse predefined cargo configurations on new shipments.
- Fleet Booking & Trip Management - let employees book company vehicles for business transport.
Master data. Before creating your first shipment, review the reference lists under Shipment Management > Configuration: Shipment Types (combination of transport mode, load mode and package input mode), Shipment Stages and Shipment Tags, plus the cargo reference data (Cargo Types, HS Codes, DG Classes, UN Numbers) and location directories (Sea Ports, Airports). Sensible defaults ship with the module, so most teams can start creating shipments right away and refine these lists later.
Usage
Run a shipment from booking to delivery
Go to Shipment Management > Operations > All Shipments.
Click New. A blank shipment opens in Draft with sensible defaults already filled in - Direction is Export, Main Transport is Sea / Waterway and Shipment Type is FCL; change any of these to match your job.
Type a working reference in Shipment Reference.
Select the Customer for this shipment.
Open the Schedule & Performance tab. This is where the shipment's Routes table lives - each row is one leg of the journey.
Click Add a line to add a leg. A row is created with a Leg Type (Main Carriage, Pre-Carriage, On-Carriage...) and a Transport Mode already proposed; adjust the Pickup/Drop-off Address, ETD and ETA as needed.
Click Confirm to move the shipment from Draft to Confirmed.
Click Start Transit once the shipment is actually moving. The ATD (Actual Time of Departure) is stamped automatically.
Click Set Done once the shipment has arrived. The ATA (Actual Time of Arrival) is stamped and the Delivery Status is evaluated automatically (On Time, in this example).
Record cargo and pack it into a package or container
Two related screens work together here: Cargo & Containers > Containers is a cross-shipment library of container/equipment profiles (reference, type, number, seal), useful to look up equipment currently in use across all your shipments -
- while the Packages smart button on a shipment's own form is where you record what is actually packed for that shipment, using any package or container profile from the shared library.
Open the shipment and click the Packages smart button (it shows the current package count, starting at 0).
Click New, then fill in a Package Reference, choose a Package Type (for example one of the ISO container profiles) and, optionally, a Shipping Mark. Weight and Volume are filled in automatically from the package type you picked - adjust them if the actual load differs.
Click Save. The package now appears in the shipment's package list.
Back on the shipment form, the Packages smart button now shows the updated count, and Total Weight / Total Volume in the header roll up automatically from every package you have recorded.
Log a tracking update and publish it to the customer
Open the shipment and click Log Tracking in the header.
In the Add Location Update window, fill in a Label, type or pick a Location (start typing an address and choose the suggestion), set the Tracking Status (On Track, At Risk, Off Track or On Hold) and, if your shipment has more than one stage available, choose the matching Stage. Add a note under Details. Leave Published on Portal checked so the customer can see it.
Click Save. The shipment's Trackings counter increases by one.
Click the Trackings smart button to see every tracking event for this shipment as cards, each with a colored status badge.
Bootstrap a shipment's stage timeline from a template
Any shipment you Archive automatically becomes available as a reusable template - its own Stage Timeline (built under the Settings tab > Stages) is what gets copied onto new shipments.
Archive a shipment whose stage timeline you want to reuse (open it, click the gear icon, then Archive). It now appears under Shipment Management > Configuration > Other > Shipment Templates.
Create a new, blank Draft shipment.
Click From Template in the header (only visible on a Draft shipment). Pick the archived shipment as the Template; a preview shows the ordered, color-coded stages that will be copied.
Click Apply. Go to the Settings tab to see the shipment's own Stage Timeline now pre-populated with the same ordered stages, ready to drive the status dropdown at the top of the form without re-entering them by hand.
Customer self-tracking on the portal
Once a shipment is Confirmed or In Transit and has at least one tracking update published, the customer can follow it without any backend access.
From My Account, the customer opens My Logistics Shipments - a list of their own shipments with Status, ETD, ETA, ATD and ATA.
Opening one shipment shows its QR code (to re-share the tracking link), full shipment information, leg-by-leg schedule, packages, cargo, and the Tracking Timeline with every published tracking event grouped by stage and colored by status.
Troubleshooting
I can only see some of the shipments
Your access rights limit you to shipments where you are the Customer, Shipper, Consignee or Responsible ("User: Own Shipments"). Ask your administrator to grant "User: All Shipments" if you need to see every shipment.
The Shipment Type I expect is not in the list
Shipment Types are configured per transport mode and load mode combination under Configuration > Other > Shipment Types. Ask an administrator to add the missing combination, or double check the Main Transport you selected on the shipment.
My tracking update is not showing on the customer portal
Open the tracking event and make sure Published on Portal is checked - it is checked by default, but it can be unchecked for internal-only notes.
A package or container I created is not linked to the shipment I expected
Always open the Packages (or a similar) list from inside the shipment itself (its own smart button), rather than the general Cargo & Containers menu - that way the new record is automatically tied to the shipment you are working on.
"From Template" only shows a few shipments to pick from
Only archived shipments are offered as templates. Archive a completed shipment first if you want to reuse its stage timeline.
FAQ
What do the shipment statuses mean? Draft (being prepared) -> Confirmed (booked) -> In Transit (moving) -> Done (delivered). A shipment can be Cancelled from Draft, Confirmed or In Transit.
What is the difference between the workflow Status and the Stage Timeline? Status is the fixed lifecycle every shipment follows (Draft/Confirmed/In Transit/Done/Cancelled). The Stage Timeline is an optional, customizable sequence (for example Planning, Pre-Carriage, Main Carriage, Completed) you can track alongside it and copy from a template.
Can a shipment have more than one leg? Yes - the Routes table on the Schedule & Performance tab supports any number of legs, each with its own transport mode, addresses and planned/actual dates, so you can model multimodal, multi-stop journeys.
Can a customer track a shipment without an Odoo account? Yes - the portal detail page is reachable with a secure link (and QR code) generated for that shipment, no login required.
What happens when I archive a shipment? It stops appearing in the regular Shipments list and becomes available as a reusable template under Shipment Templates, so its stage timeline can be applied to future shipments.
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.