| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Lines of code | 1065 |
| Technical Name |
l10n_hk_payroll |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Employees (hr) |
| Lines of code | 1065 |
| Technical Name |
l10n_hk_payroll |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
Hong Kong Payroll for Odoo
MPF contributions, 713-rule holiday & leave pay, end-of-year payment, IR56B return
Run statutory and contractual Hong Kong payroll directly in Odoo. This module computes MPF mandatory contributions, Employment Ordinance average-wage pay (statutory holiday, annual leave and sickness allowance), the end-of-year payment and an informational salaries-tax estimate for each employee, produces a payroll register (CSV and Excel) and builds the IR56B employer's-return data file. It is built on the Human Resources app and carries its own payslip and computation models, so it needs no Enterprise payroll. Compatible with Odoo 18 and Odoo 19, Community and Enterprise.
MPF mandatory contributions
5% employee and 5% employer of relevant income, with the minimum (HK$7,100) and maximum (HK$30,000) relevant-income levels: below the minimum the employee does not contribute but the employer still does, and both sides are capped at the maximum. Exempt persons (first 60 days, under 18 / over 65) are supported.
713 average-wage pay
Statutory holiday pay, annual leave pay and sickness allowance (4/5 of average daily wages) computed on the 12-month average daily wages under the Employment Ordinance, with the annual-leave entitlement derived from completed years of service.
Salaries-tax estimate (no withholding)
Hong Kong has no PAYE withholding, so the module shows an informational annual salaries-tax estimate — the lower of the progressive bands and the two-tiered standard rate — that is never deducted from net pay. The band scale is a fully editable model.
HKID validation
The employee HKID field is validated with the genuine weighted modulo-11 check-digit algorithm (e.g. A123456(3)), so mistyped identity cards are caught before payroll and the IR56B return are produced.
Payroll runs, register & IR56B
Populate employees, compute relevant income, MPF and net pay in one click, review run totals, and export a CSV or Excel payroll register. An IR56B employer's-return wizard aggregates a year of runs into the per-employee data file (BIR56A / IR56B, due around 1 May) ready for the IRD's Employer's Return e-Filing.
BYOK-friendly: the module produces the statutory figures, register and IR56B data locally; you file them through the IRD e-Filing and your MPF trustee / eMPF with your own credentials. No employee data leaves Odoo.
Disclosure: this module computes contributions and entitlements locally and produces register / return files; it does not transmit any data to a third party. All rates, levels and bands carry the current statutory defaults; confirm them against the latest official MPFA and IRD guidance before running live payroll.
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