Help & Knowledge Hub

To log in:

1. Open the TMP Portal login page.
2. Enter your registered Email Address.
3. Enter your Password.
4. Click Sign In.
5. You will be redirected to the Dashboard.

Common Issues:

To reset your password:

1. Click Forgot Password.
2. Enter your registered email address.
3. Click Send OTP.
4. Check your email.
5. Enter the OTP received.
6. Enter a new password.
7. Click Reset Password.

After a successful reset, log in using the new password.

Possible reasons:

• Email entered incorrectly.
• Email landed in Spam/Junk folder.
• Mail server delay.
• Account not registered.

If the OTP is not received within 5 minutes, please contact system support.

To register:

1. Click Create Account.
2. Fill all mandatory fields: Full Name, Email Address, Password, ID Number, Contact Number.
3. Click Create Account.

CRITICAL NOTICE: Once you register to the portal, you need to inform your coordinator/administrator so that your user account can be activated and assigned under the correct profile. Registered users must be activated before logging in.

The following user types can register:

• Transporters
• Logistics Coordinators
• HR Personnel
• Drivers
• Suppliers
• Vendors
• Company Administrators

Operational access rights depend on your assigned profile role.

The Dashboard provides a real-time overview of logistics operations:

• Active Trips
• Completed Trips
• Available Assets
• Registered Drivers
• Quick Actions
• Recent Activities
• Operational KPIs

Dashboard figures are real-time, reflecting instant changes in the system database. In contrast, reports may contain: filtered datasets, older historical data, or exported snapshots. Always refresh the dashboard before comparing metrics.

Asset Master is used to maintain active transportation assets in the fleet, including: Trucks, Trailers, Tankers, and Transport Equipment. All transport assets must be registered and approved before they can participate in trip allocations.

Navigate to: **Masters → Asset Master → Add Asset**

Provide the following data:

• Basic Information: Asset Classification, Category, Company Code, SAP Transporter ID, Description.
• Vehicle Information: Manufacturer, Model, Serial Number, Registration Number, Chassis Number, Engine Number, Vehicle Type, Registration Date.
• Performance Information: Fuel Type, Fuel Tank Capacity, Mileage Empty, Mileage Full Load, KM per Liter.

Click Save Asset to register.

The vehicle must satisfy all the following status checks:

• Asset Added
• Asset Approved
• Asset Active
• Not assigned to another active trip

If the vehicle is currently on an active dispatch trip, it will be locked and cannot be selected for allocation. You can use the **STO Trip Tracking Report** to verify active vehicle availability.

HR Master manages the central directory of personnel records, including Drivers, Transport Coordinators, Supervisors, and Logistics Personnel. Only approved HR driver resources can participate in dispatches.

Navigate to: **Masters → HR Master → Add HR Partner**

Fill out all input fields:

• Personal Information: Full Name, Gender, Date of Birth, ID Number, Huduma Number, Marital Status.
• Contact Information: Contact Number, M-Pesa Number, Residential Address.
• Employment Information: Resource Group, Manager Transporter, User Type, Employment Type, Payroll Code.

Click Save HR Partner to save. The record will await administrative validation.

A driver will only appear for allocation when they meet all these checklist criteria:

• An active HR driver profile exists.
• The driver is approved.
• The driver is set active.
• The driver is not currently assigned to another active trip.

STO stands for Stock Transfer Order. It is a document used when materials are transferred internally within the organization: between plants, between warehouses, or between company office locations.

PO stands for Purchase Order. It is a commercial document issued to purchase goods and materials from external entities: vendors, suppliers, or third-party transporters.

To load orders from SAP:

1. Navigate to: **STO/PO Orders → Load STO/PO from SAP**.
2. Select filters: Company, Date From, Date To, Supply Plant, and Receiving Plant.
3. Click **Load STO/PO**.

This imports the order details directly from the SAP API.

Possible reasons:

• Incorrect search date range.
• SAP database synchronization is not yet complete.
• The order is not released or authorized in SAP.
• Incorrect plant parameters selected.

Adjust your filters and click reload to sync orders.

The **Logistics Planner** console is used by Logistics Administrators to allocate transportation capacity for specific STOs. It allows planners to determine the required number of trucks, assign transporters, and define planned transit quantities.

