Task #19833
closedMCLCPW - Display Charges Summary in Process Receipt Section
Description
Enhance the Receipting module to display invoice charges breakdown (Freight, Ex-Works, Other Local Charges) to guide users during payment allocation.
Currently, the Process Receipt section only shows total invoice amounts. However, based on the invoice, charges are split into multiple components such as:
- Sea Freight Export
- Ex-Works
- Documentation Fee / THC / CFS Fee/ Others (Local Charges)
Users (cashiers) need visibility of grouped charge amounts to correctly record payments.
Requirement¶
Display a Charges Summary Section in Process Receipt showing:
- When user selects an invoice, system should retrieve the invoice charge details.
- System should group invoice charges into:
- Freight Charges
- Ex-Works Charges
- Other Local Charges
- For Freight Charges:
- Display original foreign currency amount.
- Display equivalent MUR amount.
- For Ex-Works Charges:
- Display original foreign currency amount.
- Display equivalent MUR amount.
- For Other Local Charges:
- Display total in MUR.
- If the charge is already in MUR:
- Foreign currency amount can be blank or shown as MUR amount.
- Equivalent MUR should still be displayed.
In the Process Receipt section, system should display invoice charge summary as follows:
| Charge Group | Display Currency |
|---|---|
| Freight Charges | Foreign currency used on invoice + equivalent MUR |
| Ex-Works Charges | Foreign currency used on invoice + equivalent MUR |
| Other Local Charges | MUR total |
Example Display¶
Based on the invoice:
| Charge Group | Foreign Currency Amount | Equivalent MUR |
|---|---|---|
| Freight Charges | USD 2,400.00 | MUR 114,000.00 |
| Ex-Works Charges | USD 120.00 | MUR 5,700.00 |
| Other Local Charges | - | MUR 5,150.00 |
Functional Requirements¶
- When user selects an Invoice Reference:
- System retrieves invoice charge details
- System categorizes charges into:
| Category | Logic |
|---|---|
| Freight Charges | Based on Charge Description & if Manifested Freight is ticked (e.g. Sea Freight, Air Freight) |
| Ex-Works Charges | Based on predefined charge mapping |
| Other Local Charges | All remaining charges |
- Display these values in Process Receipt section
Note: The system should use the invoice line currency and invoice exchange rate already used during invoice generation, not the current exchange rate.
Acceptance Criteria¶
Scenario 1 – Freight Charges Display¶
Given invoice contains freight charges in foreign currency
When invoice is selected in Process Receipt
Then system displays:
- Freight amount in foreign currency
- Freight equivalent amount in MUR
Scenario 2 – Ex-Works Charges Display¶
Given invoice contains Ex-Works charges in foreign currency
When invoice is selected in Process Receipt
Then system displays:
- Ex-Works amount in foreign currency
- Ex-Works equivalent amount in MUR
Scenario 3 – Other Local Charges Display¶
Given invoice contains remaining local charges
When invoice is selected
Then system displays total under Other Local Charges in MUR.
Scenario 4 – Amount Reconciliation¶
Given the three groups are displayed
Then:
Freight MUR + Ex-Works MUR + Other Local Charges MUR = Invoice Total Amount
GitLab Sync Log
[{"id": "43716", "author": "Avisham", "hours": 4.0, "created": "2026-05-06T11:26:03.186Z", "log_date": "2026-05-05", "comment": "Imported from GitLab by @Avisham on 2026-05-06T11:26:03.186Z: 4h-(4.0)h spend at: 2026-05-05", "status": "active", "deleted_by": "", "redmine_entry_id": 13432}]