FFA

A Freight Forwarder (FFWD) should be able to track the demurrage (detention) process for containers after they leave the CHCL yard. He/she can monitor the deadline for container return, record demurrage charges, and notify consignees to avoid additional costs.

Actors:

• Freight Forwarder (FFWD) / Co-Loader
• Consignee

Refer to Epic https://gitlab.maccs.mu/rnd/ffa/documentation/-/issues/390 for more information.

Pre-requisites:

• A File Reference must have already been created and approved in the system for the shipment.
• In order to begin the demurrage countdown, the Container Status must be updated to "Picked Up", and the deadline for returning the empty container has been recorded.

Acceptance Criteria:

1. Container Pickup & Deadline for Return

• After leaving the CHCL yard and clearing any Terminal Storage fee, the system updates the container status to "Picked Up" and starts tracking the demurrage deadline.
• The system should have a subsection named “Return of Container” within the container-level section of the Shipment Cost screen where it will store and track the following fields.
  • Pickup Date
  • Deadline for returning the empty container (the last date before demurrage applies).

2. Deadline Monitoring & Notifications

• The system should track the allowed return date (LFD).
• Automated notifications should be sent:
  • 2 days before deadline → Reminder email/SMS/WhatsApp to consignee & FFWD.
  • On deadline day → Final warning before demurrage starts.
  • After the deadline → Notification that demurrage charges are being applied.

3. Demurrage Charges

• The system should allow the user to record the Demurrage charges as an Additional Cost for the particular container at the MBL level.
• The system should allow the user to then record the Storage charges as Sales charges to bill back the client (additional invoice) at the MBL level.

4. Payment Request & Invoice Generation

• The system should allow the FFWD to generate a Payment Request to the accounting department for settling demurrage charges with the Shipping Line.
• The system should allow the user to generate an invoice to bill the consignee/client fback for this charge.

5. Container Return & Status Update

• Once the demurrage charges are cleared and the container is returned, the FFWD updates the system with:
  • Return Date
  • Return Location (Shipping Line depot)
• The shipment status should update to "Container Returned".

6. Demurrage Dashboard & Reports

• A Demurrage Dashboard should show:
  • Pending Containers (within the deadline).
  • Overdue Containers (demurrage fees being applied).
  • Returned Containers (demurrage cleared).
• The FFWD should be able to filter by Client, Vessel, Date, or Shipping Line.

@Peeroo_Raees Note that demurrage is both at Import & export level (in transhipment cases). Confirmed by Jacques from ED logistics¶