Skip to main content
Japan Payroll & Employee Profile — A Japan-localized payroll and employee-profile module for Odoo 17/18/19 that handles socia — 1/1Illustrative preview

A Japan-localized payroll and employee-profile module for Odoo 17/18/19 that handles social insurance,

income withholding tax, resident tax and JPY salary structures.

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

What is Japan Payroll & Employee Profile?

A Japan-localized payroll and employee-profile module for Odoo 17/18/19 that handles social insurance, income withholding tax, resident tax and JPY 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

Social-insurance premium calculation (健康保険 health + 厚生年金 pension) from configurable rate tables keyed to the standard remuneration grade (標準報酬月額), with employer/employee split
Long-term care insurance (介護保険) auto-enabled for employees aged 40+ via a compute field with @api.depends on date of birth
Income withholding tax (源泉徴収) computed against 甲/乙 monthly tax tables driven by dependent count and social-insurance deductions
Resident tax (住民税) special-collection handling with a per-employee, per-municipality monthly amount schedule
JPY salary structures built as hr.salary.rule records in a dedicated Japan hr.payroll.structure, fully auditable gross-to-net
hr.employee extended with Japan profile fields: myNumber (access-restricted), insurance/pension enrollment numbers, grade, dependents, municipality
Configurable annual rate tables stored as ORM records so fiscal-year rate changes need no code redeploy
QWeb PDF Japanese payslip (給与明細) plus monthly social-insurance and withholding summary reports
Zengin (全銀) bank-transfer file fields on the employee record for salary payment export
ir.model.access.csv + record rules restricting myNumber and salary visibility to authorized HR/payroll roles only
Automated action to generate the monthly payroll run and flag employees due for annual 定時決定 grade review
XML/OWL form and list views for payroll runs and payslips, localized labels in Japanese
XML-RPC / JSON-RPC endpoints so attendance/accounting systems can push hours and pull net-pay figures
Community-safe payroll base included when you are not on Odoo Enterprise hr_payroll, with graceful edition detection in __manifest__.py

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

Japanese SMEs running Odoo hit a wall the moment they try to run a real payroll cycle. Odoo Community ships no payroll engine at all, and even Enterprise hr_payroll has no Japan localization: no 健康保険 / 厚生年金 (health insurance / employee pension) tables keyed to the monthly standard remuneration grade (標準報酬月額), no 源泉徴収 income-withholding logic tied to the 甲/乙 tax tables and number of dependents, and no 住民税 (resident tax) special-collection handling where each employee's municipality sends a different monthly amount. Teams end up maintaining a parallel Excel workbook, re-keying figures into Odoo journal entries, and reconciling by hand every month — which is exactly where errors and late 納付 payments come from.

ECOSIRE builds a dedicated Japan payroll and employee-profile module on top of Odoo's HR framework. On the data side we extend hr.employee with the Japan-specific profile fields your payroll actually depends on — myNumber (individual number) stored with restricted access, health-insurance and pension enrollment numbers, standard remuneration grade, dependent count for tax and for insurance, resident-tax municipality, and bank details in the format your zengin (全銀) transfer file needs. Salary structures are modeled as Odoo hr.salary.rule records grouped into a Japan hr.payroll.structure, so gross-to-net is computed by real, auditable rules rather than a spreadsheet. Social-insurance premiums are computed from configurable rate tables (models.Model records you can update each fiscal year without a code change) against the standard remuneration grade, with the employer/employee split, and with 40-and-over long-term care insurance (介護保険) switched on by a compute field driven by date of birth via @api.depends.

Technically it is a clean Odoo addon: an __manifest__.py declaring dependencies on hr (and hr_payroll on Enterprise, or a Community-safe payroll base we include when you are not on Enterprise), models under models/ with fields and computed methods, XML/OWL form and list views for the payroll run and payslip, and QWeb PDF reports for the Japanese payslip (給与明細) and the monthly social-insurance and withholding summaries your accountant needs. Access is locked down with ir.model.access.csv plus record rules so that myNumber and salary data are visible only to authorized HR/payroll roles. Automated actions can generate the monthly payroll run and flag employees whose grade needs the annual 定時決定 (regular determination) review. Everything is reachable over Odoo's XML-RPC / JSON-RPC API, so an existing accounting or attendance system can push hours and pull net-pay figures.

Because this is build-to-order, nothing is a black box you download and hope fits. You request a quotation, we run a short scoping call to confirm your rate tables, pay calendar, allowances and which Odoo version (17.0, 18.0 or 19.0) and edition you run, then we build the module to that scope, test it on a staging copy of your database with your own employees, and hand over installable source plus a git repository. Typical delivery is one working week from confirmed scope, and every engagement includes UAT sign-off, training, and a post-go-live support window so your first live payroll run is one we run beside you.

What you get

  • Installable Odoo module source code built for your exact version (17.0, 18.0 or 19.0) and edition (Community or Enterprise)
  • Installation and configuration on your environment, including rate tables, pay calendar and salary structures set to your figures
  • Technical documentation: model/field reference, salary-rule logic, security matrix (access CSV + record rules), and rate-table update procedure
  • End-user guide plus a live training session for your HR/payroll team
  • UAT on a staging copy of your database with your own employees, with a documented rollback plan
  • Post-go-live support window covering your first live payroll run and defect fixes
  • Git repository handover with full commit history and tagged release
  • Configuration sheet capturing your social-insurance, withholding and resident-tax settings for future audits

