FFA

Create, save, issue, retrieve, and print a Delivery Order (DO) for an Air Import HAWB so that cargo release can be officially controlled and documented.

Scope

• Applicable to Air Import Shipments only
• One active DO per HAWB
• DO created through a DO screen
• Draft / Approval workflow
• Output format: PDF Refer to ticket #1363
• Accessible from File Reference Retrieve Screen at HAWB level or a new menu
• DO data must be saved in system before issue

Air Import > House Delivery Order

Screens

1. DO Retrieve Screen (List of DOs)
2. Issue DO Popup (List of HAWBs)
3. DO Entry Screen

User Flow

1. User opens Air Import > House Delivery Order
2. User clicks Issue DO
3. Popup opens: List of HAWBs
4. User selects HAWB
5. System redirects to DO Input Screen
6. User can:
   • Save Draft
   • Submit / Approve DO
   • Generate PDF after approval
   • Preview DO after approval
   • Download DO after approval

Functional Requirements

1. HDO Retrieve Screen

Search Filters

• HAWB Reference
• MAWB Reference
• File Reference
• Consignee
• Status
• Date Range

Grid Columns

• Created On
• HDO Reference
• MAWB No
• HAWB No
• File Reference
• Consignee
• DO Type
• Status
• Approval Status
• Action

Actions

• View
• Edit Draft
• Approve
• Preview PDF
• Download PDF
• Cancel

2. Issue DO Button

User clicks on "Issue DO" button.

System opens popup:

Popup Title:

List of HAWBs

Popup Search Filters

• HAWB No
• MAWB No
• File Ref
• Consignee
• Arrival Date

Popup Grid Columns

• Select
• HAWB No
• MAWB No
• Consignee
• Flight No
• Arrival Date
• Status

Popup Rules

• Only Air Import HAWBs shown
• Already approved active DO HAWBs excluded (or flagged)

3. On HAWB Selection

System redirects user to HDO Entry Screen

4. HDO Entry Screen Fields

Header

Shipment Details

Read only:

• Flight No
• Arrival Date
• Airport of Arrival
• Packages
• Gross Weight
• Chargeable Weight
• Goods Description
• Marks & Numbers

Parties

• Consignee
• Notify Party
• Agent / Forwarder

Editable Fields

5. Actions on Entry Screen

Save Draft

• Save record
• Status = Draft

Approve DO

• Validate fields
• Status = Approved
• Store approved by/date

Preview HDO

Visible only when Status = Approved

Download HDO

Visible only when Status = Approved

Note that once a DO is issued, all fields printed on the DO document shall become read-only. Any changes require Cancel/Reissue based on user permission.

Cancel HDO

System shall allow authorized users to cancel a Delivery Order (DO) from:

• DO Retrieve Screen
• DO Entry / View Screen

Only DOs with status:

• Issued / Approved

may be cancelled.

Draft DOs shall be handled through Edit or Delete Draft actions.

Cancelled DOs cannot be cancelled again.

User Action: When the user clicks Cancel DO, the system shall open a confirmation popup displaying the following:

• DO Number
• HAWB No
• Consignee
• Current Status

User must provide:

• Cancellation Reason (mandatory)

System Validation

Before cancellation, the system shall validate the following:

• User has permission to cancel DO
• DO is not already cancelled
• DO is in eligible status

On Successful Cancellation

System shall:

• Update DO Status = Cancelled
• Store Cancelled By
• Store Cancelled Date & Time
• Store Cancellation Reason
• Lock record from further approval/use
• Keep record searchable in Retrieve Screen
• Write entry to Activity Log

6. PDF Rules

PDF available only after approval.

Refer to this ticket https://gitlab.maccs.mu/rnd/ffa/documentation/-/issues/1363 for the PDF format.

Cancelled DO shall no longer be valid for release.

7. Re-Issue DO

The system shall allow authorized users to re-issue a cancelled DO.

Re-issue action available only when current DO status = Cancelled.

When the user clicks Re-Issue DO, the system shall:

• Open DO Entry Screen
• Auto-populate data from cancelled DO
• Allow editable fields based on current business rules
• Generate new DO Number upon save/issue
• Link new DO to previous cancelled DO reference

System shall retain both records:

• Original Cancelled DO
• New Re-Issued DO

with relationship reference for audit purposes.

System shall write entries for:

• Re-Issue initiated
• New DO created from cancelled DO
• New DO issued

in the Activity Log.

Activity Log

System shall maintain an Activity Log for each DO similar to Ocean module.

Columns

• Activity Date & Time
• Activity By
• Activity Description

9. Business Rules

• One active approved HDO per HAWB
• Draft may be edited
• Approved HDO read-only
• Cancelled HDO remains searchable
• Air Export excluded