Folha de pagamento CLT no Odoo: validada em produção, agora open source.
O cálculo CLT (INSS, IRRF, FGTS, 13º, férias, rescisão) rodou anos em produção em órgão público brasileiro. Agora migrado para Odoo 16 e doado à OCA, sem licença por colaborador e sem MDR sobre folha.
Quando o leiaute eSocial muda, o fix entra no GitHub OCA em dias. Você não espera o roadmap fechado de uma vendor.
AGPL-3 · validado por anos em produção · 232 testes · em curso na OCA
De onde vem o código
A KMEE construiu o módulo de folha CLT para a ABGF (Agência Brasileira Gestora de Fundos), órgão público federal cliente da KMEE. O sistema rodou em Odoo 8.0 em produção emitindo holerites mensais por anos: cálculo de INSS progressivo, IRRF, FGTS, salário-família, 13º (1ª e 2ª parcelas), férias com art.130, rescisões com verbas legais, 22 tipos de afastamento CLT, reembolso via folha, sindicatos.
Agora estamos modernizando esse mesmo código para Odoo 16 e doando à OCA. O histórico do kmee-odoo-addons no GitHub incorpora 2.257 commits dessa história via git merge --strategy=ours, preservando rastreabilidade. Todo o código foi reescrito para a API do Odoo 16, com 232 testes automatizados e BDD specs em arquivos .feature. O destino final é o repositório OCA/l10n-brazil.
Resultado: cálculo CLT autoral KMEE, validado por anos de produção real em órgão público, agora em código aberto, sem cobrança por colaborador. Toda a comunidade Odoo brasileira ganha.
O que vem dentro
Folha CLT completa, eSocial transmitindo, código auditável.
Cálculo CLT validado em produção
INSS progressivo, IRRF progressivo, FGTS, salário-família, DSR, faltas, 13º (1ª e 2ª parcelas), férias CLT art.130, rescisão por verbas configuráveis. Anos de holerite real emitido na ABGF.
Decimal ROUND_HALF_UP documentado
414 linhas de testes garantindo arredondamento correto. Corrige o bug clássico de banker's rounding do `round()` Python. É raro ver isso explicitado.
BDD specs em arquivos .feature
Cálculos auditáveis por linguagem natural (Gherkin). Seu contador pode ler. Cada cenário (admissão, férias, rescisão, 13º) tem caso de teste reproduzível.
eSocial transmitindo via certificado A1
Geração de XML via biblioteca `esociallib`, assinatura ICP-Brasil A1 (PFX), transmissão direta para o ambiente nacional. Lote <= 50 eventos (regra do governo), classificação automática por grupo.
Recursos do trabalhador completos
22 tipos de afastamento CLT, reembolso via folha (`hr.expense -> payslip`), substituição CLT art.450, sindicatos (CCT/ACT), tabelas oficiais populadas (CID 14k linhas, processo FAP 7k linhas).
AGPL-3, sem licença por colaborador
Sem cobrança por contracheque emitido e sem MDR sobre folha. Você roda na sua infra, audita o cálculo e contribui de volta para a OCA. Senior/TOTVS/ADP/Domínio cobram por colaborador ativo.
Cobertura eSocial: leiaute S-1.3
Eventos do eSocial cobertos pelo módulo, com evolução contínua na OCA.
-
S-1000Empregador -
S-1005Estabelecimentos -
S-1010Rubrica -
S-1020Lotação Tributária -
S-1070Tabela de processos -
S-1200Remuneração RGPS (mensal) -
S-1210Pagamentos -
S-1299Fechamento da competência -
S-2200Admissão / Cadastro inicial -
S-2205Alteração de dados cadastrais
-
S-2206Alteração contratual -
S-2210CAT (Comunicação de Acidente) -
S-2220ASO (Atestado Saúde Ocupacional) -
S-2230Afastamento -
S-2240Agentes nocivos -
S-2298Reintegração -
S-2299Desligamento -
S-2300Trabalhador sem vínculo -
S-3000Exclusão de evento -
S-5001/5002/5003/5011Totalizadores
A cobertura para o seu cenário (regimes, rubricas, SST) é apresentada no diagnóstico.
Comparativo com folhas proprietárias
Senior HCM, TOTVS RM Folha e Domínio/Onvio em 10 critérios técnicos e comerciais.
| Critério | Senior HCM | TOTVS RM Folha | Domínio/Onvio | Odoo + OCA (KMEE) |
|---|---|---|---|---|
| Modelo de licença | Por colaborador | Licença + manutenção | Por colaborador | Sem licença, sem por colaborador |
| Acesso ao código | Closed (SDK Senior X) | Closed ADVPL | Closed | AGPL-3: fork, audit, modifique |
| Vendor lock-in | Alto | Alto | Médio | Zero |
| BDD .feature files | Não | Não | Não | Sim |
| ROUND_HALF_UP testado | Não documentado | Não documentado | Não documentado | 414 linhas testes |
| Eventos eSocial cobertos | Completo | Completo | Completo | Cobertos pelo módulo, evolução contínua na OCA |
| Portal do empregado | Kit pronto | Kit pronto | Kit pronto | Via portal Odoo, escopo definido no projeto |
| Integração nativa NF-e/SPED | Via ETL | Nativa | Via export | Mesma base Odoo |
| Velocidade adaptação leiaute | Roadmap interno | Roadmap interno | Roadmap interno | Commit GitHub em dias |
| Validação em produção real | Centenas de clientes | Milhares de clientes | Milhares de escritórios | ABGF (anos em Odoo 8.0) |
Não atacamos competidores. Apresentamos a alternativa open source que faltava no mercado brasileiro de folha.
Perguntas frequentes
As dúvidas que mais recebemos sobre folha + eSocial no Odoo.
A folha do Odoo+KMEE está em produção?
Sim. A KMEE construiu o módulo de folha CLT para a ABGF (Agência Brasileira Gestora de Fundos), cliente da KMEE. O sistema roda em produção sobre Odoo 8.0 há anos emitindo holerites mensais. Esse mesmo cálculo autoral KMEE é módulo doado à OCA, migrado para Odoo 16.
Quais eventos eSocial o módulo cobre?
Tabelas (S-1000, S-1005, S-1010, S-1020, S-1070), eventos do trabalhador (S-2200, S-2205, S-2206, S-2210, S-2220, S-2230, S-2240, S-2298, S-2299, S-2300), periódicos (S-1200, S-1210, S-1299) e estruturais/totalizadores (S-3000, S-5001/5002/5003/5011), com evolução contínua na OCA. A cobertura para o seu cenário é apresentada no diagnóstico.
Cobre Reinf?
Não diretamente neste stack. Reinf vive em outro stack OCA (`l10n_br_reinf`) em paralelo, complementar. Para empresas que precisam de R-2010, R-2030, R-2040 (Reinf-pessoa-jurídica), trabalhamos a integração separada.
Cobre DCTFWeb?
A cobertura de DCTFWeb depende do fechamento periódico (S-1299), dos totalizadores (S-5001/5002/5003/5011) e da integração com o Reinf; o alcance para o seu cenário é apresentado no diagnóstico.
É AGPL-3 mesmo?
Sim. O código está em github.com/kmee/kmee-odoo-addons (incubadora) e em github.com/OCA/l10n-brazil (destino final). Você pode rodar, modificar, contribuir. Sem cobrança por colaborador, sem MDR sobre folha.
Quem usa hoje?
ABGF (órgão público federal) usa em produção sobre Odoo 8.0 há anos. Novos clientes começam a adotar à medida que a versão 16.0 estabiliza. Se sua empresa tem prioridade específica, KMEE pode priorizar com escopo pago.
Funciona em qual versão do Odoo?
A versão modernizada do PR atual é Odoo 16 + OCA l10n-brazil 16.0. ABGF roda Odoo 8.0 em produção. Versões 17 e 18 da OCA ainda não receberam o stack completo de account/sale/purchase brasileiros, então folha em 17/18 fica para depois.
Como assina os XMLs eSocial?
ICP-Brasil A1 (PFX), reusando o módulo `l10n_br_fiscal_certificate` da OCA. O mesmo certificado A1 que assina NF-e/CT-e/MDF-e assina os eventos eSocial. Vault externo opcional (HashiCorp, AWS, Azure, GCP).
Como transmite os eventos?
Direto para o ambiente nacional do eSocial (homologação `tp_amb=2` ou produção `tp_amb=1`). A biblioteca `esociallib` faz parsing, validação XSD e SOAP. Lote <= 50 eventos (regra do governo), classificação automática por grupo (1=tabelas, 2=não-periódicos, 3=periódicos).
E se a transmissão falhar?
O modelo `l10n_br.esocial.ocorrencia` registra erros por evento. Estado-máquina permite reenvio: `draft -> validated -> pending -> sent -> success | error | rectified`. Em caso de retorno de erro do governo, o evento volta para correção sem bloquear o lote inteiro.
Tem portal do empregado?
Via portal Odoo, com escopo definido no projeto. Se sua empresa precisa de portal/holerite digital com QR Code, conversamos sobre o desenvolvimento no diagnóstico.
Tem folha de ponto integrada?
Apenas `hr.attendance` core do Odoo. Integrações com relógio de ponto físico ou app têm escopo definido no projeto.
Quem revisou os cálculos?
Anos de uso real na ABGF + 232 testes automatizados + BDD specs em `.feature` + revisão da comunidade OCA quando o PR mergear.
Quanto custa?
Sem licença por colaborador. Você paga implantação (escopo definido após diagnóstico de adoção) e suporte mensal contínuo. Se um evento tem prioridade específica para sua operação, podemos priorizar com escopo pago, e esse trabalho beneficia toda a comunidade OCA.
Posso patrocinar a evolução de um evento ou feature?
Sim. Sponsorship é caminho comum em projetos OCA. Se sua empresa tem prioridade específica, conversamos sobre escopo, prazo e contribuição. O código volta para a OCA e todo o ecossistema brasileiro ganha.
Diagnóstico de adoção gratuito
Em 30 minutos mapeamos seu cenário (volume, eventos eSocial necessários, ERP atual, time RH) e saímos com um plano realista de adoção ou recomendação de manter o sistema atual.
Conte sobre sua folha
Quantos colaboradores, sistema atual de folha, eventos eSocial críticos, prazo. Retornamos em até 1 dia útil.
Sem spam, sem venda de lista. LGPD-compliant. Política de Privacidade.