XERPIUM LOGISTICS

Summary

Enterprise-Grade Logistics Ecosystem

XERPIUM LOGISTICS is a logistics module ecosystem built on XERPIUM 18 — covering Shipment Management, Container Management (ISO 6346), Route & Rate Card, Real-time Tracking, Fleet Management, Warehouse Operations, Freight Forwarding, Cold Chain Monitoring, and Claim Management.

🚚

SHIP

Shipment

🚌

FLEET

Fleet

🌎

FREIGHT

Freight

🏢

WH

Warehouse

🌡

COLD

Cold Chain

📈

BI

Dashboard

⚡

AI

Assistant

🔗

API

Integration

xerpium_logistics

Logistics Master Data

🚚

Shipment (logistics.shipment)

Shipment Type — Pickup, Delivery, Transfer, Return, Multimodal
Service Type — Trucking, Forwarding, Warehousing, Last-Mile, Project, Cold Chain
State — Draft → Confirmed → Assigned → In Transit → Delivered → Completed
Origin & Destination — Full address, origin/destination city
Route — Linked to logistics.route
Vehicle & Driver — fleet.vehicle & res.partner driver

📌

Route (logistics.route)

Origin & Destination — Origin & destination city with auto-name
Distance & Transit — Distance km, transit time hours
Route Type — Road, Sea, Air, Rail, Multimodal
Estimated Cost — Estimated cost per route
Shipment Count — Number of deliveries via this route

📦

Service Category (logistics.service.category)

Service Type — Trucking, Forwarding, Warehousing, Last-Mile, Project, Cold Chain
Code — Unique code per company
Accounting — Income, expense, COGS account mapping
Product Default — Default product for billing
Shipment Count — Number of shipments per category

💳

Rate Card (logistics.rate.card)

Pricing Dimensions — Price per km, kg, m³, hour
Vehicle Type — Motorcycle to Container (9 tipe)
Minimum Charge — Minimum charge per delivery
Validity Period — Valid from/to date
Auto Compute — compute_shipping_price(weight, volume, distance)

Shipment, Route, Service Category, Rate Card — Tree & Form View

Core Workflow

Integrated Logistics Operations Flow

Booking

→

Confirmed

→

Assigned

→

In Transit

→

Delivered

→

POD

→

Completed

🚚 Shipment Operations

Shipment Lines — Multiple item, weight, volume, price per line
Total Computation — Weight, volume, pieces, price auto-sum
Schedule — Scheduled pickup & delivery datetime
Actual Times — Actual pickup & delivery with tracking
Profit Margin — Revenue - Actual Cost auto compute
Invoicing — Create invoice from shipment (action_create_invoice)

🚌 Fleet Management (xerpium_logistics_fleet)

Vehicle Master — fleet.vehicle integration
Driver Management — Drivers with is_driver flag
Assignment — Vehicle & driver per shipment
Maintenance — Service schedule, fuel tracking
Utilization — Fleet usage analytics

📦 Container Management (logistics.container)

ISO 6346 10 Categories Movement Maintenance

Container Type — 20ft, 40ft, 40HC, 45HC with ISO standard dimensions
10 Categories — Dry Van, Reefer, Open Top, Flat Rack, Tank, Ventilated, Bulk, Car Carrier, Insulated, Custom
Container Master — logistics.container with ISO 6346 number, ownership (owned/leased/customer), status tracking
Status — Available, In Use, In Transit, Under Maintenance, Damaged, Lost, Retired
Location Tracking — Depot, Customer Site, Port, Terminal, Warehouse, In Transit, Maintenance Facility
Container Movement — Gate In/Out, Transfer, Loading, Discharge with before/after status & condition
Maintenance — Preventive/Corrective/Inspection/Certification with parts, labour, cost tracking
Certification — CSC Plate, ISO certification, expiry tracking
Financial — Purchase price, current value, lease rate, insurance
Shipment Integration — FCL (Full Container Load) with container_ids many2many

🌎 Freight Forwarding (xerpium_logistics_freight)

Multi-Modal — Combination of road, sea, air, rail
Consolidation — Multiple shipments per container
Documentation — Bill of Lading, Airway Bill, packing list
Customs — PIB/PEB tracking for international
Cost Tracking — Ocean freight, handling, documentation fees

🏢 Warehouse Ops (xerpium_logistics_warehouse)

Warehouse Zone — Storage zones within warehouse
Cross-Docking — Fast transfer inbound to outbound
Putaway Strategy — Optimized storage allocation
Picking — Wave picking, batch picking
Stock Transfer — Inter-warehouse stock movement

Shipment Form, Fleet Assignment, Route Map, Warehouse Zone — Operational Views

