Cadastrar um empregado CLT e abrir o contrato de trabalho

  • Cenário PES-01

  • Disponível

  • Perfil: Departamento pessoal

  • Mais tarefas do perfil: Departamento pessoal

  • Odoo 16.0

Etapa 1 de 14 do processo Folha e eSocial. Próxima: Calcular e confirmar a folha mensal de um empregado CLT.

Cadastro do funcionário com os dados de folha (tipo de contrato CLT e dependentes do IRRF) e abertura do contrato com jornada, salário e estrutura de cálculo. Os campos de folha vêm do módulo l10n_br_hr_payroll, da KMEE (kmee-odoo-addons), fora do repositório OCA/l10n-brazil; o cadastro básico (l10n_br_hr) é do OCA.

Visão geral: Manter cadastros, contratos e ausências

Vídeo

Duração: 2 min 37 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

  • Empresa configurada (Criar a empresa preenchida pela consulta de CNPJ) e estruturas salariais da folha instaladas.

  • Horário de trabalho Jornada CLT 44h/semana cadastrado.

  • O perfil Departamento pessoal precisa do grupo Criação de Contato: sem ele o cadastro do funcionário falha com Erro de Acesso (achado).

Exemplo usado neste cenário

A Sua Empresa (São Paulo) admite Bruno Teixeira Lima, empregado CLT com um dependente no IRRF, com início em 01/11/2026, salário de R$ 3.000,00 e jornada de 44 horas semanais.

Como os valores são calculados:

  • Jornada de 44 horas semanais (Constituição, art. 7º, XIII) distribuída em 6 dias: 44 / 6 = 7h20 por dia; 7h20 x 30 dias = 220 horas mensais, divisor usado pela folha (o mensalista recebe também o descanso semanal, por isso a conta usa 30 dias e não apenas os dias trabalhados).

  • Valor da hora normal: 3.000,00 / 220 = 13,64 (13,6364).

  • Hora extra a 50% (Constituição, art. 7º, XVI): 13,6364 x 1,5 = 20,45 por hora.

  • Dedução por dependente no IRRF: 189,59 por mês, valor da tabela do IRRF de 2026 da Receita Federal (https://www.gov.br/receitafederal/pt-br/assuntos/meu-imposto-de-renda/tabelas/2026), cadastrada em Configuração -> Tabelas Fiscais BR.

Passo a passo

  1. Abra o aplicativo Funcionários pelo menu de aplicativos.

  2. Clique em Novo.

  3. No nome do funcionário, digite Bruno Teixeira Lima.

  4. Na aba Informações Pessoais, crie o Endereço com o nome do funcionário (campo obrigatório).

  5. No campo CPF, informe 727.253.530-09 (número fictício, válido apenas para o teste).

  6. Na aba Folha de Pagamento, informe 1 em Dependentes IRRF; o Tipo de Contrato já é CLT.

  7. Clique no botão Contratos: o funcionário é salvo e abre o histórico de contratos.

  8. Clique em Criar para abrir o contrato do funcionário.

  9. No nome do contrato, digite Contrato Bruno Teixeira Lima.

  10. No campo Data de início do contrato, informe 01/11/2026.

  11. No campo Horário de Trabalho, escolha Jornada CLT 44h/semana.

  12. Preencha os obrigatórios: Tipo de admissão Admissão, Regime CLT e Responsável do RH.

  13. Na aba Informação de Salário, informe o Salário de 3.000,00 e a unidade Monthly (mensal).

  14. No campo Estrutura do Salário, escolha CLT.

  15. Clique em Em uso na barra de situação: o contrato passa a valer para a folha.

Resultado esperado

Funcionário Bruno Teixeira Lima cadastrado como CLT com um dependente, e contrato em uso com salário de 3.000,00, jornada de 44 horas semanais e estrutura CLT. O contrato aparece como Contrato Atual do funcionário e o holerite (Calcular e confirmar a folha mensal de um empregado CLT) já o encontra.

Se houver erro

  • Ao salvar o contrato aparece Campos inválidos: Tipo de admissão, Regime de trabalho, Responsável do RH, Unidade do salário. Esses quatro campos são obrigatórios no contrato brasileiro. Preencha os quatro campos; a unidade aparece como Monthly na lista (rótulo sem tradução, achado).

  • Ao salvar o funcionário aparece CPF False é inválido. O CPF é obrigatório e validado pelos dígitos verificadores, mesmo sem dado informado. Informe um CPF válido no campo CPF da aba Informações Pessoais.

  • Ao salvar o funcionário aparece Campos inválidos: Endereço. O endereço residencial é obrigatório no cadastro brasileiro e guarda o CPF do funcionário. Preencha o Endereço na aba Informações Pessoais, criando o contato com o nome do funcionário.

  • Ao salvar o funcionário aparece Erro de Acesso sobre o contato (res.partner). O usuário não tem o grupo Criação de Contato, necessário porque o salvar grava o endereço e o CPF no contato. Peça ao administrador o grupo Acessos Extra / Criação de Contato para o perfil.

  • O holerite não acha contrato para o funcionário. O contrato ficou como Novo, sem passar para Em uso, ou sem data de início no período do holerite. Abra o contrato, clique em Em uso e confira a data de início.

Limites deste cenário

Não cobre a admissão completa: PIS, CTPS, dependentes nominais, exame admissional e o evento S-2200 do eSocial (ver Gerar o evento S-1200 do eSocial e montar o lote de transmissão) ficam fora do roteiro. Sem o grupo Criação de Contato, o perfil Departamento pessoal não salva o funcionário (achado de permissão). Os campos eSocial do funcionário (matrícula e categoria) existem no modelo, mas não aparecem na tela (achado). Os módulos de folha são da KMEE e não fazem parte do repositório OCA.

Módulos: l10n_br_hr, l10n_br_hr_contract, l10n_br_hr_payroll, hr_contract. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.