| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 107 |
| Technical Name |
employee_service |
| License | OPL-1 |
| Website | https://www.ganemo.co |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Employees (hr)
• Discuss (mail) |
| Lines of code | 107 |
| Technical Name |
employee_service |
| License | OPL-1 |
| Website | https://www.ganemo.co |
Employee Service
Automated Tenure & Duration Tracking
Simplify HR management by automatically calculating employee service duration, managing hire dates from contracts, and tracking termination history.
What We're Solving
----------------
Automated Calculations
Stop calculating seniority manually. The system automatically computes Years, Months, and Days of service based on the start date and contract end date (or today). Perfect for benefits and vacation allocation.
Precise Dates
Hire dates are automatically derived from the Oldest Active Version of the contract. This ensures that your HR records are always in sync with your contract history without manual data entry.
Setup & User Manual
Complete Implementation Guide
1. Configuration & Logic
Understanding how dates are calculated is key to using this module effectively:
hr.version records.
A. Hire Date Logic (Read-Only)
- Source: The
system scans all
version_idslinked to the employee. - Filter: It
ignores any version where
active=False(Archived). - Selection: It picks the version with the oldest Start Date.
- Result: This date becomes the Hire Date and cannot be manually edited to prevent data inconsistency.
B. Start Date Logic (Editable)
- Definition: The actual first day of work (for accruals).
- Auto-Fill Trick: If you are creating a new employee and adding their first version/contract, the system will automatically copy the Hire Date to the Start Date for you.
- Note: Since the Hire Date is read-only, this copy triggers mainly when contract history is updated "on the fly" or during initial creation.
2. Operating Manual (Workflow)
Day-to-day usage for HR Officers:
New Hire
1. Create Employee.
2. Go to Contracts/Versions.
3. Create the first version (e.g., Start: Jan 1st).
4. Return to Profile -> Service Info.
Result: Hire Date = Jan 1st.
Correction
Wrong Hire Date?
Don't try to edit the field directly. Go to the Contract Versions history.
Correct the Start Date of the first contract there. The profile updates
automatically.
Termination
When an employee leaves:
1. Set the End Date in the Contract/Version.
2. The "Service Duration" counter uses that date automatically.
Global Ready | Multi-Language Support
This module is fully translated into English and Spanish (en_US, es_ES, es_PE, es_MX), ensuring a professional experience for international organizations.
Why Choose Ganemo?
----------------
Ganemo is the world's leading Odoo App developer and a multi-award-winning Gold Partner. For over 5 years, we have been recognized as the #1 seller of high-quality apps on the Odoo App Store. Trusted as the "Best Partner" in USA, Mexico, Chile, Spain, Colombia, Ecuador, and Peru, we deliver robust, secure, and localization-compliant solutions for global businesses.
Get a Quote & Resolve Commercial Doubts
Join thousands of satisfied clients on Odoo. Contact our sales team directly.
Official WhatsApp
Fastest response time.
LINK
+1 (828) 672-6150
Book a Demo
Let's explore your needs.
LINK
Schedule Meeting
Need More? We Do It All
Professional Odoo Services
ERP Implementation
Transform your business with a full Odoo implementation. We analyze, configure, and train your team to maximize productivity. From Accounting to Inventory, we handle the complexity so you can focus on growth.
Module Dev & Migration
Need a custom feature? Or stuck on an older version? We develop high-performance custom modules and migrate your existing code to Odoo 19 with zero data loss. Expert developers at your service.
QA / User Testing Scenarios
Enterprise Validation Plan
Scenario 1: Hire Date Automation (Basic)
- Create a new Employee "John Doe".
- Create a Version (Contract) starting on 01/01/2020.
- Go to the Service Information tab.
- PASS Criteria: 'Hire Date' must automatically show '01/01/2020'.
Scenario 2: Archived Versions Handling
- Add an older version (e.g., 2010), but set it to Archived (Active=False).
- Keep the active version from 2020.
- Refresh the employee profile.
- PASS Criteria: Hire Date should REMAIN '01/01/2020'. It must IGNORE the 2010 archived record.
Scenario 3: Complex Duration Calculation
- Set 'Start Date' to exactly 1 year and 1 month ago from today.
- Ensure the Contract has no End Date (Active).
- PASS Criteria: Service Duration should read "1 year(s) 1 month(s) 0 day(s)" (allowing for minimal day variance depending on months).
Scenario 4: Read-Only Integrity
- Try to click on the 'Hire Date' field to edit it manually.
- PASS Criteria: The field should be non-editable (Read-Only). This confirms that integrity protection is active.
FAQ & Troubleshooting
Common Resolutions
Why can't I edit the Hire Date manually?
Reason: The system enforces a single source of truth: your Contract/Version history. Allowing manual edits would cause discrepancies between HR records and Contract records.
Fix: Correct
the date in the underlying hr.version (contract) record.
Hire Date copied to Start Date automatically?
Context: Using the "Smart Onchange" feature.
When you edit an employee's version list (if editable inline) and the Hire Date changes, the system assumes the Start Date is the same only if Start Date was empty. It prevents double data entry.
Does it support Archived versions?
Answer: No. The system intentionally ignores archived versions.
This is by design to prevent old, invalid, or draft testing data from affecting the official seniority calculation.
What if 'version_ids' doesn't exist?
Dependency Check: This module is designed for
Odoo 19+ environments where hr.version is the standard for contract
history. Ensure your Odoo instance is up to date.
Commercial & Sales
For inquiries about licenses, demos, or partnerships.
Official WhatsApp
Fastest response time.
LINK
+1 (828) 672-6150
Book a Demo
Let's explore your needs.
LINK
Technical Support
Existing customers regarding module functionality.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module