Only authorized users belonging to the **Logistics Admin**, **Planning Team**, or **Operations Coordinators** roles can access and execute logistics planning decisions.

Once planned:

• The assigned transporter receives the volume allocation in their workspace.
• The STO order becomes available for physical trip allocation.
• Vehicles and drivers can then be assigned to the orders.

Trip Allocation converts planned allocations into active dispatches. It assigns a truck, trailer, driver, and transporter to move goods from the issuing plant to the receiving plant.

The required parameters are:

• STO Number
• Plant Information (Issuing & Receiving)
• Vehicle Number (Truck)
• Trailer Number
• Driver Profile
• Transporter Group
• Planned Transportation Quantity

Ensure that all these dependencies are met:

• The assigned vehicle is approved in the masters.
• The vehicle is currently free (not active on another trip).
• The assigned driver is approved and active.
• The STO has been planned/allocated by a logistics planner.
• The order quantity is not already completed.

Following a successful trip allocation, the system generates a unique QR code representing the digital gatepass file. This QR contains: Trip Number, Vehicle Details, Driver Details, Transporter Details, and STO/PO References.

The QR code is the core verification token at physical logistics checkposts. It is used for: gatepass generation, trip validation, vehicle checks, plant entry/exit authorization, and receipt confirmation. Without presenting a valid QR code, vehicles are blocked from entering or exiting plants.

When the driver arrives at the issuing plant gate, they must undergo the following process:

1. Present the allocated trip QR code.
2. The gatepass officer scans the QR code.
3. The Issuing Gatepass is generated, allowing the vehicle inside the plant.
4. Materials are loaded onto the vehicle.
5. The plant weighbridge captures the dispatch weight.

Upon arrival at the destination: the driver presents the same QR code, the QR is scanned, a Receiving Gatepass is generated, the vehicle enters the plant, materials are unloaded, and the final weight is recorded by the weighbridge.

Only authorized supervisors can generate manual gatepasses if QR scanning terminals are offline. All manual overrides are flagged and logged for auditing purposes.

Trips can be tracked dynamically through these modules:

• STO Trip Tracking Report
• Driver Last Location (GIS telemetry maps)
• GPS Tracking
• Driver Path Report

It displays the latest GPS coordinate updates, current movement speeds, vehicle location, and driver status. This telemetry requires the driver to be running the active FMS Logistics mobile application on their smartphone.

The Driver Path Report displays a historical tracking route of the trip, indicating: starting points, destinations, route deviations, and complete GPS path logs.

Possible reasons:

• The driver's mobile app is offline.
• Location services/GPS is disabled on the phone.
• Poor cell tower or network coverage.
• Mobile device battery is dead.

STO Allocation manages movements between internal company plants (Issuing Plant to Receiving Plant). In contrast, PO Allocation manages movements from external suppliers/vendors to the receiving plant, bypassing the issuing plant gatepass process. Other vehicle mapping and scheduling requirements remain identical.

The required parameters are: Vehicle, Driver, Trailer, Transporter, and PO Number.

STN stands for Stock Transfer Note. It is automatically generated after gatepass creation, material loading, and weight capture are recorded at the issuing plant weighbridge.

GRN stands for Goods Receipt Note. It is generated after arrival at the receiving plant, receiving gatepass completion, and final weight confirmation of the goods receipt.

The STN file becomes available for download immediately after loading is complete, weighbridge weight is recorded, and the issuing gatepass status is set to completed.

The GRN document becomes available after the receiving plant completes unloading, final weight is captured, and the goods receipt is posted in the system database.

Verify that:

• Loading process is fully completed.
• Weighbridge weight has been captured.
• Issuing gatepass was generated.
• SAP API synchronization has completed.

Verify that:

• The receiving gatepass was completed.
• The unloading weighbridge weight was captured.
• The material receipt was successfully posted.
• The SAP transaction update succeeded.

Available reports include:

• STO Trip Tracking Report
• PO Trip Tracking Report
• Driver Tracking Report
• Active Driver Location Report
• Trip Operations Report
• Logistics Planning Report

Most reports provide support for exporting data. You can download them using the Excel Export, CSV Export, or PDF Download buttons located at the top or bottom of report pages.