Task #17572
openTask #18500: Ocean Sprint Planning for 17/07/2025 - 25/07/2025
Reports - Sales Report VAT
71%
Description
Acceptance Criteria:¶
-
Report Generation
- The system should provide a Sales Report VAT under the reports module.
- Users should be able to generate the report for a specific date range.
- The report should be exportable in PDF, Excel, and CSV formats.
-
Filter Options
- Users should be able to filter the report by:
- Date Range (Daily, Weekly, Monthly, Custom Date Selection)
- Client
- Invoice Status (Paid, Unpaid, Partially Paid)
- Salesperson
-
Department~~ (Freight, Clearing, Warehousing, etc.).~~ since we do not have a department, list the Service (ocean import, ocean export, air import, air export, sea clearing, Air clearing, etc.) here. - VAT Type (Standard, Zero-Rated, Exempt)
- Users should be able to filter the report by:
-
Report Header:
- Company Name, Logo, Address, Contact Info, VAT Registration Number
- Report Title: "Sales Report (VAT)"
- Reporting Period (clearly stated From - To dates)
-
Fields:
- Invoice Date: The date the invoice was generated.
- Invoice #: Unique Invoice Reference.
- VAT #: VAT Registration or reference number related to client(if applicable).
- Client BRN: Business Registration Number of the client.
- Client Name: Clearly identifies customer: Code + Name.
- FC Used: Foreign currency used for the transaction (e.g., MUR, USD).
- FC Rate: Exchange rate applied for the foreign currency.
- Invoice Amount FC: Total invoice amount in Foreign Currency.
- Zero Rated, Exempted, Taxable: Clearly separated amounts per VAT classification.
- VAT Amount: VAT amount calculated per invoice.
- Invoice Amount (MUR): Invoice amount in local currency.
- Invoice Status: (Paid, Unpaid, Partially Paid)
- Salesperson: Salesperson responsible for the sale/invoice.
- Department: Clearly shows operational division (Freight, Clearing, Warehousing).
- Description/Job Ref: MBL number/HBL number or BOE number/s in case of clearing.
-
Formatting and readability:
- Clearly aligned numeric columns for easy readability.
- Amounts formatted clearly to two decimal points.
-
Permissions & Access Control
- Only authorised users (e.g., finance team, management) should have access to generate this report.
-
Footer
- Page numbering (Page X of Y)
- Printed by <user>
- Report generation Date & Time
-
Error Handling & Notifications
-
If no data is available for the selected date range, display a message:
"No data found for the selected period."
-
If the report fails to generate, log an error and notify the user.
-
-
Report Contents
The report should include the columns as per the samples given below:

{width="779" height="551"}
{width="662" height="399"}
Proposed Format:
|
# |
Invoice Date |
Invoice # |
Client VAT # |
Client BRN |
Client Name |
Department |
Salesperson |
Description/Job Ref |
FC Used |
FC Rate |
Invoice Amount FC |
Zero Rated |
Exempted |
Taxable | Invoice Amount (MUR) | VAT Amount | Invoice Status |
| 1 | 07/03/2024 | INV12452 | VAT123 | C06041409 | AC001 -ABC Ltd | Clearing | John Doe | 7202405272 | USD | 45.12 | 1,000.00 | 500 | 0 | 500 | 45,120.00 | 75 | Paid |
| 2 | 08/03/2024 | INV12453 | VAT124 | C07014066 | XY001- XYZ Ltd | Freight | Jane Smith | 7202403187 | MUR | 1 | 2,000.00 | 0 | 1,000.00 | 1,000.00 | 2,150.00 | 150 | Unpaid |
| ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ... |
|
Total |
XX,XXX.XX |
XX,XXX.XX |
|||||||||||||||
GitLab Sync Log
[{"id": "20171", "author": "Waliyuddin Delba", "hours": 4.0, "created": "2025-04-08T07:46:51.939Z", "log_date": "2025-04-07", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-04-08T07:46:51.939Z: 4h-(4.0)h spend at: 2025-04-07", "status": "active", "deleted_by": "", "redmine_entry_id": 8925}, {"id": "20118", "author": "Waliyuddin Delba", "hours": 4.0, "created": "2025-04-07T10:53:39.723Z", "log_date": "2025-04-06", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-04-07T10:53:39.723Z: 4h-(4.0)h spend at: 2025-04-06", "status": "active", "deleted_by": "", "redmine_entry_id": 8926}, {"id": "19799", "author": "Waliyuddin Delba", "hours": 3.0, "created": "2025-03-31T12:00:21.334Z", "log_date": "2025-03-30", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-03-31T12:00:21.334Z: 3h-(3.0)h spend at: 2025-03-30", "status": "active", "deleted_by": "", "redmine_entry_id": 8927}, {"id": "19761", "author": "Waliyuddin Delba", "hours": 4.0, "created": "2025-03-31T09:46:33.750Z", "log_date": "2025-03-30", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-03-31T09:46:33.750Z: 4h-(4.0)h spend at: 2025-03-30", "status": "active", "deleted_by": "", "redmine_entry_id": 8928}, {"id": "19615", "author": "Waliyuddin Delba", "hours": 3.0, "created": "2025-03-27T10:33:21.943Z", "log_date": "2025-03-26", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-03-27T10:33:21.943Z: 3h-(3.0)h spend at: 2025-03-26", "status": "active", "deleted_by": "", "redmine_entry_id": 8929}, {"id": "19440", "author": "Waliyuddin Delba", "hours": 2.0, "created": "2025-03-26T05:16:20.607Z", "log_date": "2025-03-25", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-03-26T05:16:20.607Z: 2h-(2.0)h spend at: 2025-03-25", "status": "active", "deleted_by": "", "redmine_entry_id": 8930}, {"id": "28307", "author": "Waliyuddin Delba", "hours": 2.0, "created": "2025-08-15T05:34:06.708Z", "log_date": "2025-08-13", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-08-15T05:34:06.708Z: 2h-(2.0)h spend at: 2025-08-13", "status": "active", "deleted_by": "", "redmine_entry_id": 10226}, {"id": "28238", "author": "Waliyuddin Delba", "hours": 1.0, "created": "2025-08-14T05:35:17.391Z", "log_date": "2025-08-12", "comment": "Imported from GitLab by @Waliyuddin Delba on 2025-08-14T05:35:17.391Z: 1h-(1.0)h spend at: 2025-08-12", "status": "active", "deleted_by": "", "redmine_entry_id": 10227}]