Skip to main content
Egypt Payroll & Social Insurance — Egypt-localized Odoo payroll: social insurance, progressive income-tax brackets, EGP salar — 1/1Illustrative preview

Egypt-localized Odoo payroll:

social insurance, progressive income-tax brackets, EGP salary rules and Arabic + English payslips.

What is Egypt Payroll & Social Insurance?

Egypt-localized Odoo payroll: social insurance, progressive income-tax brackets, EGP salary rules and Arabic + English payslips. 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

Egyptian social insurance engine computing the contributory (insurance) base within the statutory minimum/maximum wage bracket, with separate employer and employee contribution shares posted per payslip line
Configurable social-insurance rates and the contribution ceiling stored as localization parameters (not hard-coded), so updates when the ceiling changes are a config edit, not a code rewrite
Progressive income-tax calculation across the Egyptian annual tax brackets, applied on an annualized basis and pro-rated back to the monthly payslip
Personal exemption / tax-free threshold applied before the progressive brackets, with the higher-income phase-out logic handled in the salary rule
EGP-native salary structures and structure types with basic, allowances (housing, transport, representation), variable pay and deduction rules assembled from hr.salary.rule records
End-of-service settlement and leave encashment computation on contract termination, using accrued leave balances and final salary components
Bilingual payslip: a QWeb PDF report with full Arabic right-to-left layout plus an English version, showing gross, insurance base, tax, deductions and net
hr.contract extended with Egypt-specific fields (insurance number, insured salary, tax file data) via a models.Model inheritance layer, with @api.depends computed totals
Role-based security using ir.model.access.csv and record rules so payroll managers, HR officers and employees see only permitted payslips and contract data
Automated month-end payroll batch generation via a scheduled automated action (ir.cron), reducing manual payslip-run steps
Salary-rule categories mapped to a clean chart of accounts so payroll entries post correctly to the Egyptian localization accounting when Accounting is installed
Configurable allowance and deduction catalog so HR can add company-specific components without touching Python code
XML-RPC / JSON-RPC accessible so bank-transfer file exports, attendance imports or third-party HR systems can read and write payroll data
Employee self-service payslip access in the Portal, gated by record rules, so staff download their own Arabic/English payslip without HR involvement
Version-parity build for Odoo 17.0, 18.0 and 19.0 with a versioned __manifest__.py, tested against your target edition (Community or Enterprise)

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

Running Egyptian payroll inside Odoo means wrestling core HR Payroll into shape for local rules that Odoo does not ship out of the box: the tiered social insurance base with its capped contribution ceiling, the progressive annual income-tax brackets with the personal exemption, and payslips your employees can actually read in Arabic. Most teams end up maintaining a fragile spreadsheet alongside Odoo, or paying to re-derive the same salary rules on every version upgrade.

Egypt Payroll & Social Insurance is a build-to-order localization that ECOSIRE designs, develops and installs for your company. This is not an instant download from apps.odoo.com — our team builds the module against your actual salary structures, allowance policy and legal entity, tests it on a copy of your database, and hands it to you production-ready in one working week.

Under the hood it is a proper Odoo addon. We ship a clean __manifest__.py declaring dependencies on hr and hr_payroll (Enterprise) or a Community-payroll base, versioned for Odoo 17.0, 18.0 or 19.0. Egyptian salary rules live as hr.salary.rule records computing gross, the social-insurance contributory base, employer and employee shares, taxable income and net — driven by Python code and localization parameters rather than hard-coded numbers, so brackets and ceilings can be updated when the law changes. New models (models.Model) extend hr.contract and hr.payslip with Egypt-specific fields; computed totals use @api.depends so they recalculate correctly. Access is locked down with ir.model.access.csv plus record rules so HR officers, payroll managers and employees each see only what they should. Payslips render through a bilingual QWeb report with full Arabic RTL layout, and month-end runs can be triggered by scheduled automated actions. Everything is reachable over Odoo's XML-RPC / JSON-RPC API if you integrate with a bank file or attendance system.

You keep full ownership of the source. Because it is real Odoo — salary rules, structures, views (XML/OWL) and reports — your team or ours can extend it later without vendor lock-in, and it upgrades cleanly across Odoo 17, 18 and 19.

What you get

  • The complete, installable Odoo module source (addon folder with __manifest__.py, models, salary rules, views, security and QWeb reports) — you own the code
  • Configured Egyptian salary structures, structure types and the social-insurance + income-tax salary rules mapped to your actual pay components
  • Security configuration: ir.model.access.csv and record rules for payroll manager, HR officer and employee/portal roles
  • Bilingual Arabic + English payslip QWeb report templates styled to your company letterhead
  • Installation and deployment on your Odoo 17, 18 or 19 instance, validated first on a copy of your production database
  • Administrator and HR-user documentation covering payroll runs, updating tax brackets/insurance ceilings, and end-of-service settlement
  • A live training session for your HR/payroll team, with a recording and a quick-reference guide
  • A post-go-live support window for bug fixes and adjustments, plus a defined channel for change requests

Who this is for

HR & Payroll Manager at an Egyptian SME

Runs monthly payroll for staff paid in EGP and needs social insurance and income tax calculated correctly and defensibly, without maintaining a parallel spreadsheet or re-checking every figure by hand against the law.

Finance Controller at a multi-entity group operating in Egypt

