Skip to main content
Odoo Community Association

Payroll Sheet Importer

Beta License: AGPL-3 OCA/account-financial-tools Translate me on Weblate Try me on Runboat

This module allows importing payroll data from Excel (.xlsx) files into accounting journal entries in Odoo. It streamlines integration between external HR/payroll systems and Odoo’s accounting module.

Main Features:

  • Map Excel columns to specific accounting accounts.

  • Detect and report missing employees based on VAT/ID/Passport numbers.

  • Associate imported data with a specific accounting journal.

  • Support for multiple mapping configurations per company.

This module is ideal for companies that receive externally processed payroll in Excel format and need a semi-automated way to post it into Odoo’s accounting system.

Table of contents

Usage

Excel File Requirements

  • File must be in .xlsx format.

  • Must contain a column with employee identifiers (e.g., VAT/ID/Passport).

  • Data columns must match those defined in the selected mapping.

  • Format has to be:

VAT/ID/Passport

Base Salary

Extra Hours

Other Concepts..

1

2000

500

…

2

1800

250

…

Employee Requirements

In order to correctly match payroll entries with existing employees (and their linked partners), each employee must have a unique identifier set in one of the following fields:

  • Identification Nº (identification_id)

  • Passport (passport_id)

These fields must match the values provided in the corresponding Excel column. If no matching employee is found, the system will list the missing identifiers, and you will need to create the missing records or update the identifiers accordingly.

Creating a Column Mapping

  1. Navigate to Accounting > Configuration > Payroll Mapping.

  2. Create a new mapping and configure:

    • Mapping name.

    • Target journal.

    • Name of the column containing employee VAT/ID/Pasport.

    • Mapping lines: Excel column → account → move type (debit/credit). Ex: “NET SALARY”, 230000, credit

  3. Save the mapping for future use.

Import

  1. Go to Accounting > Accounting > Payroll Import.

  2. Upload an Excel file containing payroll data.

  3. Choose a previously configured column mapping.

  4. The system will attempt to match employees using VAT/ID/Passport numbers:

  5. After validation, click Import to generate journal entries.

  6. If employees are missing, a warning will show the unmatched identifiers.

Known issues / Roadmap

Planned Features

  • Possibility to import summarized payroll.

  • Compatiblity with other sheet file types.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors
  • APSL-Nagarro

Contributors
Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

BernatObrador

This module is part of the OCA/account-financial-tools project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Release files for odoo-addon-account-payroll-sheet-import 18.0.1.0.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-account-payroll-sheet-import 18.0.1.0.0.3
File Interpreter ABI Platform
odoo_addon_account_payroll_sheet_import-18.0.1.0.0.3-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_account_payroll_sheet_import-18.0.1.0.0.3-py3-none-any.whl

Download URL odoo_addon_account_payroll_sheet_import-18.0.1.0.0.3-py3-none-any.whl
Size 51.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
00def425902f593f2bc7bcc25e0a28ba1857f55dcbba0764951bd50c58d3eda5
BLAKE2b-256 checksum
How to use checksums
514f0bf2f631daea93a6a37456fefcf02a590caec3df8f018b94278872b340d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

18.0.1.0.0.3 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page