Logistics Module

The Logistics module is the core of ERP Tanzania, covering the full freight lifecycle from job creation to invoice settlement.

Key concepts

Concept	Description
Customer	The company that has engaged you to move goods
Job	A freight engagement — one customer, one contract
Trip	A physical truck movement under a job. One job can have multiple trips
Route	A defined origin-to-destination corridor with checkpoints
Expense	A cost incurred during a trip (fuel, toll, allowance, etc.)
Income	Revenue recognised against a job
Invoice	A VAT-compliant invoice issued to the customer

Jobs

A Job represents a contract with a customer to move goods. It groups all trips, expenses, income, and invoices for that engagement.

Status lifecycle: Draft → Open → In Transit → Completed → Closed

To create a job:

1. Go to Jobs → New Job
2. Select the customer
3. Add a description and start date
4. Save — the job opens in Draft status

Trips

A Trip is a single truck movement under a job. Each trip tracks:

• Assigned truck, trailer, and driver
• Route (with estimated days and checkpoints)
• Start date and status
• Outsourced fleet details (if using a subcontracted truck)
• Delivery confirmation (receiver name, date, confirmation flag)

Outsourced trips: If the movement uses a third-party truck, enable the outsourced flag and fill in the vendor's truck registration, driver name, license, and passport details.

Expenses

Expenses are logged against specific trips. Each expense records:

• Category: Fuel, Toll, Allowance, Maintenance, Border Fee, Other
• Amount, currency, and VAT status
• Receipt image upload
• Approval status (Pending → Approved / Rejected)

Accountants and admins can approve or reject expenses from the Expenses view.

Invoicing

Invoices are generated from completed jobs:

1. Open a job → click Create Invoice
2. Add line items (the system pre-fills from income records)
3. Apply VAT rate (default from tenant settings)
4. Set payment details and notes
5. Change status to Sent when emailed to the client

Invoices support:

• Multi-currency (TZS, USD, EUR, GBP, ZAR, ZMW)
• VAT-inclusive or exclusive mode
• Custom branding (logo, stamp, TIN, footer)
• PDF export

Routes

Define your standard corridors once and reuse them across all trips:

• Set origin and destination
• Add intermediate checkpoints
• Specify estimated days and distance (km)

Common Tanzania/corridor routes: Dar es Salaam – Lusaka, Dar – Lubumbashi, Dar – Beira, Tunduma – Lusaka, Namanga – Nairobi.

Permissions

Permission	What it allows
job.view	See all jobs and their details
job.create	Create new jobs
job.edit	Edit existing jobs
job.delete	Delete jobs (soft delete)
trip.assign	Assign trucks and drivers to trips
invoice.create	Generate invoices
expense.approve	Approve or reject expense requests