OdooWiki OCA HUB

HR - Payroll Document - PyMuPDF

hr_payroll_document_pymupdf folder_open OCA/payroll open_in_new
Payrolls License: AGPL-3

Use the library PyMuPDF (https://github.com/pymupdf/pymupdf) to attempt reading the PDF payslip.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Adds a PyMuPDF-based fallback so Odoo can still read the text of a PDF payslip when the normal reader fails, improving payslip import in the payroll management wizard.

This module extends the payroll management wizard used to import payslips from PDF files. It does not add new menus or screens; it changes what happens behind the scenes when Odoo tries to read a PDF payslip.

When the standard reading attempt fails, the module now tries a second method using the PyMuPDF library. It opens the PDF, extracts the text of each page, and rebuilds a simple PDF containing that text. The rebuilt PDF is then handed back to the normal reader, so the rest of the payslip import can continue.

  • Only runs as a fallback: if the normal reader already succeeds, nothing changes.
  • Works page by page, so multi-page payslips are handled.
  • Requires the PyMuPDF Python library to be installed on the server.
  • Touches the payroll.management.wizard model and its _get_fallback_reader method.

Business users see the benefit indirectly: payslips that previously could not be read may now be imported successfully. No new fields, buttons, reports, emails, or scheduled actions are added by this module.

Depends on

hr_payroll_document
Models and fields (1)
  • payroll.management.wizard · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

terminal Installation and usage

No verified information

Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.