OdooWiki OCA HUB

Brazilian Localization HR

l10n_br_hr folder_open OCA/l10n-brazil open_in_new
Localization License: AGPL-3

Este é o módulo base dos recursos humanos brasileiro e implementa adaptações nos modelos básicos do cadastro de Empregados e suas dependências:

  • Campo CPF com formatação e validação desto memso;
  • CPTS com validação;
  • PIS/PASEF;
  • Certificado de serviço militar;
  • Naturalidade;
  • Escolaridade - usar hr_skills;
  • Dependentes - Usar hr_employee_relative;
  • RG;
  • Título de eleitor;
  • Paternidade;
  • Etinia;
  • Tipo sanguíneo;
  • Incapacidade física;
  • Tipo: Funcionário / Autônomo / Terceirizado / Cedido;

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds Brazilian employee registration fields to Odoo HR, such as CPF, PIS/PASEP, CTPS, voter title, military certificate, ethnicity, blood type and deficiency, with CPF and PIS/PASEP validation. It also adds a Brazilian occupation code (CBO) on job positions and separates employees by relationship type.

This module adapts the standard Employee screen to Brazilian HR requirements. On the employee form you get a Documents tab with CTPS (number, series, date, district), civil certificate type, identity document (RG number, issuing organ, dates, district and city), military service certificate and category, voter registration (title, zone, section), driver license (number, category, expiry), PIS/PASEP with emission date, and parents' names. A Health tab records blood type, deficiency and a description, and a Characteristics group records ethnicity.

Business rules: the CPF is validated when saved and automatically formatted; an invalid PIS/PASEP raises an error. The employee country defaults to Brazil. Each employee has a relationship type (employee, self-employed, outsourced, assigned), defaulting to employee.

In the Employees menu a new Colaboradores section splits lists into Employees, Autônomos and Terceirizados, filtered by relationship type. Under Configuration an Employee register menu lets HR managers maintain deficiencies, identity types, civil certificate types and ethnicities; ethnicity records are read-only. A CBO menu and a CBO field on job positions let you link jobs to the Brazilian occupation classification.

It also adds a CNPJ/CEI field on the company and a Union Entity code on contacts, and extends marital status choices with common-law marriage and separated.

Required by other modules

Menus it adds

Employee registermenu_hr_deficiencymenu_hr_identity_typemenu_hr_civil_certificate_typemenu_hr_ethnicityColaboradoreshr.menu_open_view_employee_list_myAutônomosTerceirizadosRelatóriosCBO
Models and fields (11)
  • hr.job · extends an existing modelcbo_id (CBO)
  • hr.version · extends an existing model
  • hr.employee · extends an existing modelcpf (CPF), ctps (CTPS), cnpj_cpf (CNPJ/CPF), ctps_date (CTPS emission date), ethnicity, organ_exp (Dispatcher organ), pis_pasep (PIS/PASEP), blood_type, country_id, creservist (Military service status certificate), ctps_uf_id (CTPS district), voter_zone, cresv_categ (Military service status category), ctps_series (CTPS series), father_name, mother_name, rg_emission (Emission date), voter_title, driver_categ (Driver license category), registration (Registration number), birth_city_id, deficiency_id (Deficiency), voter_section, driver_license (Driver license number), identity_uf_id (ID expedition district), pis_pasep_date (PIS/PASEP emission date), alternate_email, alternate_phone, expiration_date, l10n_br_rg_code
  • res.company · extends an existing modelcnpj_cei (CNPJ/CEI Tomadora/Obra)
  • res.partner · extends an existing modelunion_entity_code (Union Entity code)
  • hr.ethnicity · new model
  • hr.deficiency · new model
  • l10n_br_hr.cbo · new model
  • hr.identity.type · new modelname (Identity type), initials, employee_ids (Employees)
  • l10n_br_hr.data.abstract · new modelcode, name
  • hr.civil.certificate.type · new model

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

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

Confirmation status: 7 confirmed, 2 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 19.0

Este módulo tem uma depedencia do pacote python erpbrasil.base

Este módulo não requer nenhuma configuração especial.

No verified information in OCA: Usage.

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.