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.
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 PR #277 do kmee-odoo-addons 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. Diferenciação técnica raríssima de ver explicitada.
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. Sem MDR sobre folha. Você roda em sua infra, audita o cálculo, contribui de volta para a OCA. Senior/TOTVS/ADP/Domínio cobram por colaborador ativo.
Cobertura eSocial — leiaute S-1.3
Honestidade total: o que está migrado para 16.0 hoje, e o que está em sprint de migração.
Migrado para Odoo 16
8 eventos cobertos hoje, validados em produção:
-
S-1000Empregador ✓ migrado -
S-1010Rubrica ✓ migrado -
S-1020Lotação Tributária ✓ migrado -
S-1200Remuneração RGPS (mensal) ✓ migrado -
S-2200Admissão / Cadastro inicial ✓ migrado -
S-2206Alteração contratual ✓ migrado -
S-2230Afastamento ✓ migrado -
S-2299Desligamento ✓ migrado
Em migração para Odoo 16
12 eventos com código legado da ABGF aguardando port para 16.0:
-
S-1005Estabelecimentos -
S-1070Tabela de processos -
S-1210Pagamentos -
S-1299Fechamento da competência -
S-2205Alteração de dados cadastrais -
S-2210CAT (Comunicação de Acidente) -
S-2220ASO (Atestado Saúde Ocupacional) -
S-2240Agentes nocivos -
S-2298Reintegração -
S-2300Trabalhador sem vínculo -
S-3000Exclusão de evento -
S-5001/5002/5003/5011Totalizadores
Sponsorship aceito: se um evento é crítico para sua operação, podemos priorizar o port — código volta para a OCA.
Comparativo com folhas proprietárias
Senior HCM, TOTVS RM Folha, Domínio/Onvio — 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 | 8 migrados + restante em port |
| Portal do empregado | Kit pronto | Kit pronto | Kit pronto | Roadmap |
| 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 é beta? ▼
Não. A KMEE construiu o módulo de folha CLT para a ABGF (Agência Brasileira Gestora de Fundos), cliente da KMEE — o sistema rodou em produção sobre Odoo 8.0 por anos emitindo holerites mensais. O PR atual traz esse mesmo código autoral KMEE migrado para Odoo 16 e doado à OCA. O badge 'Beta' no manifest reflete o ciclo de migração + revisão OCA, não imaturidade do método.
Quais eventos eSocial estão cobertos na migração para Odoo 16 hoje? ▼
8 eventos: S-1000 (empregador), S-1010 (rubrica), S-1020 (lotação tributária), S-1200 (remuneração mensal), S-2200 (admissão), S-2206 (alteração contratual), S-2230 (afastamento), S-2299 (desligamento). Os demais (S-1005, S-1070, S-1210, S-1299, S-2205, SST, S-3000, totalizadores) estão em migração — o código legado da ABGF existe, é trabalho de port para 16.0.
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? ▼
Hoje não automatiza. Depende do fechamento periódico (S-1299) + totalizadores (S-5001/5002/5003/5011) + integração com Reinf. Esses componentes estão na fila de migração.
É 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 precisa de evento ainda em migração, KMEE pode priorizar o port 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? ▼
Hoje não nativo. Roadmap. Se sua empresa precisa de portal/holerite digital com QR Code, podemos discutir desenvolvimento sob escopo.
Tem folha de ponto integrada? ▼
Apenas `hr.attendance` core do Odoo. Integrações com relógio de ponto físico ou app via roadmap.
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. É cálculo que pagou contracheque real por anos.
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 ainda em migração for crítico para sua operação, podemos priorizar o port com escopo pago — esse trabalho beneficia toda a comunidade OCA.
Posso patrocinar a migração de um evento ou feature? ▼
Sim. Sponsorship é caminho comum em projetos OCA. Sua empresa precisa de S-1299 fechando competência amanhã? Podemos priorizar com você. O código volta para a OCA — 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.