Visibility

Tracking, POD & Claim Management

🔗 Real-time Tracking (logistics.tracking)

Event Types — Created, Confirmed, Picked Up, In Transit, At Hub, Out for Delivery, Delivered, Exception, Returned
Geo Location — Latitude/longitude per event
Timestamp — Real-time event recording
Photo Evidence — Image attachment per tracking event
Status Color — Normal, Warning, Danger indicators
Reported By — Driver/hub personnel assignment

📄 Proof of Delivery (logistics.proof.of.delivery)

Recipient Info — Name, company, phone
Digital Signature — Recipient signature image capture
Delivery Date — Actual delivery datetime
POD Photos — Multiple delivery photos
Status — Pending, Delivered, Partial, Refused
Auto-Complete — POD confirmed → Shipment delivered

⚠ Claim Management (logistics.claim)

Claim Types — Damage, Loss, Delay, Shortage, Wrong Delivery, Other
Status Flow — Open → Investigating → Resolved / Rejected → Closed
Priority — Low, Medium, High, Urgent
Claim Amount — Claim amount & resolved amount
Evidence — Photo & document attachments
Responsible — PIC handling the claim

🌡 Cold Chain (xerpium_logistics_cold_chain)

Temp Monitoring — Min/max temperature range per shipment
Cold Chain Flag — is_cold_chain with temperature validation
Temperature Log — Real-time temp readings during transit
Alert Trigger — Notification if temperature is out of range
Compliance — Cold chain regulatory compliance
Industries — Food, Pharma, Chemicals

Real-time Tracking Events, POD Signature, Claim Workflow, Cold Chain Temp Log

Analytics

Logistics Dashboard — Dashboard Studio

vit_dashboard_logistics for logistics KPIs. 19 chart types, dual data source, AI auto-generate.

19

Chart Types

1

Logistics Dashboard

AI

Auto-Generate

Logistics KPI Template

Widget	Metrik	Source
Shipments by Status	logistics.shipment count by state	ORM
Revenue vs Cost	total_price vs actual_cost	ORM
On-Time Delivery	% delivered on schedule	ORM
Fleet Utilization	vehicle usage %	ORM
Top Routes	shipments by route	ORM
Claim Trends	claims by type & status	ORM

AI Dashboard Features

Auto-Generate — Natural language → dashboard via DeepSeek
NL → SQL — Natural language → SQL query real-time
Chart Insight — AI analysis of trends, peaks, anomalies
Copilot Chat — SSE-streamed chat with dashboard context
Conditional Formatting — Dynamic color based on value

Chart Types

tile line bar bar_h area pie doughnut scatter radar funnel gauge bullet map list todo stacked_bar stacked_area waterfall bubble

vit_dashboard_logistics — Shipment KPIs, Revenue Analysis, Fleet Utilization, On-Time Delivery

Logistics Accounting

Logistics Accounting Journals

Journal flow from shipment booking to revenue & cost recognition — fully integrated with account.move.

Logistics Journal Flow

Step 1

Shipment Invoice

Delivery cost billing to customer:

                DR Trade Receivables    Rp XXX,XXX

                CR Logistics Revenue    Rp XXX,XXX

📋

Step 2

Operational Cost

Operating costs per shipment:

                DR Logistics Operating Expenses    Rp XXX,XXX

                CR Trade Payables / Cash    Rp XXX,XXX

💰

Step 3

Profit Analysis

Profit margin per shipment:

                REPORT Profit Margin = Revenue - Actual Cost

                REPORT Service Category Profitability

📈

Key Logistics Accounts

Account	Tipe	Function
Trade Receivables	Asset	Logistics service billing to customer
Logistics Revenue	Income	Revenue from delivery services
Operating Expenses	Expense	Fuel, toll, driver costs, etc.
Trade Payables	Liability	Payable to logistics vendor/partner
Vehicle Depreciation	Expense	Fleet depreciation

Logistics Accounting Features

Shipment Invoice — Auto invoice from shipment lines
Multi Service Category — Account mapping per service type
Cost Tracking — Estimated vs actual cost per shipment
Profit Margin — Real-time profit per shipment/route
Analytic Distribution — Cost center per project/department
Fleet Cost — Maintenance, fuel, driver cost allocation

Ecosystem

Cross-Module Integration

Logistics fully integrated with the entire XERPIUM ecosystem.

💳

Logistics ↔ Sales

SO → Shipment auto-create
Shipping price from rate card
Sales order tracking number

📦

Logistics ↔ Inventory

Stock picking → Shipment
Warehouse zone management
Cross-dock & transfer ops

🚌

Logistics ↔ Fleet

