Skip to main content
Taiwan HR & Payroll — A build-to-order Odoo localization for Taiwanese payroll that handles labor and health insurance contri — 1/1Illustrative preview

A build-to-order Odoo localization for Taiwanese payroll that handles labor and health insurance contributions,

income-tax withholding, labor pension, and TWD salary structures.

ECOSIRE builds, installs, and supports it after you request a quotation.

What is Taiwan HR & Payroll?

A build-to-order Odoo localization for Taiwanese payroll that handles labor and health insurance contributions, income-tax withholding, labor pension, and TWD salary structures. ECOSIRE builds, installs, and supports it after you request a quotation. Built to order by ECOSIRE for Odoo 17, 18, 19 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

Labor Insurance (勞保) contribution calculation from the bracketed insured-salary grade table, with the correct employer / employee / government split as `hr.salary.rule` records
National Health Insurance (健保) premium computation including dependent-based supplementary premium logic driven by `@api.depends` computed fields
6% Labor Pension (勞退) employer contribution posted as a distinct payslip line, with optional employee voluntary contribution
Income-tax withholding lines applied per Taiwan withholding rules within the TWD salary structure
TWD-denominated salary structure and structure type seeded as installable data, wired to Taiwan-specific `hr.salary.rule.category` categories
Configurable insured-salary grade tables and contribution rates stored as editable model records — update brackets when the government revises them, no code change
Taiwan HR fields added to `hr.employee` via model inheritance: national ID / ARC number, insured-salary grade, enrolment dates, dependent count
QWeb statutory reports: monthly Labor/Health Insurance schedules and income-tax withholding summaries for authority submission
Access control via `ir.model.access.csv` plus record rules restricting payroll and insurance data to HR Officer / Manager groups
Automated actions to flag grade or rate mismatches and prompt re-enrolment when an employee's insured salary crosses a bracket
Batch payslip runs (`hr.payslip.run`) that resolve all statutory lines automatically from Python rule logic
XML-RPC / JSON-RPC exposure of the new models and fields for integration with attendance, time-off, or external HR systems
Rounding and proration handling for mid-month hires, leavers, and grade changes consistent with statutory calculation conventions
Compatible across Odoo 17.0 / 18.0 / 19.0 on Community and Enterprise, with edition-appropriate payroll wiring

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your Odoo.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

Odoo Compatibility
Odoo 17, Odoo 18, Odoo 19
Editions
Enterprise & Community
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
PostgreSQL 12+

About this Product

Taiwanese employers running Odoo hit a wall the moment payroll needs to reflect local reality. Odoo Community ships no payroll engine at all, and Odoo Enterprise hr_payroll provides only a generic rule engine with a handful of country localizations — Taiwan is not one of them. That leaves HR teams hand-calculating Labor Insurance (勞保) and National Health Insurance (健保) contributions off the bracketed insured-salary tables, tracking the employer/employee/government split, computing the 6% Labor Pension (勞退) employer contribution, and applying income-tax withholding rules in spreadsheets — then keying results back into Odoo. It is slow, error-prone, and impossible to audit cleanly at month-end.

This build-to-order module extends Odoo's native HR and payroll framework with a Taiwan-specific localization layer rather than replacing it. We ship a proper Odoo app: a __manifest__.py declaring dependencies on hr and hr_payroll, new models.Model classes for the insured-salary grade tables, contribution-rate configuration, and pension records, plus computed fields using @api.depends so that changing an employee's insured-salary grade or department instantly recalculates the employer and employee portions. Salary rules are seeded as data records (hr.salary.rule / hr.salary.rule.category) wired into a TWD-denominated salary structure, so a payslip run resolves Labor Insurance, Health Insurance, labor pension, and income-tax withholding lines automatically from Python rule logic — no manual formulas.

Technically, the module adds Taiwan-specific HR fields (national ID / ARC number, insured-salary grade, dependents for NHI supplementary premium, hire and enrolment dates) to hr.employee via inheritance, guarded by ir.model.access.csv and record rules so payroll data stays scoped to HR and payroll roles. Views are delivered as XML (with OWL components where an interactive widget helps), and month-end statutory outputs — insurance schedules and withholding summaries — are produced as QWeb reports you can hand to the Bureau of Labor Insurance, NHI Administration, and tax authority. Contribution-rate and insured-salary tables are configuration data, so when the government revises the brackets you update records instead of editing code. Everything is reachable over Odoo's XML-RPC / JSON-RPC API for integration with attendance, time-off, or an external HR system.

Because this is build-to-order, you are not downloading a fixed listing from apps.odoo.com. After a short scoping call we confirm exact requirements — your entities, pay cadence, allowances, and which Odoo version and edition you run — and then build, test, and install the module for you. Typical delivery is one working week from confirmed scope. We support Odoo 17.0, 18.0, and 19.0, on Community or Enterprise, and hand over the full source and git repository at go-live.

