Module Installation Screen

This screen shows the Odoo Apps page where you can install the Saudi End of Service Reward module. The module appears in the list of available applications with its icon and name "Saudi End of Service Reward (Enhanced)". To install the module:

• Navigate to the Apps menu from the main Odoo dashboard
• Search for "saudi_eos" in the search box or browse through the available apps
• Click on the "ACTIVATE" button to install the module
• The module will be installed and integrated with your existing Odoo 13 installation

After installation, the module will add new menu items, models, and functionality to manage End of Service processes according to Saudi Labor Law.

Module Configuration Settings

This screen shows the configuration settings for the Saudi End of Service Reward module. Here you can set up the accounting integration and automation options:

• Auto Archive Employee on EoS Payment: When enabled, automatically archives the employee record when the EoS payment is completed
• Auto Cancel Contract on EoS Payment: When enabled, automatically cancels the employee's contract when the EoS payment is completed
• EoS Expense Account: Default expense account for EoS journal entries
• EoS Payment Journal: Default payment journal (Bank/Cash) for EoS payments
• EoS Expense Journal: Default journal (e.g., Miscellaneous) for EoS expense entries

To access these settings:

• Navigate to Settings → Human Resources
• Scroll down to the "Saudi End of Service Reward Configuration" section
• Configure the desired options
• Click Save to apply the changes

Proper configuration of these settings is essential for the accounting integration to work correctly.

Creating a New EoS Request

This screen shows the form for creating a new End of Service request. The form is divided into several sections:

• Employee Contract: Select the employee and their contract
• Termination Details: Specify termination date and reason
• EoS Reward Calculation: View the calculated reward amount based on service duration and termination reason
• Leave Balance Payment: Option to include remaining leave days payout
• Last Payslip Payment: Option to include the employee's last payslip
• Total Payable: The total amount to be paid to the employee

To create a new EoS request:

• Navigate to Employees → End of Service → EoS Requests
• Click the "New" button
• Fill in the required information
• The system automatically calculates the service duration (years, months, days) and the EoS reward amount
• Click "Submit" to start the approval workflow

The EoS reward calculation follows Saudi Labor Law, taking into account the service duration and termination reason.

EoS Request Details

This screen shows a submitted End of Service request with all details filled in. The form displays:

• Request Reference: Unique identifier (e.g., EOS/2025/00001)
• Employee Information: Name, contract, department, position, company
• Termination Details: Hire date, request date, termination date, termination reason
• Service Duration: Calculated years, months, and days of service
• EoS Calculation: Last wage basis and calculated EoS reward amount
• Additional Payments: Options for leave balance and last payslip inclusion
• Total Payable Amount: Sum of all payments to be made

The request status is shown in the status bar at the top of the form (Draft, Submitted, HR Approved, Accountant Approved, Paid). The available action buttons change based on the current status and the user's role.

In this example:

• The request is for an employee with over 14 years of service
• The termination reason is "End of Contract Period" (100% calculation factor)
• The EoS reward amount is calculated based on the last wage (3,750.00 SR) and service duration
• The last payslip payment option is selected
• The total payable amount is 45,399.00 SR

HR Manager Approval Stage

This screen shows an EoS request at the HR Manager approval stage. Key elements of this screen include:

• Status Bar: Shows the current status as "SUBMITTED" with "HR APPROVE" as the next action
• HR Approve Button: Available for users with EoS HR Manager rights
• Request Details: All employee and termination information
• Activity Panel: Shows a planned activity for the HR Manager to approve the request
• Chatter: Displays the history of status changes and notifications

At this stage:

• The request has been submitted by an HR Officer
• The HR Manager receives a notification and activity to review and approve the request
• The HR Manager can review all details, including the calculated EoS amount
• The HR Manager can approve the request by clicking the "HR Approve" button
• Alternatively, they can cancel the request or request changes by adding notes in the chatter

Once the HR Manager approves the request, it moves to the next stage (Accountant Approval) and notifications are sent to the relevant Accountant users.

Payment Registration Stage

This screen shows an EoS request at the Payment Registration stage. Key elements of this screen include:

• Status Bar: Shows the current status as "ACCOUNTANT APPROVED" with "REGISTER PAYMENT" as the next action
• Register Payment Button: Available for users with EoS Accountant rights
• Request Details: All employee, termination, and calculation information
• Generated Entries: Shows the created expense journal entry (MISC/2029/08/0001)
• Activity Panel: Shows a planned activity for the Accountant to register the payment
• Chatter: Displays the history of status changes and notifications

At this stage:

• The request has been approved by the Accountant
• The expense journal entry has been created and posted
• The Accountant receives a notification and activity to register the payment
• When the Accountant clicks "Register Payment", a payment form opens
• After completing the payment, the request status changes to "Paid"
• If configured, the system automatically archives the employee and/or cancels their contract

The journal entry details show that the expense has been recorded, and the payment will settle the liability to the employee.

EoS Requests List View

This screen shows the list view of all End of Service requests. Key elements of this view include:

• Request Reference: Unique identifier for each request
• Employee: Name of the employee
• Termination Date: Date when the employment ends
• Termination Reason: Reason for the termination
• Service Years: Calculated years of service
• EoS Amount: Calculated End of Service reward
• Total Amount: Total payable amount (including any additional payments)
• Status: Current status of the request (Draft, Submitted, HR Approved, etc.)
• Company: The company the employee belongs to

This view allows you to:

• See all EoS requests at a glance
• Filter requests by status, employee, date, or other criteria
• Sort requests by any column
• Create new requests
• Access detailed views by clicking on a specific request

The list view is particularly useful for HR managers and accountants who need to monitor and process multiple EoS requests.

Journal Entries View

This screen shows the journal entries created by the End of Service module. Key elements of this view include:

• Journal Entry Reference: Unique identifier for each entry
• Date: Date of the journal entry
• Journal: The journal used (e.g., Miscellaneous Operations)
• Partner: The employee's linked partner
• Reference: Reference to the EoS request
• Status: Current status of the journal entry (Posted)
• Total: Total amount of the entry

When an EoS request is approved by the Accountant, the system automatically creates:

• Expense Journal Entry: Debits the EoS expense account and credits the employee's payable account
• Payment Entry: Created when the payment is registered, debits the employee's payable account and credits the bank/cash account

These entries ensure that:

• The EoS expense is properly recorded in the accounting system
• The liability to the employee is recognized
• The payment is properly recorded when processed

The accounting integration is a key feature of the module, ensuring that all financial aspects of the End of Service process are properly managed.