Vehicle & driver assignment
Maintenance schedule sync
Fuel & operational cost

💰

Logistics ↔ Accounting

Auto invoice per shipment
Cost recognition & margin
Service category account mapping

📈

Logistics ↔ Dashboard

vit_dashboard_logistics KPI
On-time delivery metrics
Profitability per route

⚙

Logistics ↔ Dynamic Stage

Configurable shipment workflow
RBAC stage access control
Python hooks on stage enter

📩

Logistics ↔ Notification

Real-time tracking updates
POD confirmation alerts
Claim status notifications

⚡

Logistics ↔ AI Assistant

"Find the shipment with tracking number X"
"Create a new shipment for customer Y"
"Latest tracking for shipment Z"
"Total revenue this month per route"

Comparison

Why XERPIUM Logistics?

Aspect	Manual System / Legacy	XERPIUM Logistics
Shipment Management	Spreadsheet / Books	✓ Full lifecycle, multi-type
Route Planning	✗ Manual / hafalan	✓ Route master + rate card
Real-time Tracking	✗ None	✓ Event-based + geo location
Proof of Delivery	✗ Paper / lost	✓ Digital signature + photo
Claim	✗ Not tracked	✓ Full workflow + evidence
Cold Chain	✗ Manual temperature log	✓ Temp range + monitoring
Fleet Management	✗ Manual scheduling	✓ Vehicle + driver + maintenance
Container Management	✗ Excel / manual	✓ ISO 6346, movement, maintenance, certification
Warehouse	✗ Manual recording	✓ Zone, cross-dock, putaway
Dashboard	✗ None	✓ 19 chart types, AI-powered
AI Assistant	✗ Not available	✓ 100+ tools, 11 languages
Multi Company	✗ Not available	✓ Multi-branch logistics
Accounting Integration	Separate	✓ Auto invoice & cost tracking

Portfolio

XERPIUM Industry Portfolio

Industry	Module	Dashboard	Report
Inventory & WMS	275+	✓	✓
Manufacturing	230+	✓	✓
Purchase	105	✓	✓
HR & Payroll	29	✓	✓
Aerospace	10	✓	✓
Accounting	9	✓	✓
University	9	✓	✓
Distribution	8	✓	✓
Koperasi	8	✓	✓
Retail & POS	7+	✓	✓
Gold Mining & Refinery	7	✓	✓
Aviation	6	✓	✓
Coal Mining	6	✓	✓
Hospital & Pharmacy	6	✓	✓
Hajj & Umrah Travel	6	✓	✓
Logistics	5	✓	✓
Hotel & Property	5	✓	✓
Beauty Clinic	5	✓	✓
Rental	4	✓	✓
Livestock	4	✓	✓
Fishery	4	✓	✓
Software House	4	✓	✓
Event Organizer	4	✓	✓
Satellite City	2	✓	✓
Education Foundation	2	✓	✓
Food & Beverage	1	✓	✓
Civil Construction	1	✓	✓
Garment	1	✓	✓
Agriculture	1	✓	✓
Theme Park	1	✓	✓
Data Center / IT	1	✓	✓
Palm Oil	1	✓	✓
Feedmill	1	✓	✓
Building Management	1	✓	✓
Auditor	1	✓	✓

XERPIUMLOGISTICS

Enterprise-Grade Logistics Ecosystem

Logistics Master Data

Shipment (logistics.shipment)

Route (logistics.route)

Service Category (logistics.service.category)

Rate Card (logistics.rate.card)

Integrated Logistics Operations Flow

🚚 Shipment Operations

🚌 Fleet Management (xerpium_logistics_fleet)

📦 Container Management (logistics.container)

🌎 Freight Forwarding (xerpium_logistics_freight)

🏢 Warehouse Ops (xerpium_logistics_warehouse)

Tracking, POD & Claim Management

🔗 Real-time Tracking (logistics.tracking)

📄 Proof of Delivery (logistics.proof.of.delivery)

⚠ Claim Management (logistics.claim)

🌡 Cold Chain (xerpium_logistics_cold_chain)

Logistics Dashboard — Dashboard Studio

Logistics KPI Template

AI Dashboard Features

Chart Types

Logistics Accounting Journals

Logistics Journal Flow

Key Logistics Accounts

Logistics Accounting Features

Cross-Module Integration

Logistics ↔ Sales

Logistics ↔ Inventory

Logistics ↔ Fleet

Logistics ↔ Accounting

Logistics ↔ Dashboard

Logistics ↔ Dynamic Stage

Logistics ↔ Notification

Logistics ↔ AI Assistant

Why XERPIUM Logistics?

XERPIUM Industry Portfolio