Custom Freight Forwarding, Clearing & Forwarding (C&F), Bonded Warehouse & Port Container Tracking Software

How Port Demurrage and Unbilled Disbursements Eat Clearing & Forwarding Profits

In sea and air freight forwarding, customs clearing (C&F), Container Freight Stations (CFS), and bonded warehousing—such as along the Mombasa–Nairobi–Kampala–Kigali Northern Corridor or Dar es Salaam Central Corridor—every hour of delay after vessel discharge costs hard currency. Shipping lines grant a strict window of Port Storage Free Days and Container Detention Free Days (e.g., 14 or 21 days for transit containers until the empty box is returned to the depot). When a clearing agency tracks 150 active consignment files on whiteboards and Excel sheets, a missing Import Declaration Form (IDF), a delayed Certificate of Conformity (CoC), or an un-tracked empty container return turns a $600 agency fee into a $3,500 demurrage and detention dispute.

Equally damaging is Disbursement Leakage: clearing clerks pay dozens of third-party outlays on behalf of the importer—port handling charges, shipping line delivery orders, radiation/KEBS inspection fees, verification fork-lift hire, and transit bond fees—via M-Pesa or bank transfers, and then forget to attach three of those outlays to the final client invoice. At devManue Logistics & Trade Systems Engineering, we build custom Freight Forwarding, Customs Clearing, CBM Consolidation, and Bonded Warehouse ERP platforms.

1. Core Freight Forwarding, C&F & Consolidation Modules & Build Costs

Our platform replaces paper consignment jackets and fragmented spreadsheets with a real-time digital file lifecycle:

2. Zero-Leakage Consignment Job Costing & Automated Demurrage Escalation

In our C&F accounting architecture, every operational disbursement request (whether KES 1,500 for port clerk logistics or $1,800 for shipping line DO charges) must be bound to an active ConsignmentFile and tagged as either Recoverable Client Outlay (Back-to-Back) or Internal Agency Cost. The system mathematically blocks the finance team from closing a consignment file or issuing a cargo Gate Release Order until 100% of recoverable disbursements have been pulled onto the client's final tax invoice.

Simultaneously, for Less-than-Container-Load (LCL) air and sea consolidators, our volumetric rating engine automatically computes chargeable freight across Cubic Meters (CBM) and dimensional weight so warehouse clerks never under-bill bulky cargo:

# Production Freight Consolidation Chargeable CBM/Weight & Demurrage Exposure Engine
from datetime import date
from decimal import Decimal, ROUND_HALF_UP
from dataclasses import dataclass

@dataclass(frozen=True)
class ConsignmentChargeBreakdown:
    mode: str
    actual_weight_kg: Decimal
    volume_cbm: Decimal
    chargeable_units: Decimal
    freight_charge_usd: Decimal
    demurrage_days_accrued: int
    estimated_demurrage_usd: Decimal

def calculate_lcl_and_demurrage_exposure(
    mode: str,  # "SEA_LCL" or "AIR_FREIGHT"
    length_cm: Decimal,
    width_cm: Decimal,
    height_cm: Decimal,
    cartons_count: int,
    gross_weight_kg: Decimal,
    rate_per_unit_usd: Decimal,
    discharge_date: date,
    free_days_granted: int,
    daily_demurrage_usd: Decimal,
    as_of_date: date,
) -> ConsignmentChargeBreakdown:
    """
    Computes Sea LCL W/M (1 CBM = 1,000 kg) or Air Volumetric Weight (1:6000 cm3/kg)
    alongside real-time port/detention free-day expiry exposure.
    """
    q2 = lambda v: v.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
    q3 = lambda v: v.quantize(Decimal("0.001"), rounding=ROUND_HALF_UP)

    total_volume_cbm = q3(
        (length_cm * width_cm * height_cm * Decimal(cartons_count)) / Decimal("1000000.0")
    )

    if mode == "SEA_LCL":
        # Sea LCL Revenue Ton (W/M): greater of Volume in CBM or Gross Weight in Metric Tons
        weight_mt = q3(gross_weight_kg / Decimal("1000.0"))
        chargeable = max(total_volume_cbm, weight_mt, Decimal("0.500"))  # Min 0.5 CBM
    else:
        # Air Freight IATA Volumetric Weight: (L * W * H cm) / 6000 per kg
        volumetric_kg = q2((total_volume_cbm * Decimal("1000000.0")) / Decimal("6000.0"))
        chargeable = max(gross_weight_kg, volumetric_kg)

    freight_usd = q2(chargeable * rate_per_unit_usd)

    elapsed_days = max(0, (as_of_date - discharge_date).days + 1)
    demurrage_days = max(0, elapsed_days - free_days_granted)
    demurrage_usd = q2(Decimal(demurrage_days) * daily_demurrage_usd)

    return ConsignmentChargeBreakdown(
        mode=mode,
        actual_weight_kg=gross_weight_kg,
        volume_cbm=total_volume_cbm,
        chargeable_units=chargeable,
        freight_charge_usd=freight_usd,
        demurrage_days_accrued=demurrage_days,
        estimated_demurrage_usd=demurrage_usd,
    )

3. Self-Service Importer Tracking Portals That Cut Phone Inquiries by 70%

Importers call their clearing agent five times a day asking, "Has the vessel berthed? Has the customs entry been passed? Where is the truck right now?" Our platform gives every corporate importer and groupage merchant a branded Live Shipment Portal & WhatsApp Bot showing real-time milestone ticks (Docs Verified → Entry Registered → Duty Paid → Customs Released → Loaded on Truck → Border Cleared → Delivered), downloadable customs entries, and instant M-Pesa/Bank duty & freight settlement.

Ready to digitize your clearing agency, groupage warehouse, or bonded facility? Explore our Logistics & ERP Engineering Services or book a 30-Minute Freight ERP Discovery Session.

4. Frequently Asked Questions (FAQ)