Financial Integration¶
Application Requirements¶
The Freight Forwarder module already uses analytic accounts to track revenue and costs per shipment. To extend accounting workflows even further:
Must be installed and activated Analytic account in Viindoo.
Must be installed and activated onbehalf-activation if you need to manage on-behalf collections/payments (COD, customs advances, agent fees).
Business Context¶
Without accounting integration:
Profit by shipment is unclear because supplier bills and on-behalf amounts are missing.
Customer invoicing remains disconnected from booking/shipment progress.
Agents and carriers are paid late due to manual tracking of pass-through fees.
Connecting freight with Accounting delivers:
Automatic analytic allocations for every shipment.
Standard invoicing and payment workflows tied to shipments.
Clear segregation between your revenue and on-behalf cash.
Real-time profitability dashboards per shipment, customer, or route.
Invoices and Customer Payments¶
Issue invoices directly from the sales order linked to the shipment:
Open the sales order (or use the Sales Order smart button on the shipment).
Click Create Invoice and choose the invoicing policy (regular, down payment %, or fixed amount).
Confirm and send the invoice to the customer.
When funds arrive:
Open the invoice under Accounting > Customers > Invoices.
Click Register Payment, fill payment details, and validate.
All revenue entries automatically post to the shipment’s analytic account so profitability reports update in real time.
Managing Collections and Disbursements On Behalf¶
Many shipments include pass-through fees: customs brokerage, domestic trucking at destination, COD, inspection, etc. These amounts should not inflate revenue; they must be tracked separately and paid to partners.
See also
How to record customer payments for more details.
Shipment receivable and payable for more details.
Activate the On-Behalf Feature¶
Go to Freight Forwarder > Configuration > Settings.
Enable Freight Collect & Disbursements under Freight Features.
Click Save, then Install when prompted.
Administrators can also install the module viin_freight_collect_disburse directly from Apps. Once installed, shipments show additional widgets for on-behalf balances.
Workflow Highlights¶
Sales orders and quotations flag on-behalf charges so they bypass revenue accounts.
Shipments summarize how much has been collected, transferred, or still outstanding for each partner.
Customer invoices include both freight revenue and pass-through charges, but analytic accounting separates the amounts.
When paying agents or customs, vendor bills reference the same shipment analytic account so the on-behalf balance clears.
Cost Allocation and Profitability¶
Analytic Accounts¶
Each shipment creates its own analytic account (e.g.,
SO001 - SHP001).Sales invoices, purchase orders, vendor bills, timesheets, and expenses hit that analytic account automatically.
Labor costs recorded via Viindoo Project/Timesheet are included in the same account when both integrations are active.
Profitability Dashboard¶
On the shipment kanban card, click Profitability to see revenue, costs (supplier POs, labor, miscellaneous fees), profit, and margin %.
Use Freight Forwarder > Reporting > Profitability Report to analyze shipments by customer, route, salesperson, or period.
Freight Forwarder > Reporting > Revenue Report groups results by customer to highlight key accounts.
See also
Shipment sales quotations – mark on-behalf lines correctly during quoting.
Frequently Asked Questions¶
Do on-behalf amounts affect profit? No. They post to dedicated receivable/payable accounts and are excluded from revenue/cost totals. Profitability focuses on your freight revenue minus your own costs.
Should I enable the Analytic Account suffix?
Yes, if you manage many shipments simultaneously. It keeps analytic account names unique (e.g., SO001 - SHP001) so staff can assign the right account when creating purchase orders or bills.
How can I see every entry booked to a shipment? Go to Accounting > Analytic > Analytic Accounts, open the shipment’s account, and inspect the analytic entries or run the Analytic Entries Analysis report.
See also
integration/purchase – Feed supplier purchase orders and costs into accounting.
integration/fee – Ensure surcharges appear on invoices and analytic reports.
Reports and Analysis – Explore all freight-specific reports.
Viindoo Accounting application index – Full documentation for finance and accounting features.