Wants payroll journal entries to post cleanly into Odoo Accounting with the right salary-rule-to-account mapping, and needs the numbers to reconcile with statutory insurance and tax filings each month.

Odoo administrator / IT lead

Owns the Odoo instance and cares about a clean, upgradeable addon — proper __manifest__.py, salary rules instead of hard-coded values, sane security rules — that survives version upgrades across Odoo 17, 18 and 19 without a rebuild.

HR officer processing new hires and leavers

Onboards employees with the correct insured salary and tax data, and needs end-of-service and leave-settlement figures generated automatically and consistently when someone leaves.

How Egypt Payroll & Social Insurance Compares

CriterionECOSIRECustom BuildCompetitorOdoo Native
Egyptian social insurance base & capped ceilingBuilt in as a configurable salary rule with employer/employee splitPossible, but you specify and pay for every edge caseRare; most generic payroll apps aren't Egypt-localizedNot included
Progressive income-tax brackets + personal exemptionImplemented as annualized salary rules, brackets held as parametersBuildable but re-derived from scratch each timeSometimes partial or hard-coded to one tax yearNot included
Bilingual Arabic (RTL) + English payslipQWeb report with true RTL layout, both languagesExtra scope you brief and fund separatelyUsually English-only or LTR-onlyPartial support
End-of-service & leave settlementComputed automatically on termination from accrued balancesDepends on how thoroughly it was specifiedVaries widely; often not Egypt-specificNot included
Odoo 17 / 18 / 19 version parityBuilt and tested for your target version, upgradeableOne-off; re-work likely on each upgradeDepends on the publisher keeping it currentIncluded
Source-code ownership & no lock-inYou receive and own the full addon sourceYou own it, at full bespoke costOften obfuscated or license-restrictedIncluded
Role-based access (ir.model.access.csv + record rules)Configured for manager/HR/employee/portal rolesOnly if scoped and builtGeneric, rarely tuned to payroll sensitivityPartial support
Legal-change updates (ceiling / brackets)Config edit, not a rebuild; maintenance availableDeveloper engagement each timeWait on the publisher's release cycleNot included

Frequently Asked Questions about Egypt Payroll & Social Insurance

How long until the module is delivered, and how does the build process work?

This is a build-to-order module, not an instant apps.odoo.com download. Typical delivery is one working week from the point we confirm your salary structures, allowance policy and target Odoo version. The process is: discovery and requirements sign-off, development of the salary rules and models against your data, testing on a copy of your production database, then installation, training and go-live. If you have an unusual allowance or settlement policy the timeline can shift, and we'll tell you up front.

What support and updates do I get after go-live?

Every build includes a defined post-go-live support window for bug fixes and adjustments, plus a clear channel for change requests. Because the social-insurance ceiling and income-tax brackets are stored as configurable parameters (not hard-coded), routine legal changes are a config update rather than a paid rebuild. When Egyptian rules change materially, or you upgrade to a newer Odoo version, we can quote a maintenance update — you keep the source either way, so you're never locked in.

Does it work on Odoo Community or only Enterprise?

Both are supported. Odoo's full HR Payroll app is an Enterprise feature, so on Enterprise we extend hr_payroll directly. For Community deployments we build on a Community payroll base and confirm the exact dependency and scope with you during discovery. We target Odoo 17.0, 18.0 or 19.0 — tell us your edition and version and we build the __manifest__.py to match.

How are the Egyptian social insurance and income tax actually calculated?

Both are implemented as proper Odoo salary rules (hr.salary.rule) with Python computation. Social insurance uses the statutory contributory base within the minimum/maximum insured-wage bracket and splits employer and employee shares. Income tax applies the personal exemption then the progressive annual brackets, annualized and pro-rated to the monthly payslip. Rates, the exemption and the ceiling are configurable localization parameters, so you can update them when the law changes without a developer.

Are the payslips really in Arabic, and can employees download their own?

Yes. Payslips render through a bilingual QWeb report with a full Arabic right-to-left layout plus an English version, styled to your letterhead. Employees can access their own payslips through the Odoo Portal, gated by record rules so each person only sees their own — HR doesn't have to email PDFs around.

Can it integrate with our bank file or existing HR/attendance systems?

Yes. Everything is standard Odoo data reachable over the XML-RPC / JSON-RPC API, so bank-transfer file exports, attendance imports or third-party HR tools can read and write payroll records. If you need a specific bank format or integration, we scope it during discovery and build it as part of the module.

Request a quote

Egypt Payroll & Social Insurance

Egypt-localized Odoo payroll: social insurance, progressive income-tax brackets, EGP salary rules and Arabic + English payslips.

  • Egyptian social insurance engine computing the contributory (insurance) base within the statutory minimum/maximum wage bracket, with separate employer and employee contribution shares posted per payslip line
  • Configurable social-insurance rates and the contribution ceiling stored as localization parameters (not hard-coded), so updates when the ceiling changes are a config edit, not a code rewrite
  • Progressive income-tax calculation across the Egyptian annual tax brackets, applied on an annualized basis and pro-rated back to the monthly payslip
  • Personal exemption / tax-free threshold applied before the progressive brackets, with the higher-income phase-out logic handled in the salary rule

Request a Quotation

Tell us about your Egypt Payroll & Social Insurance 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.