| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Community Apps Dependencies | Show |
| Lines of code | 4083 |
| Technical Name |
eh_hero_country_uk |
| License | OPL-1 |
| Website | https://www.erpheritage.com.au/ |
| Versions | 16.0 17.0 18.0 19.0 |
Employment Hero UK Country Pack
Adds the UK statutory employee fields and registers the United Kingdom profile so the Employment Hero sync engine can land National Insurance, PAYE and student loan data in standard Odoo HR.
Store price is USD 175 all-in: installing this also pulls the 4 paid ERP Heritage modules it depends on.
Why this module
Employment Hero UK Country Pack
Just the UK fields, done right
Adds National Insurance number, PAYE tax code and student loan plan to hr.employee, with the two sensitive identifiers restricted to HR users. No bloat, no Enterprise dependency.
Registers the UK profile
Creates the United Kingdom country profile in the connector registry, so the shared sync engine and any deployment can see the localisation is installed and active.
Mappings you can adjust
Ships pull field mappings for the three UK fields as data. Source paths are sensible defaults you tune from the interface to match your Employment Hero payload, no code required.
Day in the life
A UK employee record stays current
An Employment Hero pull job runs against your employees endpoint. The sync engine resolves each record by its external id, applies the base mapping plus the three UK mapping lines this pack adds, and writes the National Insurance number, PAYE tax code and student loan plan onto the matching hr.employee. The two sensitive identifiers are visible only to HR users on the Employment Hero (United Kingdom) group under HR Settings. Re-running the job does not duplicate anything, because the engine remembers each record's external id and source timestamp.
Edge cases
The cases most modules quietly ignore.
In the shipped code today, each one a place where a cheaper module silently does the wrong thing.
The sync engine this pack feeds keys every record by external id with a payload hash, so a re-run or a webhook redelivery updates in place and never creates a duplicate UK employee.
A mapping line is skippable when the source value is absent, so an employee missing a National Insurance number in the payload stays valid instead of clearing or failing the field.
Per-record savepoint isolation in the engine means one malformed UK record is logged as an error line while the rest of the batch still imports.
National Insurance number and PAYE tax code carry an HR-user group, so they are not readable or writable by ordinary internal users, on the form or via the ORM.
Default source paths assume a conventional Employment Hero shape; if yours differs the mapping lines are editable from the interface, with no module change needed.
The UK mappings are pull direction, so UK identifiers flow inbound from Employment Hero and are not pushed back out by this pack.
What is inside
Built to do the job, end to end.
- Three employee fields. eh_ni_number and eh_paye_tax_code restricted to hr.group_hr_user, plus eh_student_loan_plan, all added to hr.employee and surfaced in a dedicated group on the HR Settings page.
- UK country profile. One eh.country.profile record for base.uk with code UK and a display sequence, registering the localisation in the connector's country registry.
- Pull field mappings. Three eh.mapping.line records extending the base employee mapping, mapping the National Insurance, PAYE and student loan source paths to the new fields, shipped noupdate so your tuning survives upgrades.
- Form view extension. An Employment Hero (United Kingdom) group injected into the standard employee form under the HR Settings page, so the UK data has a clear, native home.
- Tests included. Unit tests assert the UK country profile installs correctly and the National Insurance field is present on hr.employee.
Honest about the edges
What this does not do, so nothing surprises you.
- This is a localisation layer, not a standalone integration. It requires the Employment Hero country base and HR modules, which in turn require the sync engine and base connector. Install the suite, not this pack alone.
- The field mappings are pull direction only. This pack does not push UK identifiers from Odoo back to Employment Hero.
- Default mapping source paths are sensible assumptions about the Employment Hero payload, not a guarantee. Verify and tune them against your own data before relying on a production sync.
- It adds employee data fields and a country profile only. It does not compute PAYE, National Insurance or student loan deductions, and it is not a UK payroll engine.
- Webhook handling, retry, conflict resolution and rate limiting are provided by the underlying engine modules, not by this country pack.
Employment Hero UK, Odoo 16 UK payroll integration, National Insurance number Odoo, PAYE tax code Odoo HR, student loan plan Odoo, UK employee localisation Odoo, Employment Hero connector country pack, hr.employee UK fields, Odoo Community HR sync, HMRC PAYE Odoo
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