Tupiniquim Nova Lima

O que é e como funciona o Tupiniquim Nova Lima

O Tupiniquim Nova Lima não é exatamente uma ferramenta única e pronta. É mais um ecossistema de scripts e configurações que roda na região metropolitana de Belo Horizonte, focado em automação de processos administrativos para prefeituras e órgãos municipais pequenos. Ninguém centralizou isso oficialmente. Surgiu de um grupo de desenvolvedores locais que começaram a compartilhar soluções em fóruns e em eventos da comunidade tech de Minas Gerais. A coisa funciona basicamente assim: você tem um servidor (pode ser uma VM simples, até no Google Cloud ou AWS, dependendo do tamanho do município) com um conjunto de scripts em Python que se comunicam com o sistema oficial de gestão pública do governo estadual. O objetivo principal é automatizar a emissão de notas fiscais de serviço, o cadastro de fornecedores e o envio de relatórios para a controlladoria. Nada de avançado, mas economiza horas de trabalho manual que os servidores públicos passam todo dia.

Como configurar o tupiniquim nova lima do zero

Você começa baixando o repositório do GitHub que o pessoal mantém. O link principal está no repositório `tupiniquim/nl-core`. A instalação pede Docker e Docker Compose rodando no seu servidor. O processo leva uns 20 minutos se você já tiver o básico configurado. O passo a passo sem enrolação: Faça o clone do repositório, entre na pasta e copie o arquivo `.env.example` para `.env`. Nele você vai colocar as credenciais de acesso ao sistema do governo estadual — essas credenciais você pede direto na SEI (Secretaria de Estado de Informática), não tem outro jeito. Depois dá um `docker compose up -d`. O sistema sobe, faz o teste de conexão e te avisa se as credenciais estão corretas.

A parte que mais dá problema é a configuração do fuso horário. O padrão do container vem como UTC, mas muitos servidores municipais ficam em horário de verão e aí a coisa trava na emissão de notas. A correção é simples: adiciona `TZ=America/Sao_Paulo` no arquivo `.env` e sobe o container de novo. Eu fiz essa pergunta em três fóruns diferentes antes de encontrar a resposta certa num post antigo do Telegram de um cara que trabalha na prefeitura de Ribeirão das Neves.

O que você realmente precisa saber antes de usar

O sistema é bom, mas ele não resolve tudo. Ele depende inteiramente da estabilidade do API do governo estadual. Se o sistema deles cair, o seu cai junto. Isso acontece frequentemente em datas de fechamento de lote, tipo final de mês e março/ setembro. Aí não tem workaround técnico que resolva. Você só espera. Outro ponto importante: a documentação é praticamente inexistente. Os arquivos README explicam o básico, mas cenários mais específicos, como lidar com notas de prestadores estrangeiros ou correções de lançamentos em lotes já enviados, ficam espalhados em issues do GitHub e em threads do fórum da comunidade. Recomendo acompanhar as issues abertas do repositório principal antes de implementar qualquer coisa em produção. Se o seu município tem mais de 50 mil habitantes, o Tupiniquim Nova Lima ainda funciona, mas começa a ficar apertado com a carga de processamento. Neste caso, eu sugeriria migrar para uma solução mais robusta, como um ERP municipal dedicado. O Tupiniquim foi feito para prefeituras pequenas, com equipe reduzida de TI. Para algo maior, você vai gastar mais tempo resolvendo problemas do que ganhando em automação.

O download e a documentação técnica estão disponíveis gratuitamente. Não tem custo de licença. A desvantagem real é o suporte: não há ninguém para ligar e pedir ajuda. Tudo é baseado em comunidade. Se você tiver paciência para ler issues e fórums, funciona bem. Se quiser um contrato com SLA, melhor procurar outra opção.