# Felisco-Sun Port Trucking — Customer Booking & Drayage Navigation Guide

> **Official Shipper & Importer User Guide**  
> **System:** Felisco-Sun Port Drayage & Haulage Customer Portal  
> **URL:** `/trucks/customer.html`  
> **Target Audience:** Importers, Exporters, Clearing & Forwarding Agents, Warehouse Managers, Factory Logistics Officers  
> **24/7 Operations Hotline:** +233 (0)24 823 8541 / +233 (0)55 794 1830  

---

## Table of Contents
1. [Welcome to Felisco-Sun Port Drayage](#1-welcome-to-felisco-sun-port-drayage)
2. [Portal Layout & Main Navigation](#2-portal-layout--main-navigation)
3. [Step-by-Step: How to Book a Truck (3-Step Wizard)](#3-step-by-step-how-to-book-a-truck-3-step-wizard)
   - [Step 1: Cargo Specifications & Delivery Route](#step-1-cargo-specifications--delivery-route)
   - [Step 2: Freight Review & Dispatch Rate Negotiation](#step-2-freight-review--dispatch-rate-negotiation)
   - [Step 3: MTN Mobile Money (MoMo) Payment & Invoice](#step-3-mtn-mobile-money-momo-payment--invoice)
4. [How Real-Time Rate Negotiation Works](#4-how-real-time-rate-negotiation-works)
5. [Tracking Your Container on the Live GPS Map](#5-tracking-your-container-on-the-live-gps-map)
6. [Managing Active Bookings & Dispatched Trips](#6-managing-active-bookings--dispatched-trips)
7. [Official Invoices, E-Waybills & Payment Receipts](#7-official-invoices-e-waybills--payment-receipts)
8. [Rating Your Driver & Reporting Issues (Disputes)](#8-rating-your-driver--reporting-issues-disputes)
9. [Frequently Asked Questions (FAQ) & Best Practices](#9-frequently-asked-questions-faq--best-practices)

---

## 1. Welcome to Felisco-Sun Port Drayage

Felisco-Sun Ghana Ltd. provides dedicated port container drayage (20ft & 40ft), heavy-duty flatbeds, lowbeds, and box truck haulage connecting **MPS Terminal 3 (Tema Port)**, **Golden Jubilee Terminal**, and **Takoradi Port (TACOTEL)** to industrial zones, warehouses, and factories across Ghana.

```
+───────────────────────────────────────────────────────────────────────────────────+
|                           YOUR CARGO JOURNEY WITH US                              |
+───────────────────────────────────────────────────────────────────────────────────+
|                                                                                   |
|  1. SUBMIT ORDER       2. DISPATCH CALL       3. MOMO PAYMENT     4. LIVE TRACK   |
|   Enter cargo,          Dispatcher reviews     Transfer to         Follow your    |
|   terminal & drop-      & agrees rate          official MoMo       truck with     |
|   off destination       via phone/SMS          with your Ref       GPS updates    |
|                                                                                   |
+───────────────────────────────────────────────────────────────────────────────────+
```

### Why Book Through the Portal?
- **GPHA Biometric Cleared Drivers:** All operators hold valid Ghana Ports & Harbours Authority passes.
- **Goods-in-Transit (GIT) Insurance:** Cargo protected up to GHS 250,000 per transit against loss or damage.
- **Real-Time GPS Tracking:** Live vehicle coordinates streamed from port gate-out to final destination.
- **Instant Official E-Receipts:** Automated GRA-compliant invoices and payment receipts sent via SMS.

---

## 2. Portal Layout & Main Navigation

When you open **`/trucks/customer.html`**, you will find four main navigation tabs:

| Tab Name | Purpose | What You Can Do |
|---|---|---|
| **1. Book Haulage** | Request a Truck | Specify cargo, select port origin & destination, review details, and submit for pricing. |
| **2. Live Fleet Radar** | Radar & Scanner | Scan for available trucks near Tema or Takoradi terminals within a 5km to 25km radius. |
| **3. My Bookings & Trips** | Tracking Hub | View pending requests, track rolling trips, inspect milestones, and view driver details. |
| **4. Payments & Invoices** | Billing & Records | Settle freight invoices, download official receipts, rate drivers, or file claims. |

---

## 3. Step-by-Step: How to Book a Truck (3-Step Wizard)

### Step 1: Cargo Specifications & Delivery Route
Open **Tab 1: Book Haulage**. Complete the order specification fields:

1. **Cargo & Vehicle Specifications:**
   - **Cargo Category:** Select your container or goods type (*20ft Container*, *40ft Standard/High Cube*, *Breakbulk / Steel*, *Palletized Goods*, *Heavy Machinery*).
   - **Required Truck Specification:** Choose matching body type (*Container Hauler 40ft*, *Container Hauler 20ft*, *Flatbed Heavy Duty*, *Lowbed Equipment Hauler*, *Box Truck*).
   - **Commodity Type:** Select commodity (*Cocoa / Agricultural*, *Steel Rebar / Iron*, *Machinery / Spare Parts*, *Timber / Wood*, *FMCG / Food & Beverage*, etc.).
   - **Cargo Weight (Tonnes):** Enter approximate gross payload weight (e.g. `25.0` tonnes).
   - **Handling Notes (Optional):** Add special instructions (e.g., *"Requires crane grounding at factory"*, *"Fragile glass bottles"*, *"Port customs seal #GH-88219"*).
2. **Contact Information:**
   - **Contact Phone Number:** Enter your active Ghana mobile phone (e.g. `0241234567`).  
     *(Important: Our operations desk will call you on this line to confirm the negotiated rate and SMS your payment link).*
   - **Shipper / Contact Person:** Enter your name or company name (e.g., *Kwesi Mensah / Apex Logistics Ltd*).
3. **Terminal Pickup & Destination:**
   - **Origin Port Terminal:** Select where your container is staged:
     - *Tema Port — MPS Terminal 3 (Meridian Berth)*
     - *Tema Port — Golden Jubilee Terminal (GPHA Yard)*
     - *Tema Port — Main Harbor Gate 1*
     - *Kpone Inland Container Depot (KICD)*
     - *Takoradi Port — TACOTEL Container Terminal*
   - **Delivery Destination Address:**
     - Select from saved destinations or click **Add Destination** to type your delivery warehouse address using Google Maps autocomplete (e.g. *Spintex Industrial Area, Accra* or *Kumasi Boankra Inland Port*).
4. Click **Review Order & Submit for Dispatch Pricing →**.

---

### Step 2: Freight Review & Dispatch Rate Negotiation
In Step 2, review your order breakdown:
- Origin Port Terminal vs. Drop-off Destination.
- Vehicle Class and Cargo Weight.
- Initial tariff baseline.

```
+──────────────────────────────────────────────────────────────────────────+
| 🏷️ NEGOTIATED FREIGHT PRICING MODEL EXPLAINED                           |
| Because terminal wait times, fuel indices, and container return fees     |
| change daily, Felisco-Sun provides customized, negotiated rates.         |
| When you click submit:                                                   |
| 1. Our operations desk immediately receives your cargo details.          |
| 2. A dispatcher calls you to finalize the exact agreed price.            |
| 3. You receive an SMS alert with your approved price and payment link.   |
+──────────────────────────────────────────────────────────────────────────+
```

- Click **Submit Request to Dispatch Desk →**.
- Your booking reference (e.g. `req-847291`) is created and an SMS notification is sent to Felisco Operations.

---

### Step 3: MTN Mobile Money (MoMo) Payment & Invoice
Once the dispatcher confirms your negotiated rate, Step 3 activates:

```
+──────────────────────────────────────────────────────────────────────────+
| 📱 OFFICIAL FELISCO-SUN MOMO PAYMENT DETAILS                             |
+──────────────────────────────────────────────────────────────────────────+
|  Recipient Name:  Philomena Sena Tsikudo Zip Up (Felisco Operations)    |
|  Mobile Number:   0557941830                                             |
|  Network:         MTN Mobile Money                                       |
|  Amount:          GHS [Your Agreed Rate] (please add MoMo fees)          |
|  Reference Code:  FS-REQ-XXXX (Shown on your screen)                     |
+──────────────────────────────────────────────────────────────────────────+
```

#### How to Pay via MTN MoMo:
1. Dial **`*170#`** on your mobile phone.
2. Select **Transfer Money → MoMo User**.
3. Enter Recipient Number: **`0557941830`**.
4. Confirm Recipient Name: **Philomena Sena Tsikudo Zip Up**.
5. Enter the exact Amount shown on your screen (plus MoMo cash-out charges).
6. In the **Reference** prompt, enter your unique reference code (e.g. `FS-REQ-8472`).
7. Enter your 4-digit PIN to authorize.
8. On the portal screen, click **✅ I've Completed the MoMo Transfer**:
   - The dispatch desk receives an instant alert.
   - Your payment is verified within 5–10 minutes.
   - A driver and truck are immediately dispatched to the terminal gate.
   - You can click **🧾 View Formal Receipt** or **Watch for Assigned Truck on Live Map**.

---

## 4. How Real-Time Rate Negotiation Works

1. **Submission:** When you submit a booking, your request appears instantly on the Felisco Dispatcher Console.
2. **Dispatcher Call:** A terminal dispatcher calls you to confirm vessel clearance, gate pass availability, and delivery time.
3. **SMS Alert:** The dispatcher locks in the agreed price in the system. You receive an instant SMS:
   > *"Felisco-Sun: Your haulage request for [Cargo] has been quoted at GHS 2,500. Click here to view invoice and pay: [Link]"*
4. **Direct Link:** Clicking the link in the SMS takes you directly to your order summary and payment screen.

---

## 5. Tracking Your Container on the Live GPS Map

### 5.1 Using the Radar Scanner (Tab 2)
- Open **Tab 2: Live Fleet Radar**.
- Select your port terminal (e.g., *Tema MPS Terminal 3*) and choose a search radius (*5 km*, *10 km*, or *25 km*).
- Click **Scan Radar** to view real-time standby trucks positioned in the Tema port buffer yards ready for dispatch.

### 5.2 Live Following of Your Assigned Truck
- Under **Track Specific Trip** on the right side of Tab 2:
  - Enter your **Trip ID** (received in your SMS confirmation or found in Tab 3).
  - Click **Follow Trip**.
  - The map centers directly on your truck and streams real-time updates as your container rolls along the highway.

---

## 6. Managing Active Bookings & Dispatched Trips

Open **Tab 3: My Bookings & Trips** to inspect all your shipments:

### 6.1 Left Column: Orders & History
- **My Active Bookings:** Shows open requests waiting for price agreement or truck matching.
- **Dispatched Trips:** Lists all rolling deliveries and completed trips.
- **Direct Trip Lookup:** Paste any Trip ID to pull up its full telemetry.

### 6.2 Right Column: Live Inspector Panel
When you select an active trip, you will see:
- **Vehicle & Driver Details:** Assigned tractor plate (e.g. `GT 1234-24`), driver name, and contact number.
- **Live Corridor Status:**
  - `assigned` — Driver notified; entering terminal gate queue.
  - `arrived_pickup` — Truck inside container terminal waiting at berth.
  - `loading` — Container being hoisted onto trailer chassis.
  - `in_transit` — Moving on highway under GPHA customs seal.
  - `arrived_dropoff` — Arrived at your warehouse gates.
  - `unloading` — Container grounded / destuffed.
  - `delivered` — Cargo received; physical waybill signed.
  - `completed` — Delivery finalized with Proof of Delivery photo.
- **Journey Milestones Timeline:** An audit log displaying the exact timestamp of every milestone.

---

## 7. Official Invoices, E-Waybills & Payment Receipts

Felisco-Sun provides corporate-ready documentation for tax filing, corporate expense reconciliation, and GRA/audit purposes.

```
+──────────────────────────────────────────────────────────────────────────+
|  DOCUMENT STATES:                                                        |
|  • BEFORE PAYMENT  ──> Commercial Freight Invoice (Proforma / FS-INV-...) |
|  • AFTER PAYMENT   ──> Official Payment Receipt (Paid in Full / FS-REC-..)|
+──────────────────────────────────────────────────────────────────────────+
```

### Viewing and Printing Your Document
1. In **Tab 1 (Step 3)** or **Tab 4 (Payments & Invoices)**, click **📄 View Document** or **📄 View / Print Freight Invoice**.
2. A high-resolution, print-ready document modal opens with:
   - Felisco-Sun Corporate Details, TIN (`C002819381X`), and official stamp.
   - Consignee Name & Contact.
   - Origin Terminal, Delivery Address & Cargo Description.
   - MoMo Transaction Reference & Timestamp.
   - Authorized Signature box.
3. Click **Print Document** to print directly on A4 paper or save as a PDF.
4. You can also view your official receipt on any device anytime at:  
   `https://[your-domain]/trucks/receipt.html?id=[YOUR_BOOKING_OR_TRIP_ID]`

---

## 8. Rating Your Driver & Reporting Issues (Disputes)

We maintain rigorous service standards across our driver fleet.

### 8.1 Rating Your Driver
1. Open **Tab 4: Payments & Invoices**.
2. Under **Rate Your Haulage Driver**, select a score from **1 to 5 Stars**.
3. Click **Send Rating**. Your feedback directly impacts the driver's bonus standing and fleet leaderboard.

### 8.2 Reporting a Dispute or Issue
If you experience an operational issue (such as terminal gate delays, container demurrage concerns, or cargo seal questions):
1. In Tab 4, locate **Report an Issue with This Trip**.
2. Type a brief description of the issue (e.g. *"Terminal crane delayed loading by 3 hours; requesting detention waiver"*).
3. Click **File Dispute**:
   - The issue is flagged with high priority on the Operations Manager's console.
   - A supervisor reviews the GPS timestamp logs and contacts you to resolve the matter.

---

## 9. Frequently Asked Questions (FAQ) & Best Practices

### Q1: What happens if I make a MoMo transfer without including the reference?
**Answer:** Always try to enter your reference (e.g. `FS-REQ-XXXX`) in the MoMo note field. If you forget, click **✅ I've Completed the MoMo Transfer** in the portal and call dispatch on **`+233 24 823 8541`** with your mobile phone number and transfer amount. Our billing desk will match your transaction manually.

### Q2: Can I book a truck before customs clearance is complete?
**Answer:** Yes! You can submit your booking up to 48 hours in advance to secure a standby truck. When your ICUMS release order is approved, notify your dispatcher to order the truck into the terminal gate.

### Q3: What should I do if the assigned truck breaks down?
**Answer:** You don't need to do anything! Felisco-Sun operates a standby fleet at Tema and Kpone. If an assigned vehicle has a mechanical issue, our operations team performs a **1-click standby truck swap**. Your payment, invoice, and cargo tracking are seamlessly transferred to a replacement vehicle.

### Q4: How do I prove that my cargo was delivered?
**Answer:** Upon delivery at your warehouse, the driver captures a **Proof of Delivery (POD)** photograph of the grounded container and signed physical waybill. This photo is verified by our operations desk and archived in your trip record.

---

### Need Immediate Assistance?
- **Operations Hotline:** +233 (0)24 823 8541
- **Emergency Dispatch:** +233 (0)55 794 1830
- **Email:** operations@feliscosun.com
- **Headquarters:** Plot 14, Commercial Wharf Road, Heavy Industrial Area, Tema, Ghana