What you get

  • Installable Odoo module source code targeting your exact Odoo version (17.0 / 18.0 / 19.0) and edition
  • Installation and configuration on your environment, including seeded insured-salary and contribution-rate tables
  • Technical documentation: model/field reference, salary-rule logic, and configuration notes
  • End-user guide plus a live training session for your HR/payroll team
  • UAT on a staging database with a documented rollback plan before production cutover
  • Post-go-live support window for defect fixes and configuration questions
  • Git repository handover with full commit history and versioned source
  • Statutory report templates (QWeb) for insurance schedules and withholding summaries

Who this is for

HR & Payroll Manager

Owns monthly payroll accuracy and statutory compliance. Needs Labor Insurance, NHI, labor pension, and withholding computed automatically inside Odoo so month-end runs are auditable instead of spreadsheet-driven.

Finance Controller

Cares about correct employer contribution costs, GL posting, and defensible audit trails. Wants payroll statutory lines reconciled and reportable directly from Odoo in TWD.

Odoo Administrator / IT Lead

Maintains the Odoo deployment and integrations. Needs a cleanly packaged module with proper access rules, upgrade-safe inheritance, and XML-RPC/JSON-RPC access rather than core patches.

Operations Director at an SME

Runs a growing Taiwanese company on Odoo and wants to stop outsourcing payroll calculations, bringing statutory processing in-house without hiring a specialist.

How Taiwan HR & Payroll Compares

CriterionECOSIRECustom BuildCompetitorOdoo Native
Taiwan statutory coverageLabor & health insurance, labor pension, and withholding built to Taiwan rulesWhatever you specify and can validate yourselfRarely covers Taiwan specifically; often genericNo Taiwan localization; generic rule engine only
Payroll engine on CommunityScoped and delivered as part of the buildYou must build it from scratchUsually Enterprise-onlyCommunity ships no payroll engine at all
Fit to your entities & pay cadenceConfirmed in scoping call, built to matchFull control but full effortFixed listing, limited configurabilityManual configuration, no local rules
Statutory reports (insurance/withholding)QWeb reports for authority submission includedBuilt only if you spec and pay for themVaries; often absent or partialNone for Taiwan
Rate/bracket maintenanceEditable config records you can update yourselfDepends on how it was builtMay require vendor update or re-purchaseN/A — no tables provided
Support & handoverPost-go-live window plus full git repo handoverTied to your developer's availabilityTicket queue, no source accessCommunity forums only
Upgrade safetyInheritance-based, no core patchesDepends on developer disciplineVaries by vendor qualityNot applicable — no module
Time to valueone working week from confirmed scopeMonths of build and testingInstant install but needs heavy local reworkImmediate but non-compliant for Taiwan

Frequently Asked Questions about Taiwan HR & Payroll

Is this an existing app I can download and install right now?

No. This is a build-to-order localization. ECOSIRE builds, tests, and installs it for your specific Odoo version and requirements after you request a quotation and we confirm scope — there is no instant download.

How long does delivery take?

Typical delivery is one working week from confirmed scope. The exact timeline depends on the complexity of your entities, allowances, and any integrations, which we agree on during the scoping call before work begins.

How are updates and support handled after go-live?

Every engagement includes a post-go-live support window for defect fixes and configuration questions, and we hand over the full git repository. Because the insured-salary and contribution-rate tables are editable configuration data, you can update statutory brackets yourself; for engine or version-upgrade changes we offer ongoing support arrangements.

Does it work with Odoo Community or only Enterprise?

We support both. Odoo Community has no native payroll engine, so for Community deployments we scope the payroll foundation as part of the build; on Enterprise we extend the existing `hr_payroll` framework. We support Odoo 17.0, 18.0, and 19.0.

What happens when the government revises insurance brackets or rates?

The insured-salary grade tables and contribution rates are stored as editable model records, not hard-coded. When the Bureau of Labor Insurance or NHI Administration revises the tables, you update the configuration records and future payslips pick up the new values — no code change required.

Will it modify Odoo core or conflict with future upgrades?

No. The module uses standard Odoo inheritance to extend `hr.employee` and adds its own models and salary rules. Core files are never patched, which keeps your deployment upgrade-safe across Odoo versions.

Can it integrate with our attendance and time-off data?

Yes. The new models and fields are exposed over Odoo's XML-RPC / JSON-RPC API and the salary rules can read worked days and leave from Odoo's attendance and time-off modules, so payroll draws from a single source of truth.

Request a quote

Taiwan HR & Payroll

A build-to-order Odoo localization for Taiwanese payroll that handles labor and health insurance contributions, income-tax withholding, labor pension, and TWD salary structures. ECOSIRE builds, installs, and supports it after you request a quotation.

  • Labor Insurance (勞保) contribution calculation from the bracketed insured-salary grade table, with the correct employer / employee / government split as `hr.salary.rule` records
  • National Health Insurance (健保) premium computation including dependent-based supplementary premium logic driven by `@api.depends` computed fields
  • 6% Labor Pension (勞退) employer contribution posted as a distinct payslip line, with optional employee voluntary contribution
  • Income-tax withholding lines applied per Taiwan withholding rules within the TWD salary structure

Request a Quotation

Tell us about your Taiwan HR & Payroll requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.