> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jadenet.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Land Freight

> Manage land-freight job orders, trips, traffic monitoring, workshop activity, charges, billing, and closure.

## Purpose

Use Land Freight to manage road-transport job orders, vehicle/driver assignment, trip execution, traffic monitoring, delivery evidence, workshop support, charges, billing, and job completion.

## Preconditions

* The user has Land Freight access for the correct office/branch.
* Customer, routes, truck types, vehicles, drivers, warehouses, issue types, charge codes, currencies, and rates exist.
* Vehicle, driver, permit, and safety requirements are satisfied.
* Pickup/delivery instructions and service pricing are approved.
* Required workshop/stock data is available for maintenance-related transactions.

## Workflow

1. Create the Land Freight order and trip in **Planning**.
2. Assign the truck, driver, route, cargo, and schedule; the trip becomes **Assigned**.
3. Dispatch the trip and update it through **Dispatched** and **InTransit**.
4. Record physical delivery and set the trip to **Delivered**.
5. Receive proof of delivery and set **POD Received**.
6. Continue through **Send Invoice** and **Collect Payment**.
7. Set **Job Closed** when the operational and financial work is complete.

The process map follows the `TripStatus` sequence implemented by the project.

```mermaid placement="top-right" theme={null}
%%{init: {'flowchart': {'defaultRenderer': 'elk'}}}%%
flowchart LR
    A([Planning]) --> B[Assigned]
    B --> C[Dispatched]
    C --> D[InTransit]
    D --> E[Delivered]
    E --> F[POD Received]
    F --> G[Send Invoice]
    G --> H[Collect Payment]
    H --> I([Job Closed])

    classDef start fill:#714B67,stroke:#56364E,color:#FFFFFF;
    classDef work fill:#EFE6ED,stroke:#714B67,color:#2F2933;
    classDef approval fill:#F8E6A0,stroke:#B8860B,color:#3B2E00;
    classDef finance fill:#D8F1EF,stroke:#00A09D,color:#123B39;
    classDef done fill:#D9EED8,stroke:#4F8A4C,color:#183817;
    classDef exception fill:#F5D8DC,stroke:#B54A59,color:#4A1720;
    class A start;
    class B,C,D,E,F work;
    class G,H finance;
    class I done;
```

## Step-by-step

<Steps>
  <Step title="Create the job order">Enter office, customer, pickup/delivery locations, cargo, service, requested schedule, vehicle requirement, pricing, and instructions.</Step>
  <Step title="Create the trip">Use **Traffic Monitoring > New Trip** and link the correct job/order.</Step>
  <Step title="Assign resources">Select an available vehicle and qualified driver; verify route, documents, capacity, condition, and contact details.</Step>
  <Step title="Dispatch">Confirm readiness and move the trip to the running state through the configured action.</Step>
  <Step title="Monitor execution">Update departure, arrival, waiting, delay, incident, delivery, and return milestones.</Step>
  <Step title="Record actuals">Enter fuel, toll, allowance, subcontractor, workshop, and other actual costs with evidence.</Step>
  <Step title="Complete delivery">Attach or reference proof of delivery and confirm actual quantities, time, route, exceptions, and returned documents.</Step>
  <Step title="Bill and close">Create customer billing, settle expenses, allocate payments/receipts, review profitability, and close the job.</Step>
</Steps>

## Screenshots

<Note>No sanitized current-version Land Freight screenshots are stored in the repository yet.</Note>

Recommended captures: Job Order; New Trip; vehicle/driver assignment; Running Trip; proof-of-delivery area; actual charges; Closed Trip.

## Result

The transport job has an assigned and traceable trip, complete execution milestones, delivery evidence, recorded actual costs and revenue, and a reviewed final status.

## Approval

The `TripDetail` status sequence is operational and does not use the generic transaction-approval engine. Separate related records can require approval, including quotations, Advance Vouchers, workshop Work Orders, Purchase Requests/Purchase Orders, bills, invoices, and Payment Vouchers. Status updates must still reflect the actual trip and proof-of-delivery evidence.

## Accounting Impact

Job/trip creation normally has no direct ledger impact. Estimated costs support planning. Posted allowances, expenses, purchase/vendor bills, customer invoices, cashier transactions, stock issues, and closing journals affect expense, inventory, AP, AR, cash/bank, revenue, and job profitability.

## Common Errors

| Error                                 | Resolution                                             |
| ------------------------------------- | ------------------------------------------------------ |
| Wrong job linked to trip              | Correct before dispatch and dependent costs            |
| Vehicle capacity/condition unsuitable | Reassign a compliant vehicle; do not dispatch          |
| Driver unavailable/unqualified        | Reassign through the approved dispatch process         |
| Trip remains Running after delivery   | Complete evidence and execute the closing action       |
| POD missing                           | Obtain and attach/reference approved delivery evidence |
| Actual toll/fuel/allowance incomplete | Record supported actuals before profitability review   |

## Related Functions

* [Relationship Management](/modules/relationship-management)
* [Warehouse Management](/modules/warehouse)
* [Expense Management](/modules/voucher-management)
* [Cashier Management](/modules/cash-and-bank)
* [Accounting and Finance](/modules/accounting)
* [Job closing](/workflow/job-closing)