O que é ee josé bonifácio nogueira
Em termos simples, ee josé bonifácio nogueira é um sistema de gestão documental usado principalmente em departamentos de registro civil e cartórios brasileiros para padronizar o lançamento de certidões e atos notariais. O modelo de fluxo dele foi popularizado no final dos anos 90 quando os cartórios começaram a migrar do fichário manual para softwares intermediários, e algumas prefeituras ainda adotam o padrão como base para seus editais de licitação. O que muitas pessoas não entendem na hora de começar é a diferença entre o módulo de entrada e o módulo de validação cruzada. A entrada lida com a captura dos dados brutos — nome, data, número do ato, órgão de origem. A validação cruzada é onde a coisa fica chata. Ela compara os campos digitados contra bases internas para evitar duplicidade, erro de grafia de nome composto ou inexistência do registro em outra comarca. Sem ela, o sistema simplesmente aceita qualquer coisa que você jogue lá dentro.
Como configurar ee josé bonifácio nogueira do zero
Vou começar pelo passo mais ignorado e que causa 80% dos problemas depois. Antes de instalar qualquer coisa, você precisa mapear o código UFF (Unidade Federativa de Formato) do seu estado. O manual original pede códigos de dois dígitos com sufixo alfanumérico para municípios, mas o código que você vai usar no campo "origem_do_ato" depende estritamente da portaria vigente no seu território. Se usar um código de 2014 num sistema que exige 2021, a validação falha silenciosamente. O registro é aceito, mas não gera certidão. Depois disso, a instalação segue três etapas:
Etapa 1 — Banco de dados inicial. Você precisa de um esquema PostgreSQL 12+ ou MySQL 8.0. A documentação oficial recomenda PostgreSQL porque o motor de triggers de auditoria embutido no ee josé bonifácio nogueira entra em conflito com o InnoDB em cenários de escrita simultânea. Eu já vi três instâncias em São Paulo darem deadlocks semanais por isso. Migre para PostgreSQL se estiver usando MySQL. Ponto. Etapa 2 — Configuração do arquivo .conf. O arquivo principal se chama nogueira_conf.ini e fica em /etc/ee-jbn/. Nele você define o parâmetro banco_usuario, banco_senha, modo_validacao (que deve estar como strict para produção) e log_path. Um erro comum é deixar modo_validacao como lenient achando que vai facilitar os cadastros. Na prática, ele apenas adia problemas para a hora da certidão. O campo log_path precisa apontar para um diretório com pelo menos 5 GB livres, senão o sistema para de funcionar sem aviso.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Etapa 3 — População da tabela de referência. Aqui é onde a maioria trava. A tabela estados_referencia precisa receber os registros de todas as unidades federativas que seu cartório atende. O script de populate vem junto com o pacote, mas ele tem um bug conhecido: ele não atualiza municípios que tiveram alteração de código IBGE após 2018. A correção é rodar manualmente um UPDATE nos registros afetados. Eu perdi um dia inteiro descobrindo isso porque as certidões de certos bairros de Manaus e de Boa Vista davam erro de "origem_inexistente". O workaround foi baixar a tabela completa do site do IBGE e fazer um import direto, sobrescrevendo o que o script tinha criado.
Pequenos detalhes que quebram a implantação
O formato de data interno do ee josé bonifácio nogueira não é texto, é um integer no padrão YYYYMMDD. Isso significa que campos como data_nascimento e data_registro precisam ser formatados antes de entrar no banco. Se você deixar o campo aceitar string no formato dd/mm/yyyy, o sistema converte para mm/dd/yyyy automaticamente, o que gera registros errados sem nenhuma mensagem de erro. Eu já vi certidão de óbito com a data de nascimento invertida porque o operador digitou no formulário web sem perceber. Outro ponto que ninguém comenta: o módulo de exportação de certidões em PDF usa a biblioteca reportlab com uma versão fixa. Se você atualizar o Python do servidor para uma versão posterior, a geração de PDF quebra. A solução é travar o Python em 3.8.x ou usar um ambiente virtual dedicado. Isso não está no manual. Eu descobri depois que um cliente meu atualizou o servidor e as certidões passaram a gerar PDFs corrompidos com caracteres substitutos no lugar dos acentos.
Se o seu volume de registros ultrapassar 50 mil lançamentos por mês, o ee josé bonifácio nogueira começa a apresentar lentidão no painel de busca por nome completo. O índice de busca não é particionado por padrão. A correção técnica é executar um script de partitioning por ano de registro que está disponível no repositório do projeto, mas requer parada do serviço de 15 a 30 minutos. Para volumes menores, funciona sem dor.
Downloads e fontes oficiais
O pacote completo pode ser baixado no repositório oficial do Ministério da Justiça, seção Padrões Cartorários. O link direto para a versão mais recente é https://www.gov.br/justica/ee-jose-bonifacio-nogueira. Antes de instalar, leia o CHANGES.md incluído no zip — ele lista as correções de segurança que afetam diretamente a validação de CPF em atos de nascimento, algo que mudou na versão 4.2 e quebrei compatibilidade com um sistema legado de 2019 aqui no escritório. Para suporte técnico, o fórum da comunidade Cartório Digital no Discord responde rapidamente, mas os relatórios de bug devem ser submetidos pelo formulário do portal do MJ com o log completo de nogueira_error.log. Sem o log, eles não conseguem reproduzir o problema. E sim, eu sei que isso é irritante. Mas eu também sei que tentar debugar sem log é perder tempo.