Who this is for

HR/Payroll manager at a Japanese SME

Runs the monthly payroll cycle and is tired of the Odoo-plus-Excel workaround. Needs social insurance, withholding and resident tax computed inside Odoo so figures reconcile automatically and 納付 payments are never late.

Finance controller / accountant

Owns the general ledger and the monthly social-insurance and withholding filings. Needs auditable salary rules and QWeb summary reports that map cleanly to journal entries rather than re-keyed spreadsheet totals.

IT lead / Odoo administrator

Maintains the Odoo instance and integrations. Wants a clean addon with a proper __manifest__.py, sane security via ir.model.access.csv and record rules, and XML-RPC/JSON-RPC access — plus a git repo they can maintain.

Foreign-parent subsidiary in Japan

A branch of an overseas group that must run compliant Japanese payroll locally while feeding net-pay and cost data back to a group system. Needs Japan-localized calculation with API access for consolidation.

How Japan Payroll & Employee Profile Compares

CriterionECOSIRECustom BuildCompetitorOdoo Native
Japan localizationBuilt for Japan: social insurance, withholding & resident taxWhatever you specify and can verifyRarely Japan-specific; mostly generic payrollNone — no Japan payroll logic
Social insurance & grade tablesEditable ORM rate tables keyed to standard remuneration gradeMust be designed and maintained from scratchHardcoded or absent, hard to update yearlyNot modeled at all
Payroll engineSalary rules; Community-safe base if not on EnterpriseYou build the whole engineEnterprise-only or thinCommunity has none; Enterprise hr_payroll un-localized
Data security (myNumber/salary)Access CSV + record rules, documented matrixDepends on your developer's rigorOften default access onlyGeneric HR access, no payroll model
Delivery modelBuild-to-order, one working week, tested on your stagingMonths of in-house dev and QAInstant download, then you fit it yourselfAvailable immediately but incomplete
Reports & filingsQWeb payslip + insurance/withholding summariesReports built per your specGeneric payslip, no JP summariesNo payroll reports
Support & ownershipSupport window, training, git repo handoverYou own and support everythingVendor tickets, limited source accessCommunity/vendor support, no feature
IntegrationsXML-RPC/JSON-RPC scoped to your systemsBuilt if you budget for itVaries, often closedAPIs exist but nothing to integrate

Frequently Asked Questions about Japan Payroll & Employee Profile

How long does delivery take?

This is a build-to-order module, not an instant download. After you request a quotation we run a short scoping call, and typical delivery is one working week from confirmed scope. The exact timeline depends on how many salary rules, allowances and integrations you need, which we lock down before starting.

Which Odoo versions and editions are supported?

We build for Odoo 17.0, 18.0 and 19.0, on both Community and Enterprise. On Enterprise we build on top of hr_payroll; on Community, where there is no payroll engine, we include a Community-safe payroll base so gross-to-net still computes. We confirm your exact version and edition on the scoping call.

How do updates and support work after go-live?

Every engagement includes a post-go-live support window that covers your first live payroll run and any defect fixes. Rate tables (social insurance, withholding, resident tax) are stored as editable ORM records so you can update fiscal-year rates yourself without a code change. Longer-term maintenance and version upgrades are available as a separate support agreement.

Is myNumber and salary data kept secure?

Yes. myNumber and salary fields are protected with ir.model.access.csv access rights plus record rules so only authorized HR/payroll roles can view them. We document the full security matrix in the handover so your team can audit exactly who can see what.

Can it connect to our attendance or accounting system?

Yes. The module is a standard Odoo addon reachable over the XML-RPC and JSON-RPC APIs, so an existing attendance system can push worked hours in and your accounting or group system can pull net-pay and cost figures out. Specific integrations are scoped and quoted with the build.

Do we own the code afterwards?

Yes. You receive the installable source and a git repository with full history and a tagged release. There is no per-seat lock-in on the module itself; you can maintain or extend it, and we remain available for support if you prefer us to.

What do you need from us to start?

Your current rate tables and standard-remuneration grades, pay calendar, list of allowances and deductions, resident-tax amounts per municipality, and your Odoo version/edition. If you are not sure, we help assemble this during scoping — that is what the initial call is for.

Request a quote

Japan Payroll & Employee Profile

A Japan-localized payroll and employee-profile module for Odoo 17/18/19 that handles social insurance, income withholding tax, resident tax and JPY salary structures. ECOSIRE builds, installs and supports it after you request a quotation.

  • Social-insurance premium calculation (健康保険 health + 厚生年金 pension) from configurable rate tables keyed to the standard remuneration grade (標準報酬月額), with employer/employee split
  • Long-term care insurance (介護保険) auto-enabled for employees aged 40+ via a compute field with @api.depends on date of birth
  • Income withholding tax (源泉徴収) computed against 甲/乙 monthly tax tables driven by dependent count and social-insurance deductions
  • Resident tax (住民税) special-collection handling with a per-employee, per-municipality monthly amount schedule

Request a Quotation

Tell us about your Japan Payroll & Employee Profile 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.